dsh-qqbot-guard：为 DeepSeek Harness 的 qqbot 群聊补上关键词放行与历史附件

它是做什么的？

qqbot-guard 是 DeepSeek Harness（DSH）的 qqbot 增强层插件，作为伴侣插件为已安装的 qqbot 主体做进程内补丁，不修改 qqbot 或 SDK 的任何磁盘文件。它解决群聊必须 @ 才回复、关键词被 mentionGate 拦下、群历史里图片语音文件只剩空行、表情只显示占位符等问题。核心能力包括伪造 mentions 放行关键词、预下载附件补全历史条目、解码表情文本，以及自动定位 qqbot 安装路径。由 anwesc 维护，采用 MIT 协议，用 JavaScript 编写。

核心功能

• 关键词放行：正文命中关键词时给消息补上 is_you 提及标记，让 mentionGate 与 slashCommand 都判定为被提及，同时触发上下文历史拼接。
• 历史附件补全：在消息链头预下载图片、语音、文件等附件，再包装 history store 的 list，为历史条目补上带路径的附件描述。
• 表情解码：读取表情扩展文本，有名字就用名字，为空则统一显示为表情占位，不按 faceId 猜测。
• 进程内原型补丁：全部通过中间件链头插入实现，升级 qqbot 不会让补丁文件失效，也不依赖插件启动顺序。
• 自动定位 qqbot：按显式配置、同目录 node_modules、各 profile、平铺布局、cwd 向上查找的顺序定位 qqbot，找不到时日志列出试过的每一处路径。

怎么使用这个插件？

先在 DSH 中装好 qqbot 主体，本插件依赖它才能拿到 bot 实例，然后启用本插件即可生效。需要调整参数时有两种方式：手机端推荐编辑 DSH 主目录下的 qqbot-guard.json，写入 triggers 关键词列表、qqbotPackage 路径、verbose 开关等配置；能写 YAML 时也可在 profile patch 中覆盖同名条目。修改 bundles 后需重启 App，因为 bundles 变更不走热重载。若不想让它工作，把 enabled 设为 false，而不是卸载——内置副本会在下次启动时补回。