QQ 私聊陪伴 phfb/dsh-qq-bot

dsh-qq-bot

把 QQ 私聊接进 DeepSeek Harness，让 DSH 常驻在你的手机 QQ 里 —— 随时能找她说话，她也会在你安静太久的时候自己开口。

这是私聊陪伴向的插件，不是群聊管理机器人。 群消息直接忽略，不碰群管、群公告、撤回禁言那一套。

本仓库两个插件，一起用才完整：

| 目录 | 包名 | 干什么 |
| dsh-qq-bot/ | dsh-qq-bot | 收 QQ 私聊 → 交给 DSH agent → 回复切成几条、带打字停顿发回去 |
| dsh-alive/ | dsh-alive | 活人感：她心里挂着没落地的事到期了，由她自己主动开口一次 |

手机 QQ → QQ 客户端(QQNT) → SnowLuma(注入 hook, OneBot v11 WS) → dsh-qq-bot → DSH agent ↑ dsh-alive ──投一条"念头"──┘

- SnowLuma 是 QQ 协议端，不在本仓库里，要你自己部署。它注入 QQNT 客户端进程，暴露 OneBot v11（HTTP 3000 / WS 3001）。
- dsh-qq-bot 是 DSH 宿主插件，零运行时依赖（只用 node:），装进 profile 就跑。
- dsh-alive 不自己连 QQ，它只把自己的"念头"投进 QQ 会话，由 dsh-qq-bot 负责发出去。

它是什么 / 不是什么

是：

- 只处理私聊：你在手机上给 BOT 号发一句话，消息经 OneBot 进来，交给 DSH 的 agent 处理，回复再原路发回 QQ。
- 带上下文管理：同一段对话有连续记忆，上下文快满了（默认 80%）自动开新局，并在 QQ 里说一声。
- 回复会切成几条、带"正在输入"的停顿，看起来像人在打字；markdown 的 、 不会漏到 QQ 里。
- 能发表情包（模型自己决定什么时候发，有间隔 / 配额 / 概率三道闸门）。
- 装了 dsh-alive 之后，她还会在你安静太久时主动开口 —— 不是定时器随机发消息，而是"你说了去拿外卖、18 分钟还没回来"这种具体的挂念。

不是：

- ❌ 不支持群聊管理。群消息进来直接忽略。
- ❌ 不支持自动加好友 / 同意好友请求。
- ❌ 不做多账号同时在线。一次只挂一个 BOT 号。
- ❌ 不保存 QQ 密码（SnowLuma 走客户端 hook，没有密码这一环）。
- ❌ 不下载图片、不转写语音，图片/语音只留占位符。

前置条件

| 需要什么 | 说明 |
| Node ≥ 22 | 插件用内置 WebSocket，没有依赖包 |
| DSH | 插件跑在 DSH 宿主进程里，DSH 关了 bot 就下线 |
| SnowLuma | OneBot v11 协议端，必须自己部署 |
| 登录了 BOT 号的 QQ 客户端 | BOT 号要在 QQNT 里真登录，并且在 SnowLuma 里挂载 |

装哪个

两个仓库目录是两个独立插件包，各装各的：

| 想干什么 | 看哪 |
| 让 QQ 消息能进能出 | dsh-qq-bot/README.md —— 从零配 SnowLuma、装插件、填配置、排查 1006 |
| 让她会主动开口 | dsh-alive/README.md —— 12 道闸门、节奏参数、装法与 junction 注意事项 |

两条路都一样：装进 DSH profile，重启 DSH，然后有个 图形化设置窗口（tools\settings-ui.cmd / tools\settings-alive.cmd）可以改参数，保存即热应用 —— 不用为了让一个数字生效去动 cordis.patch.yml（那文件改错会让整个宿主起不来）。

QQ 里能用的命令

| 命令 | 作用 |
| /qq off | 闭嘴。连接保持不断，消息只记日志 |
| /qq on | 回来 |
| /qq status | 转发开没开、当前第几局、上下文占用多少 |

对 dsh-alive 说话它也会听：「别吵 / 滚 / 闭嘴」硬静音 2 小时，「我在开会 / 上课 / 面试」软静音 90 分钟，「我忙完了 / 好了 / 出来吧」解除。

目录结构

.
├── dsh-qq-bot/ 插件本体 │ ├── lib/ index / config / client / onebot / policy │ ├── test/ 单测（node --test） │ ├── tools/ Windows 工具：设置窗口、自检、启动器、托盘 │ ├── cordis.patch.yml 出厂默认配置（bundle patch，Loader 自动读） │ └── README.md 完整文档 └── dsh-alive/ 活人感插件 ├── lib/ index / config / policy（判定核心是纯函数、可单测） ├── test/ ├── tools/ 设置窗口 └── README.md

跑测试

cd dsh-qq-bot && node --test "test//.test.mjs"
cd dsh-alive && node --test "test/policy.test.mjs"

（Node 24 不认 node --test <目录>，要么给文件路径，要么不带参数让它自己找。）

隐私

- 插件不联网上传任何东西。只连你自己机器上的 SnowLuma（127.0.0.1）。
- 不保存 QQ 密码。
- 所有状态只写在本地数据目录：会话映射、控制开关、表情闸门状态、alive 的配额与念头、日志。
- 聊天内容会进 DSH 的上下文（否则她记不住你），这部分由你自己的 DSH 配置决定。
- 删除数据目录 = 清空所有本地状态，插件下次启动当新人重新开始。
- tools\bot-config.json 里有你的 QQ 号和 SnowLuma token，已被 .gitignore 排除，别提交。

License

MIT