前言¶
在 DeepSeek Harness（DSH）上做插件，常見難點不在「會不會寫代碼」，而在擴展點選錯、配方（recipe）結構不對、本地裝不上或 slot 一跑就崩。官方文檔分散，命令行與 UI 擴展形態又多，從零搭一套可驗證的插件往往要反覆查規範、改目錄、再試安裝。
下面介紹 SkillHub 上的 DSH插件開發助手（@davtime/dsh-plugin-studio）。它面向「要在 DSH 上創建、擴展、驗證或發佈插件」的場景，把需求澄清、形態決策、配方裝配、代碼生成、本地驗證、安裝冒煙與發佈串成一條可跟進的流程；也覆蓋插件不加載、服務注入失敗、樣式丟失等排障訴求。
這是什麼¶
DSH插件開發助手 是發佈在 SkillHub 上的 Agent Skill，座標 @davtime/dsh-plugin-studio，當前版本 v1.0.2，分類爲 dev-programming，來源標註爲 enterprise，發佈者爲 達維。頁面標註 requires_api_key=false，安裝該 Skill 本身不要求額外 API Key。
Skill 基於通用 SKILL.md 格式：安裝後由 AI Agent 讀取技能說明，在用戶提出 DSH 插件相關目標時按技能內工作流執行，而不是單獨提供一個本地 GUI 或 CLI 二進制。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/davtime/dsh-plugin-studio
- API 座標頁：https://api.skillhub.cn/davtime/dsh-plugin-studio
核心功能¶
以下能力均來自 SkillHub 簡介與頁面說明，未單獨列出的細節不在本文展開。
端到端開發流程¶
從用戶給出的「一句話功能描述」出發，技能側引導完成：
- 需求澄清：把模糊目標收成可實現的插件能力邊界。
- 形態決策：在命令/工具、HTTP、服務、事件、定時任務、設置面板、工作區/儀表盤、狀態欄、根佈局替換等形態中選定合適組合。
- 配方裝配：按 DSH 插件約定組織 recipe 與擴展點。
- 代碼生成：產出與所選形態匹配的插件代碼骨架與實現要點。
- 本地驗證：在本地環境做構建與基本校驗。
- 安裝冒煙：安裝到 Harness 後做最小可用性檢查。
- 發佈：在流程末尾銜接發佈相關步驟（以技能內說明爲準）。
支持的插件能力類型¶
簡介中明確覆蓋的常見能力包括：
- 命令 / 工具（commands / tools）
- HTTP 接口
- 服務提供（service provision）
- 事件訂閱
- 定時任務
- 設置面板
- 工作區 / 儀表盤
- 狀態欄
- 根佈局替換
排障場景¶
同一 Skill 也用於排查典型運行時問題，例如：
- 插件不加載
- slot 崩潰
- 服務注入失敗
- 樣式丟失
具體診斷步驟以安裝後的 SKILL.md 與工作流爲準。
安裝與啓用¶
方式一：讓 AI 按官方安裝文檔執行¶
SkillHub 頁面給出的提示詞爲：請 Agent 根據安裝文檔完成安裝。
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@davtime/dsh-plugin-studio`。
Agent 會按 SkillHub 安裝與優先源配置 檢查 skillhub CLI、選擇當前環境的 skills 目錄並執行安裝。
方式二：手動使用 skillhub CLI¶
先確認 CLI 是否已安裝：
command -v skillhub && skillhub --version
未安裝時，可按官方文檔執行完整安裝（節選）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝技能時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。官方文檔列出的常用路徑包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
示例（將 <skills 目錄> 換成上面對應路徑）：
skillhub install @davtime/dsh-plugin-studio --dir <skills 目錄>
安裝後按所用客戶端要求重啓或刷新 Agent，使新 Skill 被加載。
典型用法¶
公開頁面未附帶獨立的長篇教程或可複製的一鍵命令示例；典型用法即：在已啓用該 Skill 的對話裏，用自然語言說明 DSH 插件目標，由 Agent 按技能工作流推進。
可參考的表述方式：
- 新建插件：說明一句話功能，例如「在 DSH 里加一個定時同步某 API 的狀態欄指示器」，並註明希望用到的擴展類型（若已確定）。
- 擴展現有插件：說明當前插件做什麼、要新增的能力，以及是否已遇到加載或 slot 問題。
- 驗證與發佈：說明本地是否已能構建、安裝是否失敗、需要冒煙檢查還是走發佈步驟。
- 排障：直接描述現象（不加載、slot 崩潰、服務注入失敗、樣式丟失等）及已嘗試步驟，便於技能側對照 DSH 插件約定排查。
經過上面的步驟，Agent 應依次推進澄清、形態與配方、生成代碼、本地驗證與安裝檢查；具體命令與文件路徑以會話中技能輸出爲準，本文不編造未在官方資料出現的配置項或案例。
適用場景與注意¶
適合誰
- 需要在 DeepSeek Harness（DSH） 上交付或維護插件的開發者。
- 希望用對話把「想法 → 配方 → 代碼 → 本地驗證 → 安裝」串起來，而不是隻靠零散文檔手寫全流程的人。
- 遇到插件加載、slot、注入、樣式等問題，希望按 DSH 插件模型系統排查時。
使用注意
- 本 Skill 描述的是 Agent 側工作流，不能替代本機 DSH / Harness 運行環境與官方插件規範；本地仍需具備對應的構建與安裝條件。
- SkillHub 頁面統計（截至抓取）：評分 100000，下載 20103；與第三方轉載的數字可能不一致，以 SkillHub 爲準。
- 安裝目錄錯誤是常見坑：務必
skillhub install ... --dir指向當前客戶端的 skills 路徑。 - 未在官方資料中寫明的 Cursor / Codex / Claude Code 差異化配置，本文不臆測；差異主要體現在 skills 目錄路徑上。
結尾¶
DSH插件開發助手 把 DSH 插件從需求到發佈（及常見故障）收成一條 Agent 可執行的技能鏈，適合從「一句話功能」起步、又要覆蓋多種擴展形態的場景。需要安裝或查看說明時，請打開 SkillHub 官方頁面：https://www.skillhub.cn/skills/davtime/dsh-plugin-studio
