前言¶
在 DeepSeek Harness（DSH）裏跑智能體，常見做法是自己在終端或 Web 裏對話，或再接一層自建網關。若希望模型以固定 QQ 身份回私聊、混羣、發語音和表情，還要把 B 站、空間、社區瀏覽等行爲收進同一套會話與工具裏，通常得自己拼 OneBot、權限和提示詞。Aurabot 是 DSH 的客戶端類插件：經 SnowLuma 或任意 OneBot v11 網關接上 QQ，在側欄提供整頁配置，並把聊天、人格、記憶和各功能拆成可開關、可替換的模塊。
這是什麼¶
Aurabot（包名 dsh-aurabot-qq，當前資料中版本 1.1.24，MIT 許可證）由插件倉庫維護，描述爲：DSH 裏的 AI 以獨立 QQ 號「大肥魚」住進 QQ——有人格、心情和記憶，能看圖、發語音、聽語音、收發表情包、翻唱、寫 QQ 空間、逛空間回評論、刷 B 站評論、刷小黑盒等，並會主動找主人聊天。
數據路徑在概念上可以記成：
QQ ⇄ SnowLuma（OneBot v11，需自行安裝）⇄ Aurabot 插件 ⇄ DSH 會話（插件 preset + 人格）
入口在 DSH 左側欄「自動化任務」下的 Aurabot；每個 QQ 私聊或羣對應側欄「Aurabot · QQ」工作區裏的一個 DSH 會話，可查看推理與工具調用，也可直接插話。
社區目錄頁：https://www.skillhub.cn/plugins/aureth-labs/dsh-aurabot-qq
源碼與說明：https://github.com/accomplish07zrh-eng/dsh-aurabot-qq
目錄站與 DeepSeek / 幻方無官方從屬關係；DSH 生態本身是「一切皆插件」，插件以你當前 DSH 進程權限運行，安裝前宜自行查看源碼與許可證。
核心功能¶
面板與安全默認¶
面板用標籤劃分：概覽、連接、人格、權限、聊天、模型、語音、表情包、生圖、空間日記、主動搭話、心情與記憶、翻唱、B 站、抖音、小黑盒、本地接口、擴展、日誌等。總開關默認關閉、試運行默認開啓——不手動打開總開關，一句都不會發到 QQ。
QQ 聊天與羣策略¶
羣聊裏停頓數秒計爲一段，回覆時先看完整段再回，避免一條一回；合併轉發會展開；拍一拍視爲對 bot 說話。被 @ 必回，無人 @ 時按話題相關度插話，並有防刷屏限制。主人可在 QQ 發 /silent、/active、/quiet、/chatty、/model、/sing、/remember、/status 等命令，總開關關着也能用。
人格通過插件 cordis.patch.yml 中的 preset（如私聊 aurabot-private、羣聊 aurabot-social）與 @deepseek-ai/dsh-persona 注入；心情、記憶追加在對話末尾，不破壞前綴緩存。記憶爲本地索引（中文二元切詞 + BM25，帶遺忘曲線與人物小檔案）；心情可關鍵詞或每輪模型判定，並影響表情、語音概率與回覆節奏。
模塊化擴展¶
除核心（配置、QQ 網關、聊天中樞、人格、權限、面板）外，每項能力都是模塊（內置在 src/modules/，用戶自定義放在數據目錄 modules/，升級不覆蓋、保存即生效）。同名模塊可替換內置行爲；掛鉤覆蓋羣聊決策、提示詞、回覆拆分、發送內容、模型選擇等。擴展說明見倉庫 src/modules/API.md，類型見 aurabot.d.ts（啓動時會複製到 modules/）。面板「擴展」頁支持模擬測試（截獲發送，不真發）。
語音、表情、空間與翻唱¶
- 語音：TTS 默認 edge-tts（插件自建 Python 虛擬環境）；可接 CosyVoice、GPT-SoVITS 等本地接口；Windows 裝不上 edge-tts 時可回退系統中文語音。ASR 先試 QQ 語音轉文字，再試 DSH
speechToText。 - 表情包：只收真實表情包消息，去重與限額後入庫；可關模塊，關後回覆裏的表情也不會真發。
- 空間：日記與互動（看評論、逛好友動態、按概率點贊評論等）走對應 QQ / 空間接口模塊。
- 翻唱：點歌或
/sing後走網易雲下載、人聲分離、RVC（Applio）換聲再混音發語音條；資料註明 RVC 翻唱目前僅支持 Windows。
B 站、抖音、小黑盒¶
- B 站：按興趣、記憶與面板關鍵詞搜視頻，讀簡介字幕熱評，可評論、私聊分享給主人或寫入經歷；主人發 B 站鏈接或卡片時用
bili_watch再看再聊。 - 抖音：獨立瀏覽器資料目錄 + CDP，需 Chrome / Chromium / Edge 且非無頭；無桌面環境需 Xvfb 等；權限默認僅主人，總開關默認關。
- 小黑盒：面板填 Cookie（須含
pkey；寫操作還需x_xhh_tokenid），可刷信息流、熱榜、搜索、點贊評論發帖等；發帖有三種風格diary/news/mix；內核對請求有統一限速。
模型與權限¶
「模型」頁支持按聊天選模型：私聊默認、羣聊默認、指定 QQ 或羣號，優先級爲指定私聊 > 指定羣 > 默認 > 全局；配置在 config.json 的 chatModels。 「權限」頁對每個寫操作單獨設置關 / 僅主人私聊（默認）/ 所有人；試運行只回話不真改資料。
QQ 網關¶
插件實現 OneBot v11 客戶端（HTTP + WebSocket）。Windows 上可用面板協助管理已自行安裝的 SnowLuma（插件不代下載、不代同意 EULA，僅啓停與注入機器人號進程）；Linux / Docker 或已有 NapCat、LLOneBot、Lagrange 等時，在嚮導填正向 WebSocket（及 token），連上後用 get_login_info 覈對是否爲機器人小號。
安裝與啓用¶
需要：DeepSeek Harness、一個作機器人的 QQ 小號、以及讓該號上線的 OneBot v11 網關。
Windows 桌面版：
& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add github:accomplish07zrh-eng/dsh-aurabot-qq
Linux / Docker（將 <profile> 換成實際 profile，容器內則在容器裏執行）：
dsh plugin --profile <profile> add github:accomplish07zrh-eng/dsh-aurabot-qq
裝好後重啓 DSH，打開 Aurabot 按嚮導操作：
- 填寫機器人 QQ 號（小號）與你的 QQ 號。
- 選擇網關：SnowLuma（Windows 需自行下載解壓並登錄機器人號後「接入機器人號」）或已有 OneBot（填 WS 地址與 token，可選 HTTP）。
- 先試運行，確認無誤再打開總開關上線。
升級：再執行上述安裝命令拉取最新版並重啓 DSH；設置、人格、記憶保留。
Linux / Docker 額外注意¶
- 語音依賴
python3-venv或 uv 以創建插件虛擬環境；無 Windows 自帶 TTS 兜底。 - 抖音需要可見瀏覽器環境；容器連宿主機 OneBot 時地址須容器可達，勿誤用僅本機有效的
127.0.0.1（若 OneBot 在別的網絡命名空間）。
插件要求 Node >=22.13.0（見 package.json 的 engines）。
典型用法¶
- 只聊天、不發社區：完成連接與人格後保持試運行或只開聊天相關模塊，總開關打開前在面板確認權限均爲「僅主人私聊」。
- 主人私聊管狀態：在 QQ 對 bot 發
/status看狀態，用/quiet、/chatty調節主動搭話，用/model切換當前會話模型（仍受面板「按聊天選模型」層級約束）。 - 自定義回覆鏈路：在數據目錄
modules/新增或替換模塊，按API.md掛接reply/send等鉤子；在「擴展」頁模擬一輪再上線。 - 小黑盒發帖：在「小黑盒」頁完成 Cookie 與登錄檢查，選默認發帖風格或單次指定
diary/news/mix，並在「權限」頁打開heybox_post等寫權限。
本地 TTS、生圖、翻唱換聲等可在「本地接口」頁生成示例腳本到數據目錄 local/，改完即生效，升級不覆蓋。
適用場景與注意¶
適合：已在用 DSH、願意用小號 + OneBot v11 網關、希望 QQ 側行爲與 DSH 工具、記憶、人格統一在一套插件裏的人。不適合：不想維護 QQ 網關、不接受 Cookie / 瀏覽器登錄態、或需要在純無頭 Linux 上完整使用抖音/RVC 的場景（資料已標明限制）。
再次強調：插件不默認向 QQ 發任何內容；SnowLuma 協議須本人勾選；所有社區寫操作都有獨立權限位。安裝與升級命令以 README 爲準，勿憑插件名自行拼接 github:owner/repo。
結尾¶
Aurabot 把 QQ 側「一個會持續生活的角色」收進 DSH：網關、會話、模塊和麪板在一處配置，能力可按需開關或自寫擴展。若要瀏覽分類與簡介，見社區目錄 https://www.skillhub.cn/plugins/aureth-labs/dsh-aurabot-qq；細節與變更以 GitHub 倉庫 README、docs/USER-MANUAL.md 與 CHANGELOG.md 爲準：https://github.com/accomplish07zrh-eng/dsh-aurabot-qq 。
