前言¶

DeepSeek Harness（DSH）以“一切皆插件”作爲擴展方式，第三方插件可以進入同一個 Harness 進程。第三方插件在 manifest、源碼結構、命名與權限邊界上不一定一致，開發或部署時容易出現兼容問題。

dsh-plugin-design 是面向 DSH 第三方插件生態的 Plugin Design / Migration / Compliance Agent：先發現並檢查插件，再對照 DH-TP-SDK 做靜態分析，生成 design.md；在用戶確認後，再進入修改、備份與回滾流程。

它屬於 DSH 第三方插件生態，目錄頁可作爲入口，但不代表 DeepSeek 官方應用商店。

這是什麼¶

dsh-plugin-design 是一個面向 DSH 第三方插件的規範分析與改造輔助插件。它由 huabai-flowerwhite 維護，採用 MIT 許可證，package.json 版本爲 1.1.0。

它不替代人工判斷，也不做權威認證。它把常見檢查項整理爲兩階段工作流：階段 1 只讀分析，階段 2 在確認後執行。

核心功能¶

• 發現第三方插件，並檢查其源碼與配置。
• 對照 DH-TP-SDK 工程化規範做靜態分析。
• 生成 design.md，把擬修改項落到文檔中。
• 經用戶確認後，對插件逐項修改。
• 支持備份與回滾。
• Host 半體提供 10 個 dshpd_* 模型工具：

dshpd_discover
dshpd_inspect
dshpd_analyze
dshpd_design
dshpd_approve
dshpd_backup
dshpd_apply
dshpd_rollback
dshpd_status
dshpd_report

• Client 半體提供 Settings 設置頁，用於展示使用方法、兩階段工作流、工具清單與安全邊界。
• 提供 DH-TP-SDK 規範冒煙測試：

npm test

等價於：

node --test

自動發現 tests/ 下的 .test.mjs。

注意：DH-TP-SDK 的 Bronze/Silver/Gold、P0–P4、S0–S4 是工程化規範等級，不是 DeepSeek 官方認證。

安裝與啓用¶

在獲取插件目錄後，按安裝命令執行：

git clone <你的倉庫> dsh-plugin-design
cd dsh-plugin-design
bash install.sh

安裝完成後，重啓 DSH：

Ctrl+C 後重新 npx dsh web / dsh web

重啓後即可完整使用：

• 聊天框擁有 10 個 dshpd_* 工具；
• 「設置 → dsh plugin design」出現設置頁，可用於選擇文件夾掃描第三方插件。

兼容信息：

• 對齊 @deepseek-ai/dsh 0.1.1-rc.2。
• Harness 版本要求爲 >=0.1.1-rc.2。
• apiLevel 爲 1。

典型用法¶

在聊天框中可以直接給出任務邊界：

使用 dsh plugin design 插件，輸出對 <插件名> 插件進行規範修改的 design.md 文件，然後詢問我意見後進行規範修改

兩階段工作流如下。

階段 1（只讀分析）：

discover → inspect → analyze → design

該階段生成 design.md，不修改源碼。

階段 2（確認後執行）：

approve → backup → apply → rollback / report

其中 approve 是門控，backup 用於備份，apply 用於逐項原子替換，失敗時可走 rollback，並可由 report 輸出結果。

適用場景與注意¶

適合在以下場景使用：

• 接手一個 DSH 第三方插件，想先查看它的規範差異；
• 需要對插件做規範化改造，但不希望直接盲改；
• 希望修改前有 design.md、修改前有備份、失敗後可回滾；
• 需要把靜態分析結果作爲改造依據，而不是直接當作認證結論。

使用前需要知道：

• 該插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
• Security Level 爲 S2，Permission Level 爲 P2：需要讀寫目標插件的 workspace 文件。
• 網絡/子進程/shell/密鑰默認全部關閉：

network.outbound: false
subprocess.enabled: false
shell.enabled: false
credentials.access: false

• 不修改 Core，不用 private API，不改 globalThis/原型。
• 靜態分析是啓發式規則，不是權威認證。
• manifest 解析是啓發式解析，不是完整 YAML 解析。
• 任務狀態（approval、backup、journal）是進程內內存態，進程重啓即失效。
• git 狀態/測試運行依賴 Agent 側 shell 工具，插件自身不直接跑 shell。
• 多插件共存時，需要保證包名/row id/slot id、模型工具名、HTTP 路由前綴全局唯一。
• 本插件尚未遷移到「插件配置卡片」檔位，當前爲純說明頁。

結尾¶

dsh-plugin-design 的價值不在“自動改對”，而在把第三方插件改造拆成可審查的步驟：先分析，再設計，再確認，再備份，再執行，最後可回滾。

• 目錄頁：https://www.skillhub.cn/plugins/huabai-flowerwhite/dsh-plugin-design
• GitHub：https://github.com/huabai-flowerwhite/dsh-plugin-design