SDK 覆盖范围
此页列出 SDK 提供的功能及适用范围。核对日期为 2026-11-04。
按官方模块查找
按官方分类查看实现情况和使用方法。
| 官方分类 | 实现情况 | 使用文档 |
|---|---|---|
| 访问凭证与调用 | 客户端缓存令牌，并发调用共用刷新。支持自定义 HTTP 客户端。 | 凭证、API 调用 |
| 事件订阅与通知 | WebSocket、Webhook，统一路由和生命周期 | 事件接入 |
| 单聊、群聊消息 | 接收、回复、显式主动发送、撤回、引用、媒体等 | 消息收发 |
| 单聊流式消息 | 显式逐次发送，业务负责顺序及恢复 | 流式消息 |
| 消息类型和交互 | 消息构造、按钮、文本标签、回调和 ACK | 类型、交互 |
| 富媒体与图片素材 | 支持 URL 和本地分片上传。Markdown 素材有独立流程。 | 富媒体、素材 |
| 机器人资料、分享、菜单/面板管理 | 机器人详情、分享链接、全局菜单查询与更新、指令面板管理 | 机器人 |
| 群聊管理 | 资料、成员、禁言、黑名单、申请和审批策略 | 群聊管理 |
| 频道消息和表态 | 接收、发送、撤回、私信会话、表态及审核 | 频道消息 |
| 频道管理和内容管理 | 频道、子频道、成员、身份组、权限、公告、日程、论坛和音频 | 频道管理 |
使用前应了解的边界
平台文档变化后，按具体字段表和当前源码重新核对。
注意事项
此页记录 SDK 源码的接口覆盖。具体版本提供的方法以该版本的 Go API 为准。
GROUP_MEMBER_EVENT订阅群成员和入群申请事件。注册OnEvent后，仍需在接入配置中订阅相应事件。部分生命周期事件不支持
Context.Reply自动路由。此时按官方允许的来源填写ReplyTarget。频道发送兼容入口将 RFC3339 时间转换为 Unix 秒。表态列表可直接使用平台返回的分页 cookie。
引用索引可能不稳定。多层引用可能变成
TMP_或文本摘要。SDK 保留收到的数据。平台未下发的消息链无法保证恢复。平台未必下发内置表情的图片 URL 或小程序的访问 URL。无论读取原始 JSON 还是 SDK 解析后的结构，都无法获得 QQ 未提供的数据。
Markdown 图片素材提供尺寸辅助。手机端显示仍需实机验证。
WebSocket 进度保存在内存中，恢复时可能重复投递。SDK 不提供持久化队列或跨进程去重，也不自动重试业务 POST。
WithField、自定义事件名和Client.Request提供扩展入口。各模块是否提供专用方法与数据结构，见上表。