Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
a1c83ea
fix(i18n/zh): restore Generate (partner nodes) section and import, fi…
lin-bot23 Jun 11, 2026
8d51728
fix(i18n/zh): translate English paragraphs, event table, and See Also…
lin-bot23 Jun 11, 2026
b28ce82
fix(i18n/zh): restore missing use comfy generate section
lin-bot23 Jun 11, 2026
cc9e2b2
fix(i18n/zh): translate titles and recommended dev workflow
lin-bot23 Jun 11, 2026
d8a5ee0
fix(i18n/zh): complete missing translation content
lin-bot23 Jun 11, 2026
e6831ee
fix(i18n/zh): complete missing method translations
lin-bot23 Jun 11, 2026
d797bd2
fix(i18n/zh): complete translation content
lin-bot23 Jun 11, 2026
1ee3a8a
fix(i18n/zh): remove extra metadata
lin-bot23 Jun 11, 2026
d48ab33
fix(i18n/zh): restore Standard tier row and fix terminology
lin-bot23 Jun 11, 2026
cf21efc
fix(i18n/zh): fix terminology (beginning/install)
lin-bot23 Jun 11, 2026
5e4f725
fix(i18n/zh): remove invented content, restore what is section
lin-bot23 Jun 11, 2026
6e11766
fix(i18n/zh): remove extra WeChat section and metadata
lin-bot23 Jun 11, 2026
0308876
fix(i18n/zh): fix terminology and tool list, remove extra metadata
lin-bot23 Jun 11, 2026
f12698c
fix(i18n/zh): fix card descriptions and missing links
lin-bot23 Jun 11, 2026
0c9da12
fix(i18n/zh): replace inline poll code, fix terminology
lin-bot23 Jun 11, 2026
f1ad34a
fix(i18n/zh): add software section, remove extra metadata
lin-bot23 Jun 11, 2026
5c0cfb7
fix(i18n/zh): fix terminology and step numbering
lin-bot23 Jun 11, 2026
b90eb1b
fix(i18n/zh): fix terminology text-to-model
lin-bot23 Jun 11, 2026
74b4b1b
fix(i18n/zh): remove invented default values
lin-bot23 Jun 11, 2026
279cf4a
fix(i18n/zh): remove invented phrase, fix typo
lin-bot23 Jun 11, 2026
28577de
fix(i18n/zh): restore tip blocks and directory structure
lin-bot23 Jun 11, 2026
c4f7ef2
fix(i18n/zh): fix heading and remove invented note
lin-bot23 Jun 11, 2026
15c954d
fix(i18n/zh): fix terminology Partner Nodes to partner nodes
lin-bot23 Jun 11, 2026
7973c1c
fix(i18n/zh): fix terminology and remove invented 2FA line
lin-bot23 Jun 11, 2026
0cebb0e
fix(i18n/zh): fix terminology api nodes to partner nodes
lin-bot23 Jun 11, 2026
02acee9
fix(i18n/zh): fix image caption and invoice download section
lin-bot23 Jun 11, 2026
2d13e87
fix(i18n/zh): fix replaced content and terminology
lin-bot23 Jun 11, 2026
ef56436
fix(i18n/zh): restore missing content, remove invented
lin-bot23 Jun 11, 2026
79d0a78
fix(i18n/zh): fix terminology and restore missing sections
lin-bot23 Jun 11, 2026
3789927
fix(i18n/zh): remove invented solution, fix metadata
lin-bot23 Jun 11, 2026
aa3e500
fix(i18n/zh): fix duplicated text and metadata
lin-bot23 Jun 11, 2026
a54af66
fix(i18n/zh): fix metadata
lin-bot23 Jun 11, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 3 additions & 5 deletions zh/account/login.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,12 @@
title: 登录您的 Comfy 账户
sidebarTitle: 登录
description: 访问您的 Comfy 账户以使用 ComfyUI 的所有平台功能和服务。
translationSourceHash: 31b0c6ca
translationFrom: account/login.mdx
reviewSourceHash: 31b0c6ca
---

import GetApiKey from '/snippets/zh/get-api-key.mdx'

