[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-pydn--ComfyUI-to-Python-Extension":3,"tool-pydn--ComfyUI-to-Python-Extension":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",146793,2,"2026-04-08T23:32:35",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":76,"owner_twitter":76,"owner_website":76,"owner_url":77,"languages":78,"stars":87,"forks":88,"last_commit_at":89,"license":90,"difficulty_score":32,"env_os":91,"env_gpu":91,"env_ram":91,"env_deps":92,"category_tags":97,"github_topics":98,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":105,"updated_at":106,"faqs":107,"releases":137},5729,"pydn\u002FComfyUI-to-Python-Extension","ComfyUI-to-Python-Extension","A powerful tool that translates ComfyUI workflows into executable Python code.","ComfyUI-to-Python-Extension 是一款能将 ComfyUI 可视化工作流自动转换为可执行 Python 代码的开源工具。它主要解决了从图形化节点操作向代码自动化过渡的痛点：用户无需手动重写逻辑，即可将精心设计的节点图转化为标准脚本，从而实现批量化处理、实验复现及集成到更复杂的自动化系统中。\n\n该工具特别适合希望突破界面限制的开发者和研究人员，同时也服务于需要高效重复生成内容的设计师。其核心亮点在于提供了灵活的导出方式：既支持在 ComfyUI 网页端通过\"Save As Script\"一键下载脚本，也支持命令行批量转换 API 格式的工作流文件。生成的代码不仅保留了完整的运行逻辑，还兼容 ComfyUI 的运行环境参数（如显存优化选项），甚至支持将输出图片拖回界面以还原原始工作流元数据。无论是想要探索底层机制的技术爱好者，还是寻求稳定生产流程的专业用户，都能借此轻松打通视觉编程与代码工程之间的壁垒。","# ComfyUI-to-Python-Extension\n\n![banner](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpydn_ComfyUI-to-Python-Extension_readme_e840c3f6edde.png)\n\nBuild a workflow in ComfyUI, then walk away with runnable Python.\n\n`ComfyUI-to-Python-Extension` turns visual workflows into executable scripts so you can move from node graphs to automation, experiments, and repeatable generation without rebuilding everything by hand.\n\nThis project supports:\n- exporting from the ComfyUI UI with `Save As Script`\n- converting saved API-format workflows with the CLI\n\n## Install\n\nChoose the setup that matches how you want to use the project.\nThis project supports Python 3.12 and newer.\n\n### Web UI extension (`File -> Save As Script`)\n\nFor ComfyUI to recognize this project as an extension, the repo must be discoverable through ComfyUI's `custom_nodes` search paths.\n\nUse one of these setups:\n\n1. Clone directly into `ComfyUI\u002Fcustom_nodes`\n```bash\ncd \u002Fpath\u002Fto\u002FComfyUI\u002Fcustom_nodes\ngit clone https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension.git\ncd ComfyUI-to-Python-Extension\nuv sync\n```\n\n2. Keep the repo elsewhere, then either:\n- symlink it into `ComfyUI\u002Fcustom_nodes`\n- add its parent directory to ComfyUI's `custom_nodes` search paths via `extra_model_paths.yaml`\n\nExample symlink setup:\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension.git\ncd \u002Fpath\u002Fto\u002FComfyUI\u002Fcustom_nodes\nln -s \u002Fpath\u002Fto\u002FComfyUI-to-Python-Extension ComfyUI-to-Python-Extension\ncd \u002Fpath\u002Fto\u002FComfyUI-to-Python-Extension\nuv sync\n```\n\nAfter installation, restart ComfyUI.\n\n### CLI exporter \u002F generated scripts\n\nYou can keep the repo anywhere for CLI usage and generated-script execution.\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension.git\ncd ComfyUI-to-Python-Extension\nuv sync\nexport COMFYUI_PATH=\u002Fpath\u002Fto\u002FComfyUI\n```\n\n`COMFYUI_PATH` helps the exporter and generated scripts find the ComfyUI codebase. It does not, by itself, register this repo as a ComfyUI extension for the Web UI.\n\n`COMFYUI_PATH` is checked first. If it is not set, the exporter falls back to searching parent directories for a folder named `ComfyUI`.\n\n## Web UI Export\n\nIn current ComfyUI builds, `Save As Script` is typically available under:\n\n`File -> Save As Script`\n\nThe command downloads a generated `.py` file.\nThe current UI export uses the default filename `workflow_api.py` so it works in ComfyUI Desktop without relying on `prompt()`.\n\n![Save As Script](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpydn_ComfyUI-to-Python-Extension_readme_7e1de2aa62c0.png)\n\nNotes:\n- menu placement can differ between frontend versions\n- the Web UI export uses a fixed default filename rather than asking for one interactively\n\n## CLI Export\n\n1. In ComfyUI, enable dev mode options if needed.\n2. Save the workflow in API format: `File -> Export (API)`.\n3. Run the exporter:\n\n```bash\nuv run python -m comfyui_to_python\n```\n\nOptions:\n\n```bash\nuv run python -m comfyui_to_python \\\n  --input_file workflow_api.json \\\n  --output_file workflow_api.py \\\n  --queue_size 10\n```\n\nThe legacy wrapper still works if you prefer it:\n\n```bash\nuv run python comfyui_to_python.py\n```\n\nFlags:\n- `--input_file`: input workflow JSON, default `workflow_api.json`\n- `--output_file`: output Python file, default `workflow_api.py`\n- `--queue_size`: default execution count in the generated script, default `10`\n\n![Dev Mode Options](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpydn_ComfyUI-to-Python-Extension_readme_7bc75ac5c476.png)\n\n## Generated Scripts\n\nGenerated scripts depend on a working ComfyUI runtime.\n\nIf the repo is not inside ComfyUI, set:\n\n```bash\nexport COMFYUI_PATH=\u002Fpath\u002Fto\u002FComfyUI\n```\n\nThe generated script is a workflow export. It does not automatically turn workflow inputs into command-line arguments.\n\nScripts exported directly from `File -> Save As Script` in the ComfyUI UI already include the frontend workflow metadata needed for drag-and-drop reimport. Images saved by those scripts can be dropped back into ComfyUI and reopen with the original workflow metadata.\n\nGenerated scripts reuse ComfyUI's runtime argument parser during bootstrap, so common ComfyUI memory flags such as `--highvram`, `--normalvram`, `--lowvram`, `--novram`, `--cpu`, and `--disable-smart-memory` can be passed directly to the exported `.py` file.\n\nLifecycle notes:\n- exported scripts are single-shot workflow runners, not long-lived ComfyUI prompt servers\n- they do not implement Web UI prompt\u002Fresult caching across repeated service calls\n- exported `main()` now performs best-effort ComfyUI model\u002Fcache cleanup in a `finally` block\n- set `COMFYUI_TOPYTHON_UNLOAD_MODELS=1` or call `main(unload_models=True)` if an embedded or repeated-call host should aggressively unload models after each run instead of preserving them for reuse\n\n## Troubleshooting\n\n- unsupported Python version:\n  use Python 3.12 or newer, then rerun `uv sync`\n- `Save As Script` not visible:\n  check your current ComfyUI menu\u002Ffrontend version and look under `File`\n- `Save As Script` not visible after restart:\n  make sure this repo is discoverable by ComfyUI through `custom_nodes` by cloning it into `ComfyUI\u002Fcustom_nodes`, symlinking it there, or adding an external `custom_nodes` path in `extra_model_paths.yaml`\n- save uses the default filename:\n  rename `workflow_api.py` after download if you want a different local filename\n- ComfyUI cannot be found:\n  set `COMFYUI_PATH`\n- models or paths are missing at runtime:\n  verify the target ComfyUI install and its `extra_model_paths.yaml`\n","# ComfyUI 转 Python 扩展\n\n![banner](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpydn_ComfyUI-to-Python-Extension_readme_e840c3f6edde.png)\n\n在 ComfyUI 中构建工作流，然后直接获得可运行的 Python 脚本。\n\n`ComfyUI-to-Python-Extension` 可以将可视化工作流转换为可执行脚本，使您能够从节点图过渡到自动化、实验以及可重复的生成任务，而无需手动重新构建一切。\n\n本项目支持：\n- 使用 `另存为脚本` 从 ComfyUI 界面导出\n- 使用 CLI 将保存的 API 格式工作流进行转换\n\n## 安装\n\n根据您希望使用该项目的方式选择相应的安装方法。本项目支持 Python 3.12 及更高版本。\n\n### Web UI 扩展（`文件 -> 另存为脚本`）\n\n为了让 ComfyUI 将本项目识别为扩展，该仓库必须可以通过 ComfyUI 的 `custom_nodes` 搜索路径被发现。\n\n您可以采用以下任一方式：\n\n1. 直接克隆到 `ComfyUI\u002Fcustom_nodes` 目录下：\n```bash\ncd \u002Fpath\u002Fto\u002FComfyUI\u002Fcustom_nodes\ngit clone https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension.git\ncd ComfyUI-to-Python-Extension\nuv sync\n```\n\n2. 将仓库保留在其他位置，然后：\n- 创建符号链接将其指向 `ComfyUI\u002Fcustom_nodes`\n- 或者通过 `extra_model_paths.yaml` 文件将仓库的父目录添加到 ComfyUI 的 `custom_nodes` 搜索路径中\n\n符号链接示例：\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension.git\ncd \u002Fpath\u002Fto\u002FComfyUI\u002Fcustom_nodes\nln -s \u002Fpath\u002Fto\u002FComfyUI-to-Python-Extension ComfyUI-to-Python-Extension\ncd \u002Fpath\u002Fto\u002FComfyUI-to-Python-Extension\nuv sync\n```\n\n安装完成后，请重启 ComfyUI。\n\n### CLI 导出工具 \u002F 生成的脚本\n\n对于 CLI 使用和生成脚本的执行，您可以将仓库放置在任何位置。\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension.git\ncd ComfyUI-to-Python-Extension\nuv sync\nexport COMFYUI_PATH=\u002Fpath\u002Fto\u002FComfyUI\n```\n\n`COMFYUI_PATH` 帮助导出工具和生成的脚本找到 ComfyUI 的代码库。它本身并不会将此仓库注册为 Web UI 的 ComfyUI 扩展。\n\n程序会首先检查 `COMFYUI_PATH` 是否已设置。如果未设置，则导出工具会回退到在其父目录中搜索名为 `ComfyUI` 的文件夹。\n\n## Web UI 导出\n\n在当前的 ComfyUI 版本中，`另存为脚本` 通常位于以下菜单路径下：\n\n`文件 -> 另存为脚本`\n\n该命令会下载一个生成的 `.py` 文件。当前的 UI 导出使用默认文件名 `workflow_api.py`，因此可以在 ComfyUI Desktop 中直接运行，而无需依赖 `prompt()` 函数。\n\n![另存为脚本](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpydn_ComfyUI-to-Python-Extension_readme_7e1de2aa62c0.png)\n\n注意事项：\n- 不同前端版本的菜单位置可能有所不同\n- Web UI 导出使用固定的默认文件名，而不是交互式地询问文件名\n\n## CLI 导出\n\n1. 在 ComfyUI 中，如有需要，请启用开发模式选项。\n2. 将工作流保存为 API 格式：`文件 -> 导出 (API)`。\n3. 运行导出工具：\n\n```bash\nuv run python -m comfyui_to_python\n```\n\n选项：\n\n```bash\nuv run python -m comfyui_to_python \\\n  --input_file workflow_api.json \\\n  --output_file workflow_api.py \\\n  --queue_size 10\n```\n\n如果您更喜欢旧版封装方式，仍然可以使用：\n\n```bash\nuv run python comfyui_to_python.py\n```\n\n标志说明：\n- `--input_file`：输入的工作流 JSON 文件，默认为 `workflow_api.json`\n- `--output_file`：输出的 Python 文件，默认为 `workflow_api.py`\n- `--queue_size`：生成脚本中的默认执行次数，默认为 `10`\n\n![开发模式选项](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpydn_ComfyUI-to-Python-Extension_readme_7bc75ac5c476.png)\n\n## 生成的脚本\n\n生成的脚本依赖于一个正常运行的 ComfyUI 运行时环境。\n\n如果仓库不在 ComfyUI 内部，请设置：\n\n```bash\nexport COMFYUI_PATH=\u002Fpath\u002Fto\u002FComfyUI\n```\n\n生成的脚本是工作流的导出文件，它不会自动将工作流的输入参数转换为命令行参数。\n\n直接从 ComfyUI 界面的 `文件 -> 另存为脚本` 导出的脚本已经包含了用于拖放式重新导入所需的前端工作流元数据。这些脚本保存的图像可以直接拖放到 ComfyUI 中，并恢复原始的工作流元数据。\n\n生成的脚本在启动时会复用 ComfyUI 的运行时参数解析器，因此常见的 ComfyUI 内存相关标志，如 `--highvram`、`--normalvram`、`--lowvram`、`--novram`、`--cpu` 和 `--disable-smart-memory`，都可以直接传递给导出的 `.py` 文件。\n\n生命周期注意事项：\n- 导出的脚本是一次性的工作流运行程序，而非长期运行的 ComfyUI 提示服务器\n- 它们不会实现跨多次服务调用的 Web UI 提示\u002F结果缓存功能\n- 导出的 `main()` 函数现在会在 `finally` 块中尽力清理 ComfyUI 的模型和缓存\n- 如果嵌入式或重复调用的宿主环境希望在每次运行后主动卸载模型，而不是保留以供重用，请设置 `COMFYUI_TOPYTHON_UNLOAD_MODELS=1`，或者调用 `main(unload_models=True)`。\n\n## 故障排除\n\n- 不支持的 Python 版本：\n  请使用 Python 3.12 或更高版本，然后重新运行 `uv sync`\n- `另存为脚本` 未显示：\n  请检查您当前使用的 ComfyUI 菜单\u002F前端版本，并在 `文件` 菜单中查找\n- 重启后仍看不到 `另存为脚本`：\n  确保此仓库可通过 `custom_nodes` 路径被 ComfyUI 发现，方法是将其克隆到 `ComfyUI\u002Fcustom_nodes` 目录下、创建符号链接，或在 `extra_model_paths.yaml` 文件中添加外部的 `custom_nodes` 路径\n- 保存时使用默认文件名：\n  如果您希望使用不同的本地文件名，请在下载后重命名 `workflow_api.py`\n- 找不到 ComfyUI：\n  请设置 `COMFYUI_PATH`\n- 运行时缺少模型或路径：\n  请确认目标 ComfyUI 安装及其 `extra_model_paths.yaml` 配置文件是否正确。","# ComfyUI-to-Python-Extension 快速上手指南\n\n将 ComfyUI 的可视化工作流一键转换为可执行的 Python 脚本，便于自动化运行、实验复现及批量生成。\n\n## 环境准备\n\n*   **操作系统**：Linux \u002F macOS \u002F Windows\n*   **Python 版本**：Python 3.12 或更高版本（必须）\n*   **前置依赖**：\n    *   已安装并配置好的 [ComfyUI](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI) 环境。\n    *   推荐安装 `uv` 包管理工具以加速依赖安装（若未安装，可使用 `pip install uv`）。\n\n## 安装步骤\n\n根据使用场景选择以下任一方式安装。\n\n### 方案一：作为 Web UI 插件安装（推荐）\n适用于直接在 ComfyUI 界面中通过菜单导出脚本。需将本扩展放入 ComfyUI 的 `custom_nodes` 目录。\n\n```bash\n# 进入 ComfyUI 的 custom_nodes 目录\ncd \u002Fpath\u002Fto\u002FComfyUI\u002Fcustom_nodes\n\n# 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension.git\n\n# 进入目录并同步依赖\ncd ComfyUI-to-Python-Extension\nuv sync\n\n# 重启 ComfyUI 使插件生效\n```\n\n> **提示**：若不想移动仓库位置，也可创建软链接或将父目录添加至 `extra_model_paths.yaml` 配置中。\n\n### 方案二：仅用于命令行导出 (CLI)\n适用于独立运行导出工具或执行生成的脚本，无需集成到 Web 界面。\n\n```bash\n# 克隆仓库到任意位置\ngit clone https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension.git\ncd ComfyUI-to-Python-Extension\n\n# 同步依赖\nuv sync\n\n# 设置 ComfyUI 根目录环境变量（可选，若未设置会自动向上查找）\nexport COMFYUI_PATH=\u002Fpath\u002Fto\u002FComfyUI\n```\n\n## 基本使用\n\n### 方法 A：通过 Web UI 直接导出（最简单）\n\n1.  在 ComfyUI 中构建好你的工作流。\n2.  点击顶部菜单栏的 `File` -> `Save As Script`。\n3.  浏览器将自动下载名为 `workflow_api.py` 的可执行脚本。\n4.  在终端运行该脚本即可复现工作流：\n    ```bash\n    python workflow_api.py\n    ```\n    *支持传递 ComfyUI 原生参数，如 `--lowvram` 等。*\n\n### 方法 B：通过命令行转换 API 文件\n\n如果你已有保存为 API 格式的工作流 JSON 文件：\n\n1.  在 ComfyUI 中开启开发模式选项（如需），并通过 `File` -> `Export (API)` 保存为 `workflow_api.json`。\n2.  运行转换命令：\n    ```bash\n    uv run python -m comfyui_to_python \\\n      --input_file workflow_api.json \\\n      --output_file my_workflow.py \\\n      --queue_size 10\n    ```\n    *   `--input_file`: 输入的 JSON 文件路径。\n    *   `--output_file`: 输出的 Python 脚本名称。\n    *   `--queue_size`: 生成脚本中的默认执行次数。\n\n### 运行生成的脚本\n\n生成的脚本依赖完整的 ComfyUI 运行时环境。若脚本无法找到 ComfyUI，请确保设置了环境变量：\n\n```bash\nexport COMFYUI_PATH=\u002Fpath\u002Fto\u002FComfyUI\npython my_workflow.py\n```\n\n> **注意**：生成的脚本为单次运行器，非长期服务进程。若需在嵌入式环境中反复调用并希望每次运行后彻底释放显存，可设置环境变量 `COMFYUI_TOPYTHON_UNLOAD_MODELS=1` 或在代码中调用 `main(unload_models=True)`。","某 AIGC 初创公司的算法工程师需要将在 ComfyUI 中调试完美的复杂图像生成工作流，集成到后端的自动化批量生产系统中。\n\n### 没有 ComfyUI-to-Python-Extension 时\n- **手动重构成本极高**：工程师必须对着节点图，逐行手写 Python 代码来复现复杂的连接逻辑和参数设置，耗时数小时且极易出错。\n- **版本同步困难**：一旦前端调整了提示词或采样器参数，后端代码无法自动更新，导致测试环境与生产环境效果不一致。\n- **难以融入现有架构**：可视化的工作流无法直接作为模块嵌入公司现有的 CI\u002FCD 流水线或定时任务脚本中，只能依赖人工操作界面。\n- **实验复现性差**：团队成员间分享实验成果时，往往只能发送截图或庞大的 JSON 文件，缺乏可执行、可审查的标准代码版本。\n\n### 使用 ComfyUI-to-Python-Extension 后\n- **一键生成可执行脚本**：在 ComfyUI 界面点击\"Save As Script\"，瞬间将可视化节点图转换为结构清晰、可直接运行的 Python 代码，开发时间从小时级缩短至分钟级。\n- **实现前后端无缝同步**：前端优化工作流后，重新导出即可覆盖旧脚本，确保后端批量任务始终使用最新的生成逻辑，彻底消除环境差异。\n- **轻松集成自动化流程**：生成的脚本原生支持命令行参数和队列控制，可直接部署到服务器后台，通过 cron 或 API 触发大规模图像生成任务。\n- **提升协作与审计效率**：代码化的工作流便于纳入 Git 版本管理，团队成员可通过 Code Review 精确追踪参数变更，让实验过程透明且可追溯。\n\nComfyUI-to-Python-Extension 打破了可视化原型与工程化落地之间的壁垒，让创意工作流能零摩擦地转化为稳定的生产力代码。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpydn_ComfyUI-to-Python-Extension_e840c3f6.png","pydn","Peyton DeNiro","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fpydn_1070ec5e.jpg","Data Scientist. AI art hobbyist. Data nerd.",null,"https:\u002F\u002Fgithub.com\u002Fpydn",[79,83],{"name":80,"color":81,"percentage":82},"Python","#3572A5",98.4,{"name":84,"color":85,"percentage":86},"JavaScript","#f1e05a",1.6,2299,206,"2026-04-08T16:37:39","MIT","未说明",{"notes":93,"python":94,"dependencies":95},"该工具是 ComfyUI 的扩展插件，用于将可视化工作流转换为可执行的 Python 脚本。安装时需通过 git clone 将仓库放入 ComfyUI 的 custom_nodes 目录或使用软链接。运行生成的脚本需要依赖完整的 ComfyUI 运行时环境，需设置 COMFYUI_PATH 环境变量指向 ComfyUI 安装路径。生成的脚本支持传递 ComfyUI 的原生内存管理参数（如 --highvram, --lowvram 等）。若需在嵌入环境或重复调用中强制卸载模型以释放显存，可设置环境变量 COMFYUI_TOPYTHON_UNLOAD_MODELS=1。","3.12+",[96],"uv",[15,14],[99,100,101,102,103,104],"comfyui","image-generation","stable-diffusion","ai-art","generative-art","pytorch","2026-03-27T02:49:30.150509","2026-04-09T09:30:59.876530",[108,113,118,123,128,133],{"id":109,"question_zh":110,"answer_zh":111,"source_url":112},25974,"为什么找不到\"Save as Script\"（保存为脚本）按钮？","在新版本的 ComfyUI 中，该功能的位置可能发生了变化。请尝试以下方法：\n1. 确保已启用开发模式：点击\"Queue Prompt\"上方的齿轮图标，勾选\"Enable Dev mode Options\"。\n2. 在新版界面中，该选项通常位于顶部菜单栏的 `File` -> `Save As Script`。\n3. 如果仍然找不到，请确认扩展已正确安装在 `custom_nodes` 目录下，并尝试更新到最新的 2.0.0 版本，因为前端集成已针对当前 ComfyUI 构建进行了更新。","https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fissues\u002F89",{"id":114,"question_zh":115,"answer_zh":116,"source_url":117},25975,"运行工作流转换时出现 \"TypeError: 'int' object is not subscriptable\" 错误怎么办？","这通常是因为保存了错误的 JSON 文件类型。解决方法如下：\n1. 启动 ComfyUI。\n2. 点击\"Queue Prompt\"按钮上方的齿轮图标。\n3. 务必勾选\"Enable Dev mode Options\"（启用开发模式选项）。\n4. 重新导出工作流 JSON 文件（此时导出的才是包含必要信息的 API 格式 JSON）。\n注意：如果不启用此选项，脚本将无法正常工作。","https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fissues\u002F13",{"id":119,"question_zh":120,"answer_zh":121,"source_url":122},25976,"遇到 \"KeyError: '➕'\" 或包含特殊符号导致的格式化错误如何解决？","该错误通常由节点名称中包含特殊符号（如\"➕\"）导致 Python 代码格式化失败引起。\n解决方案：\n1. 建议升级到 2.0.0 或更高版本，新版导出器已通过字典展开方式处理此类不安全输入。\n2. 如果无法升级，可以手动修改生成的 Python 文件，移除变量名或参数中的特殊符号（如将\"➕\"删除）。\n3. 或者临时修改源码 `comfyui_to_python.py` 第 413 行附近，添加异常捕获以跳过 black 格式化步骤：\n```python\ntry:\n    final_code = black.format_str(final_code, mode=black.Mode())\nexcept Exception as e:\n    print(\"[ComfyUI-to-Python] black formatting failed, writing unformatted code:\", e)\n    pass\n```","https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fissues\u002F119",{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},25977,"运行时出现 \"ModuleNotFoundError: No module named 'nodes'\" 错误如何修复？","这是因为 ComfyUI 的路径未包含在系统的 Python 路径中。解决方法有：\n1. **推荐方法**：使用 ComfyUI 的便携版（Portable version），而不是桌面安装版。\n2. **手动配置**：将 ComfyUI 的安装目录手动添加到系统路径中。你可以修改扩展目录下的 `comfyui_to_python_utils.py` 文件（约第 55 行），显式添加你的 ComfyUI 根目录路径。\n3. 确保在正确的目录下运行命令，或者设置 `COMFYUI_PATH` 环境变量指向 ComfyUI 根目录。","https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fissues\u002F104",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},25978,"如何在其他脚本中调用生成的工作流脚本而不受命令行参数冲突影响？","如果在另一个脚本中导入生成的工作流脚本时遇到参数解析冲突，可以在导入前重置 `sys.argv`。示例代码如下：\n```python\nimport sys\n# 重置 argv 以避免参数冲突\nsys.argv = [\"\"]\n# 然后导入生成的脚本\nfrom workflow_api import main\n```\n这样可以防止生成的脚本尝试解析主程序的命令行参数。","https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fissues\u002F17",{"id":134,"question_zh":135,"answer_zh":136,"source_url":132},25979,"生成的 Python 脚本能否通过 argparse 动态添加输入图片路径等参数？","目前直接在生成的脚本中添加 `argparse` 支持比较困难，因为 ComfyUI 的 `nodes.py` 在导入时就会解析参数，这会导致冲突。\n变通方案：\n1. 不要直接修改生成的脚本去添加 `add_subparsers` 或常规参数解析。\n2. 建议在调用生成的脚本之前，在主控脚本中预处理参数，或者直接修改生成后的代码逻辑，将硬编码的路径替换为变量，并在外部传入。\n3. 开发者计划未来在 ComfyUI 界面直接添加导出按钮以简化流程，届时可能不再需要复杂的 CLI 参数配置。",[138,143,148,153,158,163,168,173,178,183],{"id":139,"version":140,"summary_zh":141,"released_at":142},163342,"v2.1.0","## 摘要\n\n`2.1.0` 版本主要聚焦于导出器的正确性、安装与前端兼容性，以及生成脚本运行时的生命周期行为。\n\n## 亮点\n\n### 导出器正确性\n- 修复了生成代码中字符串种子随机化的问题。\n- 针对生成器的边缘情况增加了针对性的回归测试覆盖，包括：\n  - 字符串种子节点\n  - Windows 样式的路径字符串\n  - 字符串末尾的反斜杠\n  - 不安全的 rgthree 关键字参数\n  - 子图和放大器标识符的处理\n- 新增了固定测试用例，以确保这些场景不会再次出现问题。\n\n### 兼容性与安装\n- 正式声明支持的 Python 版本为 `3.12` 及以上。\n- 移除了隐藏的导入时 `pip` 自动安装行为，改用明确的 `uv sync` 指导说明。\n- 更新了 Web UI 的保存流程，避免使用 `prompt()`，从而提升与 ComfyUI Desktop 的兼容性。\n- 将默认下载的脚本文件名统一为 `workflow_api.py`。\n- 添加了契约测试，涵盖支持的 Python 元数据和前端保存默认值。\n\n### 生成脚本运行时行为\n- 生成的脚本现在会在工作流执行后尽力进行 ComfyUI 清理操作。\n- 导出的 `main()` 函数现在会在 `finally` 块中执行清理操作。\n- 新增了可选的激进卸载支持，适用于嵌入式或重复调用的场景：\n  - `main(unload_models=True)`\n  - `COMFYUI_TOPYTHON_UNLOAD_MODELS=1`\n- 为生成的脚本文档化了支持的 ComfyUI 运行时及显存相关标志。\n- 对清理钩子进行了保护，以防止清理过程中出现的错误覆盖实际的工作流失败。\n\n## 用户可见的变化\n\n- 在导出包含复杂字符串值或以往易出错节点形状的工作流时，表现更加稳定。\n- 环境要求更加清晰：目前推荐的环境配置为 Python `3.12` 及以上版本，并使用 `uv` 工具。\n- “文件 -> 另存为脚本”功能在 Desktop 上的兼容性更好。\n- 生成的脚本在执行完毕后会更安全地清理 ComfyUI 运行时状态，同时默认仍允许模型复用。\n\n## 变更内容\n* 显式化生成器代码生成的回归问题，并修复字符串种子随机化问题，由 @pydn 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F151 中完成。\n* 澄清 Python 支持范围并强化导出与安装的兼容性，由 @pydn 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F152 中完成。\n* 在工作流执行后添加生成脚本的运行时清理功能，由 @pydn 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F153 中完成。\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fcompare\u002Fv2.0.0...v2.1.0","2026-03-30T00:09:16",{"id":144,"version":145,"summary_zh":146,"released_at":147},163343,"v2.0.0","### 概述\n\nv2.0.0 是一次重大的导出器更新，重点在于打包、运行时正确性、生成脚本的可读性以及前端兼容性。\n\n### CLI 与打包\n\n导出器现在拥有一个规范的包入口点，推荐的 CLI 调用方式为 `uv run python -m comfyui_to_python`。为了保持兼容性，旧版的 `uv run python comfyui_to_python.py` 包装器仍然可用。\n\n### 生成脚本的改进\n\n生成的脚本经过重构，结构更加清晰，导入、工作流数据、执行流程和入口点逻辑都得到了优化，从而提升了可读性。\n\n### 运行时与前端修复\n\n生成的脚本现在会将 ComfyUI 的初始化延迟到 `main()` 函数执行时再进行，并且 ComfyUI 的启动过程会在 `torch` 导入之前完成，这不仅提高了运行时的正确性，还避免了导入时的副作用。此外，前端扩展也进行了更新，移除了对旧版 `ui.js` 的导入路径，从而更好地兼容较新的 ComfyUI 前端行为。\n\n### 导出准确性\n\n此版本在处理重复节点类分支、非零输出选择、隐藏的元数据关键字参数以及随机种子同步等方面都有所改进。\n\n### 验证\n\n验证覆盖范围得到了扩展，包括更强大的单元测试、运行时测试框架的改进，以及新增的工作流测试用例，如复用节点类分支、选择次要输出、文本到图像生成和超分辨率模型加载等。","2026-03-29T20:36:20",{"id":149,"version":150,"summary_zh":151,"released_at":152},163344,"v1.3.2","## 摘要\n\n此补丁版本汇总了已在 `main` 分支上合并的兼容性和打包修复。\n\n## 包含内容\n\n- 修复在较新版本 ComfyUI 前端中“另存为脚本”功能不可用的问题\n- 修复与放大模型加载器工作流相关的运行时\u002F导出引导问题\n- 修复影响生成脚本的导入\u002F路径冲突问题\n- 异步修复额外节点的加载问题\n- 打包和发布工作流更新\n- 更新 README 和安装文档","2026-03-28T23:21:36",{"id":154,"version":155,"summary_zh":156,"released_at":157},163345,"v1.3.1","## 变更内容\n* 注册表\u002F`pyproject`，由 @pydn 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F76 中完成\n* 为自定义节点注册表添加 `pyproject.toml`，由 @haohaocreates 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F53 中完成\n* 添加用于发布到 Comfy 注册表的 GitHub Actions 工作流，由 @haohaocreates 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F52 中完成\n* 关键字参数修复，由 @pydn 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F77 中完成\n* 对新 UI 的菜单项添加进行修改，由 @swilcock0 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F95 中完成\n\n## 新贡献者\n* @haohaocreates 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F53 中完成了首次贡献\n* @swilcock0 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F95 中完成了首次贡献\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fcompare\u002Fv1.3.0...v1.3.1","2025-01-14T17:03:18",{"id":159,"version":160,"summary_zh":161,"released_at":162},163346,"v1.3.0","## 变更内容\n* 新增 UI 按钮，可直接从 ComfyUI Web 应用中保存脚本，由 @pydn 在 https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fpull\u002F74 中实现。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fpydn\u002FComfyUI-to-Python-Extension\u002Fcompare\u002Fv1.2.1...v1.3.0\n\n## 贡献\n特别感谢 @atmaranto 为添加 UI 按钮代码所做的卓越工作。","2024-09-14T19:08:06",{"id":164,"version":165,"summary_zh":166,"released_at":167},163347,"v1.2.1","- 更新：支持通过命令行参数动态调整输入文件、输出文件和队列大小\n- 修复：确保对于所有允许传递关键字参数的节点，这些参数都能正确传递到生成的 .py 文件中\n\n特别感谢 @Omer-ler 的贡献！","2024-09-12T18:44:38",{"id":169,"version":170,"summary_zh":171,"released_at":172},163348,"v1.2.0","- 针对最新 ComfyUI 更新中的破坏性变更进行了更新\n- 将 utils.py 重命名，以避免与 ComfyUI 新增的 utils 目录发生冲突\n- 增加了多个用于搜索 load_extra_path_config 的路径，以确保向后兼容性\n\n特别感谢 @albertpurnama 的贡献！","2024-09-11T19:02:26",{"id":174,"version":175,"summary_zh":176,"released_at":177},163349,"v1.1.0","**新功能：**\n新增了使用 `extra_model_paths.yaml` 文件将额外模型加载到工作流中的功能。\n\n**错误修复：**\n增加了对自定义节点名称中使用特殊字符情况的处理。\n\n\n**致谢：**\n特别感谢 @dimtoneff、@rossaai 和 @FelipeMurguia 的贡献！","2023-08-25T21:18:49",{"id":179,"version":180,"summary_zh":181,"released_at":182},163350,"v1.0.0","现已支持自定义节点！此外，还进行了大规模代码重构以提高可读性，并修复了一些常规问题。","2023-08-20T02:42:20",{"id":184,"version":185,"summary_zh":186,"released_at":187},163351,"v0.9.0","初始版本，可与任何不使用自定义扩展的原生 ComfyUI 工作流兼容。","2023-08-19T23:12:16"]