search_sys_faces

search_sys_faces只读系统表情
搜索 QQ 系统表情

通过 POST http://127.0.0.1:3000/search_sys_faces(请求体为 JSON 参数)或 WebSocket 调用。

输入参数

参数 类型 必填 默认 说明
query string 编号、名称、别名或分组名

返回 (data)

匹配编号、名称、别名或分组名的表情列表。

所有响应都包裹在标准信封中:{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。

字段 类型 必填 说明
faces object[]
原始 JSON Schema
{
  "type": "object",
  "properties": {
    "faces": {
      "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": [
    "faces"
  ]
}

调用示例

curl
Python
JavaScript
Go
SnowLuma SDK
curl -X POST http://127.0.0.1:3000/search_sys_faces \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <access-token>' \
  -d '{"query":""}'
在用 AI 助手?

支持 MCP 的客户端可直接发现并调用本动作,无需手写 HTTP。见 MCP 接入