用途:本 Skill 仅用于 QQ 频道(类似 Discord 的社区产品,非 QQ 群)管理。频道层级为频道(Guild)→ 子频道(Channel),ID 均为纯数字,API 路径以 /guilds/ 或 /channels/ 开头。触发关键词包括频道、子频道、guild、channel、帖子、日程、公告、论坛、频道成员。
主要能力:借助 qqbot_platform_api 工具代理 QQ 开放平台 HTTP 接口,自动填充鉴权 Token(基础 URL 为 https://api.sgroup.qq.com)。可获取频道列表(GET /users/@me/guilds,limit 最大 100)、频道 API 权限;管理子频道(列表、详情、创建、修改、删除);管理成员(列表、详情、身份组成员、在线成员数);创建/删除公告;论坛帖子列表、详情、发帖、删帖与评论;日程的创建、修改、删除。
使用方式:工具参数为 method、path、body、query。method 与 path 必填,路径中的占位符需替换为实际纯数字 ID,query 参数值须为字符串类型。典型流程为先 GET /users/@me/guilds 获取 guild_id,再 GET /guilds/{guild_id}/channels 获取 channel_id,之后调用具体接口。成员列表分页时首次 after 填 0,用上次最后一个 user.id 作为 after 翻页,并按 user.id 去重。成员头像与频道 icon 等图片 URL 须用 Markdown 图片语法 内联展示。
适用场景:QQ 频道与子频道信息查询、成员管理与查询、论坛发帖与评论、公告发布、日程安排等。
限制:仅处理 QQ 频道操作,不适用 QQ 群;论坛操作仅私域机器人可用;删除操作不可逆;子频道分组(type=4)的 position 必须 >= 2;日程时间戳为毫秒级字符串,且有频率限制(单管理员每天 10 次,单频道每天 100 次);推荐子频道最多 3 条,两类公告会互相顶替。错误码包括 401(Token 鉴权失败)、11241(无权限)、11242(仅私域可用)、11243(需管理权限)、11281(日程频率限制)、304023(推荐子频道超限)。各接口完整参数、返回值与枚举值见 references/api_references.md。具体收费、价格与更多细节暂未提供。