前言¶
DeepSeek Harness 插件如果只部署在 Web 入口,接入 IM 渠道時容易再次維護一套獨立的提示詞、記憶和歷史上下文。多平臺分開配置後,同一個助手在不同入口的行爲會不一致:一邊改了人設,另一邊還沿用舊提示詞;一邊有長期記憶,另一邊無法讀取。
下面介紹 @stu-xie/dsh-message。它是面向 DeepSeek Harness 的插件,把微信、飛書、QQ、企業微信和釘釘統一接入同一個 DSH 助手,並提供共享提示詞、記憶與會話能力。
這是什麼¶
@stu-xie/dsh-message 的定位是 DSH 消息接入插件:一個插件承接多個 IM 入口,讓同一個 DSH 助手在不同渠道間共享提示詞、長期記憶、會話上下文和模型策略。
它主要解決這幾個問題:
- 多個 IM 渠道分散接入,配置重複;
- 不同入口的提示詞、記憶和歷史不共享;
- 需要手動處理連接狀態、重連和多機器人管理;
- IM 渠道里使用 Web 選項卡交互不順手。
許可證爲 MIT。
核心能力¶
這個插件圍繞“一個助手、多個入口”展開,下面列出已覈實的能力。
五渠道統一接入¶
支持以下渠道:
- 微信
- 飛書
- 企業微信
- 釘釘
插件使用統一 Host / Client 架構,並提供 React 設置頁,用於集中查看和管理渠道接入、助手設置與運行狀態。
共享提示詞、記憶與模型策略¶
插件會共享以下能力:
- 共享提示詞
- 靈魂設定
- 行爲規則
- 長期記憶
- 模型策略
這意味着同一個助手在多個 IM 入口之間可以保持一致的人設、規則、記憶和模型選擇策略。
接入方式¶
支持掃碼或官方機器人憑據接入。不同渠道可在設置頁中按引導完成配置。
運行能力¶
插件支持以下運行能力:
- 流式回覆
- 連接檢查
- 自動重連
- 多機器人管理
- 工作區與 Session 綁定
會話歷史記錄按 channel + botId + conversation 隔離,用於區分不同渠道、不同機器人和不同會話的上下文。
IM 渠道交互¶
IM 渠道使用編號選項交互,避免使用 Web 選項卡。適合手機端或聊天窗口中的直接輸入場景。
長期記憶¶
長期記憶支持:
- 新增
- 替換
- 刪除
- 去重
- 原子更新
可以在控制檯編輯 memory.md,也可以關閉長期記憶能力。
安裝與啓用¶
環境要求¶
先確認環境滿足以下條件:
- Node.js
22.19或更高版本 - 可用的 DeepSeek Harness
dsh命令已加入PATH,或已配置DSH_ROOT
先檢查 DSH CLI 是否可用:
dsh --help
從 npm 安裝¶
執行安裝命令:
npx -y @stu-xie/dsh-message install
安裝後啓動指定 profile:
dsh --profile web
啓動後進入設置中的插件消息接入入口:
- 設置
- 插件
- 消息接入
選擇需要的渠道,並按界面引導完成接入。
從源碼安裝¶
從源碼安裝時,先完成本地安裝和檢查:
npm install
npm run check
然後安裝到 DSH:
npm run install:dsh
如果只想安裝到指定 DSH profile,使用下面命令:
npm run install:dsh -- --profile web
卸載時使用:
npm run uninstall:dsh -- --profile web
卸載只移除插件,不會刪除機器人憑據、登錄狀態、提示詞、記憶或歷史數據。
源碼驗證¶
如果從源碼開發或修改,可以執行測試與構建:
npm test
npm run build
模型路由與默認權限¶
模型路由¶
插件的模型路由策略如下:
- 首輪使用
vllm/Qwen-3.8-Flash-Next的off檔位; - 複雜任務切換到
xhigh; - 主模型失敗時,兜底到
deepseek-official/deepseek-v4-flash。
路由變量可在本地 config/.env 中覆蓋;進程環境變量優先。如果本地 config/.env 仍寫着舊主模型 id,AgentService 啓動時會直接報錯。
默認權限¶
DSH Session 在業務消息前會強制校驗並切換爲 danger-full-access,對應:
- sandbox:
danger-full-access - approval:
never
這會關閉人工審批攔截。啓用前需要確認對應機器人入口和工作區在可控範圍內。
數據、遷移與卸載¶
數據目錄¶
數據目錄可能包含:
- 機器人憑據
- 登錄狀態
- 對話歷史
請勿把數據目錄提交到版本庫,也不要公開分享。
管理 RPC¶
管理 RPC 默認只允許 loopback。僅在可信遠程 Host 場景中,才配置:
"rpcAuthority": "trusted-host"
從舊版遷移¶
從舊版遷移會替換舊插件,但不會刪除舊數據。已存在的目標文件不會被覆蓋。
建議首次部署前備份 DSH_HOME。
適用場景與注意¶
適合以下場景:
- 已經在用 DeepSeek Harness;
- 需要把多個 IM 渠道接入同一個助手;
- 希望提示詞、長期記憶、會話上下文和模型策略保持一致;
- 希望在控制檯集中管理渠道和助手狀態。
啓用前需要注意:
- 插件會以當前
dsh進程的權限和配置運行; - 默認權限會關閉人工審批攔截,需要評估機器人入口和工作區風險;
- 數據目錄可能包含憑據和登錄狀態,不要公開;
- 安裝前應檢查源碼、依賴和許可證;
- 遷移不會刪除舊數據,但首次部署前仍建議備份
DSH_HOME。
資源鏈接¶
社區目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係,不應把它理解成官方應用商店。
目錄頁:
https://www.skillhub.cn/plugins/Stu-KatoMegumi/dsh-message
GitHub: