前言¶

在 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