qq-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PUBLIC_URL | No | 通知里登录链接的域名(Railway 上自动识别)。 | |
| QQ_TOOLSETS | No | 只开放这些类别,如 chat,events,message,qzone,qzone_web。 | |
| QQ_WATCHDOG | No | 设置为 off 可关闭登录守护。 | |
| QQ_READ_ONLY | No | 1 = 只开放只读工具。 | |
| ONEBOT_WS_URL | No | 改连其他 OneBot v11 实现(NapCat、LLBot…)的 WebSocket URL,不用自带的。 | |
| MCP_AUTH_TOKEN | Yes | 必填,访问令牌(至少 24 位随机字符)。 | |
| NOTIFY_WEBHOOK | No | 需要扫码时发通知:Discord webhook、含 {text} 的 URL(Bark、Server酱…),或任意接受 JSON POST 的地址。 | |
| QQ_DISABLED_TOOLS | No | 逗号分隔的要隐藏的工具名。 | |
| ONEBOT_ACCESS_TOKEN | No | 改连其他 OneBot v11 实现时使用的访问令牌。 | |
| QQ_WATCHDOG_INTERVAL | No | 登录检查间隔秒数,默认 30;QQ_WATCHDOG=off 关闭。 | 30 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
QQ as the user's own account (a real QQ client logged in on the server). If a tool says QQ is not connected, call qq_login: it returns the login window with a QR code; show it to the user to scan with the QQ phone app, then qq_login wait=true. Start with whoami, list_recent_chats, get_unread. Find people/groups with find_contact; targets are "qq:<QQ号>" or "group:<群号>" (names work too). Read with read_chat / search_chat, send with send_text / send_image / send_file / reply_to_message. view_image lets you see pictures. QQ空间: get_qzone_feeds (friends' feed), get_qzone_msg_list / get_qzone_msg_detail, send_qzone_msg (说说 with images), like_qzone, comment_qzone, plus qzone_visitors, qzone_board_*, qzone_albums, qzone_like_list. Groups: get_group_member_list, set_group_ban/kick/card/admin, send_group_notice, group files and albums. Live: wait_for_message, get_events. Every OneBot action is a tool; onebot_call reaches anything else.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| qq_watchdogB | State of the login watchdog that keeps QQ logged in automatically (re-clicks 登录 for the remembered account, dismisses 下线 pop-ups, restarts a stuck client, notifies when a QR scan is really needed). check_now=true runs a check immediately. |
| qq_login_statusA | Is QQ logged in and connected? Returns the account if so. |
| qq_loginA | Log in to QQ. If not logged in, returns a screenshot of the QQ login window: show the QR code to the user and ask them to scan it with the QQ phone app (扫一扫) and confirm on the phone. If the window shows a "登录"/"进入QQ" button for a remembered account instead, click it with qq_click. Call qq_login_status afterwards (or wait=true here). |
| qq_screenshotA | Screenshot of the virtual display the QQ client runs on (the QQ window by default, or the full screen). Use it to see dialogs such as login prompts, security checks or update notices. |
| qq_clickA | Click on the QQ client window (coordinates as seen in the last qq_screenshot / qq_login image). Returns a fresh screenshot. |
| qq_typeA | Type text or press keys in the focused QQ window (e.g. a verification code). keys uses xdotool names: "Return", "Tab", "ctrl+a", "BackSpace", "Escape". |
| qq_restart_clientA | Restart the QQ desktop client (use when it is stuck, crashed, or to get a fresh login QR code). Messages cannot be sent for ~20s while it restarts. |
| whoamiA | Who is logged in: QQ number, nickname, online status, and how many friends/groups. Start here. |
| find_contactA | Search friends (by remark, nickname or QQ number) and groups (by name or number). Returns ids to use as targets ("qq:" / "group:"). |
| list_contactsA | Compact list of all friends and/or groups (target id + display name), with paging. Use refresh=true after adding friends/joining groups. |
| read_chatA | Read the latest messages of a private or group chat as readable lines (oldest first). Page back with before_message_id = the oldest message_id you got. Marks the chat as read for get_unread. Note: older server history is reachable once the chat has had at least one message since QQ logged in on the server; everything seen since then is kept. |
| search_chatB | Find messages containing a keyword (case-insensitive) in one chat by scanning its history backwards. |
| send_textB | Send a text message to a friend or group. Inline tokens: [@QQ号] mention, [@all] @全体, [face:ID] QQ emoji, [reply:message_id] quote, [image:URL或路径] picture. Or use reply_to / mention. |
| send_imageA | Send a picture (http(s) URL, local path on the server, file://, or base64) to a friend or group, optionally with a caption. Set as_sticker to send it as a 表情 sticker. |
| send_voiceA | Send a voice message (mp3/wav/silk/amr… from URL, path or base64; converted automatically). |
| send_videoB | Send a video (mp4 from URL, path or base64). |
| send_fileA | Send a file to a friend or upload it to a group (群文件). Source: URL, path on the server, or base64. |
| send_messageA | Send any OneBot message to a friend or group: a CQ-code string or an array of segments, e.g. [{"type":"text","data":{"text":"hi"}},{"type":"image","data":{"file":"https://…"}}]. Segment types: text, at, face, mface, image, record, video, file, reply, forward, json, xml, poke, dice, rps, music, contact, markdown, location, share. |
| reply_to_messageA | Quote-reply to a message by its message_id (works for group and private messages). Optionally @ the original sender. |
| forward_messagesA | Forward existing messages (by message_id) to a friend or group — as one 合并转发 bundle (default) or one by one. |
| send_fake_forwardA | Send a 合并转发 card built from custom nodes (each with a display name, QQ number and content), e.g. to share a summary as a chat transcript. |
| pokeB | 戳一戳 someone: a friend in private chat, or a member inside a group. |
| view_imageA | Look at a picture: pass a message_id (first image in that message), an image URL, a local path, or an image file id. Returns the image so you can see it. |
| download_mediaA | Save the image/voice/video/file of a message (or any URL) on the server and return its local path, which other tools (send_file, send_qzone_msg images…) accept. |
| list_recent_chatsA | Chats with activity since the MCP server started (newest first): last message, unread count (messages you have not read via read_chat/get_unread). |
| get_unreadB | New incoming messages you have not seen yet (since the server started or your last get_unread/read_chat), grouped by chat. Marks them as seen. |
| get_eventsA | Raw live events received from QQ (messages, recalls, pokes, join/leave, friend/group requests, file uploads, etc.), oldest first. Use since = the last seq you saw to get only new ones. |
| wait_for_messageA | Block until a new message arrives (optionally only from a chat / sender / containing text), up to timeout_seconds. Good for "reply when they answer" flows. |
| wait_for_eventA | Block until an event of the given types arrives (e.g. "notice.group_increase", "request.friend", "notice.group_recall"). |
| list_friend_requestsA | Pending friend requests and group join/invite requests seen live, plus the group system message box (入群申请/邀请). Approve with set_friend_add_request / set_group_add_request using the flag. |
| onebot_callA | Call any OneBot v11 / extended action of the QQ runtime directly (escape hatch for anything the other tools miss). See list_actions for names. |
| qzone_visitorsA | QQ空间 访客记录: who visited a 空间 recently (yours by default; others need permission), with time and source. |
| qzone_board_listB | Read a 空间 留言板 (message board) — yours by default — with replies. |
| qzone_board_postC | Write a message on someone's 留言板 (or your own). |
| qzone_board_replyC | Reply to a message on a 留言板 (usually your own). |
| qzone_board_deleteA | Delete a 留言板 message (on your own board, or one you wrote elsewhere). |
| qzone_albumsA | List personal 空间相册 albums (yours by default) with ids, photo counts and privacy. |
| qzone_album_photosA | List photos in a personal 空间相册 album (with full-size URLs). Use view_image url=… to look at one. |
| qzone_create_albumC | Create a personal 空间相册 album. |
| qzone_delete_photosA | Delete photos from one of your 空间相册 albums (photo ids from qzone_album_photos). |
| qzone_delete_albumA | Delete one of your personal 空间相册 albums together with its photos. |
| qzone_like_listB | Who liked a 说说 (names and QQ numbers). |
| qzone_post_countsB | View / like / comment / forward counts of a 说说. |
| qzone_delete_commentA | Delete a comment under a 说说 (any comment on your own 说说, or your own comment elsewhere). |
| qzone_forwardB | 转发 a 说说 to your own 空间, with an optional comment. |
| qzone_friendsB | Friends as QQ空间 sees them, with 空间 grouping and 亲密度 (intimacy score). |
| qzone_intimacyB | 空间 friendship ranking: who you care about most (mine) or who cares about you most (theirs), by 亲密度. |
| qzone_user_cardB | Someone's 空间 name card (nickname, avatar, 空间 name, whether you can visit, etc.). |
| qzone_requestA | Call any QQ空间 web CGI with your logged-in cookies and g_tk added automatically (escape hatch). url: full https URL, or "host/path" sent via the h5.qzone.qq.com proxy, e.g. "taotao.qq.com/cgi-bin/emotion_cgi_msglist_v6". Parses JSON/JSONP/frameElement.callback responses. |
| del_group_noticeA | 删除群公告(fid 或 notice_id 二选一) notice_id 来自 _get_group_notice;删除需要管理权限。 |
| get_friend_dressA | 获取指定 QQ 号正在使用的个性装扮(挂件/名片/来电/输入状态等) 替换为需要查询的 QQ 号。 Returns: 装扮信息;目标未使用任何可查询装扮时 items 为空数组。网络失败、未登录态/风控、页面改版、返回账号与请求不一致时返回失败并附具体原因 |
| get_group_noticeA | 获取群公告 将 group_id 替换为当前账号可访问的群号。 Returns: 普通公告与新成员公告的合并数组;send_to_new_members 标识后者;图片含 id、url、宽高 |
| mark_all_as_readA | 标记全部已读 会将当前账号的会话标记为已读。 |
| send_group_noticeB | 发送群公告(支持置顶、弹窗、新成员、群昵称引导与确认) 需要群公告管理权限;普通公告 type=1,新成员公告 type=20。 Rules: type must be 1 (regular) or 20 (new members); send_to_new_members conflicts with type. |
| add_custom_faceB | 添加收藏表情 示例路径位于 SnowLuma 服务端,须替换为该服务可读取的实际文件。 |
| add_group_tagC | 向某个群分类添加资料标签 替换实际群分类和标签;需要当前账号有管理权限。 |
| can_send_imageC | can_send_image Returns: 能力查询结果。 |
| can_send_recordC | can_send_record Returns: 能力查询结果。 |
| cancel_group_album_media_likeC | cancel_group_album_media_like album_id 来自 get_group_album_list;lloc 或视频 id、batch_id 来自 get_group_album_media_list。替换群号及对应资源标识。 batch_id 必须是实际批次的十进制字符串。 |
| cancel_group_todoA | 取消群待办 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 必须是该群的消息。 |
| clean_cacheA | 清理缓存 兼容占位接口,当前返回成功但不执行清理。流式临时文件清理请使用 clean_stream_temp_file。 |
| clean_stream_temp_fileA | 清理流式传输临时文件(仅清理 stream 上传/下载目录) 清理未使用的流式临时文件;不会清理正在传输的项目。 Returns: { message, removed } |
| click_inline_keyboard_buttonA | 点击内联键盘按钮 参数必须来自同一条机器人按钮消息;msg_seq 是消息序号,不是 message_id。 |
| comment_qzoneA | 评论说说或回复指定评论(普通评论支持带图,楼中楼仅支持文字) tid 来自 get_qzone_msg_list;操作需有该说说的访问或管理权限。 Rules: all or none of: comment_id, comment_uin; all or none of: reply_uin, reply_name; reply_uin/reply_name require comment_id/comment_uin; images are not supported for comment replies; comment_id, reply_name and reply content must not be blank; comment_uin and reply_uin must be safe integers. |
| comment_qzone_public_feedA | 评论推荐动态,支持文本或上游富文本条目 feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 Returns: 上游评论结果,包含新评论,保留未知字段。 |
| complete_group_todoA | 完成群待办 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 必须是该群的消息。 |
| create_flash_taskB | 创建闪传任务 示例路径位于 SnowLuma 服务端,须替换为该服务可读取的实际文件。 files 不能为空。 |
| create_group_file_folderC | 创建群文件夹 将 group_id 替换为当前账号可访问的群号。 Returns: { result: { retCode, retMsg }, groupItem: { folderInfo: { folderId, folderName, folderPath, createTime, modifyTime, createUin, modifyUin } } } |
| del_group_album_mediaA | 删除群相册图片或视频 album_id 来自 get_group_album_list;lloc 或视频 id、batch_id 来自 get_group_album_media_list。替换群号及对应资源标识。 |
| delete_custom_faceA | 删除收藏表情 emoji_id 来自 fetch_custom_face_detail。 |
| delete_essence_msgA | 移除精华消息 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 |
| delete_flash_fileB | 删除闪传文件 fileset_id 来自 create_flash_task、get_fileset_id 或 list_filesets,替换为当前账号可访问的文件集。 |
| delete_friendB | 删除好友 会删除指定好友;仅在明确需要删除时调用。 |
| delete_group_fileB | 删除群文件 替换群文件列表中的实际 file_id;需要对应文件操作权限。 |
| delete_group_file_folderC | 删除群文件夹 会删除指定群文件夹,确认资源后调用。 |
| delete_group_folderC | 删除群文件夹 会删除指定群文件夹,确认资源后调用。 |
| delete_group_tagB | 从某个群分类移除资料标签 替换实际群分类和标签;需要当前账号有管理权限。 |
| delete_msgA | 撤回消息 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 |
| delete_qzone_msgA | 删除一条说说(QQ 空间,按 tid) tid 来自 get_qzone_msg_list;操作需有该说说的访问或管理权限。 |
| delete_qzone_public_commentA | 删除推荐动态的一条评论(需有权限) feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 comment 可取 get_qzone_public_feed_detail 返回的 feed.feed.cell_comment.comments,或后续评论页;保留完整对象。 Returns: 上游删除结果,保留未知字段。 |
| delete_qzone_public_replyA | 删除推荐动态评论下的一条回复(需有权限) feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 comment 可取 get_qzone_public_feed_detail 返回的 feed.feed.cell_comment.comments,或后续评论页;保留完整对象。 reply 使用该评论下的完整回复对象。 Returns: 上游删除结果,保留未知字段。 |
| do_group_album_commentC | do_group_album_comment album_id 来自 get_group_album_list;lloc 或视频 id、batch_id 来自 get_group_album_media_list。替换群号及对应资源标识。 |
| download_fileA | 下载文件(url 或 base64)到 data/downloads 保存到 SnowLuma 服务端临时目录,返回服务端路径;不是 MCP 主机下载路径。 Returns: { file } |
| download_file_image_streamA | 以流式方式下载图片(缓存图片 id / URL / stream 目录本地文件) file_id 来自当前账号图片消息;经 invoke_action 调用。 Returns: 流式帧:file_info → file_chunk* → file_complete |
| download_file_record_streamA | 以流式方式下载语音(缓存语音 id / URL / stream 目录本地文件) file_id 来自当前账号语音消息;经 invoke_action 调用。 Returns: 流式帧:file_info → file_chunk* → file_complete |
| download_file_streamA | 以流式方式下载文件(stream 目录本地文件 / URL / 缓存媒体) 替换实际公开可访问地址;经 invoke_action 调用,文件保存到 MCP 下载目录。 Returns: 流式帧:file_info → file_chunk* → file_complete |
| download_filesetA | 解析闪传文件下载直链(不下载,由调用方实现下载) fileset_id 来自 create_flash_task、get_fileset_id 或 list_filesets,替换为当前账号可访问的文件集。 file_index 从 0 开始。 Returns: { url, file_name, file_size } |
| fetch_custom_faceB | 获取自定义表情 Returns: 字符串数组:return_type=url 时为图片 URL,return_type=id 时为 emoji_id。 |
| fetch_custom_face_detailB | 获取自定义表情详情 Returns: 自定义表情详情数组,包含资源标识、图片地址、摘要与描述。 |
| fetch_emoji_likeA | 获取表情回应用户(NapCat 分页) 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 后续页原样传回上页 cookie。 Returns: 分页的表情回应用户列表(NapCat 形状),含分页游标 cookie 与首/末页标记。 |
| fetch_face_entityA | 按编号查询 QQ 系统表情 Returns: 表情详情;编号不存在时返回 null。 |
| fetch_ptt_textA | 获取语音转文字结果 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 Returns: { text }:语音识别出的文本。 |
| fetch_super_face_idB | 判断 QQ 系统表情是否使用超级表情格式 Returns: 是否使用超级表情格式。 |
| fetch_sys_facesB | 获取 QQ 系统表情目录 Returns: 按分组返回完整的 QQ 系统表情映射。 |
| forward_friend_single_msgB | 转发单条消息给好友 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 |
| forward_group_single_msgA | 转发单条消息到群 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 |
| forward_qzone_public_feedA | 将推荐动态转发到当前账号空间 feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 只转发,不同时评论或发送给 QQ 联系人。 Returns: 上游转发结果,保留未知字段。 |
| friend_pokeC | 好友拍一拍 戳一戳指定好友。 |
| get_ai_charactersA | 获取 AI 语音角色 将 group_id 替换为当前账号可访问的群号。 Returns: 按分类分组的 AI 语音角色列表,每组含分类名与角色(id、名称、试听 URL)。 |
| get_ai_recordA | 生成 AI 语音 character 原样使用 get_ai_characters 的 character_id;send_group_ai_record 会直接发送语音。 |
| get_clientkeyB | 获取 clientkey 返回值可能包含凭据或临时下载密钥,请勿公开或记录到不受控日志。 Returns: { clientKey, expireTime, keyIndex }:clientkey 及其过期时间与索引。 |
| get_collection_listB | 获取收藏列表 Returns: 返回收藏条目、是否还有更多数据及底部时间游标。 |
| get_cookiesA | 获取 Cookies 返回登录凭据,仅在有明确用途时读取,请勿公开。 Returns: { cookies }:指定域名的 Cookie 字符串。 |
| get_credentialsB | 获取凭证 返回登录凭据,仅在有明确用途时读取,请勿公开。 Returns: { cookies, token, csrf_token }:Cookie 字符串与 CSRF 令牌(token 与 csrf_token 同值)。 |
| get_csrf_tokenA | 获取 CSRF 令牌 Returns: { token }:CSRF 令牌(bkn,数值)。 |
| get_doubt_friends_add_requestB | 获取可疑好友申请 Returns: 可疑好友申请数组,每项含 uid(作为处理用 flag)、昵称、来源、留言与申请时间。 |
| get_emoji_likesA | 获取表情回应用户 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 Returns: { emoji_like_list }:回应该表情的用户列表(nick_name 恒为空串)。 |
| get_essence_msg_listB | 获取精华消息列表 将 group_id 替换为当前账号可访问的群号。 |
| get_fileA | 获取文件信息(仅图片/语音缓存;群文件请用 get_group_file_url) 仅查询已缓存的图片或语音,先尝试图片,再尝试语音。 |
| get_fileset_idB | 从 QQ 闪传分享码或官方分享链接获取 fileset_id share_code 使用实际闪传分享链接或提取码。 Returns: { fileset_id }:解析出的文件集 ID。 |
| get_fileset_infoA | 获取文件集信息 fileset_id 来自 create_flash_task、get_fileset_id 或 list_filesets,替换为当前账号可访问的文件集。 |
| get_flash_file_listB | 获取闪传文件列表 fileset_id 来自 create_flash_task、get_fileset_id 或 list_filesets,替换为当前账号可访问的文件集。 |
| get_flash_file_urlA | 获取闪传文件链接 fileset_id 来自 create_flash_task、get_fileset_id 或 list_filesets,替换为当前账号可访问的文件集。 file_index 从 0 开始。 |
| get_forward_msgA | 获取合并转发消息(id 或 message_id) id 是合并转发资源标识,通常来自转发消息段或上传结果 res_id,不是普通数值 message_id。 Returns: { messages }:转发内的消息节点数组(每项为 OneBot 消息事件);reply 保留 id,有内嵌引用内容时附带 message 和可用的 qq/time/seq,可作为转发节点 content 再次发送。 |
| get_friend_listA | 获取好友列表 Returns: 好友列表,包含账号、昵称、备注及回包已有的公开资料;with_profile=true 时主动补查,失败会报错。未返回的资料省略,零、空字符串和 false 保留。 |
| get_friend_msg_historyA | 获取好友消息历史(无锚点时从服务器获取最新双向记录) 省略 message_id 从最新消息开始;只读取当前账号消息。 Returns: { messages }:好友消息事件对象数组(每项为 OneBot 消息事件,内部字段不固定)。 |
| get_friends_with_categoryA | 获取分组好友列表 Returns: 好友分组数组;buddyList 与 get_friend_list 使用相同资料字段。默认只使用列表回包,with_profile=true 主动补查,失败会报错;未返回的资料省略。 |
| get_group_admin_permissionsA | 读取指定管理员的撤回、移除成员、每日移除上限及接收验证消息状态 user_id 为目标管理员 QQ 号;包含接收加群验证消息状态。 Returns: 服务器返回的管理员权限;未返回或未指定的开关为 null。每日上限仅在移除权限开启时返回,0 表示不限。 |
| get_group_admin_settingsA | 获取群管理设置的当前值 将 group_id 替换为当前账号可访问的群号。 Returns: 与对应设置接口字段对齐的当前群管理设置。 |
| get_group_album_listC | get_group_album_list 将 group_id 替换为当前账号可访问的群号。 Returns: 群相册列表数组,每项为一个相册的基本信息。 |
| get_group_album_media_listA | get_group_album_media_list album_id 来自 get_group_album_list;lloc 或视频 id、batch_id 来自 get_group_album_media_list。替换群号及对应资源标识。 下一页传回 nextAttachInfo。 Returns: 相册图片/视频列表及下一页分页游标;视频项包含 id、url、cover、尺寸、时长和多规格地址。 |
| get_group_at_all_remainA | 获取群 @全体成员 剩余次数 将 group_id 替换为当前账号可访问的群号。 Returns: { can_at_all, remain_at_all_count_for_group, remain_at_all_count_for_uin }:@全体可用性与剩余次数。 |
| get_group_detail_infoC | 获取群详细信息 将 group_id 替换为当前账号可访问的群号。 |
| get_group_file_system_infoA | 获取群文件系统信息 将 group_id 替换为当前账号可访问的群号。 Returns: { file_count, limit_count, used_space, total_space }:群文件数量与容量信息(均为服务端实际值)。 |
| get_group_file_urlC | 获取群文件下载链接 将 group_id 替换为当前账号可访问的群号。 Returns: 群文件下载链接。 |
| get_group_files_by_folderB | 获取群子目录文件列表 将 group_id 替换为当前账号可访问的群号。 Returns: 群文件系统信息(文件与文件夹列表)。 |
| get_group_honor_infoB | 获取群荣誉信息 未请求的分类仍返回空数组;当前龙王可能为 null。 |
| get_group_ignore_add_requestB | 获取被忽略的入群请求(NapCat) Returns: 被忽略的入群请求数组(NapCat 字段命名),每项含请求序列、邀请人、群信息与处理标记。 |
| get_group_ignored_notifiesB | 获取被过滤的入群请求 Returns: 被过滤的入群请求数组,每项含群号、申请人、邀请人、留言与处理标记。 |
| get_group_infoC | 获取群信息 将 group_id 替换为当前账号可访问的群号。 Returns: 群信息对象。 |
| get_group_info_exC | 获取群信息(扩展) 将 group_id 替换为当前账号可访问的群号。 |
| get_group_listC | 获取群列表 Returns: 群信息对象数组。 |
| get_group_member_infoC | 获取群成员信息 将 group_id 替换为当前账号可访问的群号。 Returns: 群成员信息对象。 |
| get_group_member_listB | 获取群成员列表 将 group_id 替换为当前账号可访问的群号。 Returns: 群成员信息对象数组。 |
| get_group_msg_historyA | 获取群消息历史 省略 message_id 从最新消息开始;翻页使用上一页实际 message_id,不要自行加减。 Returns: { messages }:群消息事件对象数组(每项为 OneBot 消息事件,内部字段不固定)。 |
| get_group_root_filesB | 获取群根目录文件列表 将 group_id 替换为当前账号可访问的群号。 Returns: 群文件系统信息(文件与文件夹列表)。 |
| get_group_share_linkA | 获取群分享链接 将 group_id 替换为当前账号可访问的群号。 Returns: 用于分享或邀请加群的链接,可作为群二维码内容。 |
| get_group_shut_listA | 获取群禁言列表 将 group_id 替换为当前账号可访问的群号。 Returns: 仍在禁言中的成员数组,每项含 QQ 号、昵称与禁言到期时间戳(秒)。 |
| get_group_signed_listA | 获取群今日打卡列表 将 group_id 替换为当前账号可访问的群号。 |
| get_group_system_msgA | 获取群系统消息 将 group_id 替换为当前账号可访问的群号。 Returns: 群系统消息数组,分别提供入群者、邀请人和处理者,可按群号或未处理状态过滤。身份为 0 时须查看状态;未知不代表不存在邀请人。 |
| get_group_tagsC | 读取某个群分类下的资料标签 group_class 使用实际群分类编号。 Returns: 该分类下的资料标签列表。 |
| get_group_todo_listA | 获取群待办列表 将 group_id 替换为当前账号可访问的群号。 Returns: 群待办数组,包含可用于待办操作的消息标识、服务端摘要与时间 |
| get_imageA | 获取图片信息 file 或 file_id 原样取自图片消息段,须在当前账号媒体缓存中存在。 |
| get_login_infoB | get_login_info Returns: 当前登录账号的 QQ 号与昵称。 |
| get_mini_app_arkB | 获取小程序卡片 ark 替换为实际分享地址;当前仅支持 bili 和 weibo。返回的 data 是卡片对象,不会自动发送。 |
| get_msgA | 获取消息 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 Returns: 消息事件对象(去除 post_type/self_id,附带 real_id);逐个尝试刷新图片、语音和视频 URL,成功使用新地址,失败保留该段原地址并继续返回消息;地址更新时同步 raw_message。 |
| get_msg_emoji_likesA | 获取一条消息的全部表情回应 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 Returns: 该消息上每个表情回应的编号、数量与用户列表。 |
| get_online_clientsA | 获取在线客户端 Returns: { clients }:QQ 本次会话最近推送的在线设备快照。 |
| get_private_file_urlA | 获取私聊文件下载链接 使用私聊文件消息段中的 file_id,必要时原样传 file_hash。 Returns: 私聊文件下载链接。 |
| get_profile_likeC | 获取资料点赞 Returns: 点赞资料:uid、最近点赞时间、收藏与点赞统计及用户明细。 |
| get_qun_album_listA | get_qun_album_list 后续页原样传回上一页的 attach_info;has_more=false 表示结束。 Returns: NapCat 风格的相册列表封套:{album_list, attach_info, has_more}。 |
| get_qzone_feed_detailA | 按说说 tid 读取完整空间动态,可用于生成分享卡片 将示例 tid 替换为 get_qzone_msg_list 或 send_qzone_msg 返回的 24 位十六进制说说编号。把结果的 feed 原样传给 get_qzone_share_ark;读取和分享均受空间权限限制。 Rules: tid must be a 24-character hexadecimal post ID. Returns: 完整动态及上游详情字段。feed 保留图片、视频、分享信息和未知字段,可直接用于 get_qzone_share_ark;attach_info 保留上游评论游标,不自动翻页。 |
| get_qzone_feedsA | 获取 QQ 空间好友动态,支持结构化正文与游标分页 保留 html;content/images 为可提取的正文和图片,未知值为 null。续页使用 next_cursor。 Returns: 好友动态、可提取的正文与图片、统计值及下一页游标;未知内容或统计为 null,HTML 保留。 |
| get_qzone_home_feedsB | 读取自己或有权访问的空间主页动态,保留完整分享信息 Returns: 完整动态及分页状态;访问受空间权限限制,旧说说接口保持不变。 |
| get_qzone_msg_detailA | 获取 QQ 空间说说详情与一页评论(含服务端内联回复,需有访问权限) tid 来自 get_qzone_msg_list;操作需有该说说的访问或管理权限。 replies 仅为服务端内联回复,不保证完整。 Returns: 说说详情、服务端报告的评论总数与本页评论;replies 仅含服务端内联返回的二级回复,不保证完整。 |
| get_qzone_msg_listA | 获取 QQ 空间说说列表(默认机器人自己的空间) 默认读取当前账号;指定 target_uin 时需有访问权限。 Returns: 说说列表对象,含说说总数与本页说说数组。 |
| get_qzone_profileA | 获取 QQ 空间名称和说明(默认当前账号) 需要有该空间的访问权限。 Returns: 空间名称和说明。 |
| get_qzone_public_capabilitiesB | 读取当前账号的空友爱看入口与推权限 Returns: 当前账号的上游入口能力对象,保留未知字段。 |
| get_qzone_public_commentsA | 继续读取推荐动态评论 feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 先读详情获取初始评论及 attach_info,再原样传入 cursor。 Returns: 上游评论页对象,保留评论、分页和未知字段。 |
| get_qzone_public_feed_detailA | 读取推荐动态详情及初始评论 feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 Returns: 上游详情 data;初始评论位于 feed.feed.cell_comment.comments,续页使用 attach_info。 |
| get_qzone_public_feedsA | 读取空友爱看推荐动态,支持独立游标分页 cursor 原样使用上次返回的 next_cursor,仅适用于同一账号;has_more=false 时停止。 Returns: 推荐动态原始 cell 对象及分页状态,保留其余上游页面字段。 |
| get_qzone_public_repliesA | 继续读取指定评论的回复 feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 comment 可取 get_qzone_public_feed_detail 返回的 feed.feed.cell_comment.comments,或后续评论页;保留完整对象。 首次续读使用评论自带的 reply_attach_info;之后传上一回复页的游标。 Returns: 上游回复页对象,保留回复、分页和未知字段。 |
| get_qzone_share_arkA | 生成空间动态分享卡片,返回原文及分享提示 feed 原样取自 get_qzone_feed_detail 的 feed,或 get_qzone_home_feeds / get_qzone_public_feeds 的 feeds 条目。分享链接可能允许未登录者访问并包含作者 QQ 号;如 requires_confirmation=true,发送前展示 notice 并取得确认。将 ark 原文作为 JSON 消息发送,不要修改卡片内容。 Returns: 生成卡片但不发送消息;后续发送仍返回普通消息编号。 |
| get_recordB | 获取语音信息;传 out_format 则服务端转码并附带 base64 file 来自语音消息段;格式转换依赖服务端可用的转换工具,成功时增加 out_format 和 base64。 Returns: 语音信息(file/url 为向 QQ 获取的当前下载地址);资源元数据缺失或远端获取失败时返回错误。out_format 指定时附带转码后的 base64。 |
| get_rkeyB | 获取下载 rkey 返回值可能包含凭据或临时下载密钥,请勿公开或记录到不受控日志。 |
| get_rkey_serverA | 获取 rkey 服务器信息 返回值可能包含凭据或临时下载密钥,请勿公开或记录到不受控日志。 Returns: { expired_time, name, private_rkey?, group_rkey? }:rkey 过期时间与(存在时的)私聊/群聊 rkey。 |
| get_share_linkA | 获取文件分享链接 fileset_id 来自 create_flash_task、get_fileset_id 或 list_filesets,替换为当前账号可访问的文件集。 |
| get_statusB | get_status Returns: 运行状态。 |
| get_stranger_infoA | 获取陌生人信息 替换为需要查询的 QQ 号。 Returns: 用户资料,含账号标识、等级别名和可用的注册时间、生日、会员信息。注册时间、生日或会员信息未返回时省略对应字段,出生年份未公开时只省略年份;登录天数暂无可靠来源,不返回占位值。 |
| get_unidirectional_friend_listC | 获取单向好友列表 |
| get_version_infoB | get_version_info Returns: 实现与协议版本信息。 |
| group_pokeC | 群拍一拍 将 group_id 替换为当前账号可访问的群号。 |
| like_qzoneA | 给一条说说点赞(QQ 空间) tid 来自 get_qzone_msg_list;操作需有该说说的访问或管理权限。 |
| list_filesetsB | 列出当前账号的所有闪传文件集 |
| mark_group_msg_as_readB | 标记群消息已读 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 |
| mark_msg_as_readB | 标记消息已读(群聊/私聊自动路由) 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 |
| mark_private_msg_as_readB | 标记私聊消息已读 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 |
| modify_custom_faceB | 修改收藏表情备注 emoji_id 来自 fetch_custom_face_detail。 |
| move_custom_face_to_frontB | 收藏表情移到最前 emoji_id 来自 fetch_custom_face_detail。 |
| move_group_fileC | 移动群文件 目录和文件标识均来自该群文件列表。 |
| nc_get_user_statusB | 获取用户在线/扩展状态 替换为需要查询的 QQ 号。 Returns: { status, ext_status }:用户在线状态码与扩展状态码。 |
| ocr_imageA | OCR 图片(服务端,需图片 URL 或已缓存的图片 file_id) 替换为实际可访问的图片地址或已缓存图片标识;不支持本地路径和 base64。 Returns: { texts, language }:识别文本数组(含置信度与坐标)与识别语言。 |
| rename_flash_fileB | 重命名闪传文件 fileset_id 来自 create_flash_task、get_fileset_id 或 list_filesets,替换为当前账号可访问的文件集。 |
| rename_group_fileB | 重命名群文件 file_id 来自群文件列表,目录必须是文件当前所在目录。 |
| rename_group_file_folderC | 重命名群文件夹 将 group_id 替换为当前账号可访问的群号。 |
| reply_qzone_public_feedA | 回复推荐动态的评论或其中某条回复 feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 comment 可取 get_qzone_public_feed_detail 返回的 feed.feed.cell_comment.comments,或后续评论页;保留完整对象。 Returns: 上游回复结果,包含新回复,保留未知字段。 |
| request_decrypt_keyA | 请求数据库解密密钥 路径位于 SnowLuma 服务端,必须指向当前账号可用的数据库;返回值是敏感密钥。 |
| search_sys_facesB | 搜索 QQ 系统表情 Returns: 匹配编号、名称、别名或分组名的表情列表。 |
| send_ark_shareB | 分享用户/群 Ark 卡片(NapCat 标准名) 生成联系人分享卡片;返回卡片数据,不等同于发送到聊天。 Returns: { arkMsg }:服务端生成的推荐联系人 Ark 卡片 JSON 字符串。 |
| send_custom_faceA | 发送账号收藏表情(emoji_id 或 MD5),保留表情显示样式 群聊和私聊目标只能提供一个;emoji_id 来自 fetch_custom_face_detail。 Returns: { message_id: number } |
| send_flash_msgA | 发送闪传消息(私聊或群聊,引用 fileset_id 让对端下载) fileset_id 来自 create_flash_task、get_fileset_id 或 list_filesets,替换为当前账号可访问的文件集。 会发送分享消息;message_id=0 是占位值,不能用于撤回或查消息。 Returns: { message_id } |
| send_forward_msgB | 发送合并转发(按 message_type/群号自动路由) 替换目标群号;nodes 是自定义转发节点数组。send_forward_msg 不提供目标时仅上传资源并返回 message_id=0。 Returns: { message_id, res_id, forward_id } |
| send_group_ai_recordA | 发送 AI 语音到群 character 原样使用 get_ai_characters 的 character_id;send_group_ai_record 会直接发送语音。 Returns: { message_id }:已发送 AI 语音的 OneBot 消息 ID。 |
| send_group_ark_shareA | 分享群 Ark 卡片(NapCat 标准名) 生成群分享卡片;返回卡片数据,不等同于发送到聊天。 Returns: 服务端生成的群推荐 Ark 卡片 JSON 字符串。 |
| send_group_forward_msgB | 发送群合并转发 替换目标群号;nodes 是自定义转发节点数组。send_forward_msg 不提供目标时仅上传资源并返回 message_id=0。 Returns: { message_id, res_id, forward_id } |
| send_group_msgB | 发送群消息 替换目标群号;成功返回的 message_id 可为负值。 Returns: { message_id: number } |
| send_likeD | 点赞 |
| send_msgA | 发送消息(按 message_type/群号 自动路由群聊或私聊) 必须提供对应目标;私聊使用 message_type=private 和 user_id。 Returns: { message_id: number } |
| send_packetB | 发送原始 SSO 包(cmd + hex data) 仅供有协议经验的调用方:cmd 和 data 必须成对替换为已验证的命令与十六进制请求;示例占位符不可直接发送。 |
| send_pokeB | 拍一拍(群聊/私聊自动路由) 将 group_id 替换为当前账号可访问的群号。 |
| send_private_forward_msgB | 发送私聊合并转发 替换目标好友 QQ 号。 Returns: { message_id, res_id, forward_id } |
| send_private_msgB | 发送私聊消息 替换目标好友 QQ 号;临时会话需另传来源 group_id。 Returns: { message_id: number } |
| send_qzone_msgA | 发表说说(QQ 空间,支持纯文字或带图;传 images 自动上传;可设置查看权限) 会发布说说;ugc_right=64 仅自己可见。16/128 还必须提供 target_uins。 Rules: ugc_right must be one of 1, 4, 16, 64, 128; target_uins is required when ugc_right is 16 or 128. |
| send_tuwen_arkC | 发送图文 Ark 卡片(私聊/群聊) 替换目标群号及实际链接;会发送分享卡片。 Returns: null |
| set_diy_online_statusC | 设置自定义在线状态 |
| set_doubt_friends_add_requestC | 处理可疑好友申请 flag 使用 get_doubt_friends_add_request 返回项的 uid。 |
| set_essence_msgA | 设置精华消息 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 |
| set_friend_add_requestB | 处理好友添加请求 flag 必须原样使用当前账号好友请求事件的 flag,不能根据 QQ 号构造。 |
| set_friend_remarkC | 设置好友备注 |
| set_friends_categoryA | 移动好友到指定分组 categoryId 与 categoryName 二选一。 Rules: exactly one of: categoryId | categoryName. Returns: 成功时返回空数据。 |
| set_group_add_optionB | 设置加群选项 修改加群设置前先用 get_group_admin_settings 查看当前状态,并确认目标设置值。 |
| set_group_add_requestC | 处理加群请求 flag 和 sub_type 原样取自同一条群请求事件;邀请事件使用 invite。 |
| set_group_adminA | 设置/取消管理员 需要群主权限;会授予该成员管理员身份。 |
| set_group_admin_permissionsA | 设置指定管理员的撤回和移除成员权限 需要当前账号具有修改权限;不会授予管理员角色。仅修改显式字段。开启移除必须提供上限,0 表示不限;修改上限需同时传 kick_member=true。 Rules: at least one of: recall_member_message, kick_member; kick_member=true requires kick_member_per_day: 0, 5, 10, 20, 50, 100 or 200; kick_member_per_day requires kick_member=true. |
| set_group_admin_receive_verifyA | 设置指定管理员是否接收加群验证消息 user_id 为目标管理员 QQ 号;需要当前账号具有修改权限。独立于撤回和移除成员权限。 |
| set_group_album_media_likeB | set_group_album_media_like album_id 来自 get_group_album_list;lloc 或视频 id、batch_id 来自 get_group_album_media_list。替换群号及对应资源标识。 batch_id 必须是实际批次的十进制字符串。 |
| set_group_banA | 禁言群成员(duration=0 解除) 替换群号和成员 QQ 号;操作是否允许取决于当前账号在该群的权限。 duration 为秒,0 表示解除禁言。 |
| set_group_cardB | 设置群名片(空字符串清除) 替换群号和成员 QQ 号;操作是否允许取决于当前账号在该群的权限。 |
| set_group_kickB | 踢出群成员 替换群号和成员 QQ 号;操作是否允许取决于当前账号在该群的权限。 |
| set_group_kick_membersB | 批量踢出群成员 替换群号和成员 QQ 号;操作是否允许取决于当前账号在该群的权限。 |
| set_group_leaveA | 退群 会退出该群,请确认目标群号后调用。 |
| set_group_member_invite_policyC | 设置群成员邀请策略 替换群号和成员 QQ 号;操作是否允许取决于当前账号在该群的权限。 |
| set_group_member_permissionsA | 设置群成员权限(仅群主可改) 至少传一个权限字段;仅修改传入的权限,其余保持原样。 Rules: at least one of: allow_member_upload_album, allow_member_temporary_session, allow_member_create_group. |
| set_group_nameA | 设置群名 替换群号和成员 QQ 号;操作是否允许取决于当前账号在该群的权限。 |
| set_group_new_member_history_visibilityB | 设置新成员是否可查看历史消息 替换群号和成员 QQ 号;操作是否允许取决于当前账号在该群的权限。 |
| set_group_portraitB | 设置群头像 示例路径位于 SnowLuma 服务端,须替换为该服务可读取的实际文件。 |
| set_group_reactionB | 群聊表情回应 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 |
| set_group_remarkC | 设置群备注 将 group_id 替换为当前账号可访问的群号。 |
| set_group_robot_add_optionC | 设置群机器人加群选项 替换群号和成员 QQ 号;操作是否允许取决于当前账号在该群的权限。 |
| set_group_searchC | 设置群被搜索方式(群指纹 / 群号搜索开关) 替换群号;数值含义以当前群设置为准。 |
| set_group_signC | 群签到 将 group_id 替换为当前账号可访问的群号。 |
| set_group_special_titleB | 设置群头衔 替换群号和成员 QQ 号;操作是否允许取决于当前账号在该群的权限。 |
| set_group_todoA | 设置群待办 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 必须是该群的消息。 |
| set_group_whole_banC | 全员禁言开关 替换群号和成员 QQ 号;操作是否允许取决于当前账号在该群的权限。 |
| set_input_statusD | 设置输入状态 |
| set_msg_emoji_likeA | 设置消息表情回应 使用消息事件或发送结果中的真实 message_id,负值合法;消息须在当前账号的消息存储中可查询。 |
| set_online_statusC | 设置在线状态 修改当前账号状态;具体状态码须与目标状态对应。 |
| set_qq_avatarB | 设置 QQ 头像 示例路径位于 SnowLuma 服务端,须替换为该服务可读取的实际文件。 |
| set_qq_profileB | 设置 QQ 资料 会修改当前账号的资料;只传入需要修改的字段。 |
| set_qzone_banA | 拉黑或解除拉黑某人(修改机器人自身 QQ 空间黑名单;enable=true 拉黑,false 解除) 修改当前账号空间黑名单。 |
| set_qzone_msg_rightA | 修改一条已发说说的查看权限(QQ 空间,按 tid) tid 来自 get_qzone_msg_list;操作需有该说说的访问或管理权限。 16 表示仅所选好友可见。 Rules: ugc_right must be one of 1, 4, 16, 64, 128; target_uins is required when ugc_right is 16 or 128. Returns: 更新后的权限对象。 |
| set_qzone_profileA | 修改当前账号的 QQ 空间名称或说明 仅修改提供的字段;空字符串表示清空对应字段。 Rules: at least one of: name, description. |
| set_qzone_public_comment_likeA | 点赞或取消赞推荐动态中的评论或回复 feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 comment 可取 get_qzone_public_feed_detail 返回的 feed.feed.cell_comment.comments,或后续评论页;保留完整对象。 必须保留评论原始 like.id。 Returns: 上游普通赞操作结果,保留未知字段。 |
| set_qzone_public_followA | 蹲或取消蹲推荐动态作者 feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 feed 需保留作者 cell_user_info。 Returns: 上游关系操作结果,保留未知字段。 |
| set_qzone_public_likeA | 点赞或取消赞推荐动态 feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 Returns: 上游普通赞操作结果,保留未知字段。 |
| set_qzone_public_upvoteA | 推或取消推空友爱看动态(独立于普通赞) feed 必须原样取自 get_qzone_public_feeds 的 feeds 数组,不能用旧说说 tid 拼造;示例中的占位字段须整体替换。 Returns: 上游推操作结果,保留未知字段。 |
| set_self_longnickC | 设置个性签名(longNick/long_nick,严格 string) |
| share_group_exA | 分享群 Ark 卡片 生成群分享卡片;返回卡片数据,不等同于发送到聊天。 Returns: 服务端生成的群推荐 Ark 卡片 JSON 字符串。 |
| share_peerA | 分享用户/群 Ark 卡片 生成联系人分享卡片;返回卡片数据,不等同于发送到聊天。 Returns: { arkMsg }:服务端生成的推荐联系人 Ark 卡片 JSON 字符串。 |
| test_download_streamA | 测试下载流(推送 10 个数据帧,验证流式传输,不触达 QQ) 经 invoke_action 调用,仅测试传输,不访问 QQ。 Returns: 流式帧:data_chunk*10 → data_complete(error=true 时以 error 帧结束) |
| trans_group_fileC | 转存群文件 替换群文件列表中的实际 file_id;需要对应文件操作权限。 Returns: { ok: true } |
| translate_en2zhB | 英译中 Returns: { words }:与输入等长的中文译文字符串数组。 |
| unlike_qzoneA | 取消对一条说说的点赞(QQ 空间;取消赞端点待真机核实) tid 来自 get_qzone_msg_list;操作需有该说说的访问或管理权限。 |
| upload_file_streamA | 以流式分块方式上传文件到机器人本地(返回可用于发送的本地路径) 第 1 步:每次上传生成新的 stream_id;这里上传 hello 的唯一分块。通过 invoke_action 调用,分块确认不等于整文件完成。 Returns: 流式帧:分块确认 type=stream、完成 type=response(含 file_path/file_name/file_size/sha256) |
| upload_forward_msgA | 上传转发消息 仅上传合并转发资源,不发送聊天消息;message_id=0 是占位值,后续使用 res_id。 |
| upload_group_fileC | 上传群文件 示例路径位于 SnowLuma 服务端,须替换为该服务可读取的实际文件。 Returns: { file_id: string } |
| upload_image_to_qun_albumB | upload_image_to_qun_album album_id 来自 get_group_album_list;lloc 或视频 id、batch_id 来自 get_group_album_media_list。替换群号及对应资源标识。 示例路径位于 SnowLuma 服务端,须替换为该服务可读取的实际文件。 |
| upload_private_fileB | 上传私聊文件 示例路径位于 SnowLuma 服务端,须替换为该服务可读取的实际文件。 默认上传并发送给该好友。 Returns: { file_id: string } |
| upload_video_to_qun_albumA | 上传视频到群相册 album_id 来自 get_group_album_list;lloc 或视频 id、batch_id 来自 get_group_album_media_list。替换群号及对应资源标识。 示例路径位于 SnowLuma 服务端,须替换为该服务可读取的实际文件。 Returns: { id: string } |
| list_tools_by_categoryA | Overview of every tool grouped by category (message, friend, group_info, group_admin, group_file, group_album, qzone, qzone_web, chat, events, extended…), to find the right one. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 260 tools
The surface contains numerous near-duplicate or heavily overlapping tools: send_text/send_message/send_msg/send_private_msg/send_group_msg, forward_messages/forward_friend_single_msg/forward_group_single_msg/send_forward_msg/send_group_forward_msg/send_private_forward_msg/upload_forward_msg, share_peer/send_ark_share/share_group_ex/send_group_ark_share, fetch_emoji_like/get_emoji_likes/get_msg_emoji_likes, and delete_group_file_folder/delete_group_folder appear to do the same thing. An agent would frequently have to guess between aliases and layered wrappers (NapCat-style vs SnowLuma-style vs OneBot-style) with no clear selection rule. Some families (group info, group admin, Qzone) are distinguishable, but the messaging and forwarding clusters are badly blurred.
Names mostly use verb_noun snake_case, but the set mixes prefixes and conventions: qq_login/qq_screenshot/qq_watchdog alongside bare send_text, get_msg, poke, mark_all_as_read, plus odd forms like nc_get_user_status, do_group_album_comment, clean_cache, and duplicate aliases such as get_group_album_list vs get_qun_album_list. There is no single predictable pattern an agent can rely on, and same-purpose tools land in different naming families.
260 tools is far beyond any reasonable agent-facing surface for a QQ client; almost every OneBot action plus Qzone CGI plus raw SSO/credential helpers is exposed individually. Many tools are redundant shims (aliases, escape hatches, capability probes, stream-test helpers) that inflate the list without adding capability. The server would have been far more coherent with a scoped core of 15-25 tools plus one escape hatch.
Coverage is effectively exhaustive: messaging, media, group info/admin/files/albums, friend handling, events, and extensive Qzone read/write operations are all present, with escape hatches (onebot_call, qzone_request, send_packet) filling any remaining gap. The only completeness concerns are minor (some operations only reachable via escape hatches), so the surface itself has no obvious dead ends.