前言¶

做 DSH 智能體時，日常配置不一定只有模型調用。環境變量、密鑰、MCP 服務器、Prompt、Profile、RSS 新聞、全局搜索、Codegraph 查詢、終端調試，都是開發過程中會反覆用到的入口。

dsh-plugin-kit 把這些常見入口做成一組 DSH Web GUI 插件卡片。它不替代 DSH 核心能力，而是通過官方 profile 機制掛載到 dsh web，給 Web GUI 增加一批可直接配置的插件。

下面介紹它的定位、安裝方式、核心功能和需要留意的限制。

這是什麼¶

dsh-plugin-kit 是 DeepSeek Harness（DSH）Web GUI 的插件全家桶。

它包含以下能力：

• 環境變量 / 密鑰管理
• MCP 服務器配置
• Prompt 管理
• Profile 管理
• 全局搜索
• Codegraph 集成
• 終端面板
• RSS / 新聞聚合
• 插件開發腳手架

倉庫由 hyzyn 維護，許可證爲 MIT。GitHub 地址是：

https://github.com/hyzyn/dsh-plugin-kit

所有插件都走官方 profile 機制掛載到 dsh web，不改 DSH 源碼。

安裝與啓用¶

先確認已安裝 DeepSeek Harness，並能啓動 dsh web。

從 npm 安裝無額外要求；從倉庫安裝需要：

Node.js >= 22.19
pnpm 10

安裝聚合包：

dsh plugin --profile web add @hyzyn/dsh-all

然後重啓：

dsh web

經過上面的步驟後，打開“設置 → 插件”，可以看到對應插件卡片。

package.json 顯示當前版本爲：

0.1.6

packageManager 爲：

pnpm@10.30.3

核心功能¶

環境變量 / 密鑰管理¶

這個插件用於在 Web GUI 裏管理環境變量和密鑰。

打開入口：

設置 → 插件 → 環境變量 / 密鑰管理

添加鍵值後，敏感條目勾選“密鑰”，再保存。保存後立即寫入當前進程的 process.env。

持久化位置：

~/.dsh/env.yml

該文件裏的託管區塊由插件維護，不建議手工修改。鍵名只允許字母、數字、下劃線，且不能重複。

MCP 服務器配置¶

這個插件用於給 DSH 添加 MCP 服務器。

打開入口：

設置 → 插件 → MCP 服務器配置

支持添加：

stdio
streamable-http

建議先點“連接測試”，再保存。保存後 1~2 秒內熱加載爲：

mcp__<服務器名>__<工具名>

持久化位置：

~/.dsh/cordis.patch.yml

這裏有一個明確限制：不要手工往該文件裏追加插件行，否則啓動時報：

duplicate loader entry id

進程會直接退出。

Prompt 管理¶

這個插件用於管理 Prompt。

打開入口：

設置 → 插件 → Prompt 管理

可以新建、編輯 Prompt，並啓用。

支持：

• 版本切換 / 回滾
• A/B 測試
• 導出 JSON / Markdown
• 從 JSON 導入

持久化位置：

~/.dsh/prompts.yml

限制：

• 每個 Prompt 至少一個版本
• 單版本內容 ≤ 500KB

Profile 管理¶

這個插件用於查看和維護 DSH profile。

打開入口：

設置 → 插件 → Profile 管理

可查看：

~/.dsh/profiles

下的全部 DSH profile。

支持：

• 創建
• 複製
• 重命名
• 刪除
• 爲每個 profile 設置端口
• 複製帶 --port 的啓動命令

持久化位置：

~/.dsh/profiles/<name>

注意：刪除是遞歸刪除。內置的 web 默認 profile 不允許刪除；headless 可以刪除。

全局搜索¶

安裝後，在側邊欄“新建會話”下方會出現全局搜索框。

輸入關鍵詞，可以搜索歷史會話與設置面板。

點擊會話會打開並嘗試定位到匹配文字；點擊面板條目會跳轉到對應設置卡片。

這個功能依賴宿主已安裝的 sessionQuery 服務。缺失時，會話搜索返回空列表。

