前言¶
在 DeepSeek Harness（DSH）裏，「幫我寫個插件」這類需求很常見。默認路徑往往是直接生成代碼，結果常與已安裝插件、市場目錄或 GitHub 上已有實現重複，主對話還會被檢索、拆解和生成過程撐得很長。
Plugcraft（dsh-plugcraft）把流程改成「先澄清需求、再查可複用實現、由你決定怎麼複用，最後纔在隔離子智能體裏補缺口並做結構校驗」。側欄裏有獨立工作臺頁面，階段和候選結果持續刷新，安裝前需要你確認。
下面按定位、能力、安裝與用法說明該插件；事實以 GitHub 倉庫 README 與 package.json（當前版本 0.12.0）爲準。
這是什麼¶
Plugcraft 是面向 DSH 的 reuse-first（複用優先）插件創作工作臺，維護者爲 lixian292，許可證爲 MIT。項目在社區目錄歸類爲 工作流。
它解決的核心問題：在寫新插件之前，先回答「是否真的需要從零新建」，並在安裝前對生成物做結構校驗，避免未經驗證就靜默安裝。
核心功能¶
工作臺對應一條固定流水線，側欄卡片上展示五步進度：澄清（clarify）→ 搜索（search）→ 決策（decide）→ 拆解（decompose）→ 構建（build）。
澄清與結構化需求¶
將自由文本需求整理爲結構化 spec，包含 surface、必須具備的能力、驗收標準與約束等字段，並保存在任務上供後續步驟使用。
四層複用檢索¶
搜索按「階梯」進行，由 Host 執行檢索與排序，不佔用主對話上下文：
- 已安裝的 DSH 插件
- 市場精選目錄（緩存目錄）
- GitHub 倉庫
- 倉庫詳情
README 說明：匿名 GitHub 搜索約 10 次/分鐘；配置只讀 token 可提高到約 30 次/分鐘（可選配置，詳見倉庫 Configuration 小節）。
四種複用決策¶
找到候選後，由用戶四選一，不由模型代決：
- Use as-is：直接採用現有實現
- DIY on top：在現有基礎上改
- Reference only：僅作參考
- From scratch：從零新建
拆解、交接與校驗¶
部分匹配時，將能力拆成 capability units，每項標記爲 reuse 或 gap。缺口交給 Creator 子智能體（cordis preset）在獨立上下文中生成。
生成 bundle 後做結構校驗（manifest、patch、client 入口、locale、icon、JavaScript 語法等），使用 node --check，不執行生成代碼。安裝須經你確認；任務最終以 done 或 install_failed 記錄。
側欄工作臺 UI¶
- 縱向 任務卡片：目標、階段、候選數量、最後更新時間；同一時間只展開一張卡片。
- 展開後：Overview（spec、搜索報告、決策、能力單元與交接摘要）、Candidates（默認五行，可「顯示全部」）、Plan & handoff（安裝 spec、Creator 狀態、校驗項、安裝結果）。
- 頁面數秒自動刷新，無單獨提交按鈕。
- 中文界面入口名：插件工作臺（英文：Plugcraft），與 Plugins、Market、Context insights 等並列。
主對話中智能體加載 plugin-workbench skill 並調用 plugin_workbench 工具後，頁面會與流水線同步更新。
安裝與啓用¶
環境要求（來自 README）：
- DSH 帶 Web UI：dsh >= 0.2.1-rc.2（在
0.2.2-rc.1上測試過） - Node.js：22.19+ 或 24+
從 GitHub 安裝（README 推薦，直至首個 npm 發佈）：
dsh plugin --profile <profile> add github:lixian292/dsh-plugcraft
從 release 壓縮包安裝（無需 registry 賬號）：在 latest release 下載 .tgz 後：
dsh plugin --profile <profile> add <path-or-url-to>/dsh-plugcraft-<version>.tgz
本地開發可在 DSH Plugins 頁通過絕對路徑安裝 bundle（例如經 plugin_manager 的 install_bundle）。README 註明計劃發佈 npm 包 dsh-plugcraft，首版發佈時 npm 註冊不可用，當前以 GitHub 與 release 包爲主渠道。
安裝完成後，在側欄打開 Plugcraft（插件工作臺）即可使用。
典型用法¶
- 打開 Plugcraft 頁面，對話過程中保持該頁打開。
- 在任意 DSH 對話中描述插件需求，例如 README 中的日曆側欄示例：月視圖、切換月份、高亮今天、事件本地保存等。
- 讓流水線運行；工作臺頁面會填入 spec、搜索結果與當前階段。
- 有候選時回答四選一決策問題。
- 按計劃跟隨能力單元與缺口；缺口生成後查看校驗結果，再確認安裝。
- 在 Plan & handoff 查看校驗與安裝結果。
便於觸發的說法（摘自 README）：
- 「是否已有能做 X 的 DSH 插件？用工作臺查一下。」
- 「爲 X 做插件，但先查已有實現。」
- 「用 plugin workbench 做這件事。」
適用場景與注意¶
適合：需要新 DSH 插件、又希望先查市場與 GitHub 是否已有可複用實現的用戶；希望檢索與生成離開主對話、且安裝前可看到結構校驗結果的開發者。
注意：
- 插件在 當前 DSH 進程的權限 下運行；安裝任何插件（含工作臺生成的 bundle）前，應自行閱讀源碼與許可證。
- 生成代碼僅做靜態結構檢查，不代表運行時行爲安全；是否安裝由你決定。
- 社區目錄 SkillHub 插件頁 爲生態索引，與 DeepSeek / 幻方無官方從屬關係。
- README 標註 16 passing 測試與 DSH 兼容性聲明（
0.2.1-rc.2+、0.2.2-rc.1+compatible）。
結尾¶
Plugcraft 把「Search first, build last」落到側欄工作臺：先澄清、四層搜索、用戶決策、缺口在 Creator 子智能體中補齊，再校驗後安裝。需要安裝命令與交互細節時，以 GitHub：lixian292/dsh-plugcraft 與 目錄頁 爲準。
