前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在構建插件時，開發者需要同時處理宿主兼容性檢查、風險等級評估（R0–R3）、權限申請、工具卡片契約設計以及商城上架合規性。手動處理這些環節容易遺漏細節或引入風險。
build-dsh-plugin 提供了一套標準化的工作流。它將自然語言或結構化的 Brief 轉換爲可執行的插件方案、源碼工程和驗收流程，並將安全默認值、證據門檻和商城兼容性要求固化爲開發約束。
它是什麼¶
這是一個面向 DeepSeek Harness (DSH) 插件開發的可複用 Agent Skill 與 DSH 原生 Skill Provider Bundle。
維護者：AI-Scarlett
許可證：MIT License
它主要解決從需求到上架過程中的碎片化問題：將開發流程拆解爲工程生成、風險審計、卡片契約設計和商城結構構建，確保插件從開發第一天起就符合 DSH STORE 的規範。
核心能力¶
1. Brief 轉換與工程生成¶
輸入當前問題、期望結果和成功標準，插件會補齊安全默認值，並輸出插件源碼工程、工具卡片契約、審計步驟和發行流程。
2. 風險與兼容性分析¶
在生成代碼前，會判斷 DSH 宿主兼容性，評估 R0–R3 風險等級。針對註冊模型 Tool 的插件，會設計符合 DSH 規範的卡片契約，包括 JSON 輸出規範、意圖定義 (presentCall/presentResult) 和持久化投影。
3. 商城兼容結構¶
從開發第一天保持商城兼容結構。對於準備上架的插件，它會將第三方倉庫分流爲 direct、monorepo、adapter-required 或 blocked，並生成與可信安裝庫物理分離的發現候選。
安裝¶
安裝到 DSH 時，使用的是倉庫根目錄的標準 Bundle。爲了不影響真實環境，建議在一次性 Profile 中進行驗收。
export DSH_HOME="$(mktemp -d)"
dsh plugin --profile build-plugin-e3 add /absolute/path/to/build-dsh-plugin-repository
dsh --profile build-plugin-e3 --dump-config
上述命令會安裝一個 Provider，該 Provider 僅掃描本倉庫的 build-dsh-plugin/ 目錄。配置中應包含唯一條目 dsh-build-plugin-skill-provider。
依賴要求：
* DSH 版本：>=0.1.0-rc.8 <0.2.0
* Node.js 運行時：>=22.13.0
使用¶
安裝成功後，即可在 DSH 中調用該 Skill。通過提供 Brief，獲取完整的插件設計方案。
示例 Brief：
當前問題：會話很多時，很難快速找到失敗或長期無響應的任務。
期望結果：在 DSH 設置頁看到異常會話及原因摘要。
成功標準：一次性 Profile 中頁面可見；異常夾具分類正確；真實 Profile 保持不變。
插件將基於上述 Brief 輸出分析報告、優勢劣勢、適用條件以及執行步驟。
邊界與約束¶
爲了保證安全和一致性，該插件在設計上有明確的邊界：
- 不修改核心：構建標準 DSH Bundle 時，不修改 DSH 源碼或
@deepseek-ai/*包，也不禁用、替換或遮蔽官方插件清單。 - 只讀優先：只讀優先原則。真實 Profile、重啓、憑據、設備及公網操作必須單獨滿足條件並授權。
- 隔離測試：測試只使用一次性 Profile/夾具，不寫入真實
~/.dsh。 - 商城上架要求：若要上架 DSH STORE，必須滿足：公開 GitHub 倉庫、40 位固定 Commit、匹配的 manifest/Patch/Entry ID/生命週期/許可證和保守權限元數據。
相關鏈接¶
- 目錄頁：https://www.skillhub.cn/plugins/AI-Scarlett/build-dsh-plugin
- GitHub 倉庫：https://github.com/AI-Scarlett/build-dsh-plugin
- 官方文檔：https://dsh.store/build/
