前言¶
在 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
