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。

相关链接

• 官方文档：https://docs.comfy.org/custom-nodes/overview
• ComfyUI 源码：https://github.com/comfyanonymous/ComfyUI
• 官方自定义节点示例：https://github.com/Comfy-Org/ComfyUI_examples_custom_node