dsh-qq-group-digest

🚀 dsh-qq-group-digest

QQ 群消息 → AI 总结 → 私聊投递，一条流水线跑完

DeepSeek-Harness 插件 · 按阈值分批 · 走 DSH 已配置模型 · 群维度报告

核心配套 · 版本信息 · 依赖 · 安装使用 · HTTP 网页服务 · 主要功能 · 数据与目录

🔗 核心配套：LuckyLilliaBot

本插件只负责 收消息 → 总结 → 投递。

QQ 登录与 OneBot11 协议端由 LuckyLilliaBot（LLBot，支持 OneBot 11 / Satori / Milky）提供。

必须先跑起 LuckyLilliaBot 并开启 OneBot11 正向 WebSocket，本插件才有消息可监听。

模型调用走 DSH 的 ctx.llm.stream —— 凭证 / 代理 / 重试 / 路由全部沿用你在 DSH「设置 → 模型」里配好的那套，插件不碰 API Key。

版本信息

项 · 值 当前版本 · v0.5.1 发布日期 · 2026-10-25 最新发布 · v0.5.1 · 总结记录双视图与精细版提示词优化

依赖

项 · 要求 DSH · ≥ 0.1.7-rc.2，且已配置至少一个可用模型 Node · ≥ 22（用内置全局 WebSocket，无第三方 ws 依赖） QQ 协议端 · LuckyLilliaBot 已登录，且开启 OneBot11 正向 WebSocket 权限 · 接收私聊的账号必须是 bot 账号的好友

插件本身 零运行时依赖 —— 只用 Node 内置模块 + DSH 宿主服务。

安装使用

① 在 LuckyLilliaBot 里开正向 WS

在 LLBot 的 OneBot11 配置里开启正向 WebSocket 服务，记下 host / port / token：

{
  "enable": true,
  "name": "dsh-digest",
  "host": "127.0.0.1",
  "port": 3001,
  "token": "换成你自己的口令",
  "messagePostFormat": "array",
  "enableForcePushEvent": true,
  "reportSelfMessage": false
}

改完重启 LLBot，确认端口在听：

Get-NetTCPConnection -State Listen | Where-Object LocalPort -eq 3001

② 源码安装

编辑 C:\Users\.dsh\profiles\desktop\package.json：

1. dependencies 里加 "dsh-qq-group-digest": "link:D:/本地安装文件夹/dsh-qq-group-digest"
2. dsh.profile.bundles 数组末尾加 "dsh-qq-group-digest"

cd C:\Users\<你>\.dsh\profiles\desktop
pnpm install

⚠️ 首次 `pnpm install` 可能失败

报 ERR_PNPM_PACKAGE_MANAGER_REMOVE_MODULES_DIR（拒绝访问 (os error 5)），因为 DSH 桌面进程正占用 node_modules。

把同一条命令再跑一次即可，第二次走增量路径。

安装或改 cordis.patch.yml 后 重启一次 DSH。之后所有日常配置都在设置页里改，不需要再重启。

③ 在设置页配置

打开 DSH → 设置 → 存储与预演

💡 首次建议先开 `dryRun`进行测试：报告只写 outbox/dryrun-*.md，不发 QQ。

核对文本满意后，到「设置 → QQ 群总结 → 存储与预演」关掉即可，热生效。

保存并生效 = 校验 → 写 settings.json → 热重建运行态。WS 断一下再重连，DSH 不用重启。

主要功能

