前言¶
在 DeepSeek Harness（DSH）裏做插件，常見卡點不在某一行業務代碼，而在形態選錯、掛載合同沒對齊、本地門禁沒過就急着改功能。官方文檔分散在合同、驗證和踩坑說明裏，自己拼一套「先規劃再腳手架再發布」的流程成本高。
下面介紹 SkillHub 上的 DSH插件腳手架（@user_62a0c738/dsh-plugin-scaffold）。它把需求澄清、三種插件形態決策、腳手架生成命令、業務實現約束、本地驗證與發佈準備串成帶決策門的 7 個階段，並附帶 references/ 裏的合同與驗證章節，適合讓 AI Agent 按同一套節奏帶你走完 DSH 插件全流程。
這是什麼¶
DSH插件腳手架 是一條面向 DeepSeek Harness 插件 的 Agent Skill：從規劃到發佈，覆蓋需求與形態決策、腳手架生成、業務實現、本地驗證、發佈準備和最終發佈。
- 座標：
@user_62a0c738/dsh-plugin-scaffold - 版本：1.0.0（社區來源，分類 dev-programming）
- 維護與源碼：goatbroai/dsh-plugin-scaffold
- SkillHub 頁面：DSH插件腳手架
- 標籤：
requires_api_key=false，安裝本 Skill 本身不需要 API Key
當你在對話裏要 規劃、創建、腳手架初始化、開發、驗證或發佈 DSH 插件/擴展，或問「如何端到端做一個 DeepSeek Harness 插件」時，Agent 會按 Skill 內 SKILL.md 的階段執行；若只是局部問題（例如掛載失敗），Skill 要求直接查 references/ 對應章節，而不是重跑全流程。
核心功能¶
以下能力均來自官方 Skill 說明與 GitHub 倉庫中的 SKILL.md，未超出已公開內容。
七個階段與決策門¶
全流程分爲階段 0～6，每階段有明確產出；上一階段未定論或未通過驗證，不得進入下一階段。階段決策持續寫入生成目錄中的 docs/plugin-plan.md。
| 階段 | 內容 |
|---|---|
| 0 | 明確插件名、一句話目標、能力面（工具/服務/HTTP/瀏覽器 UI/skill/MCP 等）、目標 profile（默認 web） |
| 1 | 按能力面選擇插件形態與分發方式（git / 本地目錄 / npm）、包管理器（默認 pnpm） |
| 2 | 調用腳手架腳本生成工程，並跑通 install / bundle / gates |
| 3 | 按選定形態實現業務（ctx.*、ctx.effect()、client slots 等） |
| 4 | 本地驗證：構建、門禁、npm pack --dry-run、安裝與瀏覽器冒煙 |
| 5 | 發佈準備：git remote、README ref、截圖、lib/ 提交、再次門禁 |
| 6 | 按分發方式發佈，並從最終源重裝驗收 |
三種插件形態¶
| 能力面 | 形態 | scaffold 參數 |
|---|---|---|
| 僅 Node 工具/服務/事件處理 | pure Cordis | --kind pure |
| 需要組合層或隨包分發多個掛載 | bundle | --kind bundle |
| Node half + 瀏覽器 client bundle | bundle-client | --kind bundle-client |
若需完全替換默認 web shell 根佈局，Skill 說明由 Agent 在實現階段通過 ctx.slots.register({ name: 'root' }) 等方式處理，腳手架無單獨參數。
腳手架與門禁¶
Skill 關聯倉庫提供 scripts/scaffold.py，用於生成帶構建腳本與門禁（pnpm run gates）的插件骨架。Skill 內還引用 references/contracts.md、gotchas.md、verification.md，分別對應 package/entry/client 合同、構建打包坑、安裝與瀏覽器驗證。
安裝與啓用¶
通過 SkillHub 安裝 Skill¶
先確認本機是否有 SkillHub CLI（見 SkillHub 安裝說明）。安裝本 Skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。
command -v skillhub && skillhub --version
未安裝 CLI 時，可按官方文檔執行完整安裝（示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
將 Skill 裝到對應客戶端目錄（路徑以你當前環境爲準）：
# Cursor 示例
skillhub install user_62a0c738/dsh-plugin-scaffold --dir ~/.cursor/skills/
# Claude Code 示例
skillhub install user_62a0c738/dsh-plugin-scaffold --dir ~/.claude/skills/
# Codex 示例（常見路徑之一）
skillhub install user_62a0c738/dsh-plugin-scaffold --dir ~/.codex/skills/
SkillHub 頁面也支持把下面提示交給 AI，讓其按安裝文檔拉取 @user_62a0c738/dsh-plugin-scaffold：
請根據 https://skillhub.cn/install/skillhub.md，安裝
@user_62a0c738/dsh-plugin-scaffold。
安裝後按你所用客戶端要求刷新或重啓，使 Skill 生效。本 Skill 不要求配置 API Key。
典型用法¶
啓用 Skill 後，在對話中說明你要做的 DSH 插件目標即可；Agent 應按階段 0 起逐步推進。下面摘錄官方 階段 2 的可復現命令（需在已克隆或已解壓的 dsh-plugin-scaffold 倉庫根目錄執行，或按 Skill 指引定位 scripts/scaffold.py）。
生成腳手架：
python3 scripts/scaffold.py <plugin-name> \
--out <output-directory> \
--kind <pure|bundle|bundle-client> \
--description "Short description"
進入生成目錄並驗證骨架：
cd <output-directory>/<plugin-name>
pnpm install
pnpm run bundle
pnpm run gates
三條命令全部通過後，再按階段 3 寫業務；改 src/ 後執行 pnpm run bundle，不要手改 lib/。
階段 4 本地驗證順序（官方）：
pnpm run bundle
pnpm run gates
npm pack --dry-run
隨後按 references/verification.md 做安裝冒煙與瀏覽器驗證。發佈階段按階段 1 選定的 git 或 npm 路徑執行 git push / npm publish，並從最終分發源重裝，確認無 plugin tree failed to load、無 slot entry crashed，且功能符合階段 0 目標。
適用場景與注意¶
適合誰
- 第一次在 DSH 上做插件，需要在 pure / bundle / bundle-client 之間做清晰選擇的人。
- 希望用統一門禁（
gates）和驗證清單，避免「能編過但裝不上、瀏覽器一打開就崩」的團隊或個人。 - 願意讓 Agent 按
docs/plugin-plan.md記錄決策、分階段推進，而不是零散改代碼的對話方式。
限制與注意
- 本 Skill 指導的是 DSH 插件工程 全流程；
scaffold.py與模板在 GitHub 倉庫中，安裝 Skill 不等於自動把腳手架腳本裝進你的插件目錄，生成步驟仍需在含該腳本的上下文中執行（通常由 Agent 按 Skill 說明操作）。 - 驗證失敗時，Skill 規定：業務問題回階段 3；形態或 contract 問題才允許回階段 1，避免在錯誤形態上堆功能。
- SkillHub 統計（截至頁面展示）：下載約 1498、安裝約 268；具體數字以 SkillHub 爲準。
結尾¶
DSH插件腳手架 把 DeepSeek Harness 插件從「想做什麼」到「從分發源重裝驗收」拆成 7 個帶決策門的階段，並綁定三種形態與腳手架、門禁命令，適合作爲 Agent 側的可重複 playbook。
- SkillHub：https://www.skillhub.cn/skills/user_62a0c738/dsh-plugin-scaffold
- API 座標頁：https://api.skillhub.cn/user_62a0c738/dsh-plugin-scaffold
- 源碼與 Skill 正文：https://github.com/goatbroai/dsh-plugin-scaffold
