leliln52/dsh-qqbot

README excerpt

dsh-qqbot 把 DeepSeek Harness（DSH）接入 QQ 机器人的插件， 支持两种接入通道 ： 通道 transport 适用 说明 OneBot 11 onebot （默认） NapCat / Lagrange / LLOneBot 等协议端 正向 WebSocket，功能全（群聊任意消息、图片等） QQ 官方开放平台 official q.qq.com 官方机器人 AppID/AppSecret 直连，群聊（@触发）/单聊/频道 两种通道下行为一致： - 每个 QQ 会话一个持久 Agent ：私聊、每个群、每个频道各自独立上下文，历史跨重启保留 （会话日志持久化到 $DSH HOME/sessions ）； - 完整工具链 ：Agent 挂载部署的 Agent 预设（web profile 下为 standard ）， 拥有文件读写、Shell/PowerShell、网页搜索、子代理、任务清单等 DSH 全部能力； - Agent 可主动发消息 ：注册 qq send 工具，Agent 可以主动向对话方汇报进度、 提问或输出结果； - 本地命令 help / status / reset ，长回复自动分块，断线自动重连。 工作原理 安装 1. 准备 QQ 接入端 OneBot 通道 （默认）：任选一个协议实现，例如 NapCat： 登录机器人 QQ 号，开启「网络监听 → WebSocket 客户端（正向 WS）」，记下地址 （默认 ws://127.0.0.1:3001 ），可选设置 access token。 QQ 官方通道 ：到 QQ 开放平台 创建机器人，在「开发设置」 拿到 AppID 与 AppSecret ；在「沙箱配置」添加测试群/私聊用户（或发布后使用）。 群聊中机器人只会收到 @它的消息；单聊需用户主动发起。 2. 安装插件到 DSH web profile 等价于在 $DSH HOME/profiles/web 下执行 pnpm add file:... ， 并把 dsh-qqbot 加入该 profile 的 bundle 列表。 然后 重启 dsh web （先 Ctrl+C 停掉旧进程再启动）。启动日志出现 qqbot: connected to ... 即成功。 3. 配置 OneBot 通道 ：默认连接 ws://127.0.0.1:3001 ，可设环境变量： QQ 官方通道 （任选其一）： 方式 A —— 环境变量： 方式 B —— profile 的 cordis.patch.yml （ $DSH HOME/profiles/web/cordis.patch.yml ）： 配置项见插件 Config （ lib/index.js ）与下方「配置项一览」。 使用 命令 作用 任意消息 交给本会话的 …

Category