前言¶
DeepSeek Harness (DSH) 採用插件化架構，允許通過插件擴展功能。dsh-plugin-qq-groupmate 是一個由用戶 lilith1257 維護的開源插件，其核心作用是將 DeepSeek Harness 中的 AI 模型通過 OneBot 11 協議接入 QQ 羣，使其以普通羣友的身份參與對話。
該插件解決了在 QQ 羣中部署私有化或特定人設 AI 的需求，支持按羣獨立配置角色與模型，並提供可視化的設置界面。
功能概覽¶
該插件主要包含以下能力：
- OneBot 11 接入：支持正向和反向 WebSocket 模式，兼容 NapCat、SnowLuma、LLOneBot、Lagrange、go-cqhttp 等主流協議端。
- 角色卡系統：支持定義人設、性格、說話風格及示例對話，兼容 SillyTavern V2 卡片格式及原生 JSON 格式。
- 按羣獨立配置：每個羣可單獨指定角色、模型、觸發規則和上下文長度，互不干擾。
- 靈活的觸發控制：支持被 @、關鍵詞前綴、概率接話、冷卻機制，並支持對私聊消息進行響應。
- 上下文與記憶管理：包含多輪上下文處理和基於金字塔算法的長期記憶壓縮功能。
- 內置命令系統：支持自定義命令前綴，提供幫助、角色切換、印象管理、提醒、貼紙、天氣、塔羅等功能。
- 可選生圖功能：當模型輸出
[生圖:標籤]時，可自動調用 Nai2API 兼容服務生成圖片。 - 可選語音回覆：基於本地 GPT-SoVITS 合成中文或日文語音，支持根據情緒自動切換參考音。
- 本機可靠路由：針對時間、日期、星期等查詢，直接由本機回答，不消耗模型額度。
- 可視化設置：所有配置均可在 DSH 的設置頁修改，即時生效，無需重啓。
安裝與啓用¶
安裝前需確保 DSH 已安裝，且系統 PATH 中包含 pnpm（dsh plugin 爲 pnpm 轉發器）。
1、執行以下命令安裝插件（web 爲 profile 名稱，請根據實際使用修改）：
dsh plugin --profile web add github:lilith1257/dsh-plugin-qq-groupmate
2、安裝完成後，dsh 會自動將此插件打包進 profile，無需手動修改配置文件，重啓 DSH 即可生效。
3、更新或卸載插件的命令如下：
dsh plugin --profile web update dsh-plugin-qq-groupmate
dsh plugin --profile web remove dsh-plugin-qq-groupmate
配置與接入¶
插件默認使用反向 WebSocket 模式，在本機 127.0.0.1:3001 監聽，等待協議端連接。
1、在協議端（如 NapCat、SnowLuma）的網絡配置中添加反向 WebSocket 地址：
ws://127.0.0.1:3001
2、若需使用正向 WebSocket 模式（插件主動連接協議端），需在 DSH 插件設置頁將 mode 改爲 forward，並填入協議端的 WebSocket 地址。
3、接入方式配置（mode）、監聽端口（listenPort）、WebSocket 地址（wsUrl）等參數均在 DSH 設置頁的可視化界面中修改。
角色卡與記憶¶
插件的數據目錄默認爲 ~/.dsh/qq-groupmate（即 DSH_HOME/qq-groupmate）。
1、角色卡：將 JSON 格式的角色卡文件放入 characters/ 目錄，文件名去掉擴展名即爲角色 ID。插件隨包自帶 characters/default.json 示例卡。支持 SillyTavern V2 格式。
2、記憶與上下文：插件支持多輪上下文和長期記憶。長期記憶採用金字塔壓縮算法，以減少 token 消耗並保留重要信息。
可選功能¶
插件提供生圖和語音功能的可選支持，但需要手動準備相關服務。
1、生圖功能：在設置頁配置 imageGen.baseUrl（服務地址）和 imageGen.token（密鑰）。需自備 Nai2API 兼容服務。
2、語音回覆：在設置頁配置 voice.endpoint（中文接口，默認 http://127.0.0.1:9880/tts）和 voice.language（語言選擇，支持 auto/zh/ja）。需自備 GPT-SoVITS 服務。
注意事項¶
- 個人項目：本項目爲個人自用項目，不承諾兼容性與技術支持。
- 依賴環境：依賴 DSH 已安裝且 PATH 中有 pnpm。
- 外部服務：生圖和語音功能需用戶自行搭建並維護 Nai2API 和 GPT-SoVITS 服務。
- 許可證：隨包的
knowledge/rp-hub-faq.md按 CC BY-NC 4.0 授權。
結語¶
dsh-plugin-qq-groupmate 通過 OneBot 11 協議爲 DeepSeek Harness 提供了接入 QQ 羣的完整解決方案。它強調配置的靈活性與獨立性，適合希望在 QQ 羣中部署特定人設 AI 的開發者或使用者。
- 項目主頁: https://github.com/lilith1257/dsh-plugin-qq-groupmate
- 社區目錄: https://www.skillhub.cn/plugins/lilith1257/dsh-plugin-qq-groupmate