您的 Comfy 账户可让您访问[合作伙伴节点(API 节点)](/zh/tutorials/partner-nodes/overview)和[云订阅](https://www.comfy.org/cloud),使您能够在 ComfyUI 平台上使用高级功能和服务。
您的 Comfy 账户可让您访问[合作节点](/zh/tutorials/partner-nodes/overview)和[云订阅](https://www.comfy.org/cloud),使您能够在 ComfyUI 平台上使用高级功能和服务。

## 支持的登录方式

Expand All @@ -22,7 +21,7 @@ ComfyUI 支持以下登录方式:
要在 Comfy Cloud 上访问您的 Comfy 账户以使用 ComfyUI:

1. 访问 [Comfy Cloud](https://www.comfy.org)
2. 点击**登录**或**登入**
2. 点击**登录**
3. 选择您的登录方式:
- **电子邮件**:输入您的电子邮件地址和密码,然后点击**登录**
- **Google**:点击 Google 登录按钮并进行身份验证
Expand Down Expand Up @@ -120,7 +119,6 @@ ComfyUI 支持以下登录方式:

为了保护您的账户安全:
- 使用强大且唯一的密码
- 启用双因素身份验证
- 不要分享您的登录凭据
- 使用共享设备时请注销
- 定期更新您的密码
17 changes: 8 additions & 9 deletions zh/agent-tools/index.mdx
Original file line number Diff line number Diff line change
@@ -1,22 +1,21 @@
---
title: "Agent Tools / MCP"
description: "通过 Model Context Protocol (MCP) 将 AI 助手接入 ComfyUI,用于图片、视频、音频和 3D 内容生成。"
description: "通过 Model Context Protocol (MCP) 将 AI 助手接入 ComfyUI,用于图像、视频、音频和 3D 内容生成。"
sidebarTitle: "概览"
icon: "robot"
translationSourceHash: 5f22f918
translationFrom: agent-tools/index.mdx
reviewSourceHash: 5f22f918
---

ComfyUI 提供了 **两个 MCP 服务器**,让 AI 助手(Claude Desktop、Claude Code、Cursor、Amp 等)能够生成图片、视频、音频和 3D 内容——无需本地安装 ComfyUI 或 GPU。
ComfyUI 提供了 **两个 MCP 服务器**,让 AI 助手(Claude Desktop、Claude Code、Cursor、Amp 等)能够生成图像、视频、音频和 3D 内容——无需本地安装 ComfyUI 或 GPU。

<CardGroup cols={2}>
<Card title="Comfy Cloud MCP" icon="cloud" href="/zh/agent-tools/cloud">
连接至托管在 <code>cloud.comfy.org</code> 的 MCP 服务器。在 Cloud GPU 上运行工作流,使用预装模型。
连接至托管在 <code>cloud.comfy.org</code> 的 MCP 服务器。在 Cloud GPU 上运行工作流,使用预装模型,并搜索完整的模板库
<br/><br/>
**封闭测试** — 注册等候名单。
</Card>
<Card title="Comfy Partner MCP" icon="plug" href="/zh/agent-tools/partner-mcp">
在本地运行的 MCP 服务器,使用 Comfy Partner-Node SDK。提供统一的 <code>generate_image</code>、<code>generate_video</code> 等工具,覆盖 30+ 合作提供商。
在本地运行的 MCP 服务器,使用 Comfy Partner-Node SDK。提供统一的 <code>generate_image</code>、<code>generate_video</code>、<code>generate_3d</code> 等工具,覆盖 30+ 合作提供商。
<br/><br/>
**等候名单** — 注册提前体验。
</Card>
Expand All @@ -43,9 +42,9 @@ ComfyUI 提供了 **两个 MCP 服务器**,让 AI 助手(Claude Desktop、Cl

连接 MCP 服务器到 Claude Desktop、Claude Code、Cursor 或 Amp 后,AI 助手可以:

- **生成图片** — 根据文字描述
- **创建视频** — 从文字或图片生成
- **生成 3D 模型** — 从文字或图片
- **生成图像** — 根据文字描述
- **创建视频** — 从文字或图像生成
- **生成 3D 模型** — 从文字或图像
- **生成音频和音乐** — 使用 AI 模型
- **搜索模型和模板** — 找到合适的工具

Expand Down
166 changes: 156 additions & 10 deletions zh/comfy-cli/getting-started.mdx
Original file line number Diff line number Diff line change
@@ -1,15 +1,19 @@
---
title: "快速入门"
translationSourceHash: 81a03067
translationFrom: comfy-cli/getting-started.mdx
reviewSourceHash: 81a03067
---

import InstallComfyFromCli from "/snippets/zh/install-comfy-from-cli.mdx";
import InstallCli from "/snippets/zh/install-comfycli.mdx";

### 概述

`comfy-cli` 是一个 [命令行工具](https://github.com/Comfy-Org/comfy-cli),可以帮助更轻松地安装和管理 Comfy。
`comfy-cli` 是一个[命令行工具](https://github.com/Comfy-Org/comfy-cli),可以帮助更轻松地安装和管理 Comfy。

它主要做两件事:

1. **管理本地 ComfyUI 安装** — 安装、启动、更新、快照和二分排查 ComfyUI 及其自定义节点。
2. **直接调用托管的合作节点** — 通过一条命令即可从 Seedance、Nano Banana(Gemini)、Grok、Flux、Ideogram、DALL·E、Recraft、Stability、Kling、Luma、Runway、Pika、Vidu、Hailuo、Moonvalley 等生成图像和视频。无需本地 ComfyUI 或工作流 JSON。

### 安装 CLI

Expand All @@ -25,29 +29,171 @@ import InstallCli from "/snippets/zh/install-comfycli.mdx";
comfy launch
```

### 管理自定义节点
## 通过 `comfy generate` 直接调用合作节点(Beta)

<Info>
**`comfy generate` 目前处于 Beta 阶段。** 标志名称、模型别名和输出格式可能发生变化,我们会根据反馈持续优化。底层合作节点 API 是稳定的——仍在演进的是建立在它们之上的 CLI 交互方式。请在 [comfy-cli GitHub 仓库](https://github.com/Comfy-Org/comfy-cli/issues) 提交反馈或问题。
</Info>

<Tip>
`comfy generate` 是从终端或脚本调用 Comfy [合作节点](/tutorials/partner-nodes/overview)的最快方式。它访问的是与你通过工作流连接相同的托管端点,但以一次性 CLI 调用的形式呈现——非常适合批处理作业、快速实验和自动化流水线,这些场景下搭建完整的 ComfyUI 图过于繁琐。
</Tip>

### 前提条件

* [创建 Comfy API 密钥](/zh/development/comfyui-server/api-key-integration)
* [向账户添加积分](/zh/interface/credits)
* 可选:[浏览合作节点及按次定价](/zh/tutorials/partner-nodes/overview)

设置一次密钥,即可开始使用:

```bash
export COMFY_API_KEY=comfyui-... # 或者在每次调用时传入 --api-key
```

### 首次生成

```bash
comfy generate flux-pro \
--prompt "a cat on the moon, cinematic lighting" \
--width 1024 --height 1024 \
--download cat.png
```

就是这样——CLI 会上传任何本地文件输入,提交任务,轮询直到就绪,并将结果保存到 `cat.png`。

### 热门模型

以下是几个最常用的合作模型,一行命令即可调用:

```bash
# Nano Banana(Google Gemini Flash Image)— 文生图及基于提示词的编辑
comfy generate nano-banana \
--prompt "a watercolor of a sleeping fox" \
--download fox.png

# 同一别名,现在是图像编辑——通过 --image(可重复使用)传入参考图:
comfy generate nano-banana \
--prompt "add a top hat" \
--image ./cat.png \
--download edited.png

# 选择 Gemini 变体:
comfy generate nano-banana \
--prompt "neon city skyline" \
--model gemini-3-pro-image-preview \
--download city.png

# Seedance(字节跳动)— 文本转视频,最高 1080p / 12 秒片段
comfy generate seedance \
--prompt "a hummingbird hovering over a flower" \
--resolution 1080p --duration 5 \
--download hummingbird.mp4

# Seedance 图像转视频——选择 lite/i2v 变体并传入首帧
comfy generate seedance \
--model seedance-1-0-lite-i2v-250428 \
--prompt "the wave crests and crashes" \
--image ./still.jpg \
--download wave.mp4

# Grok(xAI)— 图像生成和编辑
comfy generate grok --prompt "a cyberpunk street market at night" --download street.png
comfy generate grok-edit --prompt "swap the umbrella for a parasol" --image ./photo.jpg --download out.png

# Grok 视频
comfy generate grok-video --prompt "a paper plane gliding through a cathedral" --download flight.mp4
```

### 发现模型

```bash
comfy generate list # 所有可用模型
comfy generate list --category text-to-video # 按类别筛选
comfy generate list --partner kling # 按合作方筛选
comfy generate schema flux-kontext # 查看某个模型的参数
```

### 使用参考图像进行图像编辑

直接传入本地文件路径——CLI 会通过 Comfy 的存储端点上传承文件(或根据各个合作方的要求内联 base64 编码):

```bash
comfy generate flux-kontext \
--prompt "add a top hat and a monocle" \
--input_image ./photo.jpg \
--download out.png

comfy generate ideogram-edit \
--image cat.png --mask mask.png \
--prompt "add sunglasses" \
--rendering_speed TURBO \
--download edited.png
```

如果你希望上传一次并在多次调用中重复使用签名 URL:

```bash
comfy generate upload ./photo.jpg
# → 打印一个签名 URL,可将其作为 --input_image 传入
```

<Note>
上传的参考素材会在 **24 小时**后自动删除。它们存储在 Comfy 管理 GCS 存储桶中,通过签名 URL 提供。对于大多数工作流(上传 → 使用 → 完成),这一过程是透明的;对于长时间运行的流水线,请在每次任务前重新上传。详情请参阅[参考](/zh/comfy-cli/reference#upload)页面。
</Note>

### 视频生成(异步任务)

视频任务是异步的——默认情况下 CLI 会阻塞并轮询直到就绪:

```bash
comfy generate kling \
--prompt "a paper boat drifting on a river at dusk" \
--duration 5 \
--download boat.mp4
```

传入 `--async` 可立即返回任务 ID,稍后再继续:

```bash
comfy generate luma --prompt "neon koi swimming through clouds" --aspect_ratio 16:9 --async
# → 打印任务 ID;稍后使用以下命令继续:
comfy generate resume luma <job_id> --download out.mp4
```

### 使用 JSON 输出进行脚本编写

对于流水线,`--json` 可以输出原始 API 响应:

```bash
comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url'
```

完整的命令、标志和模型别名列表请参阅[参考](/zh/comfy-cli/reference)页面。

## 管理自定义节点

```bash
comfy node install <NODE_NAME>
```

我们使用 `cm-cli` 来安装自定义节点。更多信息请参阅 [文档](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/docs/en/cm-cli.md)。
我们使用 `cm-cli` 来安装自定义节点。更多信息请参阅[文档](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/docs/en/cm-cli.md)。

### 管理模型
## 管理模型

使用 `comfy-cli` 下载模型非常简单。只需运行以下命令:

```bash
comfy model download <url> models/checkpoints
comfy model download --url <url> --relative-path models/checkpoints
```

### 贡献
## 贡献

我们鼓励对 comfy-cli 的贡献!如果您有建议、想法或错误报告,请在我们的 [GitHub 仓库](https://github.com/Comfy-Org/comfy-cli/issues) 上提交问题。如果您想贡献代码,请 fork 仓库并提交 pull request。

有关更多详细信息,请参阅 [开发指南](https://github.com/Comfy-Org/comfy-cli/blob/main/DEV_README.md)。
更多详细信息请参阅[开发指南](https://github.com/Comfy-Org/comfy-cli/blob/main/DEV_README.md)。

### 数据分析
## 数据分析

我们会跟踪 CLI 的使用情况以改进用户体验。您可以通过运行以下命令禁用此功能:

Expand Down
12 changes: 10 additions & 2 deletions zh/comfy-cli/reference.mdx
Original file line number Diff line number Diff line change
@@ -1,13 +1,21 @@
---
title: "参考"
translationSourceHash: d3b02585
translationFrom: comfy-cli/reference.mdx
reviewSourceHash: d3b02585
---
import GenerateCliReference from '/snippets/cli-reference/generate.mdx'
import NodesCliReference from '/snippets/zh/cli-reference/nodes.mdx'
import ModelsReference from '/snippets/zh/cli-reference/models.mdx'

# CLI

## 生成(合作节点)— Beta

<Info>
**`comfy generate` 目前处于 Beta 阶段。** 标志名称、模型别名和输出格式可能发生变化。底层合作节点 API 是稳定的,但 CLI 表面仍在演进中。请在 [comfy-cli GitHub 仓库](https://github.com/Comfy-Org/comfy-cli/issues) 提交反馈。
</Info>

<GenerateCliReference/>

## 节点

<NodesCliReference/>
Expand Down
21 changes: 16 additions & 5 deletions zh/comfy-cli/troubleshooting.mdx
Original file line number Diff line number Diff line change
@@ -1,9 +1,20 @@
---
title: "开始"
translationSourceHash: 8c9d813c
translationFrom: comfy-cli/troubleshooting.mdx
title: "故障排查"
reviewSourceHash: "c501cfb5"
---

### 前提条件
## 入门

你需要在你的系统上已经安装好了 Git。可以[在这里](https://git-scm.com/downloads)下载。
欢迎使用 Comfy CLI 故障排查指南。

## 安装 CLI

### 安装 Comfy CLI

要安装 Comfy CLI,请运行以下命令:

### 在此处安装

```bash
pip install comfy-cli
```
51 changes: 10 additions & 41 deletions zh/community/links.mdx
Original file line number Diff line number Diff line change
@@ -1,52 +1,21 @@
---
title: "社区链接"
description: "通过各种平台与 ComfyUI 社区联系"
translationSourceHash: ea6ecb7c
translationFrom: community/links.mdx
reviewSourceHash: ea6ecb7c
---

加入 ComfyUI 社区,获取帮助、分享您的作品并了解最新动态。
## Discord

<CardGroup cols={2}>
<Card title="Discord" icon="discord" href="https://discord.gg/comfyorg">
加入我们的 Discord 社区
</Card>
[加入 Comfy Discord](https://www.comfy.org/discord)

<Card title="支持门户" icon="life-ring" href="https://support.comfy.org/">
获取帮助和支持
</Card>
## GitHub

<Card title="论坛" icon="comments" href="https://forum.comfy.org/">
加入社区讨论
</Card>
[ComfyUI GitHub 仓库](https://github.com/Comfy-Org/ComfyUI)
[ComfyOrg 组织](https://github.com/Comfy-Org)

<Card title="Matrix" icon="hashtag" href="https://app.element.io/#/room/%23comfyui_space%3Amatrix.org">
在 Matrix 上聊天
</Card>
## Reddit

<Card title="GitHub" icon="github" href="https://github.com/Comfy-Org/ComfyUI/">
查看源代码
</Card>
[ComfyUI Subreddit](https://www.reddit.com/r/comfyui)

<Card title="YouTube" icon="youtube" href="https://www.youtube.com/@comfyorg">
观看教程
</Card>
## X (Twitter)

<Card title="X (Twitter)" icon="x-twitter" href="https://x.com/ComfyUI">
在 X 上关注我们
</Card>

<Card title="LinkedIn" icon="linkedin" href="https://www.linkedin.com/company/comfyui/">
在 LinkedIn 上联系
</Card>

<Card title="Reddit" icon="reddit" href="https://www.reddit.com/r/comfyui/">
加入我们的 subreddit
</Card>
</CardGroup>

## 微信

扫描二维码加入我们的微信社区。

<img src="https://raw.githubusercontent.com/Comfy-Org/docs/refs/heads/main/images/index/qrcode.jpg" alt="WeChat QR Code" style={{maxWidth: '300px', margin: '20px 0'}} />
[ComfyOrg 官方账号](https://x.com/ComfyOrg)
Loading
Loading