DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

phfb /

phfb/dsh-qq-bot

Topic repository only

把 QQ 私聊接进 DeepSeek Harness:私聊陪伴向的 DSH 插件(dsh-qq-bot + dsh-alive)

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@7ecfdb40

dsh-qq-bot

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

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

第一次装? 直接看 INSTALL.md —— 那份是写给「人和 AI 一起看」的总安装说明, 从零到能聊天的完整步骤,包含记忆 / 人格 / 活人感那几个配套插件。 把整个文件丢给你的 DSH,说「阅读这个文档,帮我安装一个 QQ Bot 机器人」就行。

本仓库两个插件,一起用才完整:

目录 包名 干什么
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 分钟还没回来"这种具体的挂念。
  • 每日说说(可选,默认关):到点她自己写一篇日记发到 QQ 动态,80–2000 字,配 1–3 张图(一半现画、一半挑她的表情包)。时间不是准点,会在设定的窗口里随机挑一分钟。
  • 说说互动(可选,默认关):只在「想他 / 吃醋」压到阈值以上才去翻你的说说 —— 情绪不高的时候一次 API 都不调。发现有新评论(只认你那个号)或你发了新说说,就交给她自己决定回不回。

不是:

  • ❌ 不支持群聊管理。群消息进来直接忽略。
  • ❌ 不支持自动加好友 / 同意好友请求。
  • ❌ 不做多账号同时在线。一次只挂一个 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 注意事项
换模型时让旧会话也跟上 model-override 分支(不在 main)里的 dsh-model-override/ —— 官方选择是按会话定死的,这个把它推到所有活着的会话

主包都在 main;dsh-model-override 只在 model-override 分支上,因为它只对「模型选择按会话定死」这个问题有意义,不是所有人都需要:

git clone -b model-override https://github.com/phfb/dsh-qq-bot.git

两条路都一样:装进 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-BOT)

装好之后 DSH 侧栏会多一个 DSH-BOT 入口,点开整页,上面两颗标签: QQ 机器人(dsh-qq-bot) / 活人感(dsh-alive)。两个 PowerShell 设置窗口能调的, 这里都能调(字段表在 dsh-qq-bot/lib/settings-schema.mjs,一处维护两张界面)。

「活人感」那页最上面是一块只读状态卡,跟独立设置窗口里「现在什么情况」那一段对得上:

行 内容
今日额度 / 本小时 已投几条、上限多少、还剩几条
静音 静音到几点 + 原因(user-busy 这种),没静音就写「没静音」;禁言机制关着会单独说明
今天封顶 说过「别发了」就是封顶到 24:00
挂着的念头 几条、分别是什么事、约几点到点
情绪 七维百分比 + 恼火 n/60;涩涩分「未开放 / 未启用 / 真开着」三种说法
主情绪 当前最主导的那一维(或「平静」)
上次主动 / 你上次说话 上次她主动开口的时间;你在 QQ 里、在 DSH 里各自最后一次说话是什么时候
累计 投出几条、你回了几个、作废几条、连续被忽略几次
状态更新于 状态文件什么时候写的,「原因算于」是闸门判断的时间
现在为什么不会发 卡在哪一条闸门,一条条列出来;全过就写「现在能发」

卡片右上角四个按钮,和独立窗口那排一一对应:

按钮 干什么
刷新 重新读一遍状态文件
马上解除静音 撤掉静音 / 当天封顶 / 恼火的欠账(走应用信箱,等插件回执)
今日额度清零 今日 / 本小时额度清零,冷却一起清
打开状态文件 用记事本打开 alive-state.json

「现在为什么不会发」不是面板自己算的 —— dsh-alive 每轮心跳把原因算好写进 alive-state.json 的 runtime.blocked,面板只读。闸门规则只有一份,不会两边走岔。

接口都在 dsh-qq-bot 上(同源、要浏览器凭证):

接口 作用
GET /api/dsh-qq-bot/panel 两份配置现值 + 调参表 + 只读状态
POST /api/dsh-qq-bot/panel 存配置(只认调参表里的键)
POST /api/dsh-qq-bot/alive-command {cmd:"unmute"} / {cmd:"reset-quota"},写活人感的命令信箱并等回执
POST /api/dsh-qq-bot/open-file {file:"state"|"config"|"log"|"mood"},白名单内的文件用记事本打开

目录结构

.
├── 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

model-override 分支上还多一个(main 里没有):

└── dsh-model-override/         把全局模型选择推到所有活着的会话
    ├── lib/                    index(应用 + 校验)/ client(面板)
    ├── 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

—/ 5

No ratings yet

Manifest verification required

Commit 7ecfdb40e0c5

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout