前言¶

在 DeepSeek Harness（DSH）里做带记忆、带人格的智能体时，常见做法是自建桥接层：一边对接即时通讯协议，一边把消息喂给 Harness 的会话与工具运行时。QQ 侧通常还要接 OneBot v11 网关，并单独处理访问控制、本地持久化与配置面板。下面介绍的 dsh-bot（社区目录条目 reina0721/dsh-neobot，维护者 reina0721）把 QQ 接入、多人格、认知相关能力与网页管理面板收拢在一个 DSH 插件里，通过 NapCat、SnowLuma、Lagrange.OneBot 或 LLOneBot 等网关连接 QQ，数据在本机持久化。

这是什么¶

dsh-bot 是为 DeepSeek Harness 提供的插件：QQ 连接与消息、人格与认知服务、可选 DSH Session 运行时，以及连接、消息、人格、模型、认知、日志等设置面板。package.json 中当前版本为 0.11.26，许可证 MIT。运行要求：DSH >= 0.2.0 且 < 0.3.0、Node.js >= 22.13.0，以及已登录的 OneBot v11 网关；运行时无额外第三方依赖（具体能力边界见仓库文档中的实现状态说明）。

核心功能¶

下列能力均来自项目 README 与安装说明，部分模块标注为未发布或仅离线/模拟环境验证，部署前宜对照官方发布检查表与用户手册。

QQ 与访问控制¶

• QQ 连接、账号核验、事件接收，群聊与私聊消息发送。
• 访问控制：open / allowlist、主人 QQ、默认空的只读操作员列表、私聊/群白名单，统一出站闸门与审计。
• 可选 DSH Session 运行时：runtime.engine=agent 时每聊天一个 DSH Session；仅主人私聊在运行时挂载当前会话 QQ 工具，失败自动回退 oneshot。
• 回复分条、可配引用/@、连续未点名接话上限；合并转发展开、拍一拍回应、表情表态归因等交付行为。

主人 QQ 命令与模型¶

主人可用命令包括 /status、/steer、/quiet、/active、/model、/remember、/forget、/identity、/tts、/say、/sticker、/bili、/help，以及 /like、/poke、/groupinfo、/memberinfo 等；支持按聊天覆盖模型。认知设置中 cog-llm 组提供全局/人格双计数与 global|persona|both 预算模式（默认全局 300000）。

人格、记忆与认知¶

• 多人格管理，按人格隔离记忆、人物、关系、情绪及策略数据。
• 目的系统（目标/计划/意图）及面板、/purpose 相关管理；每日记忆整理、按作用域反思、时间轴只读回忆日志。
• 人物/群印象与关系编辑、旧档案 JSON/JSONL 导入当前人格。
• 出站文本防泄漏（默认启用）、「安全」页审计与上线检查清单；本地目录备份与「备份」面板（默认配额与保留策略见用户手册）。

媒体与模块¶

• 可选媒体：图片/语音链路、表情包库与媒体面板；可选 B 站公共内容（默认关闭）；OpenAI 兼容生图/改图与 /draw 等（外部 provider 默认关闭）。
• 统一模块目录：内置 media-features、reply delivery、typing、reminders 默认启用，sample 默认关闭；外部本地 JS 可重载。
• 多模型协议：OpenAI Chat/Responses、Anthropic、Gemini、Ollama 等路由配置。

README 中明确：真实 QQ/媒体验收仅完成部分；实机演示使用 DSH 0.2.1-rc.3 与历史版本 dsh-bot 的截图，演示环境可用仓库自带模拟 OneBot 网关复现，不代表真实 QQ 登录或外部模型调用。

安装与启用¶

将 desktop 换成你实际使用的 DSH profile。官方示例为从 GitHub Release 安装固定版本 0.11.26：

dsh plugin --profile desktop add https://github.com/reina0721/dsh-bot/releases/download/v0.11.26/dsh-bot.tgz

也可使用仓库提供的安装脚本（会校验发布包 SHA-256，不会自动重启 DSH）：

curl -fL https://raw.githubusercontent.com/reina0721/dsh-bot/main/scripts/install.sh -o install.sh
sh install.sh --profile desktop --version 0.11.0

Windows PowerShell 可使用 scripts/install.ps1，参数含 -Profile、-Version。最新稳定版安装包亦可通过 GitHub Releases 获取。旧版用户需先阅读仓库中的迁移说明。

安装完成后，在 DSH 面板中配置 OneBot 网关地址与访问控制项，并核对 QQ 账号连接状态。

典型用法¶

连接与状态：配置 OneBot v11 网关并使插件显示已连接后，主人可在 QQ 私聊或已放行的群中使用 /status、/help 查看运行信息。

按聊天选模型：使用 /model 为当前聊天覆盖模型（细节见用户手册「按聊天选模型与 QQ 命令」）。

会话运行时与插话：在配置中启用 runtime.engine=agent 后，主人可用 /steer 文本 向当前 agent Session 注入 1–1000 个 Unicode 字符（oneshot 模式下不可用；该能力在文档中标注为 partial，真实 DSH/QQ 未必已全部验证）。

本地提醒（默认关闭相关行为以配置为准）：/remind <秒|ISO时间> <文本>、/reminders、/forgetreminder <id>，经访问控制与限频后向当前聊天发送固定文本。

记忆与目的：/remember、/forget 与认知面板配合；/purpose 系列命令管理目的与计划步骤（部分 plan 能力标注为未发布或 partial）。

模块与媒体：在面板「模块」中启停内置模块；媒体、文件与 B 站等功能大多默认关闭或需额外 provider，开启前阅读 docs/CONFIG.md 对应小节。

适用场景与注意¶

适合谁：需要在 DSH 上跑 QQ 机器人、并希望人格/记忆/认知数据与 Harness 同机持久化、用网页面板管理的开发者；已具备 OneBot v11 网关与 DSH 0.2.x 环境。

权限与安全：插件与 DSH 同进程、以本机 DSH 进程权限运行，可读写作业区与配置；安装前应阅读源码、MIT 许可证及「安全」页说明。备份快照含密钥与认知隐私，需按秘密保护处理；恢复备份前宜停止写入并按文档重启。

能力边界：身份登记、QQ 管理审批、只读操作员扩展、语义检索、部分 QQ 通知与真实网关行为等在 README 中多处标注为 partial、未发布或仅 fake/离线测试。生产环境上线前应对照 docs/RELEASE.md 与 docs/cognitive/IMPLEMENTATION-STATUS.md，不要假设未验证项已可用。

社区插件目录 SkillHub 与 GitHub 仓库 reina0721/dsh-neobot 为独立收录入口；安装包发布路径当前指向 reina0721/dsh-bot 的 Release，与目录名称并存时以 Release 文档中的 URL 为准。

结尾¶

dsh-bot 把 QQ（OneBot v11）、多人格认知与 DSH 管理界面连在一起，适合在 Harness 0.2.x 上本地部署、以主人命令和面板驱动运维。进一步细节见仓库 docs/USER-MANUAL.md、docs/INSTALLATION.md 与 docs/DEMO.md。

• 目录页：https://www.skillhub.cn/plugins/reina0721/dsh-neobot
• GitHub：https://github.com/reina0721/dsh-neobot
• 安装包（README 原文）：https://github.com/reina0721/dsh-bot/releases/download/v0.11.26/dsh-bot.tgz