通过 POST http://127.0.0.1:3000/set_friends_category（请求体为 JSON 参数）或 WebSocket 调用。
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
uin |
uint | ✓ | 要移动的好友 QQ 号 | |
categoryId |
int | – | 目标分组 ID | |
categoryName |
string | – | 目标分组名称（必须唯一且完全匹配） |
成功时返回空数据。
该动作返回标准 OneBot 信封；data 结构待补充。
支持 MCP 的客户端可直接发现并调用本动作，无需手写 HTTP。见 MCP 接入。