如果 session-query 全文索引配置爲：

openAt: "never"

歷史會話會自動降級爲逐會話掃描。

Codegraph 集成¶

這個插件用於代碼圖譜查詢。

打開入口：

設置 → 插件 → Codegraph

支持：

• 查看索引狀態
• 搜索符號
• 查看 callers / callees / impact
• 手動 Sync / 重建索引

安裝後會自動向 systemPrompt 注入 CodeGraph 使用指引。

查詢目標項目需要先有 Codegraph 索引。索引 / 重建是本地 CLI 操作，會消耗真實磁盤與 CPU。

一臺 codegraph MCP 服務器同一時刻只掛載一個默認項目；其它已索引項目可在工具調用裏傳 projectPath 查詢。

終端面板¶

安裝後重啓：

dsh web

在側邊欄點擊“終端”，會打開內嵌 xterm.js 大彈窗。

可以新建、關閉多標籤頁真實 PTY 終端。

已知限制：

• resize 依賴 DSH 內部 terminal handle 結構
• 輸出爲 utf8 文本流，cat 二進制文件會出現替換字符

RSS / 新聞聚合¶

安裝後，可在側邊欄“新建會話”下方點擊“今日值得讀”查看新聞。

也可以打開：

設置 → 插件 → RSS / 新聞聚合

支持：

• 勾選內置渠道
• 添加自定義渠道
• 從訂閱源目錄搜索並一鍵添加

首次安裝啓動時會聯網抓取一次。

某個源不可達時，會在 digest 的“抓取失敗”裏列出，不影響其它源。

插件開發腳手架¶

dsh-plugin-kit 包含插件開發腳手架，用於生成新的 DSH 插件。

倉庫提供了以下門禁命令：

pnpm typecheck
pnpm build
pnpm aggregate

典型用法¶

先安裝聚合包：

dsh plugin --profile web add @hyzyn/dsh-all

再重啓：

dsh web

進入 Web GUI 後，按下面順序使用：

1、打開“設置 → 插件”。

2、選擇需要的插件卡片，例如“環境變量 / 密鑰管理”或“MCP 服務器配置”。

3、按卡片要求填寫內容。

4、保存後觀察插件給出的狀態，例如 MCP 熱加載、環境變量寫入 process.env。

如果要維護多套環境，使用“Profile 管理”。
如果要查看新聞，使用“RSS / 新聞聚合”。
如果要定位歷史內容，使用側邊欄全局搜索框。

適用場景與注意¶

適合：

• 需要把 DSH 常見配置放到 Web GUI 中管理的開發者
• 需要維護多套 DSH profile 的人
• 需要集中配置 MCP 服務器、Prompt、環境變量和密鑰的人
• 需要給 DSH Web GUI 增加終端、新聞聚合、全局搜索或 Codegraph 入口的人
• 需要基於 DSH 插件機制開發新插件的開發者

注意：

• 插件會掛載到 dsh web 並參與 DSH 進程運行。安裝前應檢查源碼；許可證爲 MIT。
• 以下文件的託管區塊由插件維護，不建議手工編輯：
• ~/.dsh/env.yml
• ~/.dsh/cordis.patch.yml
• ~/.dsh/prompts.yml
• 手工追加 ~/.dsh/cordis.patch.yml 中的插件行，會導致 duplicate loader entry id
• Profile 刪除是遞歸刪除；內置 web profile 不允許刪除
• 全局搜索依賴 sessionQuery 服務；缺失時會話搜索返回空列表
• Codegraph 索引與重建是本地 CLI 操作，會消耗磁盤與 CPU
• 終端面板輸出爲 utf8 文本流，二進制內容可能出現替換字符

結尾¶

dsh-plugin-kit 的價值，是把 DSH 常見配置和日常調試入口做成一組 Web GUI 插件卡片。

先安裝聚合包：

dsh plugin --profile web add @hyzyn/dsh-all

再重啓：

dsh web

然後在“設置 → 插件”裏按需啓用。

GitHub：

https://github.com/hyzyn/dsh-plugin-kit