前言¶
DeepSeek Harness（DSH）是一個「一切皆插件」的智能體運行時，開發者可以把 Session、工具、記憶等能力封裝成插件，掛到任意前端。但大多數時候，人機交互還是依賴瀏覽器或命令行，需要打開網頁、切換標籤、複製粘貼對話上下文，對日常使用來說不夠順手。
cheems135/dsh-qq-bridge 是一個 QQ（NapCat / OneBot 11）橋接插件，把 DSH 的 Session 作爲「大腦」，QQ 作爲「嘴巴」，通過 WebSocket 把二者連在一起。裝好之後，你就可以直接在 QQ 裏跟同一個 Session 聊天，還能通過管理面板統一配置人設、記憶、素材、模型和自主行爲。
它是什麼¶
- 插件名：dsh-qq-bridge
- 維護者：cheems135
- 分類：模型推理
- 倉庫：https://github.com/cheems135/dsh-qq-bridge
- 簡介：QQ (NapCat / OneBot 11) bridge for DeepSeek Harness，附帶完整的管理面板
插件通過 NapCat 的 WebSocket 服務接入 OneBot 11，把 DSH 的 sessionController 創建的會話與 QQ 消息打通。回覆內容按 ||| 或空行拆成多條氣泡，每條間隔 0.6–2.8 秒，模擬打字節奏。
安裝與啓用¶
前置條件¶
- 已安裝 DeepSeek Harness，本插件作爲 bundle 加載
- 已安裝 NapCat，並在 NapCat 裏開啓 WebSocket 服務端（記下端口和 token）
- 一個能登錄的 QQ 小號
安裝命令¶
在 DSH 的插件管理裏執行：
dsh plugin --profile <你的 profile> add /path/to/this/repo
或者把本倉庫放入 profile 的 cordis.patch.yml 作爲 bundle 引用。
配置步驟¶
裝好後打開 DSH 的「設置 → QQ 橋接」，按面板引導：
- 填寫 NapCat 的 WebSocket 地址和 token（默認
ws://127.0.0.1:3001） - 在「聯繫人」頁把自己的 QQ 加入白名單，並設爲號主
- 在「概覽」頁點擊「本地快速登錄」，拉起 NapCat（隱藏窗口、無需 UAC，可選開機自動登錄）
- 發一條消息，看到回覆即連接成功
核心功能¶
聊天與人格¶
- 內置人設預設（
whale日常口語），可在面板直接編輯文本，保存即生效 - 自定義人設：名字 + 提示詞（固定使用 whale 底座），支持導入導出
- 「底層性格」：通用規則層，在所有人設之前生效（情緒安撫、按時間問候、看圖不描述畫面等）
- AI 生成人設：用一句描述讓模型寫出提示詞併入庫
- 試聊預覽：不經過 QQ，直接用人設提示詞問模型一次，檢查語氣
記憶¶
- 按輪數自動壓縮：聊到指定輪數後，把最近對話總結爲一段「給以後的自己看」的記憶，換新會話時帶進新會話
- 記憶文件和緩存目錄可遷移位置，換路徑不丟失配置
- 面板中可查看每條記憶的生成時間，支持單獨重壓或清除
素材：表情包與語音¶
- 本地表情庫：上傳表情、分組（支持批量勾選分組）、啓用/停用
- 觸發方式：情緒詞觸發時自動發圖，也可用
[表情包:名字]精確指定 [表情包:搜 關鍵詞]：手邊無合適圖時聯網搜圖、下載併發出- 語音：
[語音]標記後合成語音消息。引擎支持 edge-tts（微軟在線音色）或自定義 HTTP TTS（GPT-SoVITS / CosyVoice 等返回音頻字節即可） - 面板可直接試聽與對比音色樣本
查資料¶
[查:詞]→ 橋接去查 → 用她的口吻轉述- 搜索引擎可選：DSH 自帶 / 維基百科 API / DuckDuckGo API / 自建 SearXNG / 自定義 URL 模板；主引擎失敗時自動回退
- 以「查一下 X」開頭的消息會直接觸發查詢，不經過模型
號主模式¶
- 指定一個或多個 QQ 號爲號主，號主說話時獲得額外權限：
[發送:QQ號|內容]給白名單內某人發消息[羣發:內容]羣發[定時:分鐘|QQ號|內容]定時發送（最長 24 小時）- 發送前會清洗掉「號主讓我轉告」等歸屬信息，對方看到的是她在說話
- 三項權限可分別關閉；目標必須白名單內
模型與成本¶
- 智力檔位：
省 / 標準 / 高 / 最高（對應off / low / high / maxthinking 深度），切換會話時生效 - QQ 裏可用
/檔位 eco|standard|high|max切換 - 每個會話可單獨指定模型，其餘跟隨全局
- 面板按 DeepSeek 峯谷價實時記錄花費，可查看今日累計與單輪成本
自主行爲¶
插件不只是被動回覆，還能按規則自主決策（0.6x 起）：
- 主動找人：某個會話超過 2 小時沒動靜時主動搭話（每日上限可配）
- 發 QQ 空間：飯點 / 下班 / 深夜，有額度時發一條生活化說說（走 cookie + g_tk，非官方接口）
- 改個性簽名：心情不等同簽名時改一句（每日上限可配）
實現分爲兩層：代碼按規則判斷「該不該動」，模型只負責寫內容。面板「自主」頁有總開關、每類動作開關、每日額度、活躍時段、最小間隔、最近動作日誌和「緊急停止」。
- 「想法」頁：每次回覆後復盤「我當時在想什麼」，加上自主決策的理由，形成一條思考時間線
- 「模擬一天」：按五個時間點各判斷一次（不執行），30 秒看出她一天會不會動
- 內容底線：發送前會過敏感詞表 + 長度上限 + 禁止鏈接
運維¶
- 監聽頁：收發記錄按對話分組、按方向篩選，每 2 秒自動刷新，消息圖片可直接查看
- 存儲：日誌 / 監聽歷史 / 語音 / 表情包可整體遷移到別的盤，按類統計佔用，支持一鍵清理
- 連接可隨時停用（保留配置），恢復後自動重連
QQ 內可用的指令¶
| 指令 | 作用 |
|---|---|
/new |
結束當前會話，下條消息開新會話（保留記憶） |
/檔位 eco\|standard\|high\|max |
切換智力檔位並重開會話 |
[表情包:名字] / [表情包:搜 關鍵詞] |
發表情包 / 聯網搜圖 |
[語音] … |
合成語音發出來 |
[查:詞] |
查資料並用她的口吻回答 |
[發送:QQ號|內容] / [羣發:內容] / [定時:分鐘|QQ號|內容] |
僅號主可用 |
配置說明¶
cordis.patch.yml 中的 config 是初始配置；面板改過後以 profile 的 settings.json 爲準。
| 鍵 | 說明 |
|---|---|
wsUrl |
NapCat 的 OneBot 11 WebSocket 地址 |
accessToken |
NapCat 裏設置的 token，沒有則留空 |
allowUsers |
允許私聊的 QQ 號；留空則誰都不理 |
allowGroups / groupRequireAt |
允許的羣；羣裏是否必須 @ |
cwd |
會話工作目錄，省略則用 DSH 當前目錄 |
agentPreset |
新人設使用的預設 |
presetRev |
人設文本修改後需要 +1，纔會換新會話 |
model |
Session 級模型路由（provider / model） |
maxReplyChars |
單條消息上限，超過會拆成多條 |
greeting |
上線後主動打招呼的內容，留空則不發 |
selfTest |
用臨時會話自檢一次，結果寫日誌 |
面板裏還能配置：智力檔位、主動行爲（定時找你 / 沉默追問 / 說完補一句）、勿擾時段、搜索與語音引擎、號主與權限、記憶壓縮與存放位置、緩存位置、開機自啓。
環境變量¶
| 變量 | 作用 |
|---|---|
DSH_PRESET_DIR |
「查看/編輯預設人設文本」的目錄，查找 *-preset/cordis.patch.yml；不設則該項不可用（其它功能不受影響） |
DSH_IM_PYTHON |
edge-tts 用的 Python 解釋器；不設則依次查找 DSH 自帶運行時與 PATH 中的 python |
已知限制¶
- 一次只連一個機器人賬號：多賬號需切換，不能同時在線
- 部分能力面向 Windows：隱藏啓動 NapCat、開機自啓、SAPI 兜底音色；其它平臺能跑但用不了這幾項
- 沒有語音識別：她聽不了你發的語音消息，只處理文字和圖片
- 記憶壓縮是「總結式」的，不是向量檢索；壓過頭的細節可能找不回來
安全¶
- 白名單爲空時，她默認不理任何人
- 號主指令的目標必須白名單內，否則直接拒絕並記日誌
- 面板路由掛在 DSH 的本地 Web 服務上，只監聽本機
適用場景與注意¶
適合想直接在 QQ 裏使用 DSH Session 的開發者或個人用戶，尤其是需要統一管理人設、記憶、模型和自主行爲的場景。
插件以當前 DSH 進程的權限運行。安裝前應檢查源碼與許可證（MIT），確認行爲符合你的使用規範。
小結¶
dsh-qq-bridge 把 DSH 的 Session 從瀏覽器和命令行解放出來，接上了 QQ。它提供了完整的管理面板，覆蓋人設、記憶、素材、模型、自主行爲與監控。如果你已經用 DSH 做智能體開發，又希望在日常對話中直接使用同一套能力，這個插件可以作爲一條可用的連接路徑。
- 目錄頁：https://www.skillhub.cn/plugins/cheems135/dsh-qq-bridge
- 倉庫：https://github.com/cheems135/dsh-qq-bridge