能力 · 说明 📥 群消息采集 · 连 OneBot11 正向 WS，按群白名单采集，(group_id, message_id) 双层 LRU 去重，real_seq 排序并标注缺口 ⏱ 批次触发 · 每群独立状态机，threshold / maxBuffer / maxWaitMs 任一满足即冻结，freezeGraceMs 抗乱序抖动 🧠 总结与降级 · 路由三级回退（显式配置 → DSH 默认 → 首个可用），失败指数退避重试；重试耗尽降级为原始摘录，仍然投递。输出被 max-tokens 截断视为失败并重试，第 2 次起上限翻倍（上限 32000） 📤 报告投递 · 每个群单独一条 QQ 消息（多群绝不合并且不会超长截断），单条超长按行分段、段间间隔防风控；单群失败不影响其它群，全部失败兜底写 outbox/failed-*.md；接收人可选，不配就只存网页端 🌐 HTTP 网页服务 · 可开关的独立端口（默认 1213）网页端：配置页 / 日志页 / 总结记录页，默认密钥登录，与 DSH 设置页并存互不影响 📝 总结记录（Markdown） · 每群每次总结存一份完整 Markdown；网页端本地零依赖渲染，可切「AI 精细版」再调一次模型产出更详尽的长文 🗂 总结记录管理 · 按群分组折叠、AI/本地标识、行勾选批量导出 .md 与批量删除（二次确认），详情页可删单条 🏷 群名持久化 · 群名单独存 group-names.json，连接时自动灌入协议端群列表；报告与网页端一律显示「群名（群号）」，不再出现「未命名群」 ✨ 重点标记与高频词条 · AI 精细版固定「高频词条 → 要点 → 结论 → 待办」结构；==文字== 渲染背景高亮、@@文字@@ 渲染强调色；成员表带 15 字内「本次重点」，只在网页详情页与导出 `.md` 里渲染，正文不再重复 🧵 历史上下文 · 每群 summaries/.json 存最近 20 条，每次总结附带此前 historyCount 条，避免重复叙述、丢关键结论 🚫 信息过滤 · 关键词模糊匹配（不区分大小写）与按群排除成员，命中的消息不计入总结，丢弃原因计入 dropReasons 🎛 设置界面 · DSH 设置页与独立网页端都能改全部配置，保存即热生效；群进度 [n/threshold] 实时可见，状态与报告 5 秒自动刷新。model.maxTokens 默认 2048（普通总结）、model.detailMaxTokens 默认 4096（AI 精细版），均可调 🧩 双提示词 · 普通总结（prompt.system）与 AI 精细版（prompt.detailSystem）各一套 system prompt，都可编辑、可一键恢复默认；设置页与网页端用两个 tab 切换，切 tab 不丢草稿 🔌 投递目标可选 · 不配接收好友也能跑：总结照常生成并进网页端与历史记录，只是不发 QQ；界面显示「未配置投递目标」提示，不报错不阻塞保存 📡 断线重连倒计时 · 协议端掉线时徽章转橙色「已断开，N 秒后重连（第 K 次）」，秒数本地每秒递减，到 0 显示「正在重连…」；恢复后转回绿色 🧭 侧边栏入口 · 可开关：开启后 DSH 主界面左侧导航多一行「QQ 群总结」 🔄 热重载 · 改 lib/** 后点「热重载插件」即可生效，未总结的消息不会丢

🌐 HTTP 网页服务

不想开 DSH 界面也能管：插件自带一个独立端口的网页端，默认关闭，需要时在设置页勾选开启。

项 · 默认值 · 说明 开关 · 关闭 · 不开就完全不监听端口，不影响 WS 管线与 DSH 设置页 端口 · 1213 · 可改；端口被占用时只记错误、不阻塞插件，换个端口再保存即可 监听地址 · 0.0.0.0 · 局域网内其它设备也能访问；只想本机用就改成 127.0.0.1 密钥验证 · 开启 · 首次访问需输入密钥；密钥随机生成，也可自定义。只存掩码，明文仅在「重新生成」时返回一次 会话有效期 · 168 小时 · 登录一次管 7 天

开启后浏览器打开 http://:1213：

页面 · 路径 · 内容 配置页 · / · 与 DSH 设置页功能完全一致的九张卡片，其中 AI 提示词卡片是两个 tab（普通总结 / AI 精细版），各自可改写、可一键恢复内置默认，切 tab 不丢草稿 日志页 · /logs · 级别 / 群号 / 关键字 / 时间范围筛选，SSE 实时推送，可导出 .jsonl；按天落盘，默认保留 7 天 总结记录页 · /summaries · 重点：按群分组可折叠，每条记录渲染成完整 Markdown 文档（高频词条 / 要点 / 参与成员表 / 投递状态），AI 精细版带 AI 徽章；支持勾选批量导出 .md、批量删除、复制、下载、看原始文本、上下条翻页

📄 本地渲染 vs AI 精细版

默认用零依赖的本地渲染器把总结排成 Markdown，不额外调用模型、零成本。

打开「AI 精细版」开关后，每批总结会再调一次模型产出更详尽的长文（建议 800–1200 字、全文不超过 1200 个汉字，带待办复选框与关键链接）；

生成失败会自动回退本地渲染，绝不影响 QQ 投递。

📤 多群投递规则

多个群同时触发时，每个群各自发送一条独立的 QQ 消息，不会把几个群的总结合并成一条 —— 合并极易撞上单条消息字数上限，导致内容被截断丢失。

场景 · 行为 单群触发 · 渲染该群一份报告 → 超长按行分段 → 逐段发送 多群触发（同一聚合窗口内） · 每群各渲染一份 → 每群各发一条（该群超长才分段） 某群发送失败 · 只影响该群；其它群照常发，失败的群写 outbox/failed--.md 网页端总结记录 · 同样按群分组展示，详情只渲染单群单批的 Markdown，不做跨群拼接

delivery.aggregateWindowMs 只决定「多个群是否在同一批里一起投递」，不影响是否合并成一条消息。

数据与目录

运行期数据在 $DSH_HOME/storages/qq-digest/（storage.dir 可改）：

路径 · 内容 messages//.jsonl · 原始消息，storage.keepDays 到期清理 summaries/.json · 每群历史总结（含 AI 精细版 md 与成员发言重点），删掉即清空该群记忆。md 只存正文，不含参与成员表 —— 成员表在网页详情页与导出文件里现场渲染 group-names.json · 群号 → 群名映射，连接协议端时自动补齐；删掉会在下次连接后重建 outbox/ · dryRun 预演与发送失败的兜底报告（多群时每群一个文件） logs/.jsonl · 网页日志页的数据源，按天落盘，默认保留 7 天 settings.json · 设置页保存的覆盖配置（含提示词与网页服务密钥）；删掉即回到 cordis.patch.yml 初始值

代码结构（点开）

dsh-qq-group-digest/
├── package.json          # 插件清单 + dsh.bundle / dsh.client 声明
├── cordis.patch.yml      # 挂载 + 首次安装的初始配置
├── index.js              # Host 半身：HTTP 路由、运行态装配
├── client.js             # Client 半身：设置页面板 + 侧边栏入口
├── lib/                  # 连接 / 接入 / 分批 / 总结 / 投递 / 存储
│   ├── http/             # 独立网页服务：server / auth / api + static 四页
│   └── summarize/        # 提示词、Markdown 渲染、总结调用
├── doc/                  # 版本变更记录 + 开发计划
└── test/                 # 308 个用例，node:test，零依赖

更新代码后如何生效

改了什么 · 怎么生效 · 要重启 DSH 吗 设置项（阈值、群号、模型、dryRun…） · 设置页点「保存并生效」 · ❌ 不要 client.js · 刷新页面（F5） · ❌ 不要 lib/pipeline.js lib/summarize/** lib/deliver/** lib/store/** lib/config.js · 设置页点「热重载插件」 · ❌ 不要 index.js、lib/http/** · 设置页点「热重载插件」不够，要重启 DSH · ✅ 要 cordis.patch.yml / package.json / 依赖 · 重启 DSH · ✅ 要

热重载的做法是把 lib/ 整棵树复制到 generations/ 再 import 其中的 runtime.js，绕过 Node 的 ESM 缓存；

新一代起来之后才停旧的，未总结消息经 snapshotPending / restorePending 继承。

但热重载只换 Runtime 及其下游。index.js 在启动时静态导入的模块（lib/http/server.js、lib/http/api.js、

lib/store/logs.js、lib/summarize/prompt-store.js 等）仍绑定在进程里的旧实例上 ——

改这些文件（尤其是网页服务的路由与静态资源）必须重启一次 DSH 才会生效。

卸载

1. 从 profile 的 package.json 删掉 dsh-qq-group-digest 依赖行与 dsh.profile.bundles 里的条目
2. 删 node_modules/dsh-qq-group-digest（link 目录）
3. pnpm install
4. 重启 DSH

运行期数据 $DSH_HOME/storages/qq-digest/ 不会被自动删除，自行决定是否清理。

许可

MIT © w2018

本插件不自带 QQ 协议实现，协议能力由 LuckyLilliaBot 提供