988hj7tczd-oss/dsh-im-qq

README excerpt

dsh-im-qq 让 DeepSeek Harness 接入 QQ 官方机器人 （q.qq.com）——通过 QQ（私聊 / 群聊 / 频道 @）直接与 harness 的完整 agent 对话：工具调用、记忆、子代理、文件系统与安全护栏， 与 Web UI 完全同源 。 设计文档： qq-bot-plugin-design.md （v0.3，API 签名已按 rc.6 源码实锤），完整设计见 GitHub 仓库 系列： dsh-im- （一个 IM 平台一个插件， core/ 平台无关可复用） 功能 能力 状态 私聊（C2C）文本收发 ✅ 已实现 群聊 @机器人 / 频道 @机器人 ✅ 已实现 会话隔离（每人/每群独立 session， qq: 前缀） ✅ 已实现 完整 agent 能力（工具/记忆/子代理/文件系统） ✅ 经 agentPresets.mount 挂 standard preset WS 长连接（心跳 / 断线重连 / RESUME / op9 重 identify） ✅ 已实现 回复合并 / 超长分段 / 去内部标签 / 错误兜底 ✅ 已实现 白名单 fail-closed + 频控 ✅ 已实现 审批桥（QQ 内联按钮 ✅/⭐/❌）+ /revoke 撤销 ✅ 已实现 斜杠命令 /help /ping /me /new /approve /always /revoke ✅ 已实现 Webhook transport（官方强制时启用） ⏳ P5 预留，未实现 图片收发 / 流式回复 / typing ⏳ P4，接口需实测确认后实现 前置条件（P0 必须核对，缺一不可） 1. 机器人类型选「公域」 ：q.qq.com 创建 bot 时必须选 公域机器人 ——私域机器人无法用 /v2/groups/ 发群消息， 永久报错 11255 ，代码无法绕过。 2. 测试人员加入沙箱 ：q.qq.com → 开发设置 → 测试人员管理 ，添加自己的 QQ 号——沙箱外人员发消息报 11255，且是永久性错误。 3. 沙箱先行 ： sandbox: true 先验证，稳定后改 false 切正式环境（正式环境需平台审核）。 4. openid 只能从真实消息抄 ：openid / group openid 是平台按 bot 维度哈希的，无法提前预知——白名单联调期用 ' ' 放行，上线前从真实收到的消息日志里抄 openid 收紧。 安装 卸载： ./uninstall.sh （同样需要重启生效）。 安装后 $DSH HOME/cordis.patch.yml 会追加一行 dsh-im-qq 注册块，插件包 symlink 到 profiles/web/node modules/dsh-im-qq 。可 dsh --dump-config 验证插件行可…

Category