前言¶
在 DeepSeek Harness（DSH）里接 QQ，常见做法是挂官方通道或 OneBot 客户端，再叠若干认知、记忆类插件。问题是：群里的 @、命令、推送和真正聊天往往混在同一条链路里，token 和权限边界不好控；人设、记忆若分散在多个插件，运维和隐私也偏散。
dsh-qqbot-refine（维护者 Anarrogantcat，仓库由鲸鱼娘与染喵长期维护）把 QQ/NapCat 增强做成单一 DSH 插件：命令、推送、禁言/撤回、图库同步、诊断等闸门在模型之前生效，多数操作 0 token；人设、半衰期记忆、本地心情引擎、关系亲近度等收在本机存储。仓库 README 还描述了向 DSH「身份系统」演进的设计（P0 已在仓库内测通，尚未部署到 DSH 宿主）。下文按当前已发布能力说明定位、功能与上手步骤。
这是什么¶
一句话：给 DSH 加一层可治理的 QQ 通道——NapCat（OneBot 11）或官方 Tencent 通道二选一，不依赖其他 DSH 插件（onebot 模式下整条链路在本插件内）。
- 目录页：https://www.skillhub.cn/plugins/Anarrogantcat/dsh-qqbot-refine
- GitHub：https://github.com/Anarrogantcat/dsh-qqbot-refine
- 分类：工作流（社区目录 SkillHub）
- 当前 package 版本：0.11.2（MIT，Node ≥20，DSH ≥0.2.0）
核心功能¶
闸门与成本¶
频率（仅 @ / 自然接话、冷却、owner 优先等）、隐私（白名单、出站脱敏、不可信内容隔离）、群秩序类命令均在模型前处理，README 功能表标明这些模块 token 为 0。每轮注入控制群上下文条数、记忆召回条数；心情默认本地引擎，不依赖第三方认知插件（可选与 dsh-feiyu-mood 联动）。
像个人：人设、心情、记忆、关系¶
- 人设：人设库 + 全局/按群/按私聊三级作用域；内置多套预设，面板与
#人设命令管理。 - 心情：七维 + 生气/得意，半衰期与惯性，影响语气等；本地计算。
- 记忆：半衰期淡忘、
#记得手动写、第一人称陈述自动记。 - 关系：对群成员的亲近度/信任度随情绪信号更新。
- 认知四张卡（S7）：在场的人、自述/承诺、待办、群摘要——数据落在本机
<store>/relations/等路径，注入时 0 token。
能干活的扩展（按需启用）¶
本地 ComfyUI 生图（#画 流程：搜 → 问 → 确认）、WSL+CUDA TTS（#说话）、B 站动态与链接、LPL/LCK 等赛程、知识库从本机路径导入（md/txt/csv/json/html/pdf/docx/sqlite 等）、自带只读 MCP 沙箱桥（工具名 mcp__<server>__<tool>）。可选配合 dsh-computer-use-win 做电脑操控，面板「隐私 / 工具」可设群成员 off / read / full。
通道：onebot 与 tencent¶
transport.mode 单活、不共存：
| 模式 | 说明 |
|---|---|
onebot |
本插件直连 NapCat websocketServers（OneBot 11），15 项能力全开，无需其他 DSH 插件 |
tencent |
挂官方 @tencent-connect/dsh-qqbot 钩子，受官方 SDK 能力限制（7 项） |
onebot 链路：NapCat → OneBotClient → 闸门 → 宿主 agent → 出站闸门 → OneBot 发送。每群/每私聊一个 DSH 会话，sessionId 为固定前缀的 sha256，重启可 resume。
NapCat 专属（仅 onebot）：撤回不答、戳一戳反应、合并转发展开、引用原文、语音转写（可选 STT 配置）、引用回复、定时撤回、群管命令等——详见 README 表格。
钱与安全（群场景）¶
#余额 / #饭、#充值、#饭账、#充值码；峰谷价折算用量；可选花费硬闸、发送失败熔断、被踢摘白名单、被禁言闭麦。配置与记忆均在 $DSH_HOME/storages/dsh-qqbot-refine/，README 强调不上传云端。
安装与启用¶
Web 版 profile 一条命令安装（桌面端可将 web 换为 desktop 或用应用内「设置 → 插件」）：
dsh plugin --profile web add github:Anarrogantcat/dsh-qqbot-refine
手动协议（与 README 一致）：插件进 profile 的 node_modules 或 package.json 依赖 → 在 dsh.profile.bundles 增加 "dsh-qqbot-refine" → 重启 DSH；cordis.patch.yml 会插入 id: qqbot-refine。
NapCat（onebot 模式，一次性）
- WebUI
http://127.0.0.1:6099→ 网络配置 → Websocket 服务器 → 新增：host=127.0.0.1、port=3001、token=<随机 32 位>、messagePostFormat=array、reportSelfMessage=否 - 保存并重启 NapCat
- 面板「通道」：
mode=onebot、地址ws://127.0.0.1:3001、填入 token → 重启 DSH
配置面板：http://127.0.0.1:<DSH端口>/qqbot-refine（仅 loopback）；也可通过浏览器半边右下角悬浮按钮打开。设置落盘 <DSH_HOME>/storages/dsh-qqbot-refine/settings.json，保存热生效。更新可在面板「检查更新」或再执行 add 命令；更新前会备份到 ~/.dsh/storages/dsh-qqbot-refine/backups/update-<时间>/。
典型用法¶
经过上面的步骤，在群里 @ 机器人即可对话。常用 # 命令（均 0 token，管理类限 Owner/Admin）：绑定 / 绑定本群、群状态、闭嘴 / 说话、撤回、禁言 / 解禁、记得 / 忘掉 / 记忆、人设、表情、B站、赛程、用量、余额 / 饭 / 充值、帮助 等；#群列表、#群成员、#踢人、#名片、#赞 仅 onebot 模式。
维护通道：#诊断（只读）→ 贴 diff → #合并（git apply –check）→ #测试。
示例认知卡片段（README 说明注入人设段，每次只取有用句）：
# 在场的人（按最近活跃）
· 染喵（群主）：今天说过 12 句
# 我刚才说过/答应过
说过：押 HLE；答应过：明天帮你查赛程
适用场景与注意¶
适合：需要在 QQ 群/私聊里跑 DSH agent，且希望频率、隐私、群管、用量在本机可控；已有 NapCat 或愿意走 OneBot 11；接受人设/记忆/心情 bundled 在同一插件、数据本地落盘。
注意：
- 插件以当前 DSH 进程权限运行，安装前应阅读仓库源码与 MIT 许可证，确认通道 token、白名单、电脑操控档位等配置符合你的安全要求。
- 群聊与资料内容一律按不可信素材处理，不当指令执行；出站会脱敏密钥与路径。
- 身份系统路线图在 README 中标注为设计已定稿、宿主侧尚未部署，勿与当前面板功能混为一谈。
- SkillHub 为社区插件目录，与 DeepSeek / 幻方无官方从属关系；星标等以 GitHub 页面为准（线索抓取时为 0）。
结尾¶
dsh-qqbot-refine 把 QQ 机器人做成「闸门在前、聊天在后」的 DSH 工作流插件：NapCat 或官方通道二选一，人设/记忆/心情/关系与群工具收在一处，并预留向统一身份底座演进的方向。进一步了解可打开 SkillHub 目录页 与 GitHub 仓库（安装细节见 docs/INSTALL.md）。
