Introduction

When handling ComfyUI custom node tasks within the DSH agent, common challenges go beyond simply “writing a node”; they include node class contracts, input/output types, frontend JavaScript extensions, node documentation, internationalization, and migration differences between V1 and V3. Temporarily referencing these materials during a conversation can easily fill the context window and result in answers lacking a consistent reference point.

Below is a DSH plugin: dsh-comfyui-node-development. It packages a condensed bilingual guide for ComfyUI custom node development into a loadable runtime skill comfyui-node-dev, available for the DSH agent to use on demand.

What is it

dsh-comfyui-node-development is a DeepSeek Harness (DSH) plugin, repository owner is shouwang37, and the license is MIT.

Its positioning is as a learning aid: it condenses ComfyUI custom node development materials into a skill that can be loaded by the DSH agent and provides relevant reference during task matching. The plugin content is summarized from the ComfyUI official documentation and cannot replace it.

Core Features

This plugin primarily provides the following capabilities.

  1. Registers a runtime skill comfyui-node-dev.
    This skill can appear in any conversation involving ComfyUI custom nodes.

  2. Built-in reference manuals.
    The plugin includes in assets/skill/references/:

   backend.md
   frontend.md
   datatypes.md
   links.md
  1. Provides human-readable summary documentation.
    The plugin contains:
   docs/SUMMARY.zh.md
   docs/SUMMARY.en.md

  1. Covers key topics in ComfyUI custom node development.
    Including:
    - Node class contracts
    - INPUT_TYPES
    - RETURN_TYPES
    - CATEGORY
    - FUNCTION
    - Node registration and lifecycle
    - Data types
    - Hidden inputs
    - Flexible inputs
    - Lazy evaluation
    - List handling
    - Frontend JavaScript extensions
    - Internationalization (i18n)
    - Node documentation
    - V1 to V3 migration points

  2. Lightweight runtime dependencies.
    The plugin runs via peer dependencies included in the DSH profile:

   @deepseek-ai/cordis ^4.0.1
   @deepseek-ai/dsh-skill ^0.1.0-rc.6

Installation and Enablement

A DSH profile is required before installation, for example web.

When installing from GitHub, you can use the following command:

dsh plugin --profile web add "github:shouwang37/dsh-comfyui-node-development"

After installation, restart the DSH web service or restart the process manager corresponding to that profile.

After installation, this plugin will mount as a profile layer comfyui-node-dev and register the comfyui-node-dev skill.

Typical Usage

After installation and enabling, you can directly ask questions related to ComfyUI custom nodes in a DSH conversation, for example:

帮我写一个 ComfyUI 自定义节点

ComfyUI 节点的 INPUT_TYPES 怎么写？

怎么给 ComfyUI 节点加前端 JS 扩展？

把这段节点代码从 V1 迁移到 V3

When the task matches the skill’s whenToUse guideline, the agent will automatically load the skill and answer based on the guides and reference manuals included within.

Applicable Scenarios and Notes

People suitable for using this plugin are typically developers who need to complete ComfyUI custom node development, troubleshooting, or migration tasks within the DSH agent.

It is suitable for the following situations:

  • Want to supplement the DSH agent with ComfyUI custom node reference materials
  • Need to quickly query node class contracts, input/output, frontend extensions, etc. during conversation
  • Need to migrate V1 node code to V3 and view migration points
  • Hope the plugin content is loaded by the agent on demand as a skill

Pre-use notes:

  1. This plugin is a learning aid and cannot replace the ComfyUI official documentation.
    The official documentation address is:
   https://docs.comfy.org/custom-nodes/overview

  1. The plugin will be loaded into the DSH agent’s runtime environment.
    It is recommended to check the repository source code, license, and dependency declarations before installation.

  2. The repository package.json declares Node and pnpm requirements:

   node >=22.0.0
   packageManager pnpm@11.21.0
  1. When installing from GitHub, the compiled artifacts lib/ are committed to the repository.
    This reduces build steps during installation.

Conclusion

The value of dsh-comfyui-node-development lies in organizing ComfyUI custom node development materials into a skill loadable by the DSH agent, reducing the steps of piecing together background information during conversations. It is suitable for scenarios where the DSH agent is needed to assist in developing, modifying, or migrating ComfyUI custom nodes.

Repository address:

https://github.com/shouwang37/dsh-comfyui-node-development