[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-Comfy-Org--comfy-cli":3,"tool-Comfy-Org--comfy-cli":62},[4,18,26,36,46,54],{"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 真正成长为懂上",159636,2,"2026-04-17T23:33:34",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":78,"owner_twitter":79,"owner_website":80,"owner_url":81,"languages":82,"stars":87,"forks":88,"last_commit_at":89,"license":90,"difficulty_score":32,"env_os":91,"env_gpu":92,"env_ram":93,"env_deps":94,"category_tags":101,"github_topics":102,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":106,"updated_at":107,"faqs":108,"releases":137},8915,"Comfy-Org\u002Fcomfy-cli","comfy-cli","Command Line Interface for Managing ComfyUI","comfy-cli 是一款专为 ComfyUI 设计的命令行管理工具，旨在让用户通过终端轻松完成 ComfyUI 的安装、配置与日常维护。它主要解决了手动部署 ComfyUI 时环境配置繁琐、依赖包管理困难以及自定义节点更新不便等痛点，将复杂的操作流程简化为几条简洁的指令。\n\n无论是希望快速搭建工作流的 AI 艺术家、需要频繁测试新节点的研究人员，还是习惯使用终端进行高效开发的工程师，都能从 comfy-cli 中受益。其核心亮点在于“一键安装”能力，不仅能自动下载最新版本的 ComfyUI 和管理器，还能智能处理 Python 虚拟环境，避免依赖冲突。此外，它支持跨平台运行（Windows、macOS、Linux），内置模型检查点下载与哈希保存功能，并创新性地引入 `uv` 解析器以大幅提升依赖安装速度，甚至能自动识别并适配特定的 GPU 驱动版本。对于需要高度定制的用户，它还支持灵活跳过默认组件安装，以便集成自定义的管理器分支或特定版本库。通过 comfy-cli，用户可以更专注于创意实现与技术探索，而非耗费时间在环境调试上。","# comfy-cli: A Command Line Tool for ComfyUI\n\n[![Run pytest](https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Factions\u002Fworkflows\u002Fpytest.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Factions\u002Fworkflows\u002Fpytest.yml)\n[![codecov](https:\u002F\u002Fcodecov.io\u002Fgithub\u002FComfy-Org\u002Fcomfy-cli\u002Fgraph\u002Fbadge.svg?token=S64WJWD2ZX)](https:\u002F\u002Fcodecov.io\u002Fgithub\u002FComfy-Org\u002Fcomfy-cli)\n[![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fcomfy-cli.svg)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fcomfy-cli\u002F)\n[![Downloads](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FComfy-Org_comfy-cli_readme_7d417aca750f.png)](https:\u002F\u002Fpepy.tech\u002Fproject\u002Fcomfy-cli)\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fpyversions\u002Fcomfy-cli)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fcomfy-cli\u002F)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fl\u002Fcomfy-cli)](https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fblob\u002Fmain\u002FLICENSE)\n\ncomfy-cli is a command line tool that helps users easily install and manage\n[ComfyUI](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI), a powerful open-source\nmachine learning framework. With comfy-cli, you can quickly set up ComfyUI,\ninstall packages, and manage custom nodes, all from the convenience of your\nterminal.\n\n## Demo\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FComfy-Org_comfy-cli_readme_61965f8e343f.gif\" width=\"400\" alt=\"Comfy Command Demo\">\n\n## Features\n\n- 🚀 Easy installation of ComfyUI with a single command\n- 📦 Seamless package management for ComfyUI extensions and dependencies\n- 🔧 Custom node management for extending ComfyUI's functionality\n- 🗄️ Download checkpoints and save model hash\n- 💻 Cross-platform compatibility (Windows, macOS, Linux)\n- 📖 Comprehensive documentation and examples\n- 🎉 install pull request to ComfyUI automatically\n\n## Installation\n\n1. (Recommended, but not necessary) Enable virtual environment ([venv](https:\u002F\u002Fdocs.python.org\u002F3\u002Flibrary\u002Fvenv.html)\u002F[conda](https:\u002F\u002Fconda.io\u002Fprojects\u002Fconda\u002Fen\u002Flatest\u002Fuser-guide\u002Fgetting-started.html))\n\n2. To install comfy-cli, make sure you have Python 3.9 or higher installed on your system. Then, run the following command:\n\n   `pip install comfy-cli`\n\n### Shell Autocomplete\n\nTo install autocompletion hints in your shell run:\n\n`comfy --install-completion`\n\nThis enables you to type `comfy [TAP]` to autocomplete commands and options\n\n## Usage\n\n### Installing ComfyUI\n\nTo install ComfyUI using comfy, simply run:\n\n`comfy install`\n\nThis command will download and set up the latest version of ComfyUI and ComfyUI-Manager on your\nsystem. If you run in a ComfyUI repo that has already been setup. The command\nwill simply update the comfy.yaml file to reflect the local setup\n\n- `comfy install --skip-manager`: Install ComfyUI without ComfyUI-Manager.\n  To use a custom Manager fork or specific version, skip the default installation\n  and install your own into the workspace venv:\n  ```bash\n  comfy install --skip-manager\n  # Then install your custom Manager:\n  pip install -e \u002Fpath\u002Fto\u002Fyour-manager-fork   # editable install\n  # or\n  pip install comfyui-manager==4.1b8          # specific version\n  ```\n- `comfy --workspace=\u003Cpath> install`: Install ComfyUI into `\u003Cpath>\u002FComfyUI`.\n- `comfy install --fast-deps`: Use `uv` instead of `pip` for faster dependency resolution\n  during initial ComfyUI installation. comfy-cli's built-in resolver compiles all requirements (core + custom nodes)\n  into a single lockfile and installs from it. Also handles GPU-specific PyTorch wheel selection automatically.\n- For `comfy install`, if no path specification like `--workspace, --recent, or --here` is provided, it will be implicitly installed in `\u003CHOME>\u002Fcomfy`.\n\n#### Python environment handling\n\nWhen you run `comfy install`, comfy-cli picks a Python environment for ComfyUI\ndependencies using the following precedence:\n\n1. An **active virtualenv or conda** environment (`VIRTUAL_ENV` \u002F `CONDA_PREFIX`) is used as-is.\n2. An **existing `.venv` or `venv`** directory inside the workspace is reused.\n3. Otherwise the choice depends on how comfy-cli was installed:\n   - **`pip install comfy-cli`** (global \u002F system Python): dependencies go\n     directly into the same Python environment. This is the typical Docker setup.\n   - **`pipx install comfy-cli`** or **`uv tool install comfy-cli`** (isolated\n     tool environment): a `.venv` is created inside the ComfyUI workspace.\n     Use `comfy launch` to start ComfyUI with the correct Python.\n\n### Specifying execution path\n\n- You can specify the path of ComfyUI where the command will be applied through path indicators as follows:\n  - `comfy --workspace=\u003Cpath>`: Run from the ComfyUI installed in the specified workspace.\n  - `comfy --recent`: Run from the recently executed or installed ComfyUI.\n  - `comfy --here`: Run from the ComfyUI located in the current directory.\n- --workspace, --recent, and --here options cannot be used simultaneously.\n- If there is no path indicator, the following priority applies:\n\n  - Run from the default ComfyUI at the path specified by `comfy set-default \u003Cpath>`.\n  - Run from the recently executed or installed ComfyUI.\n  - Run from the ComfyUI located in the current directory.\n\n- Example 1: To run the recently executed ComfyUI:\n  - `comfy --recent launch`\n- Example 2: To install a package on the ComfyUI in the current directory:\n  - `comfy --here node install comfyui-impact-pack`\n- Example 3: To update the automatically selected path of ComfyUI and custom nodes based on priority:\n\n  - `comfy node update all`\n\n- You can use the `comfy which` command to check the path of the target workspace.\n  - e.g `comfy --recent which`, `comfy --here which`, `comfy which`, ...\n\n### Default Setup\n\nThe default sets the option that will be executed by default when no specific workspace's ComfyUI has been set for the command.\n\n`comfy set-default \u003Cworkspace path> ?[--launch-extras=\"\u003Cextra args>\"]`\n\n- `--launch-extras` option specifies extra args that are applied only during launch by default. However, if extras are specified at the time of launch, this setting is ignored.\n\n### Launch ComfyUI\n\nComfy provides commands that allow you to easily run the installed ComfyUI.\n\n`comfy launch`\n\n- To run with default ComfyUI options:\n\n  `comfy launch -- \u003Cextra args...>`\n\n  `comfy launch -- --cpu --listen 0.0.0.0`\n\n  - When you manually configure the extra options, the extras set by set-default will be overridden.\n\n- To run background\n\n  `comfy launch --background`\n\n  `comfy --workspace=~\u002Fcomfy launch --background -- --listen 10.0.0.10 --port 8000`\n\n  - Instances launched with `--background` are displayed in the \"Background ComfyUI\" section of `comfy env`, providing management functionalities for a single background instance only.\n  - Since \"Comfy Server Running\" in `comfy env` only shows the default port 8188, it doesn't display ComfyUI running on a different port.\n  - Background-running ComfyUI can be stopped with `comfy stop`.\n\n- to run ComfyUI with a specific pull request:\n\n  `comfy install --pr \"#1234\"`\n\n  `comfy install --pr \"jtydhr88:load-3d-nodes\"`\n\n  `comfy install --pr \"https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI\u002Fpull\u002F1234\"`\n\n  - If you want to run ComfyUI with a specific pull request, you can use the `--pr` option. This will automatically install the specified pull request and run ComfyUI with it.\n  - Important: The --pr option cannot be combined with --version or --commit and will be rejected if used together.\n\n- To test a frontend pull request:\n\n  ```\n  comfy launch --frontend-pr \"#456\"\n  comfy launch --frontend-pr \"username:branch-name\"\n  comfy launch --frontend-pr \"https:\u002F\u002Fgithub.com\u002FComfy-Org\u002FComfyUI_frontend\u002Fpull\u002F456\"\n  ```\n\n  - The `--frontend-pr` option allows you to test frontend PRs by automatically cloning, building, and using the frontend for that session.\n  - Requirements: Node.js and npm must be installed to build the frontend.\n  - Builds are cached for quick switching between PRs - subsequent uses of the same PR are instant.\n  - Each PR is used only for that launch session. Normal launches use the default frontend.\n\n  **Managing PR cache**:\n  ```\n  comfy pr-cache list              # List cached PR builds\n  comfy pr-cache clean             # Clean all cached builds\n  comfy pr-cache clean 456         # Clean specific PR cache\n  ```\n\n  - Cache automatically expires after 7 days\n  - Maximum of 10 PR builds are kept (oldest are removed automatically)\n  - Cache limits help manage disk space while keeping recent builds available\n\n### Managing Custom Nodes\n\ncomfy provides a convenient way to manage custom nodes for extending ComfyUI's functionality. Here are some examples:\n\n- Show custom nodes' information:\n\n```\ncomfy node [show|simple-show] [installed|enabled|not-installed|disabled|all|snapshot|snapshot-list]\n                             ?[--channel \u003Cchannel name>]\n                             ?[--mode [remote|local|cache]]\n```\n\n- `comfy node show all --channel recent`\n\n  `comfy node simple-show installed`\n\n  `comfy node update all`\n\n  `comfy node install comfyui-impact-pack`\n\n- Managing snapshot:\n\n  `comfy node save-snapshot`\n\n  `comfy node restore-snapshot \u003Csnapshot name>`\n\n- Install dependencies:\n\n  `comfy node install-deps --deps=\u003Cdeps .json file>`\n\n  `comfy node install-deps --workflow=\u003Cworkflow .json\u002F.png file>`\n\n- Generate deps:\n\n  `comfy node deps-in-workflow --workflow=\u003Cworkflow .json\u002F.png file> --output=\u003Coutput deps .json file>`\n\n#### Unified Dependency Resolution (--uv-compile)\n\nRequires ComfyUI-Manager v4.1+. Instead of installing dependencies per-node with\n`pip install`, `--uv-compile` delegates to ComfyUI-Manager's unified resolver which batch-resolves\nall custom node dependencies via `uv pip compile` with **cross-node conflict detection** —\nit can identify which node packs have incompatible dependencies and why.\n\n- Install with unified resolution:\n\n  `comfy node install comfyui-impact-pack --uv-compile`\n\n- Available on: `install`, `reinstall`, `update`, `fix`, `restore-snapshot`,\n  `restore-dependencies`, `install-deps`\n\n- Run standalone (resolve all existing custom node dependencies):\n\n  `comfy node uv-sync`\n\n- `--uv-compile` is mutually exclusive with `--fast-deps` and `--no-deps`.\n\n- To make `--uv-compile` the default for all commands, see\n  [uv-compile default](#uv-compile-default) below.\n\n- Use `--no-uv-compile` to override the default for a single command:\n\n  `comfy node install comfyui-impact-pack --no-uv-compile`\n\n#### --fast-deps vs --uv-compile\n\nBoth flags use `uv` for faster dependency resolution, but they work differently:\n\n|                       | `--fast-deps`                                   | `--uv-compile`                                |\n|-----------------------|-------------------------------------------------|-----------------------------------------------|\n| **Resolver**          | comfy-cli built-in (`DependencyCompiler`)       | ComfyUI-Manager (`UnifiedDepResolver`)        |\n| **Scope**             | `comfy install`, `comfy node install\u002Freinstall` | Custom node commands only                     |\n| **Conflict handling** | Interactive prompt to pick a version            | Automatic detection with node attribution     |\n| **Config default**    | No                                              | Yes (`comfy manager uv-compile-default true`) |\n| **Requires**          | Only `uv`                                       | ComfyUI-Manager v4.1+                         |\n\n**When to use which:**\n- For initial ComfyUI installation with uv: `comfy install --fast-deps`\n- For custom node management with Manager v4.1+: `--uv-compile` (recommended)\n- For custom node management with older Manager: `--fast-deps`\n\n#### Bisect custom nodes\n\nIf you encounter bugs only with custom nodes enabled, and want to find out which custom node(s) causes the bug,\nthe bisect tool can help you pinpoint the custom node that causes the issue.\n\n- `comfy node bisect start`: Start a new bisect session with optional ComfyUI launch args. It automatically marks the starting state as bad, and takes all enabled nodes when the command executes as the test set.\n- `comfy node bisect good`: Mark the current active set as good, indicating the problem is not within the test set.\n- `comfy node bisect bad`: Mark the current active set as bad, indicating the problem is within the test set.\n- `comfy node bisect reset`: Reset the current bisect session.\n\n### Managing Models\n\n- Model downloading\n\n  `comfy model download --url \u003CURL> ?[--relative-path \u003CPATH>] ?[--set-civitai-api-token \u003CTOKEN>] ?[--set-hf-api-token \u003CTOKEN>]`\n\n  - URL: CivitAI page, Hugging Face file URL, etc...\n  - You can also specify your API tokens via the `CIVITAI_API_TOKEN` and `HF_API_TOKEN` environment variables. The order of priority is `--set-X-token` (always highest priority), then the environment variables if they exist, and lastly your config's stored tokens from previous `--set-X-token` usage (which remembers your most recently set token values).\n  - Tokens provided via the environment variables are never stored persistently in your config file. They are intended as a way to easily and safely provide transient secrets.\n\n- Model remove\n\n  `comfy model remove ?[--relative-path \u003CPATH>] --model-names \u003Cmodel names>`\n\n- Model list\n\n  `comfy model list ?[--relative-path \u003CPATH>]`\n\n### Managing ComfyUI-Manager\n\n- Disable ComfyUI-Manager completely (no manager flags passed to ComfyUI):\n\n  `comfy manager disable`\n\n- Enable ComfyUI-Manager with new GUI:\n\n  `comfy manager enable-gui`\n\n- Enable ComfyUI-Manager without GUI (manager runs but UI is hidden):\n\n  `comfy manager disable-gui`\n\n- Enable ComfyUI-Manager with legacy GUI:\n\n  `comfy manager enable-legacy-gui`\n\n- Clear reserved startup action:\n\n  `comfy manager clear`\n\n- Migrate legacy git-cloned ComfyUI-Manager to pip package:\n\n  `comfy manager migrate-legacy`\n\n#### uv-compile default\n\nSet `--uv-compile` as the default behavior for all custom node operations:\n\n  `comfy manager uv-compile-default true`\n\nWhen enabled, all node commands (`install`, `reinstall`, `update`, `fix`,\n`restore-snapshot`, `restore-dependencies`, `install-deps`) will automatically\nuse `--uv-compile`. Use `--no-uv-compile` on any individual command to override.\n\nTo disable:\n\n  `comfy manager uv-compile-default false`\n\n## Beta Feature: format of comfy-lock.yaml (WIP)\n\n```\nbasic:\n\nmodels:\n  - model: [name of the model]\n    url: [url of the source, e.g. https:\u002F\u002Fhuggingface.co\u002F...]\n    paths: [list of paths to the model]\n      - path: [path to the model]\n      - path: [path to the model]\n    hashes: [hashes for the model]\n      - hash: [hash]\n        type: [AutoV1, AutoV2, SHA256, CRC32, and Blake3]\n    type: [type of the model, e.g. diffuser, lora, etc.]\n\n  - model:\n  ...\n\n# compatible with ComfyUI-Manager's .yaml snapshot\ncustom_nodes:\n  comfyui: [commit hash]\n  file_custom_nodes:\n  - disabled: [bool]\n    filename: [.py filename]\n    ...\n  git_custom_nodes:\n    [git-url]:\n      disabled: [bool]\n      hash: [commit hash]\n    ...\n```\n\n## Analytics\n\nWe track analytics using Mixpanel to help us understand usage patterns and know where to prioritize our efforts. When you first download the cli, it will ask you to give consent. If at any point you wish to opt out:\n\n```\ncomfy tracking disable\n```\n\nCheck out the usage here: [Mixpanel Board](https:\u002F\u002Fmixpanel.com\u002Fp\u002F13hGfPfEPdRkjPtNaS7BYQ)\n\n## Contributing\n\nWe welcome contributions to comfy-cli! If you have any ideas, suggestions, or\nbug reports, please open an issue on our [GitHub\nrepository](https:\u002F\u002Fgithub.com\u002Fyoland68\u002Fcomfy-cli\u002Fissues). If you'd like to contribute code,\nplease fork the repository and submit a pull request.\n\nCheck out the [Dev Guide](\u002FDEV_README.md) for more details.\n\n## License\n\ncomfy is released under the [GNU General Public License v3.0](https:\u002F\u002Fgithub.com\u002Fyoland68\u002Fcomfy-cli\u002Fblob\u002Fmaster\u002FLICENSE).\n\n## Support\n\nIf you encounter any issues or have questions about comfy-cli, please [open an issue](https:\u002F\u002Fgithub.com\u002Fcomfy-cli\u002Fissues) on our GitHub repository or contact us on [Discord](https:\u002F\u002Fdiscord.com\u002Finvite\u002Fcomfyorg). We'll be happy to assist you!\n\nHappy diffusing with ComfyUI and comfy-cli! 🎉\n","# comfy-cli：ComfyUI 的命令行工具\n\n[![运行 pytest](https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Factions\u002Fworkflows\u002Fpytest.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Factions\u002Fworkflows\u002Fpytest.yml)\n[![codecov](https:\u002F\u002Fcodecov.io\u002Fgithub\u002FComfy-Org\u002Fcomfy-cli\u002Fgraph\u002Fbadge.svg?token=S64WJWD2ZX)](https:\u002F\u002Fcodecov.io\u002Fgithub\u002FComfy-Org\u002Fcomfy-cli)\n[![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fcomfy-cli.svg)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fcomfy-cli\u002F)\n[![下载量](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FComfy-Org_comfy-cli_readme_7d417aca750f.png)](https:\u002F\u002Fpepy.tech\u002Fproject\u002Fcomfy-cli)\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fpyversions\u002Fcomfy-cli)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fcomfy-cli\u002F)\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fl\u002Fcomfy-cli)](https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fblob\u002Fmain\u002FLICENSE)\n\ncomfy-cli 是一款命令行工具，可帮助用户轻松安装和管理 [ComfyUI](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI)，这是一个功能强大的开源机器学习框架。借助 comfy-cli，您可以通过终端便捷地快速搭建 ComfyUI、安装软件包以及管理自定义节点。\n\n## 演示\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FComfy-Org_comfy-cli_readme_61965f8e343f.gif\" width=\"400\" alt=\"Comfy 命令演示\">\n\n## 功能特性\n\n- 🚀 通过一条命令即可轻松安装 ComfyUI\n- 📦 无缝管理 ComfyUI 扩展及依赖包\n- 🔧 管理自定义节点，扩展 ComfyUI 功能\n- 🗄️ 下载检查点并保存模型哈希值\n- 💻 跨平台兼容性（Windows、macOS、Linux）\n- 📖 详尽的文档与示例\n- 🎉 自动为 ComfyUI 安装拉取请求\n\n## 安装\n\n1. （推荐，但非必需）启用虚拟环境（[venv](https:\u002F\u002Fdocs.python.org\u002F3\u002Flibrary\u002Fvenv.html)\u002F[conda](https:\u002F\u002Fconda.io\u002Fprojects\u002Fconda\u002Fen\u002Flatest\u002Fuser-guide\u002Fgetting-started.html)）\n\n2. 要安装 comfy-cli，请确保您的系统已安装 Python 3.9 或更高版本。然后运行以下命令：\n\n   `pip install comfy-cli`\n\n### Shell 自动补全\n\n要在您的 shell 中安装自动补全提示，请运行：\n\n`comfy --install-completion`\n\n这将使您能够输入 `comfy [TAB]` 来自动完成命令和选项。\n\n## 使用方法\n\n### 安装 ComfyUI\n\n要使用 comfy 安装 ComfyUI，只需运行：\n\n`comfy install`\n\n此命令将在您的系统上下载并设置最新版本的 ComfyUI 和 ComfyUI-Manager。如果您在已经设置好的 ComfyUI 仓库中运行该命令，则只会更新 `comfy.yaml` 文件以反映本地设置。\n\n- `comfy install --skip-manager`：不安装 ComfyUI-Manager 直接安装 ComfyUI。若要使用自定义 Manager 分支或特定版本，请跳过默认安装，并将您自己的安装到工作区的 venv 中：\n  ```bash\n  comfy install --skip-manager\n  # 然后安装您的自定义 Manager：\n  pip install -e \u002Fpath\u002Fto\u002Fyour-manager-fork   # 可编辑安装\n  # 或\n  pip install comfyui-manager==4.1b8          # 特定版本\n  ```\n- `comfy --workspace=\u003Cpath> install`：将 ComfyUI 安装到 `\u003Cpath>\u002FComfyUI`。\n- `comfy install --fast-deps`：在首次安装 ComfyUI 时，使用 `uv` 替代 `pip` 以加快依赖项解析速度。comfy-cli 内置的解析器会将所有需求（核心 + 自定义节点）编译成一个单独的锁定文件，并从中进行安装。同时还会自动处理 GPU 特定的 PyTorch wheel 选择。\n- 对于 `comfy install`，如果没有提供如 `--workspace`、`--recent` 或 `--here` 等路径指定，则会默认安装在 `\u003CHOME>\u002Fcomfy`。\n\n#### Python 环境处理\n\n当您运行 `comfy install` 时，comfy-cli 会按照以下优先级为 ComfyUI 依赖项选择 Python 环境：\n\n1. 如果存在**活动的 virtualenv 或 conda** 环境（`VIRTUAL_ENV` \u002F `CONDA_PREFIX`），则直接使用该环境。\n2. 如果工作区内已存在 `.venv` 或 `venv` 目录，则复用该目录。\n3. 否则，选择取决于 comfy-cli 的安装方式：\n   - **`pip install comfy-cli`**（全局 \u002F 系统 Python）：依赖项将直接安装到同一 Python 环境中。这通常是 Docker 设置中的常见做法。\n   - **`pipx install comfy-cli`** 或 **`uv tool install comfy-cli`**（隔离的工具环境）：会在 ComfyUI 工作区内部创建一个 `.venv`。请使用 `comfy launch` 来启动具有正确 Python 环境的 ComfyUI。\n\n### 指定执行路径\n\n- 您可以通过以下路径指示符来指定命令将作用于的 ComfyUI 路径：\n  - `comfy --workspace=\u003Cpath>`：从指定工作区中安装的 ComfyUI 运行。\n  - `comfy --recent`：从最近执行或安装的 ComfyUI 运行。\n  - `comfy --here`：从当前目录下的 ComfyUI 运行。\n- `--workspace`、`--recent` 和 `--here` 选项不能同时使用。\n- 如果没有路径指示符，则按以下优先级执行：\n\n  - 从由 `comfy set-default \u003Cpath>` 指定的默认 ComfyUI 路径运行。\n  - 从最近执行或安装的 ComfyUI 运行。\n  - 从当前目录下的 ComfyUI 运行。\n\n- 示例 1：运行最近执行的 ComfyUI：\n  - `comfy --recent launch`\n- 示例 2：在当前目录下的 ComfyUI 上安装一个包：\n  - `comfy --here node install comfyui-impact-pack`\n- 示例 3：根据优先级更新自动选择的 ComfyUI 和自定义节点路径：\n\n  - `comfy node update all`\n\n- 您可以使用 `comfy which` 命令来检查目标工作区的路径。\n  - 例如 `comfy --recent which`、`comfy --here which`、`comfy which` 等。\n\n### 默认设置\n\n默认设置是指在未为命令指定特定工作区的 ComfyUI 时，将默认执行的选项。\n\n`comfy set-default \u003Cworkspace path> ?[--launch-extras=\"\u003Cextra args>\"]`\n\n- `--launch-extras` 选项指定了仅在默认启动时应用的额外参数。然而，如果在启动时指定了额外参数，则此设置将被忽略。\n\n### 启动 ComfyUI\n\nComfy 提供了一些命令，方便您轻松运行已安装的 ComfyUI。\n\n`comfy launch`\n\n- 使用默认 ComfyUI 选项运行：\n\n  `comfy launch -- \u003Cextra args...>`\n\n  `comfy launch -- --cpu --listen 0.0.0.0`\n\n  - 当您手动配置额外选项时，通过 `set-default` 设置的额外选项将被覆盖。\n\n- 后台运行：\n\n  `comfy launch --background`\n\n  `comfy --workspace=~\u002Fcomfy launch --background -- --listen 10.0.0.10 --port 8000`\n\n  - 使用 `--background` 启动的实例会显示在 `comfy env` 的“后台 ComfyUI”部分，仅提供对单个后台实例的管理功能。\n  - 由于 `comfy env` 中的“Comfy Server Running”只显示默认端口 8188，因此不会显示在其他端口上运行的 ComfyUI。\n  - 可以使用 `comfy stop` 停止后台运行的 ComfyUI。\n\n- 使用特定的 Pull Request 运行 ComfyUI：\n\n  `comfy install --pr \"#1234\"`\n\n  `comfy install --pr \"jtydhr88:load-3d-nodes\"`\n\n  `comfy install --pr \"https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI\u002Fpull\u002F1234\"`\n\n  - 如果您想使用特定的 Pull Request 运行 ComfyUI，可以使用 `--pr` 选项。这将自动安装指定的 Pull Request 并使用它来运行 ComfyUI。\n  - 注意：`--pr` 选项不能与 `--version` 或 `--commit` 同时使用，否则会被拒绝。\n\n- 测试前端 Pull Request：\n\n  ```\n  comfy launch --frontend-pr \"#456\"\n  comfy launch --frontend-pr \"username:branch-name\"\n  comfy launch --frontend-pr \"https:\u002F\u002Fgithub.com\u002FComfy-Org\u002FComfyUI_frontend\u002Fpull\u002F456\"\n  ```\n\n  - `--frontend-pr` 选项允许您通过自动克隆、构建并在此会话中使用该前端来测试前端 PR。\n  - 要求：必须安装 Node.js 和 npm 才能构建前端。\n  - 构建结果会被缓存，以便快速切换 PR——后续再次使用同一 PR 时会立即生效。\n  - 每个 PR 只用于当前的启动会话。正常启动时仍使用默认前端。\n\n  **管理 PR 缓存**：\n  ```\n  comfy pr-cache list              # 列出缓存的 PR 构建\n  comfy pr-cache clean             # 清除所有缓存的构建\n  comfy pr-cache clean 456         # 清除特定 PR 的缓存\n  ```\n\n  - 缓存会在 7 天后自动过期。\n  - 最多保留 10 个 PR 构建（最旧的会自动移除）。\n  - 缓存限制有助于管理磁盘空间，同时保持最近的构建可用。\n\n### 管理自定义节点\n\ncomfy 提供了一种便捷的方式来管理自定义节点，以扩展 ComfyUI 的功能。以下是一些示例：\n\n- 显示自定义节点的信息：\n\n```\ncomfy node [show|simple-show] [installed|enabled|not-installed|disabled|all|snapshot|snapshot-list]\n                             ?[--channel \u003Cchannel name>]\n                             ?[--mode [remote|local|cache]]\n```\n\n- `comfy node show all --channel recent`\n\n  `comfy node simple-show installed`\n\n  `comfy node update all`\n\n  `comfy node install comfyui-impact-pack`\n\n- 管理快照：\n\n  `comfy node save-snapshot`\n\n  `comfy node restore-snapshot \u003Csnapshot name>`\n\n- 安装依赖：\n\n  `comfy node install-deps --deps=\u003Cdeps .json file>`\n\n  `comfy node install-deps --workflow=\u003Cworkflow .json\u002F.png file>`\n\n- 生成依赖：\n\n  `comfy node deps-in-workflow --workflow=\u003Cworkflow .json\u002F.png file> --output=\u003Coutput deps .json file>`\n\n#### 统一依赖解析 (--uv-compile)\n\n需要 ComfyUI-Manager v4.1+。与其为每个节点单独使用 `pip install` 安装依赖，不如使用 `--uv-compile` 将任务交给 ComfyUI-Manager 的统一解析器，通过 `uv pip compile` 批量解析所有自定义节点的依赖，并具备跨节点冲突检测功能——它可以识别哪些节点包存在不兼容的依赖及其原因。\n\n- 使用统一解析安装：\n\n  `comfy node install comfyui-impact-pack --uv-compile`\n\n- 适用于：`install`、`reinstall`、`update`、`fix`、`restore-snapshot`、`restore-dependencies`、`install-deps`\n\n- 单独运行（解析所有现有自定义节点的依赖）：\n\n  `comfy node uv-sync`\n\n- `--uv-compile` 与 `--fast-deps` 和 `--no-deps` 互斥。\n\n- 若要将 `--uv-compile` 设为所有命令的默认设置，请参阅下方的 [uv-compile 默认设置]。\n\n- 使用 `--no-uv-compile` 可以覆盖单个命令的默认设置：\n\n  `comfy node install comfyui-impact-pack --no-uv-compile`\n\n#### --fast-deps 与 --uv-compile\n\n这两个标志都使用 `uv` 来加速依赖解析，但它们的工作方式有所不同：\n\n|                       | `--fast-deps`                                   | `--uv-compile`                                |\n|-----------------------|-------------------------------------------------|-----------------------------------------------|\n| **解析器**          | comfy-cli 内置的 (`DependencyCompiler`)       | ComfyUI-Manager (`UnifiedDepResolver`)        |\n| **适用范围**             | `comfy install`、`comfy node install\u002Freinstall` | 仅限自定义节点相关命令                     |\n| **冲突处理**          | 交互式提示选择版本                            | 自动检测并标注导致冲突的节点                 |\n| **默认配置**    | 无                                              | 是（`comfy manager uv-compile-default true`） |\n| **所需条件**          | 仅需 `uv`                                       | 需要 ComfyUI-Manager v4.1+                   |\n\n**何时使用哪个：**\n- 对于初次安装 ComfyUI 并希望使用 uv 时：`comfy install --fast-deps`\n- 对于使用 Manager v4.1+ 管理自定义节点时：`--uv-compile`（推荐）\n- 对于使用较旧版本 Manager 管理自定义节点时：`--fast-deps`\n\n#### 自定义节点二分法\n\n如果您遇到的问题仅在启用自定义节点时出现，并且想找出是哪个或哪些自定义节点导致了问题，那么二分法工具可以帮助您定位具体问题节点。\n\n- `comfy node bisect start`：开始一个新的二分法会话，可选传入 ComfyUI 启动参数。执行命令时会自动将起始状态标记为“坏”，并将当时启用的所有节点作为测试集。\n- `comfy node bisect good`：将当前活动节点集合标记为“好”，表示问题不在该测试集中。\n- `comfy node bisect bad`：将当前活动节点集合标记为“坏”，表示问题在该测试集中。\n- `comfy node bisect reset`：重置当前的二分法会话。\n\n### 管理模型\n\n- 模型下载\n\n  `comfy model download --url \u003CURL> ?[--relative-path \u003CPATH>] ?[--set-civitai-api-token \u003CTOKEN>] ?[--set-hf-api-token \u003CTOKEN>]`\n\n  - URL：CivitAI 页面、Hugging Face 文件 URL 等...\n  - 您也可以通过 `CIVITAI_API_TOKEN` 和 `HF_API_TOKEN` 环境变量指定您的 API 令牌。优先级顺序为：`--set-X-token`（始终最高）、环境变量（如果存在），最后是您配置文件中之前使用 `--set-X-token` 时保存的令牌（会记住您最近设置的令牌值）。\n  - 通过环境变量提供的令牌绝不会持久化存储在您的配置文件中。它们旨在以安全且便捷的方式提供临时密钥。\n\n- 删除模型\n\n  `comfy model remove ?[--relative-path \u003CPATH>] --model-names \u003C模型名称>`\n\n- 列出模型\n\n  `comfy model list ?[--relative-path \u003CPATH>]`\n\n### 管理 ComfyUI-Manager\n\n- 完全禁用 ComfyUI-Manager（不向 ComfyUI 传递管理器标志）：\n\n  `comfy manager disable`\n\n- 启用带有新 GUI 的 ComfyUI-Manager：\n\n  `comfy manager enable-gui`\n\n- 启用不带 GUI 的 ComfyUI-Manager（管理器运行但 UI 隐藏）：\n\n  `comfy manager disable-gui`\n\n- 启用带有旧版 GUI 的 ComfyUI-Manager：\n\n  `comfy manager enable-legacy-gui`\n\n- 清除预留的启动操作：\n\n  `comfy manager clear`\n\n- 将旧版通过 Git 克隆的 ComfyUI-Manager 迁移到 pip 包：\n\n  `comfy manager migrate-legacy`\n\n#### 默认启用 uv-compile\n\n将 `--uv-compile` 设置为所有自定义节点操作的默认行为：\n\n  `comfy manager uv-compile-default true`\n\n启用后，所有节点命令（`install`、`reinstall`、`update`、`fix`、`restore-snapshot`、`restore-dependencies`、`install-deps`）都会自动使用 `--uv-compile`。如需覆盖此设置，可在单个命令中使用 `--no-uv-compile`。\n\n要禁用：\n\n  `comfy manager uv-compile-default false`\n\n## 测试功能：comfy-lock.yaml 的格式（开发中）\n\n```\nbasic:\n\nmodels:\n  - model: [模型名称]\n    url: [来源网址，例如 https:\u002F\u002Fhuggingface.co\u002F...]\n    paths: [模型路径列表]\n      - path: [模型路径]\n      - path: [模型路径]\n    hashes: [模型哈希值]\n      - hash: [哈希值]\n        type: [AutoV1、AutoV2、SHA256、CRC32 和 Blake3]\n    type: [模型类型，例如 diffuser、lora 等]\n\n  - model:\n  ...\n\n# 与 ComfyUI-Manager 的 .yaml 快照兼容\ncustom_nodes:\n  comfyui: [提交哈希]\n  file_custom_nodes:\n  - disabled: [布尔值]\n    filename: [.py 文件名]\n    ...\n  git_custom_nodes:\n    [git URL]:\n      disabled: [布尔值]\n      hash: [提交哈希]\n    ...\n```\n\n## 分析数据\n\n我们使用 Mixpanel 跟踪分析数据，以帮助我们了解使用模式并确定工作重点。首次下载 CLI 时，系统会请求您同意收集数据。如果您希望随时退出：\n\n```\ncomfy tracking disable\n```\n\n您可以在此处查看使用情况：[Mixpanel 板](https:\u002F\u002Fmixpanel.com\u002Fp\u002F13hGfPfEPdRkjPtNaS7BYQ)\n\n## 贡献\n\n我们欢迎对 comfy-cli 的贡献！如果您有任何想法、建议或错误报告，请在我们的 [GitHub 仓库](https:\u002F\u002Fgithub.com\u002Fyoland68\u002Fcomfy-cli\u002Fissues) 中提交问题。如果您想贡献代码，请先 fork 该仓库，然后提交 pull request。\n\n更多详情请参阅 [开发指南](\u002FDEV_README.md)。\n\n## 许可证\n\ncomfy 采用 [GNU 通用公共许可证 v3.0](https:\u002F\u002Fgithub.com\u002Fyoland68\u002Fcomfy-cli\u002Fblob\u002Fmaster\u002FLICENSE) 发布。\n\n## 支持\n\n如果您在使用 comfy-cli 时遇到任何问题或有疑问，请在我们的 GitHub 仓库中 [提交问题](https:\u002F\u002Fgithub.com\u002Fcomfy-cli\u002Fissues)，或通过 [Discord](https:\u002F\u002Fdiscord.com\u002Finvite\u002Fcomfyorg) 联系我们。我们将竭诚为您提供帮助！\n\n祝您使用 ComfyUI 和 comfy-cli 体验愉快！🎉","# comfy-cli 快速上手指南\n\n`comfy-cli` 是一个命令行工具，旨在帮助用户轻松安装、管理和运行 [ComfyUI](https:\u002F\u002Fgithub.com\u002Fcomfyanonymous\u002FComfyUI)。它支持跨平台（Windows, macOS, Linux），提供一键安装、自定义节点管理及依赖解析等功能。\n\n## 环境准备\n\n在开始之前，请确保您的系统满足以下要求：\n\n*   **操作系统**：Windows、macOS 或 Linux。\n*   **Python 版本**：必须安装 **Python 3.9** 或更高版本。\n*   **推荐环境**：建议先创建并激活虚拟环境（如 `venv` 或 `conda`），以避免依赖冲突（非强制，但推荐）。\n    ```bash\n    # 示例：创建 venv\n    python -m venv venv\n    # Windows 激活\n    venv\\Scripts\\activate\n    # macOS\u002FLinux 激活\n    source venv\u002Fbin\u002Factivate\n    ```\n*   **可选加速**：国内用户若遇到下载慢的问题，可配置 pip 国内镜像源（如清华源）：\n    ```bash\n    pip config set global.index-url https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n    ```\n\n## 安装步骤\n\n1.  **安装 comfy-cli**\n    使用 pip 进行安装：\n    ```bash\n    pip install comfy-cli\n    ```\n\n2.  **启用命令自动补全（可选）**\n    安装后，运行以下命令以在终端中启用命令和选项的自动补全功能：\n    ```bash\n    comfy --install-completion\n    ```\n    启用后，输入 `comfy` 后按 `Tab` 键即可自动提示后续命令。\n\n## 基本使用\n\n### 1. 安装 ComfyUI\n这是最常用的命令，它将下载并设置最新版本的 ComfyUI 及 ComfyUI-Manager。默认安装路径为 `\u003C用户主目录>\u002Fcomfy`。\n\n```bash\ncomfy install\n```\n\n*   **指定安装路径**：\n    ```bash\n    comfy --workspace=\u002Fpath\u002Fto\u002Fyour\u002Fdir install\n    ```\n*   **使用更快的依赖解析**（推荐，需安装 `uv`）：\n    ```bash\n    comfy install --fast-deps\n    ```\n*   **跳过 Manager 安装**（如需使用特定版本或 fork 版）：\n    ```bash\n    comfy install --skip-manager\n    ```\n\n### 2. 启动 ComfyUI\n安装完成后，直接运行以下命令即可启动 ComfyUI：\n\n```bash\ncomfy launch\n```\n\n*   **传递额外参数**（例如监听所有 IP）：\n    ```bash\n    comfy launch -- --listen 0.0.0.0\n    ```\n*   **后台运行**：\n    ```bash\n    comfy launch --background\n    ```\n*   **测试前端 PR**（需安装 Node.js）：\n    ```bash\n    comfy launch --frontend-pr \"#456\"\n    ```\n\n### 3. 管理自定义节点 (Custom Nodes)\n`comfy-cli` 提供了便捷的节点管理命令：\n\n*   **安装节点**：\n    ```bash\n    comfy node install comfyui-impact-pack\n    ```\n*   **更新所有节点**：\n    ```bash\n    comfy node update all\n    ```\n*   **查看已安装的节点**：\n    ```bash\n    comfy node simple-show installed\n    ```\n*   **统一依赖解析**（推荐用于解决依赖冲突，需 ComfyUI-Manager v4.1+）：\n    ```bash\n    comfy node install \u003Cnode-name> --uv-compile\n    ```\n\n### 4. 指定工作区\n如果系统中安装了多个 ComfyUI，可以通过以下标识指定操作对象：\n\n*   `--workspace=\u003Cpath>`：指定具体路径。\n*   `--recent`：针对最近运行或安装的实例。\n*   `--here`：针对当前目录下的实例。\n\n**示例**：更新当前目录下的 ComfyUI 节点：\n```bash\ncomfy --here node update all\n```\n\n**示例**：查看目标工作区路径：\n```bash\ncomfy which\n```","一位 AI 艺术家需要在多台不同操作系统的设备上快速部署最新的 ComfyUI 环境，并频繁测试各类自定义节点以创作复杂工作流。\n\n### 没有 comfy-cli 时\n- **环境配置繁琐**：每次换新电脑或重置系统，都需手动克隆仓库、创建虚拟环境并逐个安装依赖，耗时且容易因路径错误导致失败。\n- **节点管理混乱**：更新或卸载自定义节点时，需深入文件夹手动操作，常因版本冲突引发界面报错，排查问题极其困难。\n- **模型下载低效**：寻找和下载大体积检查点（Checkpoints）需手动浏览网页，缺乏统一的哈希值校验机制，文件完整性难以保证。\n- **跨平台兼容性差**：在 Windows、macOS 和 Linux 之间切换时，需反复查阅不同的安装文档，脚本不通用导致维护成本高昂。\n\n### 使用 comfy-cli 后\n- **一键极速部署**：仅需运行 `comfy install`，工具自动完成环境搭建、依赖解析及 ComfyUI-Manager 配置，将数小时的准备工作缩短至几分钟。\n- **智能节点管控**：通过终端命令即可轻松安装、更新或移除自定义节点，自动处理依赖冲突，确保工作流稳定运行。\n- **模型资产管理**：内置模型下载与哈希保存功能，直接从命令行获取验证过的模型文件，杜绝损坏文件导致的运行崩溃。\n- **全平台统一体验**：无论底层系统是 Win、Mac 还是 Linux，均使用相同的命令逻辑，彻底消除平台差异带来的学习负担。\n\ncomfy-cli 将原本碎片化、高门槛的环境运维工作转化为标准化的命令行操作，让创作者能专注于算法创意而非配置调试。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FComfy-Org_comfy-cli_61965f8e.gif","Comfy-Org","Comfy Org","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FComfy-Org_bd077766.png","",null,"hello@comfy.org","comfyui","https:\u002F\u002Fcomfy.org","https:\u002F\u002Fgithub.com\u002FComfy-Org",[83],{"name":84,"color":85,"percentage":86},"Python","#3572A5",100,754,120,"2026-04-16T21:52:45","GPL-3.0","Windows, macOS, Linux","未说明（工具本身为管理脚本，具体 GPU 需求取决于安装的 ComfyUI 及模型）","未说明",{"notes":95,"python":96,"dependencies":97},"该工具是 ComfyUI 的命令行管理助手，并非直接运行 AI 模型的核心程序。支持通过 venv 或 conda 虚拟环境安装；若使用 pipx 或 uv tool 安装，会自动在工作区创建 .venv。测试前端 Pull Request 时需预先安装 Node.js 和 npm。支持自动处理特定 GPU 的 PyTorch wheel 选择。","3.9+",[98,99,100],"uv (可选，用于加速依赖解析)","ComfyUI-Manager (v4.1+ 用于统一依赖解析)","Node.js 和 npm (仅测试前端 PR 时需要)",[15,14,13],[103,79,104,105],"ai","command-line","stable-diffusion","2026-03-27T02:49:30.150509","2026-04-18T14:13:16.371655",[109,114,119,124,129,133],{"id":110,"question_zh":111,"answer_zh":112,"source_url":113},39967,"在 CentOS 7.9 上使用 pip 安装 comfy-cli 时遇到 'av' 包构建失败错误怎么办？","该错误是因为 CentOS 7.9 自带的 ffmpeg-devel 版本（2.8.15）过旧，无法满足新版 'av' 包的编译需求。最可靠的解决方法是在 conda 环境中通过 conda-forge 安装预编译二进制文件：\n\n1. 运行命令：`conda install -c conda-forge av`\n2. 安装成功后，重新运行：`comfy install --restore`\n\n如果 conda-forge 无法解决，由于 CentOS 7.9 的系统限制，建议长期使用更新的操作系统（如 Ubuntu 22.04）或使用基于现代发行版的 Docker 容器运行 ComfyUI。若无需多媒体功能，也可尝试直接运行 `comfy launch` 或 `python main.py` 跳过该依赖。","https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fissues\u002F327",{"id":115,"question_zh":116,"answer_zh":117,"source_url":118},39968,"为什么使用 token 从 CivitAI 下载模型时会报 401 未授权错误？","这是 comfy-cli 1.5.0+ 版本引入的一个回归 bug，导致即使设置了 API token 也无法正确认证。该问题已在后续发布的新版本中修复。\n\n解决方案：请将 comfy-cli 升级到最新发布的版本。升级后，使用 `--set-civitai-api-token` 参数或设置 `CIVITAI_API_TOKEN` 环境变量即可正常下载需要登录的资源。","https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fissues\u002F322",{"id":120,"question_zh":121,"answer_zh":122,"source_url":123},39969,"运行 comfy-cli 帮助命令时报错 'TypeError: Parameter.make_metavar() missing 1 required positional argument: ctx' 如何解决？","该错误是由于 `typer` 和 `click` 库的版本不兼容导致的。此问题已在 2026 年 1 月完全解决。\n\n解决方案：请确保安装最新版本的 comfy-cli。维护者已移除了对 click 的强制版本锁定，并将 `typer` 依赖提升至 `>=0.12.5`。如果您仍遇到此问题，请尝试卸载后重新安装：\n`pipx uninstall comfy-cli`\n`pipx install comfy-cli`","https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fissues\u002F264",{"id":125,"question_zh":126,"answer_zh":127,"source_url":128},39970,"在使用 comfy-cli 运行工作流时遇到图像编辑器崩溃或模型加载错误怎么办？","如果日志中出现特定模型（如 QwenImageTEModel_）加载异常或崩溃，这通常不是 comfy-cli 本身的问题，而是工作流中使用的特定节点或模型兼容性问题。\n\n建议步骤：\n1. 检查是否使用了实验性或不稳定的模型\u002F节点，尝试替换为稳定版本（如 Stable Diffusion 或 RealisticVision）。\n2. 确保 ComfyUI 后端已正确更新到与支持该工作流相匹配的版本。\n3. 如果问题依旧，请在 ComfyUI 主仓库而非 comfy-cli 仓库提交 issue，因为此类崩溃通常源于核心后端而非 CLI 工具。","https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fissues\u002F334",{"id":130,"question_zh":131,"answer_zh":132,"source_url":113},39971,"如何确认 comfy-cli 安装环境是否正确？","当遇到依赖安装失败或运行时错误时，可以使用内置命令检查环境状态。运行以下命令查看当前环境配置和依赖情况：\n`comfy env`\n\n该命令会显示 Python 版本、已安装的包、路径配置等信息，有助于排查如 'av' 包构建失败或权限问题等环境相关错误。根据输出信息，您可以决定是否需要切换虚拟环境、更新系统库或改用 Docker 容器。",{"id":134,"question_zh":135,"answer_zh":136,"source_url":118},39972,"设置 CivitAI API Token 的正确方法有哪些？","在 comfy-cli 中设置 CivitAI API Token 有两种等效方式：\n\n1. **命令行参数方式**：在下载命令中直接使用 `--set-civitai-api-token` 参数：\n   `comfy model download --url '\u003Curl>' --set-civitai-api-token '\u003Cyour_token>'`\n\n2. **环境变量方式**：在执行命令前导出环境变量：\n   `export CIVITAI_API_TOKEN='\u003Cyour_token>'`\n   然后运行正常的下载命令。\n\n注意：请确保使用的是已修复该问题的 comfy-cli 版本（高于 1.5.0 的修复版），否则即使设置 token 也会报 401 错误。",[138,143,148,153,158,163,168,173,178,183,188,193,198,203,208,213,218,223,228,233],{"id":139,"version":140,"summary_zh":141,"released_at":142},323478,"v1.7.2","## 变更内容\n* 功能：由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F405 中改进了 `--fast-deps` 和 `--uv-compile` 的文档说明。\n* 功能：由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F414 中为模型下载新增了 aria2 RPC 下载后端。\n* 修复：当 PyTorch 版本 ≥ 2.11 时，`fast-deps` 会移除 CUDA 运行时包，此修复由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F413 中完成。\n* 修复：当使用 uv pip install\u002Fsync 失败时，打印 NFS 临时解决方案提示，此修复由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F417 中完成。\n* 修复：在 comfy update 中优雅地处理缺少 cm-cli 的情况，此修复由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F419 中完成。\n* 杂项（依赖）：由 @dependabot[bot] 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F423 中将 uv 组中的 uv 从 0.9.6 升级至 0.11.6。\n* 修复：在模型下载中重试瞬时错误，并清理部分下载的文件，此修复由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F422 中完成。\n* 功能：在模型下载完成后显示耗时，此功能由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F427 中实现。\n* 修复：在 get_latest_release 中使用 GITHUB_TOKEN 以避免速率限制，此修复由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F428 中完成。\n\n特别感谢 @Kinasa0096 发现并报告了这些问题！\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.7.1...v1.7.2","2026-04-12T14:31:40",{"id":144,"version":145,"summary_zh":146,"released_at":147},323479,"v1.7.1","## 变更内容\n* 功能：由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F398 中添加对 CUDA 13.0 的支持\n* 功能：由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F399 中实现自动检测 CUDA 驱动版本以选择合适的 PyTorch 轮子包\n* 修复：由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F400 中过滤 bisect 节点列表中的 FETCH 进度行\n* 功能：由 @snomiao 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F386 中添加 `comfy code-search`（别名 `comfy cs`）子命令\n* 修复：由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F401 中为非 Git 安装添加基于文件的 fallback 机制，用于检查 ComfyRepo\n* CI：由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F396 中移除已损坏的 Homebrew 发布任务\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.7.0...v1.7.1","2026-04-01T07:41:40",{"id":149,"version":150,"summary_zh":151,"released_at":152},323480,"v1.7.0","## 变更内容\n* feat: 增加 ComfyUI-Manager v4 支持，并由 @ltdrdata 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F363 中实现 uv-compile 统一依赖解析\n* chore(deps): 在 1 个目录下的 uv 组中，将 requests 从 2.32.4 升级至 2.33.0，由 @dependabot[bot] 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F387 中完成\n* fix: 修正 CLI 命令中的退出码和错误信息，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F388 中完成\n* refactor: 提取 PyTorch 安装辅助函数，并统一 PR 引用解析器，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F389 中完成\n* test: 为 config_manager 和 env_checker 添加测试覆盖率，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F390 中完成\n* test: 为 utils.py 中的 download_url 和 tarball 往返功能添加测试覆盖率，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F391 中完成\n* test: 为 comfy node pack 添加集成测试，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F392 中完成\n* fix: 对于全局 Python 安装，跳过工作区虚拟环境的创建，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F394 中完成\n* test: 修复安装测试中的 os.chdir 泄漏以及 ConfigManager 的磁盘写入问题，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F395 中完成\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.6.1...v1.7.0","2026-03-28T13:01:01",{"id":154,"version":155,"summary_zh":156,"released_at":157},323481,"v1.6.1","## 变更内容\n* 修复：在工作区操作中使用正确的 Python 可执行文件，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F375 中完成\n* 修复：在 Comfy 节点初始化时从 Git 远程 URL 中剥离凭据，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F376 中完成\n* 新增功能：将 `subprocess.run` 改为在管理器运行时打印输出，由 @wutzebaer 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F353 中完成\n* 修复：更新 README 中的徽章，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F377 中完成\n* 修复：为 PyPI 更新检查添加超时机制，以防止离线时程序挂起，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F378 中完成\n* 修复：在 AMD ROCm 版本的 PyTorch 安装中使用 `--index-url`，并添加 `--rocm-version` 标志，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F379 中完成\n* 修复：在 NVIDIA 版本的 PyTorch 安装中使用 `--index-url`，并将 `--cuda-version` 传递给 `fast-deps` 路径，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F380 中完成\n* 修复：使端到端测试 `test_node` 对临时性的 Git 克隆失败更具韧性，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F381 中完成\n* 修复：`--fast-deps` 现在会尊重 `--skip-torch-or-directml` 选项，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F382 中完成\n* 修复：在 `pyproject.toml` 中支持 PEP 639 SPDX 许可证标识符，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F383 中完成\n* 修复：在 `comfy run` 中优雅地处理 WebSocket 错误，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F384 中完成\n* 修复：在 `comfy run` 中处理未知节点 ID 时不会崩溃，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F385 中完成\n\n## 新贡献者\n* @wutzebaer 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F353 中做出了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.6.0...v1.6.1","2026-03-26T13:19:33",{"id":159,"version":160,"summary_zh":161,"released_at":162},323482,"v1.6.0","## 变更内容\n* 改进 npm 未找到错误信息，添加针对不同操作系统的指导说明，由 @christian-byrne 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F354 中实现。\n* 修复：将 typer 更新至 >=0.12.5，以支持 PEP 604 联合类型，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F357 中完成。\n* 测试：为 _print_npm_not_found_help 函数添加覆盖率测试，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F359 中完成。\n* 修复：从配置文件中解析布尔值的问题，由 @KennethWussmann 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F364 中修复。\n* 使用 Dependabot[bot] 将 uv 组在 1 个目录下批量升级 4 次，相关更改见 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F358。\n* 修复了 Windows 下的 URL 命名问题，并修正了旧版 cpython 版本号中的错误，由 @AllenCraigBarnard 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F366 中完成。\n* 修复：修正安装命令验证中的运算符优先级问题，由 @Xyc2016 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F365 中完成。\n* 修复：动态解析独立 Python 的补丁版本号，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F369 中完成。\n* 修复：为 --cpu 安装路径应用 --pr 验证并进行透传处理，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F370 中完成。\n* 修复：处理 download_file 函数中缺失 Content-Length 头部的情况，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F371 中完成。\n* 修复：模型列表和移除功能现在会查找子目录中的文件，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F372 中完成。\n* 修复：在依赖编译时使用 --torch-backend 替代 --extra-index-url，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F373 中完成。\n* 修复：当当前工作目录为默认工作区时，应用 default_launch_extras 设置，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F374 中完成。\n\n## 新贡献者\n* @KennethWussmann 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F364 中完成了首次贡献。\n* @AllenCraigBarnard 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F366 中完成了首次贡献。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.5.4...v1.6.0","2026-03-13T10:51:12",{"id":164,"version":165,"summary_zh":166,"released_at":167},323483,"v1.5.4","## 变更内容\n* 在 \u002F.github\u002Fworkflows 中，由 @dependabot[bot] 提交的 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F324 将 ci-dependencies 组别更新了 3 次。\n* 在 1 个目录中，由 @dependabot[bot] 提交的 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F343 将 ci-dependencies 组别更新了 2 次。\n* 修复 comfy-cli install --cpu 仍会安装 CUDA 版本 PyTorch 的问题，由 @Xyc2016 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F345 中完成。\n* 繁琐任务：将 CI 构建迁移到使用 Python 3.10，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F347 中完成。\n* 重构 node show 参数，使用 Enum 以提高验证性和清晰度，由 @Xyc2016 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F346 中完成。\n* 繁琐任务：移除未使用的代码，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F348 中完成。\n* 将支持的最低 Python 版本设置为 3.10，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F349 中完成。\n* 修复（安装）：按标签安装较旧版本的 ComfyUI，由 @Xyc2016 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F350 中完成。\n* 修复 ComfyUI 仓库 URL，由 @fengsi 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F351 中完成。\n\n## 新贡献者\n* @Xyc2016 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F345 中完成了首次贡献。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.5.3...v1.5.4","2026-01-11T11:38:01",{"id":169,"version":170,"summary_zh":171,"released_at":172},323484,"v1.5.3","## 变更内容\n* @HenkDz 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F321 中为节点打包添加了 .comfyignore 支持\n* @yt-koike 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F326 中支持 CUDA 12.9\n* @fengsi 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F330 中修复了 `list_models()` 的返回类型问题\n* @qiacheng 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F331 中修复了嵌入式 Python 环境中 Intel Arc GPU 的安装问题，现在不再需要 Conda 环境\n* @fengsi 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F332 中正确解决了 `model list` 命令中的 `list` 名称冲突问题\n* @christian-byrne 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F336 中禁用了遥测功能\n\n## 新贡献者\n* @HenkDz 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F321 中完成了首次贡献\n* @yt-koike 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F326 中完成了首次贡献\n* @fengsi 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F330 中完成了首次贡献\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.5.2...v1.5.3","2025-11-08T06:57:17",{"id":174,"version":175,"summary_zh":176,"released_at":177},323485,"v1.5.2","## 变更内容\n* 在 \u002F.github\u002Fworkflows 中升级 ci-dependencies 组，并由 @dependabot[bot] 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F313 中进行了 2 次更新\n* 修复 Node.js\u002Fnpm\u002Fpnpm 的检测功能，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F316 中完成\n* 修复在安装自定义 Node.js 时 --exit-on-fail 参数的问题，由 @robinjhuang 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F317 中完成\n* 为之前的 PR 添加了针对 \"--exit-on-fail\" 的小型测试，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F318 中完成\n* 更新 install.py 以支持 Intel Arc GPU，由 @qiacheng 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F319 中完成\n* 修复在检查 URL 授权时不必要的完整文件下载问题，由 @qiacheng 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F320 中完成\n* 修复 (CivitAI)：正确解析带有查询参数的 URL，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F323 中完成\n\n## 新贡献者\n* @qiacheng 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F319 中完成了首次贡献\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.5.1...v1.5.2","2025-09-30T07:19:58",{"id":179,"version":180,"summary_zh":181,"released_at":182},323486,"v1.5.1","## 变更内容\n* 添加 uv-pre-commit，用于处理依赖锁文件，由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F308 中实现\n* [功能] 更新前端 PR 支持 nx 和 pnpm，由 @christian-byrne 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F314 中实现\n* 为 comfy node install 添加 --no-deps 参数。由 @robinjhuang 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F315 中实现\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.5.0...v1.5.1","2025-09-04T19:56:39",{"id":184,"version":185,"summary_zh":186,"released_at":187},323487,"v1.5.0","## 变更内容\n* 由 @coderfromthenorth93 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F283 中实现，从 `pyproject.toml` 文件的 `tool.comfy` 部分解析 `Banner`。\n* 由 @jtydhr88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F284 中添加 Web 元数据。\n* 由 @jtydhr88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F287 中添加 PR 支持功能。\n* 由 @jtydhr88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F288 中为 PR 支持功能添加 README。\n* 由 @snomiao 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F285 中更新 pyproject 规范至版本 2 #281。\n* 由 @Olexandr88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F293 中修复并替换损坏的 Discord 链接。\n* 由 @Arcitec 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F296 中重构配置解析逻辑，采用分层回退机制并增强覆盖支持。\n* 由 @ltdrdata 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F275 中为 `comfy node install` 命令新增 `--exit-on-fail` 支持。\n* 由 @ltdrdata 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F256 中修复与 'ruff' Python 环境不匹配的问题。\n* 由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F297 中移除对 \"numpy\u003C2\" 的版本锁定。\n* 由 @neverbiasu 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F286 中重构 `env` 命令，使用 `ui.display_table` 实现一致的表格显示。\n* 由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F298 中修复 ruff，使其在 CI 中输出需要更改的内容。\n* 由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F300 中添加 Codecov 配置。\n* 由 @Arcitec 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F299 中在 ConfigManager 中使用常量。\n* 由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F301 中添加 pre-commit 的 pyproject-fmt 检查。\n* 由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F302 中添加文件结尾修正和去除尾部空格的 pre-commit 检查。\n* 由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F303 中更新 ruff，并启用 PyUpgrade 规则。\n* 由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F304 中引入 ruff 的 RET504 规则。\n* 由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F305 中为 GitHub Actions 添加令牌权限。\n* 由 @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F306 中配置 Dependabot 用于 GitHub Actions。\n* 由 @dependabot[bot] 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F307 中将 \u002F.github\u002Fworkflows 中的 ci-dependencies 组别更新两次。\n* 由 @jtydhr88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F310 中改用 gh:comfy-org\u002Fcookiecutter-comfy-extension。\n* 由 @christian-byrne 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F309 中添加前端 PR 支持，用于测试 ComfyUI_frontend 的拉取请求。\n\n## 新贡献者\n* @Olexandr88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F293 中完成了首次贡献。\n* @Arcitec 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F296 中完成了首次贡献。\n* @bigcat88 在 https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F297 中完成了首次贡献。\n* @neverbiasu 在 https:\u002F\u002Fgithub.com\u002FComfy","2025-08-12T05:07:43",{"id":189,"version":190,"summary_zh":191,"released_at":192},323488,"v1.4.1","## What's Changed\r\n* Send additional metadata to registry service during node creation by @coderfromthenorth93 in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F279\r\n\r\n## New Contributors\r\n* @coderfromthenorth93 made their first contribution in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F279\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.4.0...v1.4.1","2025-06-09T16:36:15",{"id":194,"version":195,"summary_zh":196,"released_at":197},323489,"v1.4.0","## What's Changed\r\n* fix(config-parser): update registry domain into latest by @snomiao in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F276\r\n* Added: publish all files in includes field in pyproject.toml by @jtydhr88 in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F270\r\n* Fix Windows Unicode error in node commands by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F277\r\n\r\n## New Contributors\r\n* @jtydhr88 made their first contribution in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F270\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.3.9...v1.4.0","2025-05-29T22:22:19",{"id":199,"version":200,"summary_zh":201,"released_at":202},323490,"v1.3.9","## What's Changed\r\n* Fixed: Pin version of click dependency. by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F265\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.3.8...v1.3.9","2025-05-13T23:13:47",{"id":204,"version":205,"summary_zh":206,"released_at":207},323491,"v1.3.8","## What's Changed\r\n* Simplify function calls for enabling\u002Fdisabling tracking. by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F243\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.3.7...v1.3.8","2025-02-25T04:27:07",{"id":209,"version":210,"summary_zh":211,"released_at":212},323492,"v1.3.7","## What's Changed\r\nYou can scaffold a custom node repo using `comfy node scaffold` now.\r\n* Remove e2e tests for standalone command. by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F240\r\n* Add cookie-cutter template for custom nodes. by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F239\r\n* Use keyword arguments for cm-cli. by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F241\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.3.6...v1.3.7","2025-02-11T00:46:30",{"id":214,"version":215,"summary_zh":216,"released_at":217},323493,"v1.3.6","## What's Changed\r\n* [Fix tests] Use node registry name. by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F238\r\n* Use torch CUDA 12.6 as default by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F237\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.3.5...v1.3.6","2025-02-01T20:59:35",{"id":219,"version":220,"summary_zh":221,"released_at":222},323494,"v1.3.5","## What's Changed\r\n* Raise error for upload_file_to_signed_url function by @yoland68 in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F228\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.3.4...v1.3.5","2025-01-03T23:36:22",{"id":224,"version":225,"summary_zh":226,"released_at":227},323495,"v1.3.4","## What's Changed\r\n* Update default CUDA version to 12.4. by @jimlee2048 in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F222\r\n\r\n## New Contributors\r\n* @jimlee2048 made their first contribution in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F222\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.3.3...v1.3.4","2025-01-03T01:43:11",{"id":229,"version":230,"summary_zh":231,"released_at":232},323496,"v1.3.3","## What's Changed\r\n* Fixed: registry node pack file header should be zip. by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F225\r\n* [Registry] Publish all files tracked by git by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F224\r\n* Generate xml coverage. by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F227\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.3.2...v1.3.3","2024-12-31T22:12:53",{"id":234,"version":235,"summary_zh":236,"released_at":237},323497,"v1.3.2","## What's Changed\r\n* fix: specify commit hash by @sko00o in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F213\r\n* Add Ruff dependencies and warning message when custom nodes are using eval or exec calls by @yoland68 in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F218\r\n* Create validate command for ppl to test using the ruff checks by @yoland68 in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F219\r\n* Update default python to 3.12.8 for standalone. by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F221\r\n* Remove comfyui related prefix from node names. by @robinjhuang in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F220\r\n\r\n## New Contributors\r\n* @sko00o made their first contribution in https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fpull\u002F213\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FComfy-Org\u002Fcomfy-cli\u002Fcompare\u002Fv1.3.1...v1.3.2","2024-12-27T23:41:15"]