belowthetree/dsh-qqbot

README 摘要

dsh-qqbot QQ 官方机器人插件，作为 DeepSeek Harness 的 树外插件 维护（不在 harness 源码树内）。一个包、两个半： - host 半 （ lib/index.js ）： /qqbot on off 命令、绑定会话、WebSocket 网关、QQ 端审批转发。 - client 半 （ lib/client.js ，经 dsh.client 声明随同一条挂载行自动加载）：输入区工具行的「连接 QQ」开关 + 设置面板的 QQ Bot 设置页签 。 安装 从 npm 装进你运行的 profile（无需本地构建）： 等价的手动方式（进入 profile 目录执行 pnpm）： 注意： - 必须带 -w ：profile 目录自带 pnpm-workspace.yaml ，不带 -w 时 pnpm 报 ERR PNPM ADDING TO ROOT 直接失败。 - 本包没有 dsh.bundle 声明，不会进入 profile 的 bundles 层，这符合预期——由下面的 patch 行按包名挂载；client 半由 dsh.client 扫描同一条挂载行自动进浏览器。 - 升级到新版本：重新 add 一次新版本号，然后重启 dsh。registry 版是安装时的快照（不再指向源码目录），改本地源码不影响它。 本地开发（link 到源码） 改插件源码时用 link: 直接指向源码目录： - 用 link: 而不是裸路径 ：裸路径是 file: 语义（快照副本），改源码不生效； link: 直接指向源码目录，重新 pnpm run build 后即时生效，无需重新 add。 - 改完发布版后切回本地版用同一条 link: 命令（ pnpm add 会把依赖 spec 从 registry 改写成 link）。 - 反之，切回发布版： dsh plugin --profile add -w dsh-qqbot@ 。 在 profile 自己的 cordis.patch.yml （ $DSH HOME/profiles/ /cordis.patch.yml ）挂载（凭据在设置界面填写，不再写在这里）： 不要放进 $DSH HOME/cordis.patch.yml （home 层）：它作用于 所有 profile，而只有装过这个包的 profile 才能解析——其他 profile（如 headless）会直接启动失败。 配置（设置界面） 重启 dsh 后打开 设置（左下角）→ QQ Bot 页签，填写： 字段 说明 AppID QQ 开放平台机器人应用的 AppID。 AppSecret 写穿不回显 ：保存后输入框留空表示「保持现有密钥」；页面显示「已配置」，可用「清除密钥」移除。 使用沙箱环境 勾选后走沙箱网关（ sandbox…

分类