ComfyUI 节点开发指南 shouwang37/dsh-comfyui-node-development

dsh-comfyui-node-development

DeepSeek Harness（DSH）插件：把 ComfyUI 自定义节点开发的浓缩双语指南（中文为主，保留英文术语）打包为运行时技能 comfyui-node-dev。

任何 DSH 智能体都可以按需加载该技能——它涵盖节点类契约（INPUT_TYPES、RETURN_TYPES、CATEGORY、FUNCTION）、节点注册与生命周期、数据类型、隐藏/灵活输入、惰性求值、列表处理、前端 JavaScript 扩展、国际化（i18n）、节点文档，以及 V1 → V3 迁移要点。

内容总结自 ComfyUI 官方文档（docs.comfy.org，中文镜像 docs.comfy.org/zh）。本插件是学习辅助，不能替代官方文档。

特性

- 一个技能搞定一切：comfyui-node-dev —— 任何涉及 ComfyUI 自定义节点的对话中都可加载。
- 深度参考分册：assets/skill/references/ 内置 backend.md、frontend.md、datatypes.md、links.md。
- 人类可读总结：docs/SUMMARY.zh.md 与 docs/SUMMARY.en.md。
- 零运行时依赖：插件仅通过 ctx.skills 注册运行时技能；peer 依赖只有 DSH profile 自带的两个包（@deepseek-ai/cordis、@deepseek-ai/dsh-skill）。

安装到 DSH

需要一个 DSH profile（如 web）。在终端执行：

从 GitHub 安装（推荐，零构建开箱即用）
dsh plugin --profile web add "github:shouwang37/dsh-comfyui-node-development"

或使用本地路径
dsh plugin --profile web add "file:C:/path/to/dsh-comfyui-node-development"

然后重启 DSH web 服务（或 profile 对应的进程管理器）。插件会作为 profile 图层 comfyui-node-dev 挂载，并注册 comfyui-node-dev 技能。

使用方法

在任意对话中提问，例如：

- "帮我写一个 ComfyUI 自定义节点"
- "ComfyUI 节点的 INPUT_TYPES 怎么写？"
- "怎么给 ComfyUI 节点加前端 JS 扩展？"
- "把这段节点代码从 V1 迁移到 V3"

任务匹配技能的 whenToUse 指引时，智能体会自动加载该技能。

开发

pnpm install
pnpm build # tsc -> lib/
pnpm smoke # 冒烟测试：在桩上下文中注册技能

说明：编译产物 lib/ 会提交进仓库，这样从 GitHub 安装时无需执行构建脚本（pnpm 会拦截 git 依赖的构建脚本）。

仓库结构

.
├── src/ # 插件源码（Cordis 插件入口 + 技能注册） ├── assets/skill/ # 技能正文与分册（随插件分发给智能体） ├── docs/ # 人类可读总结（中/英） ├── cordis.patch.yml # DSH bundle 补丁（profile 图层挂载） ├── package.json # 声明 dsh.bundle └── scripts/smoke.mjs # 冒烟测试

许可证

MIT —— 见 LICENSE。

相关链接

- 官方文档：
- ComfyUI 源码：
- 官方自定义节点示例：