前言¶
用 DeepSeek Harness（DSH）做日常助手时，群聊往往进不了「可检索、可总结」的上下文：几百条未读里混着表情包和闲聊，选课、截止、@ 你的那条却沉在最下面。自己逐群翻既费时间，把整库聊天记录塞进对话也不现实。
QQreminder 是社区维护者 K9m1a5c 发布的 DSH 插件（分类：联网工具；GitHub 约 2 stars）。它在本机对已索引的 QQ 群消息做多信号召回，再交给 DSH 里的 AI 做精排与问答，输出可点击的 HTML 报告和「你可能漏了」类提醒。分析层强调全程本地、只读、不登录 QQ、不上传聊天内容；解密 QQ 本地库不在插件范围内，需自备索引或先用示例数据试玩。
这是什么¶
QQreminder 给 DeepSeek Harness 增加「群聊信息管家」能力：从大量群消息里挑出与关注词、@、群权重等信号相关的条目，并生成带「为什么重要」说明的报告。
插件版本见仓库 package.json（当前资料为 1.0.1），许可证 MIT，分析引擎为 Python 3.8+，README 标明 Windows 优先开发与测试，核心逻辑可跨平台。插件以 DSH 进程权限运行，安装前建议阅读源码与许可证。
核心功能¶
下面介绍 README 中已列出的能力，均围绕本地索引 index.db 与配置 focus.json 工作。
可点击 HTML 报告¶
生成报告后可在浏览器离线打开。总览包含有效消息、涉及群、重点条目、疑似遗漏、发言人数等统计；关键群卡片、最重要 N 条（含命中关注词与权重说明）、「你可能漏了」等区块可点进对应群详情。报告会声明数据截止时间，避免把旧库文件当成实时。
DSH 面板与授权¶
在 DSH 设置 → QQreminder 中可配置「我的关注词」、刷新索引、生成摘要、生成报告，以及「QQ 内容读取」开关。关闭读取时仅输出统计与元数据，正文不出现在输出中（对应 authorization.json 的 qq_read）。面板还提供加载示例数据、用 AI 分析（冷启动时由本地统计与抽样材料辅助定群与关注词）。
自带技能与 AI 工具¶
插件注册技能与工具（如 qq_search、qq_digest），安装后可直接用自然语言让 AI 翻群、按话题检索或问「有没有漏掉的」，无需记忆 CLI。也可在面板选日期区间生成报告，或生成摘要指令并复制到剪贴板后粘贴给 AI。
打分与配置¶
本地脚本负责召回：关注词加权、@ 我、群主/管理员、身份词、通知强弱词、群权重等多信号打分；中等分数且含时效/行动词的消息会进入「遗漏」提示。focus.json 可配置监工群、关注词、降权词、身份词、通知词、遗漏提示词与打分区间等，改词即改「什么算重要」。精排与行业差异部分由对话中的 AI 完成。
安装与启用¶
需要 DSH 0.2.0 及以上。官方安装命令如下：
dsh plugin add https://github.com/K9m1a5c/dsh-qqreminder
依赖仅为本机 Python 3.8+，引擎使用标准库，无需 pip install。插件会自动查找 python3 / python / py。
启用步骤：
- 执行上述命令安装插件。
- 打开 DSH → 设置 → QQreminder。
- 尚无真实索引时，可点【加载示例数据】用虚构群聊零配置体验报告形态。
数据从哪来¶
QQreminder 是分析层，不自带 QQ 数据库解密。第一次试用推荐方式 A：面板加载示例数据。接入真实聊天需方式 B：在数据目录（默认 ~/QQreminder，可用环境变量 QQREMINDER_ROOT 修改）下准备 qgd/data/index.db、focus.json、authorization.json，表结构见仓库 README（messages / groups / meta 等）。方式 C 为自行用社区第三方工具处理加密库并整理成索引，README 列出了若干 GitHub 项目并说明需自行评估合规与风险，与本插件无关联。方式 D 为安装后对 AI 说明需求，由 AI 参照插件内 assets/qqreminder.md 引导准备明文库并生成 index.db。
索引更新为手动：面板【刷新索引】或让 AI 触发扫描，不会在后台偷偷扫盘。
典型用法¶
面板三步¶
- 安装并打开 QQreminder 设置页。
- 无数据时加载示例数据，或按 README 准备好
index.db后刷新索引。 - 按需打开「QQ 内容读取」，选择日期区间生成报告，或生成摘要。
对话示例¶
可直接对 DSH 说：
- 「翻一下群，看看今天有什么重要的」
- 「帮我找群里关于选课的所有信息」
- 「有没有我漏掉的？」
AI 会调用插件工具完成检索与 digest，无需记命令名。
focus.json 片段¶
关注词与群权重是日常最常改的配置，结构如下（完整字段见仓库 README）：
{
"监工群": [ { "群号": "…", "群名": "…", "权重": 2.0 } ],
"关注词": { "截止": 6, "报名": 5, "选课": 6 },
"降权词": { "抽奖": -3, "优惠": -3 }
}
适用场景与注意¶
适合群多、又需要从 PC 版 QQ 本地同步下来的消息里快速抓通知与待办的用户（学生选课/截止、办公群需求与会议等）。不适用手机 QQ、微信、TIM；看不到 QQ 未同步到本机的消息；QQ 长期未开则库文件停在最后写入时刻。
诚实边界（来自官方说明）：不连腾讯服务器、不改 QQ 数据目录、不自动推送新消息；唯一可能离开本机的是你主动发给 AI 的材料（例如「用 AI 分析」）。插件在 DSH 进程权限下读你指定的数据目录，安装与启用前请自行审查 K9m1a5c/dsh-qqreminder 源码。
DSH 生态采用「一切皆插件」思路；社区插件目录由 SkillHub 目录页 等站点收录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
QQreminder 把「本地召回 + AI 精排」拆成两层：先用规则与关注词从海量群聊里捞出可疑条目，再在 DSH 里用对话完成总结、检索与遗漏检查，并用 HTML 报告把「为什么重要」写清楚。若你已在用 DSH 并希望把 QQ 群聊纳入助手上下文，可从示例数据或自备索引开始试。
- 目录页：https://www.skillhub.cn/plugins/K9m1a5c/dsh-qqreminder
- GitHub：https://github.com/K9m1a5c/dsh-qqreminder
