用途：为 ComfyUI 节点撰写原创、面向初学者的文档。每个节点存为独立 JSON 文件，按分区与分类组织：src/data/nodes/ 下含 _metadata.json，以及 comfy_nodes、partner_nodes、subgraph_blueprints、extensions 四个顶层目录，其下分类路径与节点 category 字段对应（空格替换为连字符）。嵌入文档位于 embedded-docs/comfyui_embedded_docs/docs/<NodeName>/en.md，仅作参考，必须改写而非复制。
主要能力：为每个节点填写 description（50–200 字符）、beginner_description（100–400 字符）、tips（general/beginner/advanced）、use_cases、common_errors、complexity_level，并在内容齐全后设 documentation_complete 为 true。写作要求使用主动语态、解释原因、用类比，提示需具体可执行（含具体数值与节点名）。
使用方式：用 find 定位节点文件，用 rg '"documentation_complete": false' src/data/nodes/ -l 查找待补全节点。版本升级流程分三阶段：先确认 ComfyUI 已运行并更新（必要时 cd <COMFYUI_DIR>、git pull、pip install -r requirements.txt、./start.sh），再运行 ./scripts/extract-comfyui-nodes.sh 与 ./scripts/import-new-nodes.sh 提取并导入，最后按分区并行补全文档，验证无未完成节点后执行 pnpm run build 并更新 exports/NODE_UPDATE_PLAN.md。大批量（50+ 节点）可按分类分组并行处理。
适用场景：批量记录新节点、改进已有弱文档、按分类（API、数据集、采样、潜空间、音频等）补充针对性说明。
限制：嵌入文档仅作参考，禁止复制；API 节点需说明密钥、云端处理与可能费用；具体收费、价格、平台与效果资料未提供。