通过 POST http://127.0.0.1:3000/fetch_sys_faces（请求体为 JSON 参数）或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
refresh |
bool | – | false |
是否强制从 QQ 刷新目录 |
按分组返回完整的 QQ 系统表情映射。
所有响应都包裹在标准信封中：{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
packs |
object[] | ✓ |
{
"type": "object",
"properties": {
"packs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"pack_name": {
"type": "string"
},
"emojis": {
"type": "array",
"items": {
"type": "object",
"properties": {
"q_sid": {
"type": "string",
"description": "QQ 表情目录标识（部分 emoji 为 Unicode 表情字符串）"
},
"q_des": {
"type": "string",
"description": "表情描述"
},
"em_code": {
"type": "string"
},
"q_cid": {
"type": [
"integer",
"null"
]
},
"ani_sticker_type": {
"type": [
"integer",
"null"
]
},
"ani_sticker_pack_id": {
"type": [
"integer",
"null"
]
},
"ani_sticker_id": {
"type": [
"integer",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"emoji_name_alias": {
"type": "array",
"items": {
"type": "string"
}
},
"ani_sticker_width": {
"type": [
"integer",
"null"
]
},
"ani_sticker_height": {
"type": [
"integer",
"null"
]
},
"is_super": {
"type": "boolean",
"description": "是否使用超级表情格式"
}
},
"required": [
"q_sid",
"q_des",
"em_code",
"q_cid",
"ani_sticker_type",
"ani_sticker_pack_id",
"ani_sticker_id",
"url",
"emoji_name_alias",
"ani_sticker_width",
"ani_sticker_height",
"is_super"
]
}
}
},
"required": [
"pack_name",
"emojis"
]
}
}
},
"required": [
"packs"
]
}curl -X POST http://127.0.0.1:3000/fetch_sys_faces \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <access-token>' \
-d '{"refresh":false}'支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。