前言¶
在 DSH 智能體中處理 ComfyUI 自定義節點任務時，常見的問題不只是“寫一個節點”，還包括節點類契約、輸入輸出類型、前端 JavaScript 擴展、節點文檔、國際化，以及 V1 到 V3 的遷移差異。每次在對話中臨時查閱這些資料，容易把上下文填滿，也會讓回答缺少一致參考。
下面介紹一個 DSH 插件：dsh-comfyui-node-development。它把 ComfyUI 自定義節點開發的濃縮雙語指南打包爲可加載的運行時技能 comfyui-node-dev，供 DSH 智能體按需使用。
這是什麼¶
dsh-comfyui-node-development 是一個 DeepSeek Harness（DSH）插件，倉庫 owner 是 shouwang37，許可證爲 MIT。
它的定位是學習輔助：把 ComfyUI 自定義節點開發資料濃縮成一份可被 DSH 智能體加載的技能，並在任務匹配時提供相關參考。插件內容總結自 ComfyUI 官方文檔，不能替代官方文檔。
核心功能¶
這個插件主要提供以下能力。
-
註冊一個運行時技能
comfyui-node-dev。
該技能可以出現在任何涉及 ComfyUI 自定義節點的對話中。 -
內置參考分冊。
插件在assets/skill/references/中包含：
backend.md
frontend.md
datatypes.md
links.md
- 提供人類可讀的總結文檔。
插件包含：
docs/SUMMARY.zh.md
docs/SUMMARY.en.md
- 覆蓋 ComfyUI 自定義節點開發的關鍵主題。
包括：
- 節點類契約
INPUT_TYPESRETURN_TYPESCATEGORYFUNCTION- 節點註冊與生命週期
- 數據類型
- 隱藏輸入
- 靈活輸入
- 惰性求值
- 列表處理
- 前端 JavaScript 擴展
- 國際化（i18n）
- 節點文檔
- V1 到 V3 遷移要點
- 運行時依賴較輕。
插件通過 DSH profile 自帶的 peer 依賴運行：
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-skill ^0.1.0-rc.6
安裝與啓用¶
安裝前需要一個 DSH profile，例如 web。
從 GitHub 安裝時，可以使用下面的命令：
dsh plugin --profile web add "github:shouwang37/dsh-comfyui-node-development"
安裝完成後，重啓 DSH web 服務，或重啓該 profile 對應的進程管理器。
該插件安裝後會作爲 profile 圖層 comfyui-node-dev 掛載，並註冊 comfyui-node-dev 技能。
典型用法¶
安裝啓用後，可以直接在 DSH 對話中提出與 ComfyUI 自定義節點相關的問題，例如：
幫我寫一個 ComfyUI 自定義節點
ComfyUI 節點的 INPUT_TYPES 怎麼寫？
怎麼給 ComfyUI 節點加前端 JS 擴展？
把這段節點代碼從 V1 遷移到 V3
當任務匹配技能的 whenToUse 指引時，智能體會自動加載該技能，並基於其中包含的指南和參考分冊回答。
適用場景與注意¶
適合使用這個插件的人，通常是需要在 DSH 智能體中完成 ComfyUI 自定義節點開發、排錯或遷移任務的開發者。
它比較適合以下情況：
- 想給 DSH 智能體補充一份 ComfyUI 自定義節點參考資料
- 需要在對話中快速查詢節點類契約、輸入輸出、前端擴展等問題
- 需要把 V1 節點代碼遷移到 V3，並查看遷移要點
- 希望插件內容以技能形式被智能體按需加載
使用前需要注意：
- 該插件是學習輔助，不能替代 ComfyUI 官方文檔。
官方文檔地址是：
https://docs.comfy.org/custom-nodes/overview
-
插件會加載到 DSH 智能體的運行環境中。
安裝前建議檢查倉庫源碼、許可證和依賴聲明。 -
倉庫
package.json聲明瞭 Node 和 pnpm 要求：
node >=22.0.0
packageManager pnpm@11.21.0
- 從 GitHub 安裝時，編譯產物
lib/會提交進倉庫。
這樣可以減少安裝時的構建步驟。
結尾¶
dsh-comfyui-node-development 的價值，是把 ComfyUI 自定義節點開發資料整理成 DSH 智能體可加載的技能，減少在對話中臨時拼接背景資料的步驟。它適合需要讓 DSH 智能體協助開發、修改或遷移 ComfyUI 自定義節點的場景。
倉庫地址：
https://github.com/shouwang37/dsh-comfyui-node-development
