通过 POST http://127.0.0.1:3000/search_sys_faces(请求体为 JSON 参数)或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
query |
string | ✓ | 编号、名称、别名或分组名 |
匹配编号、名称、别名或分组名的表情列表。
所有响应都包裹在标准信封中:{ "status": "ok", "retcode": 0, "data": ... }。下表描述 data 字段。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
faces |
object[] | ✓ |
支持 MCP 的客户端可直接发现并调用本动作,无需手写 HTTP。见 MCP 接入。