From ace5336face9c16c5ab172976833e1fe5d3398f5 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 15:47:49 +0800 Subject: [PATCH 01/59] fix(i18n/zh): add missing Generate (partner nodes) section and import in CLI reference --- zh/comfy-cli/reference.mdx | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/zh/comfy-cli/reference.mdx b/zh/comfy-cli/reference.mdx index 8f2bd4f1e..fb3d5dac0 100644 --- a/zh/comfy-cli/reference.mdx +++ b/zh/comfy-cli/reference.mdx @@ -3,11 +3,20 @@ title: "参考" translationSourceHash: d3b02585 translationFrom: comfy-cli/reference.mdx --- +import GenerateCliReference from '/snippets/zh/cli-reference/generate.mdx' import NodesCliReference from '/snippets/zh/cli-reference/nodes.mdx' import ModelsReference from '/snippets/zh/cli-reference/models.mdx' # CLI +## 生成（合作节点）— Beta + + +**`comfy generate` 目前处于 Beta 阶段。** 参数名称、模型别名及输出格式可能会有所变化。底层合作节点接口是稳定的，但 CLI 界面仍在演进中。欢迎在 [comfy-cli GitHub 仓库](https://github.com/Comfy-Org/comfy-cli/issues) 提交反馈。 + + + + ## 节点 From 797db51c20268eb89aba938437ae67ca1b6ade83 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 15:48:43 +0800 Subject: [PATCH 02/59] fix(i18n/ko): fix terminology - transcription, workflow, custom, etc. --- ko/tutorials/llm/gemma4/gemma4.mdx | 29 ++++++++++++++--------------- 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/ko/tutorials/llm/gemma4/gemma4.mdx b/ko/tutorials/llm/gemma4/gemma4.mdx index 6aea23152..afff276f6 100644 --- a/ko/tutorials/llm/gemma4/gemma4.mdx +++ b/ko/tutorials/llm/gemma4/gemma4.mdx @@ -1,16 +1,15 @@ --- -title: "Gemma 4 ComfyUI 워크플로우 예시" -description: "Gemma 4는 구글의 멀티모달 LLM 제품군으로, 텍스트 생성, 이미지 이해, 비디오 분석 및 오디오 변환을 지원하며 최대 256K 컨텍스트를 처리합니다. 2B, 4B, 31B 크기로 제공됩니다." +title: "Gemma 4 ComfyUI 워크플로 예시" +description: "Gemma 4는 구글의 멀티모달 LLM 제품군으로, 텍스트 생성, 이미지 이해, 비디오 분석 및 오디오 전사를 지원하며 최대 256K 컨텍스트를 처리합니다. 2B, 4B, 31B 크기로 제공됩니다." sidebarTitle: "Gemma 4" -translationSourceHash: 817ba970 -translationFrom: tutorials/llm/gemma4/gemma4.mdx +reviewSourceHash: 817ba970 --- import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx" -**Gemma 4**는 구글 딥마인드에서 개발한 경량 오픈 LLM의 최신 세대이며, 텍스트 생성, 이미지 이해, 비디오 분석, 오디오 변환 및 구조화된 도구 사용을 위해 설계되었습니다. ComfyUI에서는 기본 **텍스트 생성** 모델로 원활하게 지원됩니다. +**Gemma 4**는 구글 딥마인드에서 개발한 경량 오픈 LLM의 최신 세대이며, 텍스트 생성, 이미지 이해, 비디오 분석, 오디오 전사 및 구조화된 도구 사용을 위해 설계되었습니다. ComfyUI에서는 기본 **텍스트 생성** 모델로 원활하게 지원됩니다. **모델 주요 특징**: @@ -22,7 +21,7 @@ import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx" - **사고 모드** — 답변 생성 전 내장된 단계별 추론 기능 - **긴 컨텍스트** — 최대 128K 토큰(E2B/E4B) 및 256K 토큰(31B) - **다국어 지원** — 기본적으로 35개 이상의 언어를 지원하며, 140개 이상의 언어로 사전 학습됨 -- **함수 호출** — 구조화된 도구 사용 및 에이전트 기반 워크플로우에 대한 기본 지원 +- **함수 호출** — 구조화된 도구 사용 및 에이전트 기반 워크플로에 대한 기본 지원 - **ComfyUI 기본 지원** — 내장된 `TextGenerate` 및 `CLIPLoader` 노드를 통해 로드되고 실행됩니다. **관련 링크**: @@ -30,11 +29,11 @@ import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx" - [Google AI for Developers](https://ai.google.dev/gemma) - [ComfyUI 소스 코드 (nodes_textgen.py)](https://github.com/Comfy-Org/ComfyUI/blob/master/comfy_extras/nodes_textgen.py) -## 이용 가능한 워크플로우 +## 이용 가능한 워크플로 ### Gemma 4: 텍스트 생성 - + JSON 파일을 다운로드하거나 템플릿 라이브러리에서 "Gemma 4 텍스트 생성"을 검색하세요. @@ -42,14 +41,14 @@ import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx" Comfy Cloud에서 열기 -![Gemma 4 텍스트 생성 워크플로우](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/llm_gemma4_text_gen-1.webp) +![Gemma 4 텍스트 생성 워크플로](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/llm_gemma4_text_gen-1.webp) -이 워크플로우는 Gemma 4의 핵심 **텍스트 생성** 기능을 보여줍니다. 텍스트 프롬프트와 함께 추가적인 컨텍스트로 이미지, 오디오 파일 또는 비디오를 선택할 수 있으며, 자연어 출력을 생성합니다. 추론, 코딩 및 다국어 프롬프트까지 지원합니다. +이 워크플로는 Gemma 4의 핵심 **텍스트 생성** 기능을 보여줍니다. 텍스트 프롬프트와 함께 추가적인 컨텍스트로 이미지, 오디오 파일 또는 비디오를 선택할 수 있으며, 자연어 출력을 생성합니다. 추론, 코딩 및 다국어 프롬프트까지 지원합니다. **입력**: - **텍스트 프롬프트** — 질문이나 지침 -- **이미지** (선택사항) — 시각적 이해 작업용 (OCR, 객체 탐지, 차트 읽기 등) -- **오디오** (선택사항) — 음성 인식 또는 텍스트 변환용 +- **이미지** (선택사항) — 시각적 이해 작업용 (OCR, 객체 감지, 차트 읽기 등) +- **오디오** (선택사항) — 음성 인식 또는 음성 텍스트 변환용 - **비디오** (선택사항) — 프레임별 비디오 이해용 (내부적으로 1 FPS로 하위 샘플링됨) **주요 제어 옵션**: @@ -62,7 +61,7 @@ import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx" - **생성된 텍스트** — 모델의 응답을 일반 텍스트 문자열로 반환 - 이 워크플로우는 서브그래프 노드를 사용해 모듈식 처리를 수행합니다. 서브그래프 문서를 확인하여 워크플로우를 맞춤화하고 확장하는 방법을 배워보세요. + 이 워크플로는 서브그래프 노드를 사용해 모듈식 처리를 수행합니다. 서브그래프 문서를 확인하여 워크플로를 사용자 정의하고 확장하는 방법을 배워보세요. ## 모델 다운로드 @@ -74,11 +73,11 @@ Gemma 4 모델은 ComfyUI에서 텍스트 인코더로 로드됩니다. 관련 - 균형 잡힌 성능. 워크플로우의 기본 모델입니다. + 균형 잡힌 성능. 워크플로의 기본 모델입니다. - 모든 Gemma 4 모델 가중치 둘러보기. + 모든 Gemma 4 모델 가중치 찾아보기. 다운로드한 `.safetensors` 파일을 다음 위치에 저장하세요: From 26e3b3a28ed754ade809ac18b9813be9b0a48440 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 15:49:14 +0800 Subject: [PATCH 03/59] fix(i18n/zh): add missing 'comfy generate' section and fix heading levels in getting-started --- zh/comfy-cli/getting-started.mdx | 160 +++++++++++++++++++++++++++++-- 1 file changed, 153 insertions(+), 7 deletions(-) diff --git a/zh/comfy-cli/getting-started.mdx b/zh/comfy-cli/getting-started.mdx index 51de0b087..b937dc856 100644 --- a/zh/comfy-cli/getting-started.mdx +++ b/zh/comfy-cli/getting-started.mdx @@ -11,6 +11,11 @@ import InstallCli from "/snippets/zh/install-comfycli.mdx"; `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 @@ -25,7 +30,148 @@ import InstallCli from "/snippets/zh/install-comfycli.mdx"; comfy launch ``` -### 管理自定义节点 +## 使用 `comfy generate` 直接调用合作节点（Beta） + + +**`comfy generate` 目前处于 Beta 阶段。** 参数名称、模型别名及输出格式可能会根据反馈进行调整。底层合作节点接口是稳定的——仍在演进的是 CLI 的使用体验。如有反馈或问题，请提交至 [comfy-cli GitHub 仓库](https://github.com/Comfy-Org/comfy-cli/issues)。 + + + +`comfy generate` 是在终端或脚本中调用 Comfy [合作节点](/zh/tutorials/partner-nodes/overview) 的最快方式。它调用的是同一个托管端点——只不过以一次性 CLI 调用的方式——非常适合批量任务、快速实验和自动化管线，而无需搭建完整的 ComfyUI 工作流。 + + +### 前置条件 + +* [创建 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 传入 +``` + + +上传的参考资源会在 **24 小时** 后自动删除。它们存储在 Comfy 管理的 GCS 存储桶中，通过签名 URL 提供服务。对于大多数工作流（上传 → 使用 → 完成），这个过程是透明的；对于长时间运行的管线，请在每次任务前重新上传。详情请参见[参考文档](/zh/comfy-cli/reference#upload)。 + + +### 视频生成（异步任务） + +视频任务是异步的——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 --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 @@ -33,21 +179,21 @@ comfy node install 我们使用 `cm-cli` 来安装自定义节点。更多信息请参阅 [文档](https://github.com/Comfy-Org/ComfyUI-Manager/blob/main/docs/en/cm-cli.md)。 -### 管理模型 +## 管理模型 使用 `comfy-cli` 下载模型非常简单。只需运行以下命令： ```bash -comfy model download models/checkpoints +comfy model download --url --relative-path models/checkpoints ``` -### 贡献 +## 贡献 -我们鼓励对 comfy-cli 的贡献！如果您有建议、想法或错误报告，请在我们的 [GitHub 仓库](https://github.com/Comfy-Org/comfy-cli/issues) 上提交问题。如果您想贡献代码，请 fork 仓库并提交 pull request。 +我们鼓励对 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 的使用情况以改进用户体验。您可以通过运行以下命令禁用此功能： From 1eceeda6b4f7325d7ef31a45146e32751096fb69 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 15:49:31 +0800 Subject: [PATCH 04/59] fix(i18n/zh): translate custom nodes tips page title and heading --- zh/custom-nodes/tips.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh/custom-nodes/tips.mdx b/zh/custom-nodes/tips.mdx index d9ef0fece..eb662dfa5 100644 --- a/zh/custom-nodes/tips.mdx +++ b/zh/custom-nodes/tips.mdx @@ -1,7 +1,7 @@ --- -title: "Tips" +title: "提示" translationSourceHash: 9fe5613e translationFrom: custom-nodes/tips.mdx --- -### Recommended Development Lifecycle +### 推荐的开发工作流 From 76f53aa532f16bc1938d72007361c1c6970c6ef9 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:48:24 +0800 Subject: [PATCH 05/59] =?UTF-8?q?fix(i18n/zh):=20=E5=AE=8C=E6=95=B4?= =?UTF-8?q?=E7=BF=BB=E8=AF=91=E5=AD=90=E5=9B=BE=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/custom-nodes/js/subgraphs.mdx | 98 ++++++++++++++++---------------- 1 file changed, 48 insertions(+), 50 deletions(-) diff --git a/zh/custom-nodes/js/subgraphs.mdx b/zh/custom-nodes/js/subgraphs.mdx index d3f5bbd3e..6a6242f4f 100644 --- a/zh/custom-nodes/js/subgraphs.mdx +++ b/zh/custom-nodes/js/subgraphs.mdx @@ -1,25 +1,23 @@ --- title: "子图" description: "在 ComfyUI 扩展中使用子图：节点 ID、图遍历、事件、控件提升和清理。" -translationSourceHash: 66a72faa -translationFrom: custom-nodes/js/subgraphs.mdx --- -## Overview +## 概述 -Subgraphs let users group nodes into reusable, nestable components. Each subgraph is its own `LGraph` with a UUID. For the user-facing guide, see [Subgraphs](/zh/interface/features/subgraph). +子图让用户可以将节点分组为可复用、可嵌套的组件。每个子图都是一个独立的 `LGraph`，带有 UUID。面向用户的指南请参阅[子图](/zh/interface/features/subgraph)。 -## Node Identifiers +## 节点标识符 -ComfyUI uses three distinct node identifier types. Using the wrong one causes silent failures. +ComfyUI 使用三种不同的节点标识符类型。使用了错误的类型会导致静默失败。 -| Type | Format | Used for | +| 类型 | 格式 | 用途 | |------|--------|----------| -| `node.id` | `42` (number) | Local to its immediate graph level. `graph.getNodeById(id)` | -| Execution ID | `"1:2:3"` (colon-separated string) | Backend progress messages, `UNIQUE_ID` | -| Locator ID | `":"` or `""` | UI state: badges, errors, images | +| `node.id` | `42`（数字） | 仅限于当前直接图层级。`graph.getNodeById(id)` | +| 执行 ID | `"1:2:3"`（冒号分隔的字符串） | 后端进度消息、`UNIQUE_ID` | +| 定位器 ID | `":"` 或 `""` | UI 状态：徽章、错误、图像 | -To construct a node's locator ID from within an extension: +从扩展内部构造节点的定位器 ID： ```javascript function getLocatorId(node) { @@ -28,9 +26,9 @@ function getLocatorId(node) { } ``` -## Traversing Nodes +## 遍历节点 -### Current layer only +### 仅当前层级 ```javascript for (const node of app.graph.nodes) { @@ -38,9 +36,9 @@ for (const node of app.graph.nodes) { } ``` -### All nodes recursively +### 递归遍历所有节点 -To walk into nested subgraphs, use a recursive helper that calls a callback on every node: +要进入嵌套子图，使用递归辅助函数，对每个节点调用回调： ```javascript function walkGraph(graph, callback) { @@ -51,7 +49,7 @@ function walkGraph(graph, callback) { } ``` -Full example: +完整示例： ```javascript import { app } from "../../scripts/app.js" @@ -73,49 +71,49 @@ app.registerExtension({ }) ``` -## Root vs Active Graph +## 根图与当前活动图 -| You want to... | Use | +| 需求 | 使用 | |-----------------|-----| -| Operate on all nodes in the workflow | `app.graph` (root) | -| Operate on only the visible layer | `app.canvas?.graph` | -| Access a specific subgraph | `someNode.subgraph` | +| 对工作流中所有节点进行操作 | `app.graph`（根图） | +| 仅对当前可见层级进行操作 | `app.canvas?.graph` | +| 访问特定子图 | `someNode.subgraph` | ```javascript -// All nodes (including nested subgraphs) +// 所有节点（包括嵌套子图） walkGraph(app.graph, (node) => { /* ... */ }) -// Only nodes the user currently sees +// 仅用户当前可见的节点 for (const node of app.canvas?.graph?.nodes ?? []) { /* ... */ } ``` -## Events +## 事件 -### Subgraph-level events +### 子图层级事件 -Dispatched on `subgraph.events`: +通过 `subgraph.events` 分发： -| Event | Payload | When | +| 事件 | 载荷 | 触发时机 | |-------|---------|------| -| `widget-promoted` | `{ widget, subgraphNode }` | Widget promoted to parent node | -| `widget-demoted` | `{ widget, subgraphNode }` | Widget removed from parent node | -| `input-added` | `{ input }` | Input slot added | -| `removing-input` | `{ input, index }` | Input slot being removed | -| `output-added` | `{ output }` | Output slot added | -| `removing-output` | `{ output, index }` | Output slot being removed | -| `renaming-input` | `{ input, index, oldName, newName }` | Input slot renamed | -| `renaming-output` | `{ output, index, oldName, newName }` | Output slot renamed | +| `widget-promoted` | `{ widget, subgraphNode }` | 控件提升到父节点 | +| `widget-demoted` | `{ widget, subgraphNode }` | 控件从父节点移除 | +| `input-added` | `{ input }` | 输入槽添加 | +| `removing-input` | `{ input, index }` | 输入槽正在被移除 | +| `output-added` | `{ output }` | 输出槽添加 | +| `removing-output` | `{ output, index }` | 输出槽正在被移除 | +| `renaming-input` | `{ input, index, oldName, newName }` | 输入槽重命名 | +| `renaming-output` | `{ output, index, oldName, newName }` | 输出槽重命名 | -### Canvas-level events +### 画布层级事件 -Dispatched on `app.canvas.canvas` (the HTML canvas element): +通过 `app.canvas.canvas`（HTML canvas 元素）分发： -| Event | Payload | When | +| 事件 | 载荷 | 触发时机 | |-------|---------|------| -| `subgraph-opened` | `{ subgraph, closingGraph, fromNode }` | User navigates into a subgraph | -| `subgraph-converted` | `{ subgraphNode }` | Selection converted to a subgraph | +| `subgraph-opened` | `{ subgraph, closingGraph, fromNode }` | 用户导航进入一个子图 | +| `subgraph-converted` | `{ subgraphNode }` | 选区被转换为子图 | -### Listening pattern +### 监听模式 ```javascript import { app } from "../../scripts/app.js" @@ -131,12 +129,12 @@ app.registerExtension({ }) ``` -## Widget Promotion +## 控件提升 -When a `SubgraphInput` connects to a widget inside a subgraph, a copy of that widget appears on the parent subgraph node. This fires `widget-promoted`. Removing the connection fires `widget-demoted`. +当 `SubgraphInput` 连接到子图内部的某个控件时，该控件的一个副本会出现在父级子图节点上。这会触发 `widget-promoted` 事件。断开连接则会触发 `widget-demoted`。 -Widget promotion behavior is still evolving and may change in future releases. +控件提升行为仍在演进中，未来版本可能会发生变化。 ```javascript @@ -177,9 +175,9 @@ app.registerExtension({ }) ``` -## Cleanup +## 清理 -Use an `AbortController` to clean up all event listeners when a node is removed. +使用 `AbortController` 在节点被移除时清理所有事件监听器。 ```javascript import { app } from "../../scripts/app.js" @@ -210,10 +208,10 @@ app.registerExtension({ ``` -`onRemoved` can also fire during subgraph conversion, not just deletion. Guard teardown logic if you need to preserve state across restructuring. +`onRemoved` 不仅会在删除时触发，也可能在子图转换时触发。如果需要在重构过程中保留状态，请对销毁逻辑进行防护。 -## See Also +## 参见 -- [Subgraphs (User Guide)](/zh/interface/features/subgraph) -- [Extension Hooks](/zh/custom-nodes/js/javascript_hooks) +- [子图（用户指南）](/zh/interface/features/subgraph) +- [扩展钩子](/zh/custom-nodes/js/javascript_hooks) From 1de434b1332f8267975295108bbc124346e33564 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:48:25 +0800 Subject: [PATCH 06/59] fix(i18n/ja): add missing Generate (partner nodes) section and GenerateCliReference import --- ja/comfy-cli/reference.mdx | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/ja/comfy-cli/reference.mdx b/ja/comfy-cli/reference.mdx index d5024a538..44526e85e 100644 --- a/ja/comfy-cli/reference.mdx +++ b/ja/comfy-cli/reference.mdx @@ -3,11 +3,20 @@ title: "リファレンス" translationSourceHash: d3b02585 translationFrom: comfy-cli/reference.mdx --- +import GenerateCliReference from '/snippets/cli-reference/generate.mdx' import NodesCliReference from '/snippets/cli-reference/nodes.mdx' import ModelsReference from '/snippets/cli-reference/models.mdx' # CLI +## Generate（パートナーノード）— Beta + + +**`comfy generate` はベータ版です。** フラグ名、モデルエイリアス、出力形式は変更される可能性があります。基盤となるパートナーエンドポイントは安定していますが、CLI のインターフェースは依然として進化中です。フィードバックは [comfy-cli GitHub リポジトリ](https://github.com/Comfy-Org/comfy-cli/issues) にお寄せください。 + + + + ## ノード From 613be3d751cfc26845de86c64428d519ad3941e1 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:48:53 +0800 Subject: [PATCH 07/59] fix(i18n/ja): add missing 'comfy generate' section, fix title and model download command --- ja/comfy-cli/getting-started.mdx | 151 ++++++++++++++++++++++++++++++- 1 file changed, 149 insertions(+), 2 deletions(-) diff --git a/ja/comfy-cli/getting-started.mdx b/ja/comfy-cli/getting-started.mdx index 0ef507885..e366fd2eb 100644 --- a/ja/comfy-cli/getting-started.mdx +++ b/ja/comfy-cli/getting-started.mdx @@ -1,5 +1,5 @@ --- -title: "クイックスタート" +title: "はじめに" translationSourceHash: 81a03067 translationFrom: comfy-cli/getting-started.mdx --- @@ -11,6 +11,11 @@ import InstallCli from "/snippets/ja/install-comfycli.mdx"; `comfy-cli` は、Comfy のインストールと管理を容易にする [コマンドラインツール](https://github.com/Comfy-Org/comfy-cli) です。 +以下の 2 つの機能を提供します。 + +1. **ローカル ComfyUI の管理** — ComfyUI とそのカスタムノードのインストール、起動、更新、スナップショット、バイセクトが可能です。 +2. **ホスト型パートナーノードを直接呼び出し** — Seedance、Nano Banana（Gemini）、Grok、Flux、Ideogram、DALL·E、Recraft、Stability、Kling、Luma、Runway、Pika、Vidu、Hailuo、Moonvalley などから、1 つのコマンドで画像や動画を生成できます。ローカル ComfyUI やワークフロー JSON は必要ありません。 + ### CLI のインストール @@ -25,6 +30,148 @@ import InstallCli from "/snippets/ja/install-comfycli.mdx"; comfy launch ``` +## `comfy generate` でパートナーノードを直接呼び出す（Beta） + + +**`comfy generate` はベータ版です。** フラグ名、モデルエイリアス、出力形式はフィードバックに基づいて変更される可能性があります。基盤となるパートナーエンドポイントは安定していますが、その上にある CLI の操作性はまだ進化中です。フィードバックや問題は [comfy-cli GitHub リポジトリ](https://github.com/Comfy-Org/comfy-cli/issues) で報告してください。 + + + +`comfy generate` は、Comfy の [パートナーノード](/ja/tutorials/partner-nodes/overview) をターミナルやスクリプトから呼び出す最速の方法です。ComfyUI ワークフローに組み込むのと同じホスト型エンドポイントを、ワンショット CLI 呼び出しで利用できます。バッチジョブ、簡単な実験、フル ComfyUI グラフを立ち上げるにはオーバーキルな自動化パイプラインに最適です。 + + +### 前提条件 + +* [Comfy API キーの作成](/ja/development/comfyui-server/api-key-integration) +* [アカウントへのクレジット追加](/ja/interface/credits) +* オプション：[パートナーノードと呼び出しごとの料金を確認](/ja/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` に保存します。 + +### 人気のモデル + +よく使われるパートナーモデルの一部を、1 行で呼び出すことができます： + +```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（ByteDance）— テキストから動画へ、最大 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 # 1 つのモデルのパラメータを確認 +``` + +### 参照画像を使った画像編集 + +ローカルファイルのパスを直接渡します — 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 として渡せる +``` + + +アップロードされた参照アセットは **24 時間** 後に自動削除されます。Comfy 管理の GCS バケットに保存され、署名付き URL で提供されます。ほとんどのワークフロー（アップロード → 使用 → 完了）では透過的ですが、長時間実行されるパイプラインの場合は、各ジョブの前に再アップロードしてください。詳細は [リファレンス](/ja/comfy-cli/reference#upload) を参照してください。 + + +### 動画生成（非同期ジョブ） + +動画ジョブは非同期です — 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 --download out.mp4 +``` + +### JSON 出力を使ったスクリプト + +パイプラインでは、`--json` で生の API レスポンスを出力します： + +```bash +comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url' +``` + +コマンド、フラグ、モデルエイリアスの完全なリストは [リファレンス](/ja/comfy-cli/reference) を参照してください。 + ### カスタムノードの管理 ```bash @@ -38,7 +185,7 @@ comfy node install `comfy-cli` を使用したモデルのダウンロードは簡単です。以下を実行するだけです： ```bash -comfy model download models/checkpoints +comfy model download --url --relative-path models/checkpoints ``` ### コントリビューション From 259cb0f22f39727c04011c3914b11bb7f036c264 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:48:57 +0800 Subject: [PATCH 08/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D=20API?= =?UTF-8?q?=20=E5=AF=86=E9=92=A5=E9=9B=86=E6=88=90=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E4=B8=AD=E7=9A=84=E6=9C=AF=E8=AF=AD=E5=92=8C=E5=86=85=E5=AE=B9?= =?UTF-8?q?=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../comfyui-server/api-key-integration.mdx | 47 +++++++++---------- 1 file changed, 22 insertions(+), 25 deletions(-) diff --git a/zh/development/comfyui-server/api-key-integration.mdx b/zh/development/comfyui-server/api-key-integration.mdx index dfd7dcde9..99113e95d 100644 --- a/zh/development/comfyui-server/api-key-integration.mdx +++ b/zh/development/comfyui-server/api-key-integration.mdx @@ -1,35 +1,32 @@ --- -title: '通过 API Key 集成来使用 ComfyUI API 节点' -description: '本文介绍了如何通过 API Key 集成来使用 ComfyUI API 节点' -sidebarTitle: 'Partner Node API 集成' +title: 'ComfyUI 账户 API 密钥集成' +description: '本文介绍了如何在无头模式下使用 ComfyUI 账户 API 密钥调用付费合作节点' +sidebarTitle: '合作节点 API 集成' icon: 'puzzle-piece' -translationSourceHash: 1276143d -translationFrom: development/comfyui-server/api-key-integration.mdx --- -从[PR #8041](https://github.com/Comfy-Org/ComfyUI/pull/8041)开始，ComfyUI 支持通过创建 API Key 来直接使用 ComfyUI 内置的 API 节点，无需特定的前端界面（甚至可以完全不使用前端）。 +从[PR #8041](https://github.com/Comfy-Org/ComfyUI/pull/8041)开始，ComfyUI 支持通过你的 ComfyUI 账户 API 密钥直接使用内置的付费合作节点，无需特定的前端界面（甚至可以完全不使用前端）。 这意味着你可以创建工作流来组合： - 本地操作系统模型 - 自定义节点社区的工具 - 流行的付费模型 -并通过本地 Comfy webserver API 一起运行所有内容，让它处理所有的协调工作。 +然后通过将 prompt 发送到 Comfy webserver API 来一起运行所有内容，由它处理所有的协调工作。 -这对于将 Comfy 用作后端服务、通过命令行运行 Comfy、拥有自己的前端等用户都很有帮助。 +这对于希望将 Comfy 用作后端服务、通过命令行运行、或使用自有前端等用户都很有帮助。 ## 前提条件 -使用 API Key 来调用 ComfyUI 内置的 API 节点需要： -- 确保你的 ComfyUI 版本 >= [PR #8041](https://github.com/Comfy-Org/ComfyUI/pull/8041) -- 对应账户的 [API Key](/zh/development/api-development/getting-an-api-key) +使用你的 ComfyUI 账户 API 密钥来调用付费合作节点需要： +- 一个 [ComfyUI 账户 API 密钥](/zh/development/api-development/getting-an-api-key) - 足够的账户积分 -使用 API Key 来调用 ComfyUI 内置的 API 节点需要先在 [ComfyUI Platform](https://platform.comfy.org/login) 上注册一个账户，然后[创建 API key](/zh/development/api-development/getting-an-api-key) + + **重要提示：** 本文介绍的是**ComfyUI 账户 API 密钥**，用于在工作流中访问付费合作节点。如果你想向注册表发布自定义节点，请参见[发布节点](/zh/registry/publishing)。 + - -请参考用户界面章节了解如何使用 API Key 进行登录 - +要使用你的 ComfyUI 账户 API 密钥来调用付费合作节点，你需要在 [ComfyUI Platform](https://platform.comfy.org/login) 上注册一个账户，然后[创建 API 密钥](/zh/development/api-development/getting-an-api-key) 你需要确保你的 ComfyUI 账户有足够的积分来测试对应的功能。 @@ -40,19 +37,19 @@ translationFrom: development/comfyui-server/api-key-integration.mdx ## Python 示例 -以下是一个如何通过 Python 代码向 ComfyUI API 发送包含 API节点的工作流的示例： +以下是一个如何通过 Python 代码向 ComfyUI API 发送包含合作节点的工作流的示例： ```python -"""在无头模式或使用替代前端运行 ComfyUI 时使用 API 节点 +"""在无头模式或使用替代前端运行 ComfyUI 时使用合作节点 -你可以通过在 prompt 中包含 API key 来执行包含 API 节点的 ComfyUI 工作流。 -API key 需要添加到 payload 的 `extra_data` 字段中。 +你可以通过在 prompt 中包含 API 密钥来执行包含合作节点的 ComfyUI 工作流。 +API 密钥需要添加到 payload 的 `extra_data` 字段中。 下面我们展示一个如何实现的示例。 更多信息请参考： -- API 节点概述: https://docs.comfy.org/zh/tutorials/partner-nodes/overview -- 要生成 API key，请登录这里: https://platform.comfy.org/login +- 合作节点概述: https://docs.comfy.org/zh/tutorials/partner-nodes/overview +- 要生成 API 密钥，请登录这里: https://platform.comfy.org/login """ import json @@ -60,7 +57,7 @@ from urllib import request SERVER_URL = "http://127.0.0.1:8188" -# 我们有一个包含 API 节点的 prompt/job（API 格式的工作流）。 +# 我们有一个包含合作节点的 prompt/job（API 格式的工作流）。 workflow_with_api_nodes = """{ "11": { "inputs": { @@ -109,9 +106,9 @@ prompt = json.loads(workflow_with_api_nodes) payload = { "prompt": prompt, # 将 `api_key_comfy_org` 添加到 payload 中。 - # 如果你需要处理多个客户端，可以先从关联的用户获取 key。 + # 如果你需要处理多个客户端，可以先从关联的用户获取密钥。 "extra_data": { - "api_key_comfy_org": "comfyui-87d01e28d*******************************************************" # 替换为实际的 key + "api_key_comfy_org": "comfyui-87d01e28d*******************************************************" # 替换为实际的密钥 }, } data = json.dumps(payload).encode("utf-8") @@ -124,6 +121,6 @@ request.urlopen(req) ## 相关文档 -- [API节点概述](https://docs.comfy.org/zh/tutorials/partner-nodes/overview) +- [合作节点概述](https://docs.comfy.org/zh/tutorials/partner-nodes/overview) - [账户管理](https://docs.comfy.org/zh/interface/user) - [积分](https://docs.comfy.org/zh/interface/credits) \ No newline at end of file From 93600f7d603b7b549e109e78a4cbb0d9de56f2ce Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:49:05 +0800 Subject: [PATCH 09/59] fix(i18n/ja): fix mistranslation of partner nodes and Sign in terminology --- ja/account/login.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja/account/login.mdx b/ja/account/login.mdx index 6ca5790bc..eec9cdce9 100644 --- a/ja/account/login.mdx +++ b/ja/account/login.mdx @@ -8,7 +8,7 @@ translationFrom: account/login.mdx import GetApiKey from '/snippets/get-api-key.mdx' -Comfy アカウントを利用すると、[パートナーノード（API ノード）](/tutorials/partner-nodes/overview)および[クラウドサブスクリプション](https://www.comfy.org/cloud)にアクセスでき、ComfyUI プラットフォーム全体でプレミアム機能やサービスをご利用いただけます。 +Comfy アカウントを利用すると、[パートナーノード（Partner Node）](/ja/tutorials/partner-nodes/overview)および[クラウドサブスクリプション](https://www.comfy.org/cloud)にアクセスでき、ComfyUI プラットフォーム全体でプレミアム機能やサービスをご利用いただけます。 ## サポートされるログイン方法 @@ -22,7 +22,7 @@ ComfyUI では、以下のログイン方法がサポートされています： Comfy Cloud 上で ComfyUI を使用するための Comfy アカウントにアクセスするには： 1. [Comfy Cloud](https://www.comfy.org) へ移動します -2. **ログイン**または**サインイン**をクリックします +2. **ログイン**をクリックします 3. ログイン方法を選択します： - **メールアドレス**：メールアドレスとパスワードを入力し、「ログイン」をクリックします - **Google**：Google ログインボタンをクリックして認証を行います From f171024f48a6c4408951adfa9ef130643e761498 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:49:11 +0800 Subject: [PATCH 10/59] fix(i18n/ja): remove extraneous comment from description frontmatter --- ja/manager/configuration.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja/manager/configuration.mdx b/ja/manager/configuration.mdx index c8fcfee25..294515e9e 100644 --- a/ja/manager/configuration.mdx +++ b/ja/manager/configuration.mdx @@ -1,7 +1,7 @@ --- title: 設定 sidebarTitle: 設定 -description: ComfyUI-Manager の設定を構成します "ZH title has typo (\"配置配置\"). ZH table omits \"(with System User API)\". ZH URLs point to different repo owners (comfy-org vs ltdrdata) and include locale paths. Following EN source for URLs and details." +description: ComfyUI-Manager の設定を構成します translationSourceHash: d87a6ccb translationFrom: manager/configuration.mdx --- From 976c205e94e3f4e2a6cdab55bc0655d954f31780 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:49:19 +0800 Subject: [PATCH 11/59] fix(i18n/ja): replace Chinese text with proper Japanese terms --- ja/tutorials/video/ltx/ltx-2.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ja/tutorials/video/ltx/ltx-2.mdx b/ja/tutorials/video/ltx/ltx-2.mdx index 5f84765c8..2193e24b2 100644 --- a/ja/tutorials/video/ltx/ltx-2.mdx +++ b/ja/tutorials/video/ltx/ltx-2.mdx @@ -33,7 +33,7 @@ import UpdateReminder from "/snippets/ja/tutorials/update-reminder.mdx"; | ltx-2-spatial-upscaler-x2-1.0 | 高解像度のための 2x 空間アップスケーラー | | ltx-2-temporal-upscaler-x2-1.0 | 高 FPS のための 2x 時間アップスケーラー | -## 快速入門 +## はじめに LTX-2 は ComfyUI でネイティブサポートされています。開始するには： @@ -113,7 +113,7 @@ IC-LoRAs を使用して構造制御付き動画を生成します。 LTX-2 のプロンプトを作成する際は、アクションやシーンの詳細で時系列な説明に焦点を当ててください。具体的な動き、外見、カメラアングル、環境の詳細を一つの流れるような段落に含めます。アクションから直接始め、説明を文字通りかつ正確に保ってください。 プロンプトの構造： -- 一文で主要アクションを描述 +- 一文で主要アクションを説明 - 動きやジェスチャーの詳細 - キャラクター/物体の外見 - 背景と環境の詳細 From cb4753c2de8934391fbb38e8fde6434ca577b7f5 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:49:29 +0800 Subject: [PATCH 12/59] =?UTF-8?q?fix(i18n/zh):=20=E6=81=A2=E5=A4=8D=20API?= =?UTF-8?q?=20=E7=A4=BA=E4=BE=8B=E6=96=87=E6=A1=A3=E4=B8=AD=E7=BC=BA?= =?UTF-8?q?=E5=A4=B1=E7=9A=84=E5=AE=8C=E6=95=B4=E4=BB=A3=E7=A0=81=E5=9D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../comfyui-server/api-examples.mdx | 71 +++++++++++++------ 1 file changed, 49 insertions(+), 22 deletions(-) diff --git a/zh/development/comfyui-server/api-examples.mdx b/zh/development/comfyui-server/api-examples.mdx index 18f26f463..53f1c7676 100644 --- a/zh/development/comfyui-server/api-examples.mdx +++ b/zh/development/comfyui-server/api-examples.mdx @@ -1,8 +1,6 @@ --- title: "API 示例" description: "调用 ComfyUI Server API 的三种常见方式" -translationSourceHash: 8afd49d2 -translationFrom: development/comfyui-server/api-examples.mdx --- 本页演示了与 ComfyUI Server API 交互的三种方式，从简单的 HTTP 提交到完整的 WebSocket 集成实时图像输出。 @@ -19,7 +17,7 @@ translationFrom: development/comfyui-server/api-examples.mdx 源码：[`basic_api_example.py`](https://github.com/Comfy-Org/ComfyUI/blob/master/script_examples/basic_api_example.py) -最简单的方式：提交工作流，不等待结果。适用于不需要即时输出的场景。 +最简单的方式：提交工作流，不等待结果。适用于提交后稍后检查输出的场景。 ```python """basic_api_example.py — 仅通过 HTTP 提交工作流。""" @@ -174,16 +172,29 @@ def get_images(ws, prompt): if __name__ == "__main__": - # 此处省略完整工作流 JSON，请参考方法一的示例 - # prompt = json.loads(prompt_text) - # prompt["3"]["inputs"]["seed"] = 5 - # prompt["6"]["inputs"]["text"] = "masterpiece best quality man" - - # ws = websocket.WebSocket() - # ws.connect(f"ws://{SERVER_ADDRESS}/ws?clientId={client_id}") - # images = get_images(ws, prompt) - # ws.close() - pass + prompt_text = """{ + "3": { ... }, "4": { ... }, "5": { ... }, + "6": { ... }, "7": { ... }, "8": { ... }, + "9": { "class_type": "SaveImage", "inputs": { ... } } + }""" + prompt = json.loads(prompt_text) + prompt["3"]["inputs"]["seed"] = 5 + prompt["6"]["inputs"]["text"] = "masterpiece best quality man" + + ws = websocket.WebSocket() + ws.connect(f"ws://{SERVER_ADDRESS}/ws?clientId={client_id}") + images = get_images(ws, prompt) + ws.close() + + print(f"Got {len(images)} output node(s) with images.") + + # 显示图片（需要 Pillow）： + # for node_id in images: + # for image_data in images[node_id]: + # from PIL import Image + # import io + # img = Image.open(io.BytesIO(image_data)) + # img.show() ``` @@ -247,14 +258,30 @@ def get_images(ws, prompt): if __name__ == "__main__": - # prompt = json.loads(prompt_text) - # prompt["3"]["inputs"]["seed"] = 5 - - # ws = websocket.WebSocket() - # ws.connect(f"ws://{SERVER_ADDRESS}/ws?clientId={client_id}") - # images = get_images(ws, prompt) - # ws.close() - pass + prompt_text = """{ + "3": { "class_type": "KSampler", "inputs": { ... } }, + ... + "save_image_websocket_node": { + "class_type": "SaveImageWebsocket", + "inputs": {"images": ["8", 0]} + } + }""" + prompt = json.loads(prompt_text) + prompt["3"]["inputs"]["seed"] = 5 + + ws = websocket.WebSocket() + ws.connect(f"ws://{SERVER_ADDRESS}/ws?clientId={client_id}") + images = get_images(ws, prompt) + ws.close() + + print(f"Received {len(images)} image(s) via WebSocket.") + + # 显示（需要 Pillow）： + # for image_data in images.get("save_image_websocket_node", []): + # from PIL import Image + # import io + # img = Image.open(io.BytesIO(image_data)) + # img.show() ``` @@ -267,7 +294,7 @@ if __name__ == "__main__": - **发送即忘。** 适用于不需要立即获取输出的场景。 + **发送即忘。** 适用于不需要立即获取输出，或稍后检查结果即可的场景。 **推荐。** 等待完成，然后下载结果。简单性和可靠性之间最佳平衡。 From 18c5672f70b5e718cf51120c9b2b99fd6f6c8dbc Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:49:31 +0800 Subject: [PATCH 13/59] fix(i18n/ko): remove extra translation metadata lines not in English source --- .../retrieve-all-personal-access-tokens-for-a-publisher.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/ko/registry/api-reference/token-management/retrieve-all-personal-access-tokens-for-a-publisher.mdx b/ko/registry/api-reference/token-management/retrieve-all-personal-access-tokens-for-a-publisher.mdx index 2a950ae66..5b4575db1 100644 --- a/ko/registry/api-reference/token-management/retrieve-all-personal-access-tokens-for-a-publisher.mdx +++ b/ko/registry/api-reference/token-management/retrieve-all-personal-access-tokens-for-a-publisher.mdx @@ -1,5 +1,3 @@ --- openapi: get /publishers/{publisherId}/tokens -translationSourceHash: 1d53c4fe -translationFrom: registry/api-reference/token-management/retrieve-all-personal-access-tokens-for-a-publisher.mdx --- \ No newline at end of file From ff707cf3e0e8ca99391d92e0d7c8c446d1b485e8 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:49:31 +0800 Subject: [PATCH 14/59] fix(i18n/ja): fix partner node terminology in luma text-to-image --- ja/tutorials/partner-nodes/luma/luma-text-to-image.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ja/tutorials/partner-nodes/luma/luma-text-to-image.mdx b/ja/tutorials/partner-nodes/luma/luma-text-to-image.mdx index 01034d069..a22f9a4a3 100644 --- a/ja/tutorials/partner-nodes/luma/luma-text-to-image.mdx +++ b/ja/tutorials/partner-nodes/luma/luma-text-to-image.mdx @@ -1,5 +1,5 @@ --- -title: "Luma Text to Image API ノード ComfyUI 公式サンプル" +title: "Luma Text to Image パートナーノード ComfyUI 公式サンプル" description: "本ガイドでは、ComfyUI で Luma Text to Image パートナーノードを使用する方法について説明します" sidebarTitle: "Luma Text to Image" translationSourceHash: f0284d80 @@ -21,14 +21,14 @@ import UpdateReminder from "/snippets/ja/tutorials/update-reminder.mdx"; 詳細なパラメーター設定については、以下のドキュメントをご参照ください： -Luma Text to Image API ノードのドキュメント +Luma Text to Image ノードのドキュメント -Luma Reference API ノードのドキュメント +Luma Reference ノードのドキュメント -## Luma Text to Image API ノードによるテキストから画像を生成するワークフロー +## Luma Text to Image ノードによるテキストから画像を生成するワークフロー `Luma Text to Image` ノードに画像入力が一切ない状態で使用すると、これはテキストから画像を生成する（text-to-image）ワークフローとして機能します。本ガイドでは、`style_image` および `image_luma_ref` を用いた例を作成し、Luma AI の優れた画像処理能力を体験できるようにしています。 From 292c3617e6fdc66712fd606a725ed1dc0d3e7599 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:49:38 +0800 Subject: [PATCH 15/59] fix(i18n/ko): remove extra translation metadata lines from delete-a-specific-node --- ko/registry/api-reference/nodes/delete-a-specific-node.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/ko/registry/api-reference/nodes/delete-a-specific-node.mdx b/ko/registry/api-reference/nodes/delete-a-specific-node.mdx index ad046f1f3..05d45a996 100644 --- a/ko/registry/api-reference/nodes/delete-a-specific-node.mdx +++ b/ko/registry/api-reference/nodes/delete-a-specific-node.mdx @@ -1,5 +1,3 @@ --- openapi: delete /publishers/{publisherId}/nodes/{nodeId} -translationSourceHash: 50f3c2d7 -translationFrom: registry/api-reference/nodes/delete-a-specific-node.mdx --- \ No newline at end of file From 5dfcdf89962decbd3b664ac113862cd610d884e7 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:49:38 +0800 Subject: [PATCH 16/59] fix(i18n/ja): fix 'about' terminology from Chinese to Japanese --- ja/custom-nodes/js/javascript_about_panel_badges.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ja/custom-nodes/js/javascript_about_panel_badges.mdx b/ja/custom-nodes/js/javascript_about_panel_badges.mdx index 046b9e0bb..aa6441f49 100644 --- a/ja/custom-nodes/js/javascript_about_panel_badges.mdx +++ b/ja/custom-nodes/js/javascript_about_panel_badges.mdx @@ -1,10 +1,10 @@ --- -title: "关于パネルバッジ" +title: "情報パネルバッジ" translationSourceHash: 1cbbc032 translationFrom: custom-nodes/js/javascript_about_panel_badges.mdx --- -关于パネルバッジ API により、拡張機能は ComfyUI の关于ページにカスタムバッジを追加できます。これらのバッジには拡張機能に関する情報を表示でき、ドキュメント、ソースコード、または他のリソースへのリンクを含めることができます。 +情報パネルバッジ API により、拡張機能は ComfyUI の情報ページにカスタムバッジを追加できます。これらのバッジには拡張機能に関する情報を表示でき、ドキュメント、ソースコード、または他のリソースへのリンクを含めることができます。 ## 基本的な使い方 @@ -77,4 +77,4 @@ app.registerExtension({ }); ``` -バッジは設定ダイアログの关于パネルに表示され、ComfyUI インターフェースの右上隅にあるギアアイコンからアクセスできます。 \ No newline at end of file +バッジは設定ダイアログの情報パネルに表示され、ComfyUI インターフェースの右上隅にあるギアアイコンからアクセスできます。 \ No newline at end of file From 7cc22f0e0ac63a46d566e8505386d3a6f4a1c0ee Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:49:53 +0800 Subject: [PATCH 17/59] fix(i18n/ja): fix terminology, remove extra card, fix Chinese text --- .../comfyui-server/api-key-integration.mdx | 28 ++++++++----------- 1 file changed, 12 insertions(+), 16 deletions(-) diff --git a/ja/development/comfyui-server/api-key-integration.mdx b/ja/development/comfyui-server/api-key-integration.mdx index a1a90abc4..a8cc71576 100644 --- a/ja/development/comfyui-server/api-key-integration.mdx +++ b/ja/development/comfyui-server/api-key-integration.mdx @@ -1,13 +1,13 @@ --- title: 'ComfyUI アカウント API キー統合' -description: 'この記事では、ヘッドレスモードで有料 API ノードを呼び出すために ComfyUI アカウント API キーを使用する方法について説明します' +description: 'この記事では、ヘッドレスモードで有料パートナーノードを呼び出すために ComfyUI アカウント API キーを使用する方法について説明します' sidebarTitle: 'Partner Node API 統合' icon: 'puzzle-piece' translationSourceHash: 1276143d translationFrom: development/comfyui-server/api-key-integration.mdx --- -[PR #8041](https://github.com/Comfy-Org/ComfyUI/pull/8041) 以降、ComfyUI は特定のフロントエンドインターフェースを必要とせずに（フロントエンドなしで実行することも可能です）、ComfyUI アカウント API キーを通じて内置の有料 API ノードを直接使用できるようになりました。 +[PR #8041](https://github.com/Comfy-Org/ComfyUI/pull/8041) 以降、ComfyUI は特定のフロントエンドインターフェースを必要とせずに（フロントエンドなしで実行することも可能です）、ComfyUI アカウント API キーを通じて組み込みの有料パートナーノードを直接使用できるようになりました。 これにより、以下を組み合わせるワークフローを作成できます： - ローカル OS モデル @@ -20,19 +20,15 @@ translationFrom: development/comfyui-server/api-key-integration.mdx ## 前提条件 -ComfyUI アカウント API キーを使用して有料 API ノードを呼び出すには、以下が必要です： +ComfyUI アカウント API キーを使用して有料パートナーノードを呼び出すには、以下が必要です： - [ComfyUI アカウント API キー](/ja/development/api-development/getting-an-api-key) - 十分なアカウントクレジット - **重要：** このページでは、ワークフロー内の有料 API ノードへのアクセスに使用される **ComfyUI アカウント API キー** について説明します。代わりにカスタムノードをレジストリに公開したい場合は、[ノードの公開](/registry/publishing) を参照してください。 + **重要：** このページでは、ワークフロー内の有料パートナーノードへのアクセスに使用される **ComfyUI アカウント API キー** について説明します。代わりにカスタムノードをレジストリに公開したい場合は、[ノードの公開](/registry/publishing) を参照してください。 -有料 API ノードを呼び出すために ComfyUI アカウント API キーを使用するには、まず [ComfyUI Platform](https://platform.comfy.org/login) でアカウントを登録し、[API キーを作成する](/ja/development/api-development/getting-an-api-key)必要があります。 - - -API キーでログインする方法については、ユーザーインターフェースセクションを参照してください - +有料パートナーノードを呼び出すために ComfyUI アカウント API キーを使用するには、まず [ComfyUI Platform](https://platform.comfy.org/login) でアカウントを登録し、[API キーを作成する](/ja/development/api-development/getting-an-api-key)必要があります。 対応する機能をテストするために、ComfyUI アカウントに十分なクレジットがあることを確認する必要があります。 @@ -41,20 +37,20 @@ API キーでログインする方法については、ユーザーインター -## Python 示例 +## Python 例 -以下は、Python コードを使用して API ノードを含むワークフローを ComfyUI API に送信する方法の例です： +以下は、Python コードを使用してパートナーノードを含むワークフローを ComfyUI API に送信する方法の例です： ```python -"""ComfyUI をヘッドレスモードまたは代替フロントエンドで実行する際に API ノードを使用する +"""ComfyUI をヘッドレスモードまたは代替フロントエンドで実行する際にパートナーノードを使用する -API キーをプロンプトに含めることで、API ノードを含む ComfyUI ワークフローを実行できます。 +API キーをプロンプトに含めることで、パートナーノードを含む ComfyUI ワークフローを実行できます。 API キーは、ペイロードの `extra_data` フィールドに追加する必要があります。 以下に、その方法の例を示します。 詳細情報： -- API ノードの概要：https://docs.comfy.org/tutorials/partner-nodes/overview +- パートナーノードの概要：https://docs.comfy.org/tutorials/partner-nodes/overview - API キーを生成するには、こちらにログインしてください：https://platform.comfy.org/login """ @@ -63,7 +59,7 @@ from urllib import request SERVER_URL = "http://127.0.0.1:8188" -# API ノードを含むプロンプト/ジョブ（「API 形式」のワークフロー）があります。 +# パートナーノードを含むプロンプト/ジョブ（「API 形式」のワークフロー）があります。 workflow_with_api_nodes = """{ "11": { "inputs": { @@ -125,6 +121,6 @@ request.urlopen(req) ## 関連ドキュメント -- [API ノードの概要](https://docs.comfy.org/tutorials/partner-nodes/overview) +- [パートナーノードの概要](https://docs.comfy.org/tutorials/partner-nodes/overview) - [アカウント管理](https://docs.comfy.org/interface/user) - [クレジット](https://docs.comfy.org/interface/credits) \ No newline at end of file From 100b2c17081b2cc161c4956dd6b6eb44c187e788 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:49:58 +0800 Subject: [PATCH 18/59] fix(i18n/ko): add missing heading, fix wheelchair translation, fix link prefix --- ko/development/cloud/api-reference.mdx | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/ko/development/cloud/api-reference.mdx b/ko/development/cloud/api-reference.mdx index d6ac19708..79d34846b 100644 --- a/ko/development/cloud/api-reference.mdx +++ b/ko/development/cloud/api-reference.mdx @@ -406,6 +406,7 @@ prompt_id = submit_workflow_with_partner_nodes(workflow, API_KEY) [platform.comfy.org](https://platform.comfy.org/login)에서 API 키를 생성하세요. 이는 클라우드 API 인증에 사용되는 키(`X-API-Key` 헤더)와 동일합니다. 자세한 가이드는 [API 키 받기](/ko/development/api-development/getting-an-api-key)를 참조하세요. +### 워크플로우 입력 수정 ```typescript TypeScript @@ -454,7 +455,7 @@ workflow = set_workflow_input(workflow, "6", "text", "아름다운 풍경") ## 작업 상태 확인 -작업 완료 여부를 휠체어로 확인합니다. +작업 완료 여부를 확인합니다. @@ -540,7 +541,7 @@ WebSocket 연결을 통해 실시간 실행 업데이트를 받습니다. - 각 JSON 메시지 유형의 완전한 스키마 정의는 [OpenAPI 사양](/development/cloud/openapi)을 참조하세요. + 각 JSON 메시지 유형의 완전한 스키마 정의는 [OpenAPI 사양](/ko/development/cloud/openapi)을 참조하세요. --- From ed548d3c2ac59b7573f41d55b032a291dbbfee65 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:04 +0800 Subject: [PATCH 19/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=E6=95=85=E9=9A=9C=E6=8E=92=E6=9F=A5=E6=96=87=E6=A1=A3=E7=9A=84?= =?UTF-8?q?=E6=80=A7=E8=83=BD=E5=91=BD=E4=BB=A4=E3=80=81Windows=20?= =?UTF-8?q?=E6=A1=8C=E9=9D=A2=E9=97=AE=E9=A2=98=E3=80=81=E5=89=8D=E7=AB=AF?= =?UTF-8?q?=E9=97=AE=E9=A2=98=E3=80=81Intel=20GPU=20=E7=AD=89=E7=BC=BA?= =?UTF-8?q?=E5=A4=B1=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/troubleshooting/overview.mdx | 301 ++++++++++++++++++++------------ 1 file changed, 192 insertions(+), 109 deletions(-) diff --git a/zh/troubleshooting/overview.mdx b/zh/troubleshooting/overview.mdx index 7c57205da..d7efbd74e 100644 --- a/zh/troubleshooting/overview.mdx +++ b/zh/troubleshooting/overview.mdx @@ -3,21 +3,19 @@ title: "如何排查和解决 ComfyUI 中出现的错误" description: "常见 ComfyUI 问题、解决方案和如何有效报告错误" icon: "lightbulb" sidebarTitle: "概述" -translationSourceHash: 770c31b9 -translationFrom: troubleshooting/overview.mdx --- - 我们日常收到的诸多反馈问题，我们发现绝大部分的问题提交都与自定义节点有关,所以在提交对应的错误反馈之前，请你确保详细阅读了 [自定义节点故障排除](/zh/troubleshooting/custom-node-issues) 部分的指南，来确保对应的问题并不是由 ComfyUI 核心问题导致的。 + 我们日常收到的诸多反馈问题，我们发现绝大部分的问题提交都与自定义节点有关，所以在提交对应的错误反馈之前，请你确保详细阅读了[自定义节点故障排查](/zh/troubleshooting/custom-node-issues)部分的指南，来确保对应的问题并不是由 ComfyUI 核心问题导致的。 - + 查看如何排查自定义节点导致的问题。 ## 常见问题与快速修复 -在深入详细故障排除之前，请尝试这些常见解决方案： +在深入详细故障排查之前，请尝试这些常见解决方案： ### ComfyUI 无法启动 @@ -32,8 +30,8 @@ translationFrom: troubleshooting/overview.mdx **症状：** "Prompt execution failed"（提示执行失败）对话框，带有"Show report"（显示报告）按钮，工作流停止执行 **快速修复：** -1. **点击"Show report"** - 阅读详细错误消息以识别具体问题 -2. **检查是否是自定义节点问题** - [遵循我们的自定义节点故障排除指南](/zh/troubleshooting/custom-node-issues) +1. **点击"Show report"** - 阅读详细的报错信息以识别具体问题 +2. **检查是否是自定义节点问题** - [遵循我们的自定义节点故障排查指南](/zh/troubleshooting/custom-node-issues) 3. **验证模型文件** - 查看[模型文档](/zh/development/core-concepts/models)了解模型设置 4. **检查显存使用情况** - 关闭其他使用 GPU 内存的应用程序 @@ -51,13 +49,10 @@ translationFrom: troubleshooting/overview.mdx 对于低显存系统： ```bash -# 低显存模式（将模型分成多个部分） +# 低显存模式（使用 CPU 处理文本编码器） python main.py --lowvram -# 当 --lowvram 不够用时的更低显存模式 -python main.py --novram - -# CPU 模式（非常慢但适用于任何硬件） +# CPU 模式（非常慢但适用于任何硬件，仅作为最后手段使用） python main.py --cpu ``` @@ -66,12 +61,6 @@ python main.py --cpu # 禁用预览（节省显存和处理） python main.py --preview-method none -# 将模型保持在显存中（更快但使用更多显存） -python main.py --highvram - -# 强制 FP16 精度（更快，使用更少显存） -python main.py --force-fp16 - # 使用优化的注意力机制 python main.py --use-pytorch-cross-attention python main.py --use-flash-attention @@ -89,21 +78,23 @@ python main.py --reserve-vram 2 python main.py --disable-smart-memory # 使用不同的缓存策略 -python main.py --cache-none # 更少的内存使用 -python main.py --cache-lru 10 # 缓存 10 个结果 +python main.py --cache-none # 更少的内存使用，但更慢 +python main.py --cache-lru 10 # 缓存 10 个结果，更快 +python main.py --cache-classic # 使用旧风格（激进）的缓存 ``` ## 安装过程中出现的问题 ### 桌面应用问题 -有关全面的桌面安装故障排除，请参见[桌面安装指南](/zh/installation/desktop/windows)。 +有关全面的桌面安装故障排查，请参见[桌面安装指南](/zh/installation/desktop/windows)。 -- **无法安装**：以管理员身份运行安装程序 -- **缺少依赖项**：安装 [Visual C++ 可再发行组件](https://aka.ms/vs/17/release/vc_redist.x64.exe) -- **启动时崩溃**：检查 Windows 事件查看器以获取错误详细信息 +- **不支持的设备**：ComfyUI Desktop Windows 仅支持带有 CUDA 的 NVIDIA GPU。对于其他 GPU，请使用 [ComfyUI 便携版](/zh/installation/comfyui_portable_windows)或[手动安装](/zh/installation/manual_install) +- **安装失败**：以管理员身份运行安装程序，确保至少 15GB 磁盘空间 +- **维护页面**：如果下载失败，请检查[镜像设置](/zh/installation/desktop/windows#mirror-settings) +- **缺少模型**：迁移时模型不会被复制，仅链接。请验证模型路径 - **"应用程序已损坏"**：在安全性与隐私设置中允许应用程序 @@ -152,7 +143,7 @@ pip install torch torchvision torchaudio --index-url https://download.pytorch.or **LD_LIBRARY_PATH 错误：** -常见错误： +常见症状： - "libcuda.so.1: cannot open shared object file" - "libnccl.so: cannot open shared object file" - "ImportError: libnvinfer.so.X: cannot open shared object file" @@ -220,11 +211,11 @@ python -c "import torch; print('CUDA available:', torch.cuda.is_available()); pr ## 模型相关问题 -有关综合模型故障排除，包括架构不匹配、缺少模型和加载错误，请参见专门的[模型问题](/zh/troubleshooting/model-issues)页面。 +有关综合模型故障排查，包括架构不匹配、缺少模型和加载错误，请参见专门的[模型问题](/zh/troubleshooting/model-issues)页面。 ## 网络和 API 问题 -### API 节点不工作 +### 合作节点不工作 **症状：** API 调用失败、超时错误、配额超出 @@ -244,41 +235,125 @@ python -c "import torch; print('CUDA available:', torch.cuda.is_available()); pr 3. **临时禁用 VPN** - VPN 可能阻止连接 4. **检查代理设置** - 如果不需要，禁用代理 +### 前端问题 + +**"Frontend or Templates Package Not Updated"（前端或模板包未更新）：** +```bash +# 通过 Git 更新 ComfyUI 后，更新前端依赖 +pip install -r requirements.txt +``` + +**"Can't Find Custom Node"（找不到自定义节点）：** +- 在 ComfyUI 设置中禁用节点验证 + +**"Error Toast About Workflow Failing Validation"（工作流验证失败的错误提示）：** +- 暂时在设置中禁用工作流验证 +- 向 ComfyUI 团队报告问题 + +**非 Localhost 访问时的登录问题：** +- 普通登录仅在从 localhost 访问时有效 +- 对于局域网/远程访问：在 [platform.comfy.org/login](https://platform.comfy.org/login) 生成 API 密钥 +- 在登录对话框中使用 API 密钥，或使用 `--api-key` 命令行参数 + ## 硬件特定问题 ### NVIDIA GPU 问题 -**CUDA 错误、GPU 未检测到：** +**"Torch not compiled with CUDA enabled" 错误：** ```bash -# 检查 CUDA 安装 -nvidia-smi +# 先卸载 torch +pip uninstall torch + +# 安装带 CUDA 13.0 的稳定版 PyTorch +pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 + +# 对于 nightly 版本（可能有性能改进） +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/cu132 -# 验证 PyTorch CUDA 支持 +# 验证 CUDA 支持 python -c "import torch; print(torch.cuda.is_available())" +``` -# 重新安装带 CUDA 的 PyTorch -pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 +**GPU 未被检测到：** +```bash +# 检查 GPU 是否可见 +nvidia-smi + +# 检查驱动版本和 CUDA 兼容性 +nvidia-smi --query-gpu=driver_version --format=csv ``` ### AMD GPU 问题 -**ROCm 支持、性能问题：** +**ROCm 支持（仅限 Linux）：** ```bash -# 安装 ROCm 版本的 PyTorch +# 安装稳定的 ROCm PyTorch（撰写时为 7.2） pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2 + +# 对于 nightly 版本（撰写时为 ROCm 7.2，可能有性能改进） +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm7.2 +``` + +**不支持的 AMD GPU：** +```bash +# 对于 RDNA2 或更老型号（6700、6600） +HSA_OVERRIDE_GFX_VERSION=10.3.0 python main.py + +# 对于 RDNA3 显卡（7600） +HSA_OVERRIDE_GFX_VERSION=11.0.0 python main.py ``` +**性能优化：** +```bash +# 启用实验性内存高效注意力（PyTorch 2.4 后不再需要） +TORCH_ROCM_AOTRITON_ENABLE_EXPERIMENTAL=1 python main.py --use-pytorch-cross-attention + +# 启用可调优操作（首次运行慢，后续运行更快） +PYTORCH_TUNABLEOP_ENABLED=1 python main.py +``` + + ### Apple Silicon (M1/M2/M3) 问题 -**MPS 后端错误：** +**MPS 后端设置：** ```bash +# 安装 Apple Silicon 的 PyTorch nightly +# 请遵循 Apple 指南：https://developer.apple.com/metal/pytorch/ + # 检查 MPS 可用性 python -c "import torch; print(torch.backends.mps.is_available())" -# 如果 MPS 导致问题，强制使用 CPU +# 启动 ComfyUI +python main.py +``` + +**如果 MPS 导致问题：** +```bash +# 强制 CPU 模式 +python main.py --cpu + +# 带内存优化 python main.py --force-fp16 --cpu ``` +### Intel GPU 问题 + +**方式一：原生 PyTorch XPU 支持（Windows/Linux）：** +```bash +# 安装带 XPU 支持的 PyTorch nightly +pip install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/xpu + +# 启动 ComfyUI +python main.py +``` + +**方式二：Intel Extension for PyTorch（IPEX）：** +```bash +# 对于 Intel Arc A 系列显卡 +conda install libuv +pip install torch==2.3.1.post0+cxx11.abi torchvision==0.18.1.post0+cxx11.abi torchaudio==2.3.1.post0+cxx11.abi intel-extension-for-pytorch==2.3.110.post0+xpu --extra-index-url https://pytorch-extension.intel.com/release-whl/stable/xpu/us/ +``` + ## 获取帮助和报告错误 ### 报告错误之前 @@ -288,93 +363,105 @@ python main.py --force-fp16 --cpu - 检查 [ComfyUI 论坛](https://forum.comfy.org/) - 查看 [Discord 讨论](https://discord.com/invite/comfyorg) -2. **尝试基本故障排除：** +2. **尝试基本故障排查：** - 使用[默认工作流](/zh/get_started/first_generation)进行测试 - - 禁用所有自定义节点（参见[自定义节点故障排除](/zh/troubleshooting/custom-node-issues)） - - 检查控制台/终端中的错误消息 + - 禁用所有自定义节点（参见[自定义节点故障排查](/zh/troubleshooting/custom-node-issues)） + - 检查控制台/终端中的报错信息 + - 如果使用 comfy-cli，尝试更新：`comfy node update all` ### 如何有效报告错误 #### 对于 ComfyUI 核心问题 -**问题提交：** [GitHub Issues](https://github.com/Comfy-Org/ComfyUI/issues) +**提交位置：** [GitHub Issues](https://github.com/Comfy-Org/ComfyUI/issues) #### 对于桌面应用问题 -**问题提交：** [桌面 GitHub Issues](https://github.com/Comfy-Org/desktop/issues) +**提交位置：** [桌面 GitHub Issues](https://github.com/Comfy-Org/desktop/issues) #### 对于前端问题 -**问题提交：** [前端 GitHub Issues](https://github.com/Comfy-Org/ComfyUI_frontend/issues) +**提交位置：** [前端 GitHub Issues](https://github.com/Comfy-Org/ComfyUI_frontend/issues) #### 对于自定义节点问题 -**问题提交：** 请到对应的自定义节点仓库中提交问题 +**提交位置：** 请到对应的自定义节点仓库中提交问题 -### 在 issue 中你需要提供的信息 +### 需要提供的信息 报告任何问题时，请包括以下内容： - + + + +**系统信息（可在设置的关于页面找到）：** +- 操作系统（Windows 11、macOS 14.1、Ubuntu 22.04 等） +- ComfyUI 版本（检查设置中的关于页面） +- Python 版本：`python --version` +- PyTorch 版本：`python -c "import torch; print(torch.__version__)"` +- GPU 型号和驱动程序版本 +- 安装方式（桌面版、便携版、手动安装、comfy-cli） + +![设置菜单-关于页面](/images/troubleshooting/menu-about.jpg) + + - - - 操作系统（Windows 11、macOS 14.1、Ubuntu 22.04 等） - - ComfyUI 版本（检查设置中的关于页面） - - Python 版本：`python --version` - - PyTorch 版本：`python -c "import torch; print(torch.__version__)"` - - GPU 型号和驱动程序版本 - - ![设置菜单-关于页面](/images/troubleshooting/menu-about.jpg) - - - - - ```bash - # 系统信息 - systeminfo | findstr /C:"OS Name" /C:"OS Version" - - # GPU 信息 - wmic path win32_VideoController get name - - # Python 和 PyTorch 信息 - python --version - python -c "import torch; print(f'PyTorch: {torch.__version__}')" - python -c "import torch; print(f'CUDA Available: {torch.cuda.is_available()}')" - ``` - - - ```bash - # 系统信息 - uname -a - - # GPU 信息（Linux） - lspci | grep VGA - - # Python 和 PyTorch 信息 - python --version - python -c "import torch; print(f'PyTorch: {torch.__version__}')" - python -c "import torch; print(f'CUDA Available: {torch.cuda.is_available()}')" - ``` - - - + + ```bash + # 系统信息 + systeminfo | findstr /C:"OS Name" /C:"OS Version" + + # GPU 信息 + wmic path win32_VideoController get name + + # Python 和 PyTorch 信息 + python --version + python -c "import torch; print(f'PyTorch: {torch.__version__}')" + python -c "import torch; print(f'CUDA Available: {torch.cuda.is_available()}')" + ``` + + + ```bash + # 系统信息 + uname -a + + # GPU 信息（Linux） + lspci | grep VGA + + # Python 和 PyTorch 信息 + python --version + python -c "import torch; print(f'PyTorch: {torch.__version__}')" + python -c "import torch; print(f'CUDA Available: {torch.cuda.is_available()}')" + ``` + - - - - - 问题的清晰描述 - - 重现问题的步骤 - - 预期行为与实际行为 - - 如果可以，提供截图或复现过程的屏幕录制 - - - - 控制台/终端的完整错误文本 - - 浏览器控制台错误（F12 → 控制台选项卡） - - 任何崩溃日志或错误对话框 - - - - 已安装的自定义节点列表 - - 重现问题的工作流文件（.json） - - 最近的更改（新安装、更新等） - + + + + + +**对于桌面应用问题，还需提供：** +- 日志文件来自：`C:\Users\<用户名>\AppData\Roaming\ComfyUI\logs`（Windows） +- 配置文件来自：`C:\Users\<用户名>\AppData\Roaming\ComfyUI`（Windows） + + + +**问题的详细信息：** +- 问题的清晰描述 +- 重现问题的步骤 +- 预期行为与实际行为 +- 如果可以，提供截图或复现过程的屏幕录制 + +**报错信息：** +- 控制台/终端的完整错误文本 +- 浏览器控制台错误（F12 → 控制台选项卡） +- 任何崩溃日志或错误对话框 + + + +**其他上下文：** +- 已安装的自定义节点列表 +- 重现问题的工作流文件（.json） +- 最近的更改（新安装、更新等） + ## 社区资源 @@ -383,7 +470,3 @@ python main.py --force-fp16 --cpu - **Discord：** [ComfyUI Discord 服务器](https://discord.com/invite/comfyorg) - **Reddit：** [r/comfyui](https://reddit.com/r/comfyui) - **YouTube：** [ComfyUI 教程](https://www.youtube.com/@comfyorg) - - -对于影响许多用户的紧急问题，请查看我们的[状态页面](https://status.comfy.org)和[官方 Twitter](https://x.com/ComfyUI)以获取公告。 - \ No newline at end of file From bd70db7b188e571a2e31b9d3c2f67c8d1964f610 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:11 +0800 Subject: [PATCH 20/59] =?UTF-8?q?fix(i18n/zh):=20=E7=A7=BB=E9=99=A4?= =?UTF-8?q?=E9=A2=9D=E5=A4=96=E5=85=83=E6=95=B0=E6=8D=AE=E8=A1=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/registry/api-reference/nodes/create-a-new-custom-node.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/zh/registry/api-reference/nodes/create-a-new-custom-node.mdx b/zh/registry/api-reference/nodes/create-a-new-custom-node.mdx index fdbcddb30..c6b290596 100644 --- a/zh/registry/api-reference/nodes/create-a-new-custom-node.mdx +++ b/zh/registry/api-reference/nodes/create-a-new-custom-node.mdx @@ -1,5 +1,3 @@ --- openapi: post /publishers/{publisherId}/nodes -translationSourceHash: c29b437f -translationFrom: registry/api-reference/nodes/create-a-new-custom-node.mdx --- \ No newline at end of file From d17a29fd65b9aef18b3e9a9384cb3fa3dbaa4578 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:16 +0800 Subject: [PATCH 21/59] fix(i18n/ja): add Standard row to table, fix TypeScript code comments and template literal --- ja/development/cloud/overview.mdx | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/ja/development/cloud/overview.mdx b/ja/development/cloud/overview.mdx index 8ee55c975..586795c15 100644 --- a/ja/development/cloud/overview.mdx +++ b/ja/development/cloud/overview.mdx @@ -94,6 +94,7 @@ API ユーザーは、前のジョブの完了を待たずに、複数のワー | サブスクリプションティア | 同時ジョブ数 | |-------------------|-----------------| +| Standard | 1 | | Creator | 3 | | Pro | 5 | @@ -171,7 +172,7 @@ async function main() { await Deno.readTextFile("workflow_api.json") ); - # シードを変更してバリエーションを作成 + // シードを変更してバリエーションを作成 const seeds = [42, 123, 456]; const workflows = seeds.map((seed) => { const wf = structuredClone(base); @@ -179,16 +180,16 @@ async function main() { return wf; }); - # すべてのワークフローを同時に送信 + // すべてのワークフローを同時に送信 const promptIds = await Promise.all( workflows.map((wf) => submitWorkflow(wf)) ); for (const pid of promptIds) { - console.log(`Job submitted: {pid}`); + console.log(`Job submitted: ${pid}`); } - # 各ジョブをポーリングまたは WebSocket で監視... + // 各ジョブをポーリングまたは WebSocket で監視... } main(); From df4ccb0fbe195455e2aeebeb7293947dc25d6575 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:17 +0800 Subject: [PATCH 22/59] fix(i18n/ko): restore untranslated JSON key and fix links array syntax --- ko/specs/workflow_json_0.4.mdx | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/ko/specs/workflow_json_0.4.mdx b/ko/specs/workflow_json_0.4.mdx index 4222d0f90..4ec62cbe5 100644 --- a/ko/specs/workflow_json_0.4.mdx +++ b/ko/specs/workflow_json_0.4.mdx @@ -244,7 +244,7 @@ translationFrom: specs/workflow_json_0.4.mdx "properties": { "type": "object", "properties": { - "S&R용 노드 이름": { + "Node name for S&R": { "type": "string" } }, @@ -338,13 +338,14 @@ translationFrom: specs/workflow_json_0.4.mdx }, { "type": "array", - "items": { - "type": "string" + "items": { + "type": "string" + } + }, + { + "type": "number" } - }, - { - "type": "number" - } + ] } ] } From 882407aa8e7a5bf849333e6ef7e2392316d6e1eb Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:20 +0800 Subject: [PATCH 23/59] =?UTF-8?q?fix(i18n/zh):=20=E6=B7=BB=E5=8A=A0=20Stan?= =?UTF-8?q?dard=20=E7=AD=89=E7=BA=A7=E8=A1=8C=E5=92=8C=E7=A7=AF=E5=88=86?= =?UTF-8?q?=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/development/cloud/overview.mdx | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/zh/development/cloud/overview.mdx b/zh/development/cloud/overview.mdx index 6a6472088..25f993fb9 100644 --- a/zh/development/cloud/overview.mdx +++ b/zh/development/cloud/overview.mdx @@ -25,7 +25,7 @@ Comfy Cloud API 提供以编程方式访问 Comfy Cloud 的能力，可在云端 ## 积分与用量 -API 请求消耗的是与 Comfy Cloud 网页端相同的每月积分配额——不存在单独的 API 积分池。每个等级的包含积分、加购选项以及单次工作流运行时长上限对 API 任务和网页端任务完全相同。Creator 和 Pro 等级的每月积分数量请参阅[定价方案](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api)。如果在月中用尽积分，可在账户面板中购买加购包。 +API 请求消耗的是与 Comfy Cloud 网页端相同的每月积分配额——不存在单独的 API 积分池。每个等级的包含积分、加购选项以及单次工作流运行时长上限对 API 任务和网页端任务完全相同。Standard、Creator 和 Pro 等级的每月积分数量请参阅[定价方案](https://www.comfy.org/cloud/pricing?utm_source=docs&utm_campaign=cloud-api)。如果在月中用尽积分，可在账户面板中购买加购包。 ## 基础 URL @@ -94,6 +94,7 @@ API 用户可以同时提交多个工作流，无需等待之前的任务完成 | 订阅等级 | 并发任务数 | |----------|-----------| +| Standard | 1 | | Creator | 3 | | Pro | 5 | From b1c5ffb0c0ee24a8c046eeab01d8a4852862e688 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:33 +0800 Subject: [PATCH 24/59] fix(i18n/ko): fix reroute, conditioning and finished translations --- ko/development/core-concepts/links.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ko/development/core-concepts/links.mdx b/ko/development/core-concepts/links.mdx index 5474065af..6470e79fe 100644 --- a/ko/development/core-concepts/links.mdx +++ b/ko/development/core-concepts/links.mdx @@ -23,7 +23,7 @@ ComfyUI에서 노드 간에 그려진 선이나 곡선을 **_링크_**라고 합 ![캔버스 메뉴](/images/interface/link/canvas_menu.jpg) -링크를 표시하는 것은 특히 워크플로우를 학습하거나 공유하거나 디버깅할 때 유용합니다—데이터 흐름을 한눈에 볼 수 있도록 해줍니다. 수정하지 않을 완성된 워크플로우에서는 링크를 숨기는 것이 시각적 혼잡을 줄여줍니다. +링크를 표시하는 것은 특히 워크플로우를 학습하거나 공유하거나 디버깅할 때 유용합니다—데이터 흐름을 한눈에 볼 수 있도록 해줍니다. 수정하지 않을 완료된 워크플로우에서는 링크를 숨기는 것이 시각적 혼잡을 줄여줍니다. ### 노드 재배치 From 9bbbdde68baa2f32a210f7e14fa9317dd5d7af38 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:44 +0800 Subject: [PATCH 25/59] fix(i18n/ja): fix manager terminology, remove extraneous description comment, fix grammar --- ja/manager/install.mdx | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/ja/manager/install.mdx b/ja/manager/install.mdx index 0e39fa750..aa45430a2 100644 --- a/ja/manager/install.mdx +++ b/ja/manager/install.mdx @@ -1,7 +1,7 @@ --- title: ComfyUI-Manager のインストール sidebarTitle: インストール -description: 異なるセットアップにおける ComfyUI-Manager のインストール方法 "English header \"Legacy installation methods\" emphasizes obsolescence, while Chinese \"自定义节点版本安装方法\" emphasizes installation type (Custom Node Version)." +description: 異なるセットアップにおける ComfyUI-Manager のインストール方法 translationSourceHash: 1776f66e translationFrom: manager/install.mdx --- @@ -14,12 +14,12 @@ translationFrom: manager/install.mdx [Windows ポータブル版](/installation/comfyui_portable_windows) を使用しているユーザーの場合、新しい ComfyUI-Manager は ComfyUI コアに組み込まれていますが、有効化する必要があります。 -1. 管理者機能の依存関係をインストールします： +1. マネージャー機能の依存関係をインストールします： ```bash .\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt ``` -2. 管理者機能を有効にして ComfyUI を起動します： +2. マネージャー機能を有効にして ComfyUI を起動します： ```bash .\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager pause @@ -38,12 +38,12 @@ translationFrom: manager/install.mdx source venv/bin/activate ``` -2. 管理者機能の依存関係をインストールします： +2. マネージャー機能の依存関係をインストールします： ```bash pip install -r manager_requirements.txt ``` -3. ComfyUI 実行時に `--enable-manager` フラグを使用して管理者機能を有効にします： +3. ComfyUI 実行時に `--enable-manager` フラグを使用してマネージャー機能を有効にします： ```bash python main.py --enable-manager ``` @@ -53,15 +53,15 @@ translationFrom: manager/install.mdx | フラグ | 説明 | |------|-------------| | `--enable-manager` | ComfyUI-Manager を有効にします | -| `--enable-manager-legacy-ui` | 新版 UI の代わりに旧版管理者 UI を使用します（`--enable-manager` が必要） | -| `--disable-manager-ui` | バックグラウンド機能を維持しつつ、管理者 UI とエンドポイントを無効にします（`--enable-manager` が必要） | +| `--enable-manager-legacy-ui` | 新版 UI の代わりに旧版マネージャー UI を使用します（`--enable-manager` が必要） | +| `--disable-manager-ui` | バックグラウンド機能を維持しつつ、マネージャー UI とエンドポイントを無効にします（`--enable-manager` が必要） | ### 新旧 UI の切り替え 以下のバージョン更新は pip インストールのみをサポートします。カスタムノード経由でインストールされたバージョンは、新版 UI への切り替えをサポートしません。 - + 新版 UI を使用する場合： ```bash python main.py --enable-manager @@ -74,7 +74,7 @@ python main.py --enable-manager --enable-manager-legacy-ui -デスクトップ版ユーザーは、**サーバー設定 → UI 設定 → 旧版管理者インターフェースを使用**で旧版 UI に切り替えることができます +デスクトップ版ユーザーは、**サーバー設定 → UI 設定 → 旧版マネージャーインターフェースを使用**で旧版 UI に切り替えることができます ![旧版 UI に切り替え](/images/manager/manager_use_legacy_manager_ui.png) @@ -89,7 +89,7 @@ python main.py --enable-manager --enable-manager-legacy-ui ```bash git clone https://github.com/Comfy-Org/ComfyUI-Manager comfyui-manager ``` -3. 管理者機能の依存関係をインストールします： +3. マネージャー機能の依存関係をインストールします： ```bash cd comfyui-manager pip install -r requirements.txt From d99ae7aee39fb926aa2bed9e43bcabfcb92f8cb0 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:48 +0800 Subject: [PATCH 26/59] fix(i18n/ko): fix reroute node and conditioning translations --- ko/development/core-concepts/links.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/ko/development/core-concepts/links.mdx b/ko/development/core-concepts/links.mdx index 6470e79fe..c70033c4d 100644 --- a/ko/development/core-concepts/links.mdx +++ b/ko/development/core-concepts/links.mdx @@ -26,15 +26,15 @@ ComfyUI에서 노드 간에 그려진 선이나 곡선을 **_링크_**라고 합 링크를 표시하는 것은 특히 워크플로우를 학습하거나 공유하거나 디버깅할 때 유용합니다—데이터 흐름을 한눈에 볼 수 있도록 해줍니다. 수정하지 않을 완료된 워크플로우에서는 링크를 숨기는 것이 시각적 혼잡을 줄여줍니다. -### 노드 재배치 +### 경유점 노드 -워크플로우가 복잡해지면 링크가 겹치거나 노드 뒤로 지나가 읽기가 어려워질 수 있습니다. **재배치** 노드를 사용하면 2D 그래프 공간 내 어느 지점이든 수동으로 와이어를 리디렉션할 수 있어 레이아웃을 깔끔하고 알아보기 쉽게 유지할 수 있습니다. +워크플로우가 복잡해지면 링크가 겹치거나 노드 뒤로 지나가 읽기가 어려워질 수 있습니다. **경유점** 노드를 사용하면 2D 그래프 공간 내 어느 지점이든 수동으로 와이어를 리디렉션할 수 있어 레이아웃을 깔끔하고 알아보기 쉽게 유지할 수 있습니다. -![ComfyUI 재배치 노드](/images/interface/link/reroute.jpg) +![ComfyUI 경유점 노드](/images/interface/link/reroute.jpg) -ComfyUI에는 그래프 캔버스에 기본 제공되는 재배치 기능도 있습니다. 새 워크플로우에서는 이를 사용하는 것을 권장합니다. +ComfyUI에는 그래프 캔버스에 기본 제공되는 경유점 기능도 있습니다. 새 워크플로우에서는 이를 사용하는 것을 권장합니다. -![ComfyUI 기본 재배치](/images/interface/link/native_reroute.jpg) +![ComfyUI 기본 경유점](/images/interface/link/native_reroute.jpg) ## 색상 코드화 @@ -47,7 +47,7 @@ ComfyUI의 모든 데이터 유형은 고유한 색상을 가지고 있습니다 | 확산 모델 | 라벤더 | | CLIP 모델 | 노란색 | | VAE 모델 | 장미 | -| 조건부 | 주황색 | +| 조건화 | 주황색 | | 잠재 이미지 | 분홍 | | 픽셀 이미지 | 파란색 | | 마스크 | 초록 | From 0b1fbdfde9852bc6f96ed0a0b1dacf9889c91095 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:50 +0800 Subject: [PATCH 27/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=E5=A4=9A=E4=B8=AA=E6=96=87=E6=A1=A3=E7=9A=84=E6=A0=87=E9=A2=98?= =?UTF-8?q?=E3=80=81=E6=9C=AF=E8=AF=AD=E3=80=81=E7=BC=BA=E5=A4=B1=E5=86=85?= =?UTF-8?q?=E5=AE=B9=E5=92=8C=E5=A4=9A=E4=BD=99=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/agent-tools/index.mdx | 4 ++-- zh/comfy-cli/troubleshooting.mdx | 4 ++-- zh/community/links.mdx | 8 ------- zh/tutorials/partner-nodes/topaz/astra-2.mdx | 22 +++++++++++--------- 4 files changed, 16 insertions(+), 22 deletions(-) diff --git a/zh/agent-tools/index.mdx b/zh/agent-tools/index.mdx index 920a08c52..ac009248a 100644 --- a/zh/agent-tools/index.mdx +++ b/zh/agent-tools/index.mdx @@ -11,12 +11,12 @@ ComfyUI 提供了 **两个 MCP 服务器**，让 AI 助手（Claude Desktop、Cl - 连接至托管在 cloud.comfy.org 的 MCP 服务器。在 Cloud GPU 上运行工作流，使用预装模型。 + 连接至托管在 cloud.comfy.org 的 MCP 服务器。在 Cloud GPU 上运行工作流，使用预装模型，并可搜索完整模板库。

**封闭测试** — 注册等候名单。 - 在本地运行的 MCP 服务器，使用 Comfy Partner-Node SDK。提供统一的 generate_image、generate_video 等工具，覆盖 30+ 合作提供商。 + 在本地运行的 MCP 服务器，使用 Comfy Partner-Node SDK。提供统一的 generate_image、generate_video、generate_3d 等工具，覆盖 30+ 合作提供商。

**等候名单** — 注册提前体验。 diff --git a/zh/comfy-cli/troubleshooting.mdx b/zh/comfy-cli/troubleshooting.mdx index dbb7c7f18..e4f652d89 100644 --- a/zh/comfy-cli/troubleshooting.mdx +++ b/zh/comfy-cli/troubleshooting.mdx @@ -1,9 +1,9 @@ --- -title: "开始" +title: "故障排查" translationSourceHash: 8c9d813c translationFrom: comfy-cli/troubleshooting.mdx --- ### 前提条件 -你需要在你的系统上已经安装好了 Git。可以[在这里](https://git-scm.com/downloads)下载。 \ No newline at end of file +你需要在你的系统上已经安装好了 Git。[安装](https://git-scm.com/downloads)它。 \ No newline at end of file diff --git a/zh/community/links.mdx b/zh/community/links.mdx index 8abc4dc7e..9481012e9 100644 --- a/zh/community/links.mdx +++ b/zh/community/links.mdx @@ -1,8 +1,6 @@ --- title: "社区链接" description: "通过各种平台与 ComfyUI 社区联系" -translationSourceHash: ea6ecb7c -translationFrom: community/links.mdx --- 加入 ComfyUI 社区，获取帮助、分享您的作品并了解最新动态。 @@ -44,9 +42,3 @@ translationFrom: community/links.mdx 加入我们的 subreddit - -## 微信 - -扫描二维码加入我们的微信社区。 - -WeChat QR Code diff --git a/zh/tutorials/partner-nodes/topaz/astra-2.mdx b/zh/tutorials/partner-nodes/topaz/astra-2.mdx index 30f38fa50..17faca488 100644 --- a/zh/tutorials/partner-nodes/topaz/astra-2.mdx +++ b/zh/tutorials/partner-nodes/topaz/astra-2.mdx @@ -1,31 +1,33 @@ --- title: "Astra 2 - 创意扩散视频放大" -description: "Astra 2 模型的用途与特点，以及在 ComfyUI 中通过 Topaz Video Enhance 使用的要点。" +description: "Astra 2 模型在 ComfyUI 中的用途，以及对细节和风格的可控创意放大。" sidebarTitle: "Astra 2" -translationSourceHash: 2840b2ae -translationFrom: tutorials/partner-nodes/topaz/astra-2.mdx --- import ReqHint from "/snippets/zh/tutorials/partner-nodes/req-hint.mdx"; import UpdateReminder from "/snippets/zh/tutorials/update-reminder.mdx"; -Astra 2 是 Topaz 提供的 **创意扩散类视频放大模型**，主要服务于 **生成式 AI 产出或明显风格化** 的镜头：在保持时间与语义连贯的前提下，对画面中原本稀疏、平滑或缺乏微观结构的区域 **推断并补充合理的纹理与细节**，并可输出至 **FullHD（1080p）或 4K**。与传统偏重尺寸拉伸与锐化的放大相比，它更侧重「补信息与质感」，并可通过 **创意强度**、**锐化** 以及可选的 **描述性提示词**（概括画面氛围或质感，而非操作指令）在一定程度上收敛成片风格——适用于希望在可控偏移内提升信息量与观感层次的剪辑与成片流程。 +针对 GenAI 视频的增强型创意放大，具有对细节和风格的先进控制能力。 + +## 什么是 Astra 2？ + +**如果你还不了解：** Astra 2 主要面向 **AI 生成和风格化视频**。传统的简单放大主要是放大和锐化现有像素；而 Astra 2 可以在源画面较柔和的地方 **添加合理的新细节和纹理**，使片段看起来更丰富——不仅仅是放大。 ## 模型概述 -相较 Astra 1，对细节合成与风格化过程的 **可调维度更多**。适用于 GenAI / 风格化素材、广角与人群等大场面、以及观感偏「塑料感」或偏平滑但 **需要可信纹理** 的镜头。 +它在 Astra 1 的基础上增强了对于细节和风格化生成方式的控制（创意强度、锐化、可选的**描述性**提示词——不是步骤列表）。适用场景包括：风格化/GenAI 素材、广角和稀疏细节场景，以及在恢复纹理前显得过于平滑的画面。 ## 主要能力 -- **补质感与细节** — 不仅是锐化。 -- **可调观感** — 创意、锐化、可选提示词引导。 -- **风格化 / 广角** — 适合需要推断补全信息的画面。 +- **添加纹理和细节** — 不仅仅是锐化。 +- **可调的观感** — 创意强度、锐化、可选的提示词引导。 +- **风格化 & 广角** — 适用于需要推断补全信息的画面。 ## 在 ComfyUI 里 -使用 **Topaz Video Enhance**。**Topaz Video Enhance (Legacy)** **没有** Astra 2。将放大模型设为 **Astra 2**，输出 **1080p** 或 **4K**，输入须为 **MP4**。 +使用 **Topaz Video Enhance**。**Topaz Video Enhance (Legacy)** **没有** Astra 2。将放大模型设为 **Astra 2**，分辨率设为 **FullHD** 或 **4K**；输入须为 **MP4**。 -填写 **Prompt** 时最多 **450** 帧（30fps 约 15 秒）；留空最多 **9000** 帧。**Sharp**、**Realism** 在高级选项里。 +可选 **Prompt**：最多 **450** 帧（30fps 约 15 秒）。留空最多 **9000** 帧。在高级选项中展开 **Sharp** 和 **Realism**。 From 1006e7b11081ce7ecab96fbd0b7f7a04167bf9ab Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:55 +0800 Subject: [PATCH 28/59] =?UTF-8?q?fix(i18n/ja):=20clean=20frontmatter=20des?= =?UTF-8?q?cription,=20translate=20nightly=20to=20=E3=83=8A=E3=82=A4?= =?UTF-8?q?=E3=83=88=E3=83=AA=E3=83=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ja/manager/troubleshooting.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ja/manager/troubleshooting.mdx b/ja/manager/troubleshooting.mdx index ba0517bb4..10759c65d 100644 --- a/ja/manager/troubleshooting.mdx +++ b/ja/manager/troubleshooting.mdx @@ -1,7 +1,7 @@ --- title: トラブルシューティング sidebarTitle: トラブルシューティング -description: 一般的な ComfyUI-Manager の問題を解決します "The internal link for \"Configuration\" uses \"/manager/configuration\" in English but \"/zh/manager/configuration\" in Chinese (locale-specific path)." +description: 一般的な ComfyUI-Manager の問題を解決します translationSourceHash: 631c08a9 translationFrom: manager/troubleshooting.mdx --- @@ -106,7 +106,7 @@ GitHub API のレート制限を回避するには、トークンを設定して ## セキュリティポリシー -git URL 経由でカスタムノードをインストールする際、または nightly バージョンを使用する際に `This action is not allowed with this security level configuration` エラーが発生した場合は、`config.ini` ファイルでセキュリティレベルを調整する必要があります。 +git URL 経由でカスタムノードをインストールする際、またはナイトリー バージョンを使用する際に `This action is not allowed with this security level configuration` エラーが発生した場合は、`config.ini` ファイルでセキュリティレベルを調整する必要があります。 `config.ini` ファイルの場所は次の通りです： - **ComfyUI v0.3.76+**：`/__manager/config.ini` @@ -136,7 +136,7 @@ security_level = normal | **低** | ComfyUI の更新 | -git URL 経由または nightly バージョンでカスタムノードをインストールするには、`config.ini` で `security_level = weak` を設定してください。 +git URL 経由またはナイトリー バージョンでカスタムノードをインストールするには、`config.ini` で `security_level = weak` を設定してください。 ## サポートを受ける From bfba4348cfa8ec16ee6e5fec6701d6b6d5d76dc3 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:50:59 +0800 Subject: [PATCH 29/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=E5=BC=80=E5=8F=91=E6=A6=82=E8=BF=B0=E7=9A=84=E5=8D=A1=E7=89=87?= =?UTF-8?q?=E6=8F=8F=E8=BF=B0=E3=80=81=E9=93=BE=E6=8E=A5=E5=92=8C=E7=BC=BA?= =?UTF-8?q?=E5=A4=B1=E7=9A=84=20API=20=E6=A6=82=E8=A7=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/development/overview.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/zh/development/overview.mdx b/zh/development/overview.mdx index 27f35f38f..e7768ea4f 100644 --- a/zh/development/overview.mdx +++ b/zh/development/overview.mdx @@ -11,11 +11,11 @@ ComfyUI 是一个模块化的 GenAI 推理引擎，可以部署为 API 服务器 在自有环境中运行 ComfyUI 并将其暴露为 API 端点。了解 WebSocket 消息协议、可用路由和执行模式。 - - 从本地服务器搭建开始，了解消息类型、路由处理和执行模型反转。 + + 在自有机器上将 ComfyUI 作为 API 服务运行。启动、配置、并通过 REST 和 WebSocket API 调用。 -另见：[消息与路由](/zh/development/comfyui-server/comms_messages) · [执行模型反转](/zh/development/comfyui-server/execution_model_inversion_guide) · [Partner Node API 集成](/zh/development/comfyui-server/api-key-integration) +另见：[API 示例](/zh/development/comfyui-server/api-examples) · [合作节点 API 集成](/zh/development/comfyui-server/api-key-integration) ## Cloud API @@ -25,7 +25,7 @@ ComfyUI 是一个模块化的 GenAI 推理引擎，可以部署为 API 服务器 了解如何认证、提交任务、查询状态以及从 Comfy Cloud 下载结果。 -另见：[API 参考](/zh/development/cloud/api-reference) · [OpenAPI 规范](/zh/development/cloud/openapi) · [获取 API Key](/zh/development/api-development/getting-an-api-key) +另见：[API 参考](/zh/development/cloud/api-reference) · [OpenAPI 规范](/zh/development/cloud/openapi) · [获取 API Key](/zh/development/api-development/getting-an-api-key) · [API 概览](/zh/development/api-development/overview) ## Agent Tools / MCP From e2bff34832b95c77c49f254329d76183d4c4918f Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:51:02 +0800 Subject: [PATCH 30/59] fix(i18n/ja): fix Chinese terms in cloud page --- ja/get_started/cloud.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ja/get_started/cloud.mdx b/ja/get_started/cloud.mdx index 09d16d6e1..e7babd385 100644 --- a/ja/get_started/cloud.mdx +++ b/ja/get_started/cloud.mdx @@ -23,7 +23,7 @@ ComfyUI Cloud は、ローカルバージョンと同じ機能を備えた Comfy - 自有ハードウェアがなくても、強力なサーバー GPU でワークフローを高速実行できます + 自前のハードウェアがなくても、強力なサーバー GPU でワークフローを高速実行できます @@ -40,13 +40,13 @@ ComfyUI Cloud は、ローカルバージョンと同じ機能を備えた Comfy ComfyUI には、公式クラウドバージョンである [Comfy Cloud](https://comfy.org/cloud) と、オープンソースのセルフホストバージョンの両方があります。強力な GPU をお持ちの場合、ComfyUI をローカルで実行するのは素晴らしい選択肢です。一方、クラウドバージョンはすぐに使用できるオンラインサービスです。URL を開くだけで、インストールや設定は不要です。 -| 类别 | Comfy Cloud | 自托管（本地 ComfyUI） | +| カテゴリ | Comfy Cloud | セルフホスト（ローカル ComfyUI） | |----------|-------------|------------------------------| | **コスト** | 月額サブスクリプション | 無料 | -| **GPU** | 強力な Blackwell RTX 6000 Pro | 自有 GPU を用意 | +| **GPU** | 強力な Blackwell RTX 6000 Pro | 自前の GPU を用意 | | **技術知識** | 技術知識は不要です。 | デスクトップ版とポータブル版では簡単に始められますが、カスタムノードのインストールやローカルインストールの問題を解決する必要があります。 | | **カスタムノード** | プリインストールされたカスタムノードを使用でき、互換性の問題を心配する必要はありません。 | 任意のカスタムノードをインストールできますが、自分で管理する必要があります。 | -| **モデル** | プリインストールされたモデルを使用します。Civitai から LoRA モデルをインポートできます。Hugging Face からモデルをインポートできます（近日予定）。 | 任意のモデルを使用できますが、まずダウンロードする必要があります。 | +| **モデル** | プリインストールされたモデルを使用します。Civitai から LoRA モデルをインポートできます。Hugging Face からモデルをインポートできます（近日公開）。 | 任意のモデルを使用できますが、まずダウンロードする必要があります。 | | **主な違い** | チームのオンボーディングが容易 | オフライン動作、無限にカスタマイズ可能 | | **始める** | [ComfyUI Cloud を実行](https://comfy.org/cloud) | [ComfyUI をローカルにインストール](/installation/system_requirements) | From 85535e8f3f8c37535240057d18f05847b89f474b Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:51:21 +0800 Subject: [PATCH 31/59] fix(i18n/ko): fix transcription translation and remove extra metadata --- ko/tutorials/llm/gemma4/gemma4.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/ko/tutorials/llm/gemma4/gemma4.mdx b/ko/tutorials/llm/gemma4/gemma4.mdx index afff276f6..f2b66692f 100644 --- a/ko/tutorials/llm/gemma4/gemma4.mdx +++ b/ko/tutorials/llm/gemma4/gemma4.mdx @@ -2,7 +2,6 @@ title: "Gemma 4 ComfyUI 워크플로 예시" description: "Gemma 4는 구글의 멀티모달 LLM 제품군으로, 텍스트 생성, 이미지 이해, 비디오 분석 및 오디오 전사를 지원하며 최대 256K 컨텍스트를 처리합니다. 2B, 4B, 31B 크기로 제공됩니다." sidebarTitle: "Gemma 4" -reviewSourceHash: 817ba970 --- import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx" @@ -48,7 +47,7 @@ import UpdateReminder from "/snippets/ko/tutorials/update-reminder.mdx" **입력**: - **텍스트 프롬프트** — 질문이나 지침 - **이미지** (선택사항) — 시각적 이해 작업용 (OCR, 객체 감지, 차트 읽기 등) -- **오디오** (선택사항) — 음성 인식 또는 음성 텍스트 변환용 +- **오디오** (선택사항) — 음성 인식 또는 오디오 전사용 - **비디오** (선택사항) — 프레임별 비디오 이해용 (내부적으로 1 FPS로 하위 샘플링됨) **주요 제어 옵션**: From 6fb8223fb70464b28021b699c1358bfc2fb18139 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:51:25 +0800 Subject: [PATCH 32/59] fix(i18n/ja): fix partner node terminology in flux kontext page --- .../black-forest-labs/flux-1-kontext.mdx | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/ja/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx b/ja/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx index 646125e23..1cdaeb86c 100644 --- a/ja/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx +++ b/ja/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx @@ -1,5 +1,5 @@ --- -title: "ComfyUI Flux.1 Kontext Pro Image API ノード公式サンプル" +title: "ComfyUI Flux.1 Kontext Pro Image パートナーノード公式サンプル" description: "本ガイドでは、ComfyUI で Flux.1 Kontext Pro Image パートナーノードを用いた画像編集の方法について説明します" sidebarTitle: "Flux.1 Kontext" translationSourceHash: 115e6de3 @@ -32,17 +32,17 @@ Kontext の核心的な強みは、優れた文脈理解能力とキャラクタ 以下の画像の `metadata` にはワークフロー情報が含まれています。ダウンロード後、ComfyUI へドラッグ＆ドロップすることで、対応するワークフローを読み込むことができます。 -![ComfyUI Flux.1 Kontext Pro Image API ノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/multiple_image_input/multiple_image_input.png) +![ComfyUI Flux.1 Kontext Pro Image パートナーノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/multiple_image_input/multiple_image_input.png) 入力用として以下の画像をダウンロードするか、ご自身の画像をご利用ください： -![ComfyUI Flux.1 Kontext Pro Image API ノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/multiple_image_input/girl.jpg) -![ComfyUI Flux.1 Kontext Pro Image API ノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/multiple_image_input/dog.jpg) -![ComfyUI Flux.1 Kontext Pro Image API ノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/multiple_image_input/sofa.jpg) +![ComfyUI Flux.1 Kontext Pro Image パートナーノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/multiple_image_input/girl.jpg) +![ComfyUI Flux.1 Kontext Pro Image パートナーノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/multiple_image_input/dog.jpg) +![ComfyUI Flux.1 Kontext Pro Image パートナーノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/multiple_image_input/sofa.jpg) ### 2. ワークフローを手順通りに完了させる -![ComfyUI Flux.1 Kontext Pro Image API ノードワークフローステップ](/images/tutorial/api_nodes/bfl/flux_1_kontext_multiple_image_input_guide.jpg) +![ComfyUI Flux.1 Kontext Pro Image パートナーノードワークフローステップ](/images/tutorial/api_nodes/bfl/flux_1_kontext_multiple_image_input_guide.jpg) 画像中の番号順に従って、ワークフローを完了させることができます： @@ -58,21 +58,21 @@ Kontext の核心的な強みは、優れた文脈理解能力とキャラクタ 後続の2つのワークフローは、使用するパートナーノードが異なるのみです。実際には、複数画像入力ワークフローをベースに必要な変更を行うだけでよく、大きな違いはありません。 -## Flux.1 Kontext Pro Image API ノードワークフロー +## Flux.1 Kontext Pro Image パートナーノードワークフロー ### 1. ワークフローファイルのダウンロード 以下の画像の `metadata` にはワークフロー情報が含まれています。ダウンロード後、ComfyUI へドラッグ＆ドロップすることで、対応するワークフローを読み込むことができます。 -![ComfyUI Flux.1 Kontext Pro Image API ノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_pro_image.png) +![ComfyUI Flux.1 Kontext Pro Image パートナーノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_pro_image.png) 入力用として以下の画像をダウンロードするか、ご自身の画像をご利用ください： -![ComfyUI Flux.1 Kontext Pro Image API ノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_pro_image_input.png) +![ComfyUI Flux.1 Kontext Pro Image パートナーノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_pro_image_input.png) ### 2. ワークフローを手順通りに完了させる -![ComfyUI Flux.1 Kontext Pro Image API ノードワークフローステップ](/images/tutorial/api_nodes/bfl/flux_1_kontext_pro_image_step_guide.jpg) +![ComfyUI Flux.1 Kontext Pro Image パートナーノードワークフローステップ](/images/tutorial/api_nodes/bfl/flux_1_kontext_pro_image_step_guide.jpg) 画像中の番号順に従って、ワークフローを完了させることができます： 1. `Load Image` ノードで、編集したい画像を読み込みます。 @@ -80,21 +80,21 @@ Kontext の核心的な強みは、優れた文脈理解能力とキャラクタ 3. `Run` ボタンをクリックするか、ショートカットキー `Ctrl (Cmd) + Enter` を使用して画像編集を実行します。 4. API からの結果を待った後、`Save Image` ノードで編集済み画像を確認できます。また、対応する画像は `ComfyUI/output/` ディレクトリにも保存されます。 -## Flux.1 Kontext Max Image API ノードワークフロー +## Flux.1 Kontext Max Image パートナーノードワークフロー ### 1. ワークフローファイルのダウンロード 以下の画像の `metadata` にはワークフロー情報が含まれています。ダウンロード後、ComfyUI へドラッグ＆ドロップすることで、対応するワークフローを読み込むことができます。 -![ComfyUI Flux.1 Kontext Max Image API ノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_max_image.png) +![ComfyUI Flux.1 Kontext Max Image パートナーノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_max_image.png) デモ用として以下の画像をダウンロードするか、ご自身の画像をご利用ください： -![ComfyUI Flux.1 Kontext Max Image API ノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_max_image_input.png) +![ComfyUI Flux.1 Kontext Max Image パートナーノードワークフロー](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/bfl/flux_1_kontext_max_image_input.png) ### 2. ワークフローを手順通りに完了させる -![ComfyUI Flux.1 Kontext Max Image API ノードワークフローステップ](/images/tutorial/api_nodes/bfl/flux_1_kontext_max_image_step_guide.jpg) +![ComfyUI Flux.1 Kontext Max Image パートナーノードワークフローステップ](/images/tutorial/api_nodes/bfl/flux_1_kontext_max_image_step_guide.jpg) 画像中の番号順に従って、ワークフローを完了させることができます： 1. `Load Image` ノードで、編集したい画像を読み込みます。 From 8638be759bcea666349f4069053e23eab3583ea8 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:51:33 +0800 Subject: [PATCH 33/59] fix(i18n/ja): fix mistranslation of partner nodes, re-try terminology, remove unnecessary example --- ja/account/create-account.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ja/account/create-account.mdx b/ja/account/create-account.mdx index e1903be06..6fedac6a2 100644 --- a/ja/account/create-account.mdx +++ b/ja/account/create-account.mdx @@ -6,7 +6,7 @@ translationSourceHash: 370a9d90 translationFrom: account/create-account.mdx --- -Comfy アカウントを作成すると、[パートナー ノード（API ノード）](/tutorials/partner-nodes/overview) や [クラウド サブスクリプション](https://www.comfy.org/cloud) にアクセスできるようになり、ComfyUI プラットフォーム全体でプレミアム機能やサービスを利用できるようになります。 +Comfy アカウントを作成すると、[パートナー ノード（Partner Node）](/ja/tutorials/partner-nodes/overview) や [クラウド サブスクリプション](https://www.comfy.org/cloud) にアクセスできるようになり、ComfyUI プラットフォーム全体でプレミアム機能やサービスを利用できるようになります。 ## Comfy Cloud での Comfy アカウント作成 @@ -49,6 +49,6 @@ ComfyUI 用の Comfy アカウントは、Comfy Cloud 上から直接作成で アカウント作成時に問題が発生した場合の対処法： - メールアドレスが有効であり、かつ既に登録されていないことを確認してください -- パスワードが最低限の要件（例：文字数・記号の使用など）を満たしているか確認してください -- ブラウザのキャッシュをクリアして、再度試行してください +- パスワードが最低限の要件を満たしているか確認してください +- ブラウザのキャッシュをクリアして、再試行してください - 問題が解決しない場合は、[サポート](/support/contact-support) までお問い合わせください \ No newline at end of file From 82faf3f5acf85397ab7ffb2bb55dea1f56735c1b Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:51:35 +0800 Subject: [PATCH 34/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=E4=BE=9D=E8=B5=96=E6=96=87=E6=A1=A3=E5=92=8C=20Cloud=20API=20?= =?UTF-8?q?=E5=8F=82=E8=80=83=E4=B8=AD=E7=9A=84=E9=97=AE=E9=A2=98=E5=92=8C?= =?UTF-8?q?=E6=9C=AF=E8=AF=AD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/development/cloud/api-reference.mdx | 81 +------------------ zh/development/core-concepts/dependencies.mdx | 10 ++- 2 files changed, 11 insertions(+), 80 deletions(-) diff --git a/zh/development/cloud/api-reference.mdx b/zh/development/cloud/api-reference.mdx index 7526d9cab..50008f4c4 100644 --- a/zh/development/cloud/api-reference.mdx +++ b/zh/development/cloud/api-reference.mdx @@ -455,82 +455,7 @@ workflow = set_workflow_input(workflow, "6", "text", "a beautiful landscape") ## 检查任务状态 -轮询任务完成状态。 - - -```bash curl -curl -X GET "$BASE_URL/api/job/{prompt_id}/status" \ - -H "X-API-Key: $COMFY_CLOUD_API_KEY" -``` - -```typescript TypeScript -interface JobStatus { - status: string; -} - -async function getJobStatus(promptId: string): Promise { - const response = await fetch(`${BASE_URL}/api/job/${promptId}/status`, { - headers: getHeaders(), - }); - if (!response.ok) throw new Error(`HTTP ${response.status}`); - return response.json(); -} - -async function pollForCompletion( - promptId: string, - timeout: number = 300, - pollInterval: number = 2000 -): Promise { - const startTime = Date.now(); - - while (Date.now() - startTime < timeout * 1000) { - const { status } = await getJobStatus(promptId); - - if (status === "success") { - return; - } else if (["error", "failed", "cancelled"].includes(status)) { - throw new Error(`Job failed with status: ${status}`); - } - - await new Promise((resolve) => setTimeout(resolve, pollInterval)); - } - - throw new Error(`Job ${promptId} did not complete within ${timeout}s`); -} - -await pollForCompletion(promptId); -console.log("Job completed!"); -``` - -```python Python -def get_job_status(prompt_id: str) -> str: - """Get the current status of a job.""" - response = requests.get( - f"{BASE_URL}/api/job/{prompt_id}/status", - headers=get_headers() - ) - response.raise_for_status() - return response.json()["status"] - -def poll_for_completion(prompt_id: str, timeout: int = 300, poll_interval: float = 2.0) -> None: - """Poll until job completes or times out.""" - start_time = time.time() - - while time.time() - start_time < timeout: - status = get_job_status(prompt_id) - - if status == "success": - return - elif status in ("error", "failed", "cancelled"): - raise RuntimeError(f"Job failed with status: {status}") - - time.sleep(poll_interval) - - raise TimeoutError(f"Job {prompt_id} did not complete within {timeout}s") - -poll_for_completion(prompt_id) -print("Job completed!") -``` + --- @@ -989,7 +914,7 @@ REST API 端点返回标准 HTTP 状态码： |--------|------| | `400` | 无效请求（错误的工作流、缺少字段） | | `401` | 未授权（无效或缺少 API 密钥） | -| `402` | 余额不足 | +| `402` | 积分不足 | | `429` | 订阅未激活 | | `500` | 内部服务器错误 | @@ -1003,5 +928,5 @@ REST API 端点返回标准 HTTP 状态码： | `ModelDownloadError` | 所需模型不可用或下载失败 | | `ImageDownloadError` | 从 URL 下载输入图像失败 | | `OOMError` | GPU 内存不足 | -| `InsufficientFundsError` | 账户余额不足（用于合作伙伴节点） | +| `InsufficientFundsError` | 账户积分不足（用于合作伙伴节点） | | `InactiveSubscriptionError` | 订阅未激活 | diff --git a/zh/development/core-concepts/dependencies.mdx b/zh/development/core-concepts/dependencies.mdx index 1db02b4cc..c38f15194 100644 --- a/zh/development/core-concepts/dependencies.mdx +++ b/zh/development/core-concepts/dependencies.mdx @@ -26,7 +26,7 @@ ComfyUI 的工作方式也是如此。工作流只有在找到并加载所有必 ## 自定义节点 -自定义节点是 ComfyUI 的一个重要组成部分， +自定义节点是 ComfyUI 的重要组成部分，用于扩展其功能。它们由社区创建，可以安装以向工作流添加新的功能。 ## Python 依赖 @@ -76,7 +76,13 @@ pydantic-settings~=2.0 ```bash pip install -r requirements.txt ``` -从而来安装 ComfyUI 最新的依赖以保证 ComfyUI 的正常运行，你也可以通过修改特定包的依赖版本来实现部分依赖的升级或者降级 +从而确保 ComfyUI 的依赖保持最新以保证 ComfyUI 的正常运行，你也可以通过修改特定包的依赖版本来实现部分依赖的升级或者降级 + +## 软件 + +像 ComfyUI 这样的高级应用也有**_软件依赖_**。这些是应用程序运行所需的编程代码库和数据。自定义节点是软件依赖的示例。在更基础的层面上，Python 编程环境是 ComfyUI 的最终依赖。运行特定版本的 ComfyUI 需要正确版本的 Python。Python、ComfyUI 和自定义节点的更新都可以通过 **ComfyUI Manager** 窗口处理。 + +![ComfyUI 自定义节点管理器](/images/concepts/core-concepts_dependecies_custom-nodes-manager.png) 另外 ComfyUI 的前端 [ComfyUI_frontend](https://github.com/Comfy-Org/ComfyUI_frontend) 目前是作为一个独立的项目来进行维护，我们会在对应版本稳定之后更新对应的 `comfyui-frontend-package` 依赖版本，如果你需要切换对应的前端版本，你可以在[这里](https://pypi.org/project/comfyui-frontend-package/#history)查看对应的版本信息。 From a55c39bb081847143f03fdc14eca1dcf09d18256 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:51:41 +0800 Subject: [PATCH 35/59] fix(i18n/ja): add missing sign-up link, fix hyperlink, allowlist term, and vibe translation --- ja/agent-tools/partner-mcp.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ja/agent-tools/partner-mcp.mdx b/ja/agent-tools/partner-mcp.mdx index 822b1091d..59c8c5665 100644 --- a/ja/agent-tools/partner-mcp.mdx +++ b/ja/agent-tools/partner-mcp.mdx @@ -8,7 +8,7 @@ translationFrom: agent-tools/partner-mcp.mdx --- - **プライベートプレビュー — ウェイトリストが必要です。** Comfy Partner MCP サーバーは現在プライベートプレビュー中です。機能や API は変更される可能性があります。 + **プライベートプレビュー — ウェイトリストが必要です。** Comfy Partner MCP サーバーは現在プライベートプレビュー中です。機能や API は変更される可能性があります。[ウェイトリストにサインアップ](#)してアクセスをリクエストしてください。 Comfy Partner MCP は、AI エージェントに **30以上のパートナープロバイダー**（BFL、Ideogram、Kling、Runway、Veo、Meshy、ElevenLabs など）に対応した統一生成ツールを提供するローカル MCP サーバーです。すべての生成タイプで単一の標準リクエスト形式を使用します。 @@ -26,7 +26,7 @@ Comfy Partner MCP は、AI エージェントに **30以上のパートナープ - **Node.js 20+** - **pnpm 10** -- **Comfy API キー**（`comfyui-` で始まる）— Comfy パートナーダッシュボードから取得 +- **[Comfy API キー](/development/api-development/getting-an-api-key)**（`comfyui-` で始まる）— Comfy パートナーダッシュボードから取得 --- @@ -86,7 +86,7 @@ COMFY_API_KEY=comfyui-... node /ABSOLUTE/PATH/TO/partner-mcp/packages/mcp/dist/b | `COMFY_API_KEY` | はい | API キー（`comfyui-…`）。`X-API-Key` ヘッダーとして送信。 | | `COMFY_API_BASE_URL` | いいえ | プロキシホストを上書き（デフォルトは本番 Comfy API）。 | | `COMFY_INLINE_LIMIT_KB` | いいえ | ツール結果にインライン化する画像バイト数の上限。デフォルト `600`。 | -| `COMFY_MCP_RESOURCE_LINKS` | いいえ | `resource_link` コンテンツブロックの強制オン/オフ。デフォルトはアローリスト（`claude-*`、`mcp-inspector`）。 | +| `COMFY_MCP_RESOURCE_LINKS` | いいえ | `resource_link` コンテンツブロックの強制オン/オフ。デフォルトはホワイトリスト（`claude-*`、`mcp-inspector`）。 | --- @@ -127,7 +127,7 @@ MCP サーバーは **10 個のツール** を提供します。インストー ``` -calm な lo-fi ビートの音楽を30秒くらい生成して +calm な lo-fi バイブの音楽を30秒くらい生成して ``` --- From a48e20ca4218ec589623f75b5fe3b8d4bffc0784 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:51:45 +0800 Subject: [PATCH 36/59] fix(i18n/ko): remove translation metadata from frontmatter of 3 files --- ko/development/cloud/api-reference.mdx | 2 -- ko/development/core-concepts/links.mdx | 2 -- ko/specs/workflow_json_0.4.mdx | 2 -- 3 files changed, 6 deletions(-) diff --git a/ko/development/cloud/api-reference.mdx b/ko/development/cloud/api-reference.mdx index 79d34846b..691f75eed 100644 --- a/ko/development/cloud/api-reference.mdx +++ b/ko/development/cloud/api-reference.mdx @@ -2,8 +2,6 @@ title: "클라우드 API 참조" description: "Comfy Cloud의 코드 예제와 함께 제공되는 완벽한 API 참조" icon: "book-open" -translationSourceHash: 5ec787f8 -translationFrom: development/cloud/api-reference.mdx --- import PollJobCompletion from "/snippets/ko/cloud/poll-job-completion.mdx" diff --git a/ko/development/core-concepts/links.mdx b/ko/development/core-concepts/links.mdx index c70033c4d..5951497b2 100644 --- a/ko/development/core-concepts/links.mdx +++ b/ko/development/core-concepts/links.mdx @@ -2,8 +2,6 @@ title: "링크" description: "ComfyUI에서 연결 링크 이해하기" icon: "share-nodes" -translationSourceHash: 4f931efb -translationFrom: development/core-concepts/links.mdx --- ## 링크는 노드를 연결합니다 diff --git a/ko/specs/workflow_json_0.4.mdx b/ko/specs/workflow_json_0.4.mdx index 4ec62cbe5..d50ba038e 100644 --- a/ko/specs/workflow_json_0.4.mdx +++ b/ko/specs/workflow_json_0.4.mdx @@ -1,8 +1,6 @@ --- title: "워크플로우 JSON 0.4" description: "ComfyUI 워크플로우를 위한 JSON 스키마." -translationSourceHash: dd7a23ce -translationFrom: specs/workflow_json_0.4.mdx --- ## v0.4 From 7e84d4a7d97983d348cdf543e467c8213e11fce3 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:51:47 +0800 Subject: [PATCH 37/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D=20Recr?= =?UTF-8?q?aft=20=E6=96=87=E6=A1=A3=E7=BC=96=E5=8F=B7=E3=80=81=E6=9C=AF?= =?UTF-8?q?=E8=AF=AD=E5=92=8C=E5=9B=BE=E7=89=87=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../partner-nodes/recraft/recraft-text-to-image.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/zh/tutorials/partner-nodes/recraft/recraft-text-to-image.mdx b/zh/tutorials/partner-nodes/recraft/recraft-text-to-image.mdx index 61a0b4794..1d6dc7d9d 100644 --- a/zh/tutorials/partner-nodes/recraft/recraft-text-to-image.mdx +++ b/zh/tutorials/partner-nodes/recraft/recraft-text-to-image.mdx @@ -22,24 +22,24 @@ import UpdateReminder from "/snippets/zh/tutorials/update-reminder.mdx"; 下面的图片的`metadata`中已经包含工作流信息，请下载并拖入 ComfyUI 中加载对应工作流。 -![Recraft 文本到图像工作流](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/recraft/t2i/recraft_t2i.png) +![Recraft 文本转图像工作流](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/api_nodes/recraft/t2i/recraft_t2i.png) ### 2. 按步骤完成工作流的运行 -![Recraft 文本到图像工作流步骤图](/images/tutorial/api_nodes/recraft/recraft_t2v_step_guide.jpg) +![Recraft 文本转图像工作流步骤图](/images/tutorial/api_nodes/recraft/recraft_t2v_step_guide.jpg) 你可参考图片中的序号来完成最基础的工作流运行： 1. (可选) 修改 `Color` 的 `Recraft Color RGB` 的颜色为你想要的颜色 2. (可选) 修改 `Recraft Style` 节点来控制图像的视觉风格，如数字插画、真实照片或Logo设计等，这个分组同时提供了其它的风格节点，你可以按需启用 3. (可选) 修改 `Recraft Text to Image` 节点中的 `prompt` 参数，你也可以通过修改`size`参数来改变 4. 点击 `Run` 按钮，或者使用快捷键 `Ctrl(cmd) + Enter(回车)` 来执行图像的生成 -3. 等待 API 返回结果后，你可在 `Save Image` 节点中查看生成的图像，对应的图像也会被保存至 `ComfyUI/output/` 目录下 +5. 等待 API 返回结果后，你可在 `Save Image` 节点中查看生成的图像，对应的图像也会被保存至 `ComfyUI/output/` 目录下 > (可选) 我们在工作流中提供了 **Convert to SVG** 的分组，由于该分组中的 `Recraft Vectorize Image` 节点也会额外消耗积分，你可按需启用，将生成的图像转换成 SVG 格式 ### 3. 补充说明 -- **Recraft Style**：提供多种预设风格，如真实照片、数字插画、Logo栅格等 +- **Recraft Style**：提供多种预设风格，如真实照片、数字插画、Logo设计等 - **Seed 参数**：仅用于确定节点是否应重新运行，但实际生成结果与种子值无关 ## 相关节点详解 From 3b356ee191e773811144cb168f521d0cfe68ae07 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:51:53 +0800 Subject: [PATCH 38/59] fix(i18n/ja): fix description, add omitted text, fix template wording, fix controls description --- ja/tutorials/partner-nodes/topaz/astra-2.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ja/tutorials/partner-nodes/topaz/astra-2.mdx b/ja/tutorials/partner-nodes/topaz/astra-2.mdx index 734ad9ea4..152e56f3c 100644 --- a/ja/tutorials/partner-nodes/topaz/astra-2.mdx +++ b/ja/tutorials/partner-nodes/topaz/astra-2.mdx @@ -29,7 +29,7 @@ Astra 1 より、ディテールやスタイルの出し方を細かく寄せら **Topaz Video Enhance** を使う。**Topaz Video Enhance (Legacy)** には **Astra 2** がありません。Upscaler を **Astra 2**、解像度を **FullHD** または **4K**、入力は **MP4** のみ。 -**Prompt** あり: 最大 **450** フレーム（30fps で約 15 秒）。なし: 最大 **9000** フレーム。**Sharp** / **Realism** は詳細オプション。 +**Prompt** あり: 最大 **450** フレーム（30fps で約 15 秒）。なし: 最大 **9000** フレーム。必要に応じて **Sharp** や **Realism** の高度なコントロールを展開できます。 From 7f1d7a15dc7843dddcbb4c9ab1ca86ac5a0f16cf Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:52:00 +0800 Subject: [PATCH 39/59] fix(i18n/ja): fix partner node terminology in luma image-to-image --- ja/tutorials/partner-nodes/luma/luma-image-to-image.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ja/tutorials/partner-nodes/luma/luma-image-to-image.mdx b/ja/tutorials/partner-nodes/luma/luma-image-to-image.mdx index 469b07298..eb01159e9 100644 --- a/ja/tutorials/partner-nodes/luma/luma-image-to-image.mdx +++ b/ja/tutorials/partner-nodes/luma/luma-image-to-image.mdx @@ -1,6 +1,6 @@ --- -title: "Luma Image to Image API ノード｜ComfyUI 公式サンプル" -description: "本ガイドでは、ComfyUI における Luma Image to Image 合作ノードの使用方法について説明します" +title: "Luma Image to Image パートナーノード｜ComfyUI 公式サンプル" +description: "本ガイドでは、ComfyUI における Luma Image to Image パートナーノードの使用方法について説明します" sidebarTitle: "Luma Image to Image" translationSourceHash: 6eadbdbe translationFrom: tutorials/partner-nodes/luma/luma-image-to-image.mdx @@ -21,10 +21,10 @@ import UpdateReminder from "/snippets/ja/tutorials/update-reminder.mdx"; 各パラメーターの詳細な設定については、以下のドキュメントをご参照ください： -Luma Image to Image API ノードのドキュメント +Luma Image to Image ノードのドキュメント -## Luma Image to Image API ノードによる画像から画像へ（Image-to-Image）ワークフロー +## Luma Image to Image ノードによる画像から画像へ（Image-to-Image）ワークフロー この機能は、物体や形状の変更に非常に適していますが、色調の変更にはやや不向きです。推奨される `image_weight` 値は 0.0～0.1 程度の低めの数値です。 From 234ebdad52ba69b7a07b60eda99682efba8e239b Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:52:05 +0800 Subject: [PATCH 40/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D=20Trip?= =?UTF-8?q?o=20=E6=96=87=E6=A1=A3=E6=9C=AF=E8=AF=AD=E5=92=8C=20Comfy=20Des?= =?UTF-8?q?ktop=20=E8=AE=BE=E7=BD=AE=E6=A0=BC=E5=BC=8F=E5=8F=8A=E6=9C=AF?= =?UTF-8?q?=E8=AF=AD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/interface/settings/comfy-desktop.mdx | 24 +++++++------------ .../partner-nodes/tripo/model-generation.mdx | 8 +++---- 2 files changed, 13 insertions(+), 19 deletions(-) diff --git a/zh/interface/settings/comfy-desktop.mdx b/zh/interface/settings/comfy-desktop.mdx index caec2bdda..7576a46af 100644 --- a/zh/interface/settings/comfy-desktop.mdx +++ b/zh/interface/settings/comfy-desktop.mdx @@ -14,34 +14,28 @@ import SettingsMenuContext from "/snippets/zh/interface/settings-menu-context.md ## 常规 **窗口样式** -- **默认值**: default -- **说明**: 控制应用窗口的标题栏样式 +**功能**: 控制应用窗口的标题栏样式 -**自动更新检查** -- **默认值**: 启用 -- **说明**: 自动检查 ComfyUI 桌面版的更新，在更新可同时将会提醒你进行更新 +**自动检查更新** +**功能**: 自动检查 ComfyUI 桌面版的更新，当有更新时将提醒你进行更新 **发送匿名使用情况统计** -- **默认值**: 启用 -- **说明**: 发送匿名使用情况统计数据，帮助改进软件 ，对应的设置修改需要重启才能生效 +**功能**: 发送匿名使用情况统计数据，帮助改进软件。对应的设置修改需要重启才能生效 -## UV（包管理器） +## UV 这个部分主要针对中国地区用户设置使用，因为 Desktop 使用的许多原始镜像都是中国境外的，所以对国内用户访问不一定友好，你可以在这里设置你自己的镜像源，以提高访问速度，保证对应包可以正常访问下载。 **Python 安装镜像** -- **默认值**: 空（使用默认源） -- **说明**: +**功能**: - 管理的 Python 安装包从 Astral python-build-standalone 项目下载 - 可设置镜像 URL 使用不同的 Python 安装源 - 提供的 URL 将替换默认的 GitHub 下载地址 - 支持使用 file:// 协议从本地目录读取分发包 -- **验证**: 自动检查镜像可达性 +**验证**: 自动检查镜像可达性 **PyPI 安装镜像** -- **默认值**: 空（使用默认源） -- **说明**: 默认的 pip 包安装镜像源 +**功能**: 默认的 pip 包安装镜像源 **Torch安装镜像** -- **默认值**: 空（使用默认源） -- **说明**: PyTorch 专用的 pip 安装镜像源 + **功能**: PyTorch 专用的 pip 安装镜像源 diff --git a/zh/tutorials/partner-nodes/tripo/model-generation.mdx b/zh/tutorials/partner-nodes/tripo/model-generation.mdx index 61d94601d..bc1e10d1c 100644 --- a/zh/tutorials/partner-nodes/tripo/model-generation.mdx +++ b/zh/tutorials/partner-nodes/tripo/model-generation.mdx @@ -17,7 +17,7 @@ Tripo AI 是一家专注于生成式 AI 3D 建模的公司，它提供用户友 - 图生模型 - 多视图模型生成 - 骨骼绑定 -- 骨骼动画 +- 重定向骨骼模型 @@ -36,7 +36,7 @@ Tripo AI 是一家专注于生成式 AI 3D 建模的公司，它提供用户友 ![ComfyUI Tripo Text to Model Step Guide](/images/tutorial/api_nodes/tripo/tripo_text_to_model_step_guide.jpg) -你可参考图片中的序号来完成最基础的文生图工作流运行： +你可参考图片中的序号来完成最基础的文生模型工作流执行： 1. 在 `Tripo: Text to Model` 节点的 `prompt` 中输入提示词 - model： 可以选择不同的模型，目前仅 v1.4 模型支持 `Tripo: Refine Draft model` 的后续优化 - style: 中可以设置不同的风格 @@ -63,7 +63,7 @@ Tripo AI 是一家专注于生成式 AI 3D 建模的公司，它提供用户友 ![ComfyUI Tripo Text to Model Step Guide](/images/tutorial/api_nodes/tripo/tripo_image_to_model_step_guide.jpg) -你可参考图片中的序号来完成最基础的文生图工作流运行： +你可参考图片中的序号来完成最基础的图生模型工作流执行： 1. 在 `Load Image` 节点中加载提供的输入图片 2. 在 `Tripo: Image to Model` 节点中修改对应的参数设置 - model： 可以选择不同的模型，目前仅 v1.4 模型支持 `Tripo: Refine Draft model` 的后续优化 @@ -93,7 +93,7 @@ Tripo AI 是一家专注于生成式 AI 3D 建模的公司，它提供用户友 ![ComfyUI Tripo Text to Model Step Guide](/images/tutorial/api_nodes/tripo/tripo_multiview_to_model_step_guide.jpg) -你可参考图片中的序号来完成最基础的文生图工作流运行： +你可参考图片中的序号来完成最基础的多视图模型生成工作流执行： 1. 在 `Load Image` 节点中分别加载提供的输入图片 2. 在 `Tripo: Image to Model` 节点中修改对应的参数设置 - model： 可以选择不同的模型，目前仅 v1.4 模型支持 `Tripo: Refine Draft model` 的后续优化 From c39d0d3b293dff724f57f6b7f6a4c397328a2855 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:52:18 +0800 Subject: [PATCH 41/59] fix(i18n/ja): fix terminology - Partner Nodes, Lite Graph title, Extension, About, redundant phrasing --- ja/interface/settings/overview.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ja/interface/settings/overview.mdx b/ja/interface/settings/overview.mdx index d6f9b6f59..1b58c4968 100644 --- a/ja/interface/settings/overview.mdx +++ b/ja/interface/settings/overview.mdx @@ -17,7 +17,7 @@ translationFrom: interface/settings/overview.mdx - ComfyUI アカウントに関連するユーザー設定。主に ComfyUI アカウントにログインして API ノードを使用するために利用されます。 + ComfyUI アカウントに関連するユーザー設定。主に ComfyUI アカウントにログインしてパートナーノードを使用するためのものです。 クレジットの購入およびクレジット残高履歴のエントリー。ComfyUI アカウントへのログイン後のみ表示されます。 @@ -25,13 +25,13 @@ translationFrom: interface/settings/overview.mdx ComfyUI コア設定オプションの詳細説明 - + ComfyUI 内のキャンバス（Lite Graph）設定オプションの詳細説明 テーマ、背景色、サイドバーの位置など、ComfyUI の外観オプションを変更します。 - + ComfyUI 内のフロントエンド拡張プラグインの有効/無効状態を管理します。 @@ -46,7 +46,7 @@ translationFrom: interface/settings/overview.mdx ComfyUI のキーボードショートカット設定を変更します - + 現在の ComfyUI バージョン情報、デバイス実行環境情報などを確認できます。これは日常的なフィードバックに非常に役立ちます。 From 20055b976d15f68034e574a3304e551a33514874 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:52:21 +0800 Subject: [PATCH 42/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D=20Mana?= =?UTF-8?q?ger=20=E5=92=8C=E5=90=88=E4=BD=9C=E8=8A=82=E7=82=B9=20FAQ=20?= =?UTF-8?q?=E7=9A=84=E6=9C=AF=E8=AF=AD=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/manager/pack-management.mdx | 2 +- zh/tutorials/partner-nodes/faq.mdx | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/zh/manager/pack-management.mdx b/zh/manager/pack-management.mdx index 820b2415e..3165b515e 100644 --- a/zh/manager/pack-management.mdx +++ b/zh/manager/pack-management.mdx @@ -38,7 +38,7 @@ translationFrom: manager/pack-management.mdx 3. 或者在**版本（version）** 选择特定版本进行安装 ### 更新节点 -在 **Update available** 筛选器下，可以筛选出当前节点列表中可更新的节点 +在 **有可用更新** 筛选器下，可以筛选出当前节点列表中可更新的节点 ![更新节点](/images/manager/new_ui_update_pack.jpg) 1. 对应可更新节点会显示一个可更新的箭头标志 2. 在 **version** 选择特定版本 diff --git a/zh/tutorials/partner-nodes/faq.mdx b/zh/tutorials/partner-nodes/faq.mdx index cdf274e7f..093a64710 100644 --- a/zh/tutorials/partner-nodes/faq.mdx +++ b/zh/tutorials/partner-nodes/faq.mdx @@ -1,6 +1,6 @@ --- -title: "Partner Nodes 场景问题" -description: "在使用 Partner Nodes 时你可能遇到的常见问题。" +title: "合作节点常见问题" +description: "在使用合作节点时你可能遇到的常见问题。" sidebarTitle: "常见问题" translationSourceHash: 9533cb6b translationFrom: tutorials/partner-nodes/faq.mdx @@ -8,6 +8,6 @@ translationFrom: tutorials/partner-nodes/faq.mdx import Faq from "/snippets/zh/tutorials/partner-nodes/faq.mdx"; -本文是关于 合作伙伴节点使用的常见问题， +本文是关于合作节点使用的常见问题。 From 471cb98040a6159d4b10196098757c8f455843ca Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:52:34 +0800 Subject: [PATCH 43/59] =?UTF-8?q?fix(i18n/ja):=20fix=20Chinese=20=E6=A8=A1?= =?UTF-8?q?=E5=9E=8B=20to=20Japanese=20=E3=83=A2=E3=83=87=E3=83=AB=20throu?= =?UTF-8?q?ghout?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ja/troubleshooting/model-issues.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/ja/troubleshooting/model-issues.mdx b/ja/troubleshooting/model-issues.mdx index 8e9f4ecc7..bf1fc6634 100644 --- a/ja/troubleshooting/model-issues.mdx +++ b/ja/troubleshooting/model-issues.mdx @@ -1,8 +1,8 @@ --- -title: "ComfyUI 模型問題のトラブルシューティングと解決方法" -description: "アーキテクチャの不一致、模型の不足、読み込みエラーなど、模型関連の問題のトラブルシューティング" +title: "ComfyUI モデル問題のトラブルシューティングと解決方法" +description: "アーキテクチャの不一致、モデルの不足、読み込みエラーなど、モデル関連の問題のトラブルシューティング" icon: "cube" -sidebarTitle: "模型問題" +sidebarTitle: "モデル問題" translationSourceHash: 6cdb3b79 translationFrom: troubleshooting/model-issues.mdx --- @@ -48,7 +48,7 @@ translationFrom: troubleshooting/model-issues.mdx ``` 問題：SD1.5 ControlNet を SDXL チェックポイントで使用している（またはその逆） エラー："mat1 and mat2 shapes cannot be multiplied (154x2048 and 768x320)" - 修正：チェックポイントアーキテクチャ用に設計された ControlNet 模型を使用する + 修正：チェックポイントアーキテクチャ用に設計された ControlNet モデルを使用する - SD1.5 チェックポイントには SD1.5 ControlNet が必要 - SDXL チェックポイントには SDXL ControlNet が必要 ``` @@ -57,7 +57,7 @@ translationFrom: troubleshooting/model-issues.mdx ```bash # エラーが VAE デコード段階で発生するか確認する # "expected input[X, Y, Z] to have N channels, but got M channels" を探す - # Y 値はチャンネル数を示す：4 = SD 模型，16 = Flux 模型 + # Y 値はチャンネル数を示す：4 = SD モデル，16 = Flux モデル ``` 4. **予防戦略：** @@ -103,7 +103,7 @@ CheckpointLoaderSimple: ### 解決策 1. **モデルを再ダウンロードする** - ダウンロード過程中にファイルが破損している可能性があります -2. **利用可能なディスク容量を確認する** - モデル読み込みのに十分な容量があることを確認する（モデルは 2-15GB 以上の場合があります） +2. **利用可能なディスク容量を確認する** - モデル読み込みに十分な容量があることを確認する（モデルは 2-15GB 以上の場合があります） 3. **ファイル権限を確認する** - ComfyUI がモデルファイルを読み取れることを確認する 4. **異なるモデルでテストする** - 問題がモデル固有のものかシステム全体のものかを確認する From 8aa834e4599f9cc6e4e7e7c52cb2a3dbc9836615 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:54:07 +0800 Subject: [PATCH 44/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D=20Comf?= =?UTF-8?q?y=20=E8=AE=BE=E7=BD=AE=E4=B8=AD=E7=9A=84=E6=9C=AF=E8=AF=AD?= =?UTF-8?q?=E5=92=8C=E6=A0=BC=E5=BC=8F=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/interface/settings/comfy.mdx | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/zh/interface/settings/comfy.mdx b/zh/interface/settings/comfy.mdx index aa5a99a63..d4ba0b7e3 100644 --- a/zh/interface/settings/comfy.mdx +++ b/zh/interface/settings/comfy.mdx @@ -11,19 +11,19 @@ import SettingsMenuContext from "/snippets/zh/interface/settings-menu-context.md -## API 节点 +## 合作节点 -### 显示 API 节点定价徽章 +### 显示合作节点定价徽章 - **默认值**：启用 -- **功能**：控制是否在 API 节点上显示定价徽章，帮助用户识别 API 节点的使用成本 +- **功能**：控制是否在合作节点上显示定价徽章，帮助用户识别合作节点的使用成本 -![启用效果](/images/interface/setting/comfy/api_node_pricing_badge.jpg) +![显示合作节点定价徽章](/images/interface/setting/comfy/api_node_pricing_badge.jpg) -> 更多关于 API 节点请参考 [API 节点](/zh/tutorials/partner-nodes/overview) +> 更多关于合作节点请参考 [合作节点](/zh/tutorials/partner-nodes/overview) ## 开发者模式 -### 启用开发模式选项 +### 启用开发模式选项（API 保存等） - **默认值**：禁用 - **功能**：启用开发者模式选项（如API保存等） @@ -87,18 +87,18 @@ import SettingsMenuContext from "/snippets/zh/interface/settings-menu-context.md 在 ComfyUI 的迭代过程中，我们会对一些节点进行调整，也会启用一些节点，这些节点可能在未来版本中发生重大变化或被移除，但是为了保证兼容性类似弃用的节点并没有被移除，你可以通过下面的设置来启用是否显示 **实验性节点** 和 **已弃用节点** -### 显示已弃用节点 +### 在搜索中显示已弃用节点 - **默认值**：禁用 - **功能**：控制是否在搜索中显示已弃用的节点，已弃用节点在UI中默认隐藏，但在现有工作流中仍然有效 -![已弃用节点](/images/interface/setting/comfy/depr_node.jpg) +![在搜索中显示已弃用节点](/images/interface/setting/comfy/depr_node.jpg) -### 显示实验性节点 +### 在搜索中显示实验性节点 - **默认值**：启用 -- **功能**：控制是否在搜索中显示实验性节点，实验性节点说一些新的功能支持，但未完全稳定，可能在未来版本中发生变化或被移除 +- **功能**：控制是否在搜索中显示实验性节点，实验性节点是一些新的功能支持，但未完全稳定，可能在未来版本中发生变化或被移除 -![已弃用节点](/images/interface/setting/comfy/beta_node.jpg) +![在搜索中显示实验性节点](/images/interface/setting/comfy/beta_node.jpg) ## 节点搜索框 @@ -156,9 +156,9 @@ import SettingsMenuContext from "/snippets/zh/interface/settings-menu-context.md - **默认值**：100 - **功能**：设置单次点击添加到队列的最大任务数量，防止意外添加过多任务到队列 -## 验证和开发者设置 +## 验证 -### 验证节点定义 +### 验证节点定义（慢） - **默认值**：禁用 - **功能**：控制是否在启动时验证所有节点定义（慢），仅推荐给节点开发者使用，当启用时系统会使用 Zod 模式对每个节点定义进行严格验证，这一功能会消耗更多内存和时间 - **错误处理**：验证失败的节点定义会被跳过，并在控制台输出警告信息 From 468791f818ed9247c7906fe76c1e2e63f6b52a8b Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:54:15 +0800 Subject: [PATCH 45/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=E4=BB=98=E6=AC=BE=E8=AE=B0=E5=BD=95=E4=B8=AD=E7=9A=84=E7=BF=BB?= =?UTF-8?q?=E8=AF=91=E4=B8=8D=E4=B8=80=E8=87=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/support/payment/payment-history.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/zh/support/payment/payment-history.mdx b/zh/support/payment/payment-history.mdx index 2e65b4451..39fd35708 100644 --- a/zh/support/payment/payment-history.mdx +++ b/zh/support/payment/payment-history.mdx @@ -29,8 +29,8 @@ translationFrom: support/payment/payment-history.mdx ## 下载发票 -在 Stripe 门户中你可以看到 Invoice history 列表，点击对应的 invoice 可以查看发票详情, 并下载对应的发票 +在 Stripe 门户中，打开发票历史列表中的任意条目以查看详情并下载 PDF 副本。 -![下载发票](/images/support/payment/billing-5-download-invoice.jpg) +![发票历史详情及下载选项](/images/support/payment/billing-5-download-invoice.jpg) -请确定在支付生成发票前你的发票信息填写正确 [编辑您的付款信息](/zh/support/payment/editing-payment-information) \ No newline at end of file +请确保在生成新发票前填写正确的账单信息。通过[编辑您的付款信息](/zh/support/payment/editing-payment-information)进行更新。 \ No newline at end of file From 9dbf87701c0b79adb436ad3f190bb785f2e3524d Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:54:17 +0800 Subject: [PATCH 46/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=E7=99=BB=E5=BD=95=E6=96=87=E6=A1=A3=E7=9A=84=E6=9C=AF=E8=AF=AD?= =?UTF-8?q?=E9=97=AE=E9=A2=98=EF=BC=88=E5=90=88=E4=BD=9C=E8=8A=82=E7=82=B9?= =?UTF-8?q?=E3=80=81=E7=99=BB=E5=BD=95=E3=80=81API=20=E5=AF=86=E9=92=A5?= =?UTF-8?q?=EF=BC=89=E5=B9=B6=E7=A7=BB=E9=99=A4=E9=A2=9D=E5=A4=96=E5=AE=89?= =?UTF-8?q?=E5=85=A8=E6=8F=90=E7=A4=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/account/login.mdx | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/zh/account/login.mdx b/zh/account/login.mdx index fcf9462c5..b539cf70d 100644 --- a/zh/account/login.mdx +++ b/zh/account/login.mdx @@ -8,7 +8,7 @@ translationFrom: account/login.mdx 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 平台上使用高级功能和服务。 ## 支持的登录方式 @@ -22,7 +22,7 @@ ComfyUI 支持以下登录方式： 要在 Comfy Cloud 上访问您的 Comfy 账户以使用 ComfyUI： 1. 访问 [Comfy Cloud](https://www.comfy.org) -2. 点击**登录**或**登入** +2. 点击**登录**或**登录** 3. 选择您的登录方式： - **电子邮件**：输入您的电子邮件地址和密码，然后点击**登录** - **Google**：点击 Google 登录按钮并进行身份验证 @@ -39,7 +39,7 @@ ComfyUI 支持以下登录方式： - **电子邮件**：输入您的电子邮件地址和密码 - **Google**：点击 Google 登录按钮并进行身份验证 - **GitHub**：点击 GitHub 登录按钮并进行身份验证 - - **API Key**：用于非白名单部署的 API Key 登录（见下文） + - **API 密钥**：用于非白名单部署的 API 密钥登录（见下文） ![用户设置界面](/images/interface/setting/user.jpg) @@ -120,7 +120,6 @@ ComfyUI 支持以下登录方式： 为了保护您的账户安全： - 使用强大且唯一的密码 -- 启用双因素身份验证 - 不要分享您的登录凭据 - 使用共享设备时请注销 - 定期更新您的密码 From 7fc8272656f2ea93bee957b86459f1f3b240d909 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:54:31 +0800 Subject: [PATCH 47/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=E5=90=88=E4=BD=9C=E8=8A=82=E7=82=B9=E6=A6=82=E8=BF=B0=E7=9A=84?= =?UTF-8?q?=E6=9C=AF=E8=AF=AD=E5=92=8C=E6=A0=BC=E5=BC=8F=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/tutorials/partner-nodes/overview.mdx | 36 +++++++++++-------------- 1 file changed, 16 insertions(+), 20 deletions(-) diff --git a/zh/tutorials/partner-nodes/overview.mdx b/zh/tutorials/partner-nodes/overview.mdx index f6fc6145d..940d5cc27 100644 --- a/zh/tutorials/partner-nodes/overview.mdx +++ b/zh/tutorials/partner-nodes/overview.mdx @@ -28,43 +28,40 @@ Partner Nodes 是一组特殊的节点，它们能够连接到外部 API 服务 ![Select Comfy API Key Login](/images/interface/setting/user/user-login-api-1.jpg) -## 使用 ComfyUI 账户 API Key 集成来调用付费模型 合作伙伴节点 +## 使用 ComfyUI 账户 API Key 集成来调用付费合作节点 -目前我们支持通过 ComfyUI 账户 API Key 集成来访问我们的服务来调用付费模型 合作伙伴节点，请参考 API Key 集成章节了解如何使用 API Key 集成来调用付费模型 合作伙伴节点 +目前我们支持通过 ComfyUI 账户 API Key 集成来访问我们的服务来调用付费合作节点，请参考 API Key 集成章节了解如何使用 API Key 集成来调用付费合作节点。 - **重要提示:** 此处讨论的 API 密钥是您的 **ComfyUI 账户 API Key**(用于在工作流中访问付费 合作伙伴节点)。这与开发者用于将自定义节点发布到注册表的 **注册表发布 API Key** **不同**。如果您想发布自定义节点,请参阅[发布节点](/zh/registry/publishing)。 + **重要提示:** 此处讨论的 API 密钥是您的 **ComfyUI 账户 API Key**（用于在工作流中访问付费合作节点）。这与开发者用于将自定义节点发布到注册表的 **注册表发布 API Key** **不同**。如果您想发布自定义节点，请参阅[发布节点](/zh/registry/publishing)。 -请参考 API Key 集成章节了解如何使用 API Key 集成来调用付费模型 合作伙伴节点 +请参考 API Key 集成章节了解如何使用 API Key 集成来调用付费合作节点 -## Partner Nodes 的优势 +## 合作节点的优势 -Partner Nodes 为 ComfyUI 用户提供了几个重要优势： +合作节点为 ComfyUI 用户提供了几个重要优势： - **访问闭源模型**：使用最先进的 AI 模型，无需自行部署 -- **无缝集成**：合作伙伴节点与其他 ComfyUI 节点完全兼容，可以组合创建复杂工作流 +- **无缝集成**：合作节点与其他 ComfyUI 节点完全兼容，可以组合创建复杂工作流 - **简化的体验**：无需管理 API 密钥或处理复杂的 API 请求 - **可控的成本**：预付费系统确保您完全控制支出，没有意外费用 -## 计费方式 +## 定价 - -请参考定价页面了解对应的 API 定价 + +请参考定价页面了解对应的合作节点定价 - -![选择 Comfy API Key 登录](/images/zh/interface/setting/user/user-login-api-1.jpg) - ## 关于开源和选择加入 -重要的是要注意，**Partner Nodes 是完全可选的**。ComfyUI 将始终保持完全开源，并对本地用户免费。合作伙伴节点设计为"选择加入"功能，为那些想要访问外部 SOTA（最先进）模型的用户提供便利。 +重要的是要注意，**合作节点是完全可选的**。ComfyUI 将始终保持完全开源，并对本地用户免费。合作节点设计为"选择加入"功能，为那些想要访问外部 SOTA（最先进）模型的用户提供便利。 -## 如何完全禁用合作伙伴节点 +## 如何完全禁用合作节点 -您可以添加 `--disable-api-nodes` 启动参数来禁用 ComfyUI 中的所有合作伙伴节点。此参数还将阻止前端与互联网通信。 +您可以添加 `--disable-api-nodes` 启动参数来禁用 ComfyUI 中的所有合作节点。此参数还将阻止前端与互联网通信。 **手动安装用户：** @@ -81,16 +78,15 @@ python main.py --disable-api-nodes pause ``` -## 如何使用 Partner Nodes +## 使用场景 -Partner Nodes 的一个强大应用是将外部模型的输出与本地节点结合。例如： +合作节点的一个强大应用是将外部模型的输出与本地节点结合。例如： - 使用 [GPT-Image-1](/zh/tutorials/partner-nodes/openai/gpt-image-1) 生成基础图像，然后通过本地 `WanImageToVideo` 节点转换为视频 - 结合外部生成的图像与本地的上采样或风格转换节点 - 创建混合工作流，充分利用闭源和开源模型的优势 -这种灵活性使 ComfyUI 成为真正的通用生成式 AI 入口，将各种不同的 AI 功能整合到一个统一的工作流中，带来了更多可能性 - +这种灵活性使 ComfyUI 成为真正的通用生成式 AI 入口，将各种不同的 AI 功能整合到一个统一的工作流中，带来了更多可能性。 ## 常见问题 From dff435faa94135cba7169c538b51daf986089790 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:54:46 +0800 Subject: [PATCH 48/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D?= =?UTF-8?q?=E6=94=AF=E4=BB=98=E5=8E=86=E5=8F=B2=E6=96=87=E6=A1=A3=E7=9A=84?= =?UTF-8?q?=E5=9B=BE=E7=89=87=E8=AF=B4=E6=98=8E=E5=92=8C=E8=AF=91=E6=96=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/support/payment/payment-history.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh/support/payment/payment-history.mdx b/zh/support/payment/payment-history.mdx index 39fd35708..77fc581b6 100644 --- a/zh/support/payment/payment-history.mdx +++ b/zh/support/payment/payment-history.mdx @@ -31,6 +31,6 @@ translationFrom: support/payment/payment-history.mdx 在 Stripe 门户中，打开发票历史列表中的任意条目以查看详情并下载 PDF 副本。 -![发票历史详情及下载选项](/images/support/payment/billing-5-download-invoice.jpg) +![发票历史详情，高亮显示下载选项](/images/support/payment/billing-5-download-invoice.jpg) -请确保在生成新发票前填写正确的账单信息。通过[编辑您的付款信息](/zh/support/payment/editing-payment-information)进行更新。 \ No newline at end of file +请确保在生成新发票前填写正确的账单信息。您可以通过[编辑您的付款信息](/zh/support/payment/editing-payment-information)进行更新。 \ No newline at end of file From e07a0bc6e5c752857b9f627ee23d7ab26c57f5d7 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:54:50 +0800 Subject: [PATCH 49/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D=20LTXV?= =?UTF-8?q?=20=E6=96=87=E6=A1=A3=E7=BC=BA=E5=A4=B1=E7=9A=84=E6=8F=90?= =?UTF-8?q?=E7=A4=BA=E3=80=81=E7=9B=AE=E5=BD=95=E5=92=8C=E6=9C=AF=E8=AF=AD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/tutorials/video/ltxv.mdx | 52 +++++++++++++++++++++++-------------- 1 file changed, 32 insertions(+), 20 deletions(-) diff --git a/zh/tutorials/video/ltxv.mdx b/zh/tutorials/video/ltxv.mdx index 93520d5a3..2d0d5efe8 100644 --- a/zh/tutorials/video/ltxv.mdx +++ b/zh/tutorials/video/ltxv.mdx @@ -2,44 +2,56 @@ title: "LTX-0.9.5 ComfyUI 工作流示例" sidebarTitle: "LTX-0.9.5" description: "学习如何在 ComfyUI 中使用 LTX-Video 0.9.5 高效生成视频" -translationSourceHash: 7d8a0192 -translationFrom: tutorials/video/ltxv.mdx --- import UpdateReminder from '/snippets/zh/tutorials/update-reminder.mdx' - -将任意视频直接拖入 ComfyUI 即可开始使用 - - -## 快速入门 - -[LTX-Video](https://huggingface.co/Lightricks/LTX-Video) 是 Lightricks 开发的高效视频生成模型。 - -使用该模型的关键是提供详细的长描述提示词。 - -请下载 [ltx-video-2b-v0.9.5.safetensors](https://huggingface.co/Lightricks/LTX-Video/resolve/main/ltx-video-2b-v0.9.5.safetensors?download=true) 文件并放入 `ComfyUI/models/checkpoints` 目录。 - -若尚未下载 [t5xxl_fp16.safetensors](https://huggingface.co/Comfy-Org/mochi_preview_repackaged/resolve/main/split_files/text_encoders/t5xxl_fp16.safetensors?download=true) 文件，请将其放入 `ComfyUI/models/text_encoders` 目录。 +[LTX-Video](https://huggingface.co/Lightricks/LTX-Video) 是 Lightricks 开发的高效视频生成模型。使用该模型的关键是提供详细的长描述提示词。 ## 多帧控制 -通过系列图像控制视频生成。可下载输入图像：[起始帧](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/ltxv/multi-frame/house1.png) 和 [结束帧](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/ltxv/multi-frame/house2.png)。 +通过一系列图像控制视频生成。可下载输入图像：[起始帧](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/ltxv/multi-frame/house1.png) 和 [结束帧](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/ltxv/multi-frame/house2.png)。 + +LTX-Video 多帧控制 -LTX-Video 多帧控制工作流 + +将任意视频直接拖入 ComfyUI 即可运行工作流。 + ## 图生视频 通过首帧图像控制视频生成：[示例首帧](https://raw.githubusercontent.com/Comfy-Org/example_workflows/refs/heads/main/ltxv/i2v/girl1.png)。 -

Run on Comfy Cloud

+

在 Comfy 云上运行

 -LTX-Video 图生视频工作流 +LTX-Video 图生视频 + + +将任意视频直接拖入 ComfyUI 即可运行工作流。 + ## 文生视频 -LTX-Video 文生视频工作流 +LTX-Video 文生视频 + + +将任意视频直接拖入 ComfyUI 即可运行工作流。 + + +## 前提条件 + +将以下模型下载并放到指定位置： + +- [ltx-video-2b-v0.9.5.safetensors](https://huggingface.co/Lightricks/LTX-Video/resolve/main/ltx-video-2b-v0.9.5.safetensors?download=true) +- [t5xxl_fp16.safetensors](https://huggingface.co/Comfy-Org/mochi_preview_repackaged/resolve/main/split_files/text_encoders/t5xxl_fp16.safetensors?download=true)（如尚未下载） + +``` +├── checkpoints/ +│ └── ltx-video-2b-v0.9.5.safetensors +└── text_encoders/ + └── t5xxl_fp16.safetensors +``` From 99fc1c38ff482dbc8a979b31271cfac32e8c86d4 Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:54:59 +0800 Subject: [PATCH 50/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D=20Wan2?= =?UTF-8?q?.1=20Fun=20InP=20=E6=96=87=E6=A1=A3=E7=9A=84=E6=9C=AF=E8=AF=AD?= =?UTF-8?q?=E5=92=8C=E6=AD=A5=E9=AA=A46?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/tutorials/video/wan/fun-inp.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/zh/tutorials/video/wan/fun-inp.mdx b/zh/tutorials/video/wan/fun-inp.mdx index 4f29d3091..384a46ba6 100644 --- a/zh/tutorials/video/wan/fun-inp.mdx +++ b/zh/tutorials/video/wan/fun-inp.mdx @@ -33,7 +33,7 @@ Wan-Fun InP 是阿里巴巴推出的开源视频生成模型，属于 ​​Wan2 目前 ComfyUI 已原生支持了 Wan2.1 Fun InP 模型，在开始本篇教程前，请更新你的 ComfyUI 保证你的版本在[这个提交](https://github.com/Comfy-Org/ComfyUI/commit/0a1f8869c9998bbfcfeb2e97aa96a6d3e0a2b5df)版本之后 -## Wan2.1 Fun Control 工作流 +## Wan2.1 Fun InP 工作流 下载下面的图片，并拖入 ComfyUI 中以加载对应的工作流 @@ -77,14 +77,14 @@ Wan-Fun InP 是阿里巴巴推出的开源视频生成模型，属于 ​​Wan2 ### 3. 按步骤完成工作流 -![ComfyUI Wan2.1 Fun Control 视频生成工作流步骤图](/images/tutorial/video/wan/fun_inp_flow_diagram.png) +![ComfyUI Wan2.1 Fun InP 视频生成工作流步骤图](/images/tutorial/video/wan/fun_inp_flow_diagram.png) 1. 确保 `Load Diffusion Model` 节点加载了 `wan2.1_fun_inp_1.3B_bf16.safetensors` 2. 确保 `Load CLIP` 节点加载了 `umt5_xxl_fp8_e4m3fn_scaled.safetensors` 3. 确保 `Load VAE` 节点加载了 `wan_2.1_vae.safetensors` 4. 确保 `Load CLIP Vision` 节点加载了 `clip_vision_h.safetensors ` 5. 在 `Load Image` 节点（已被重命名为`Start_image`） 上传起始帧 -6. 在第二个 `Load Image` 节点上传用于控制视频。注意： 目前这个节点还不支持 mp4 只能使用 Webp 视频 +6. 在第二个 `Load Image` 节点上传结束帧 7. （可选）修改 Prompt 使用中英文都可以 8. （可选）在 `WanFunInpaintToVideo` 修改对应视频的尺寸，不要使用过大的尺寸 9. 点击 `Run` 按钮，或者使用快捷键 `Ctrl(cmd) + Enter(回车)` 来执行视频生成 From e0f4ff4cdc8aadcdf351f88e772b29efa35e742b Mon Sep 17 00:00:00 2001 From: lin-bot23 Date: Thu, 11 Jun 2026 16:55:33 +0800 Subject: [PATCH 51/59] =?UTF-8?q?fix(i18n/zh):=20=E4=BF=AE=E5=A4=8D=20Wan2?= =?UTF-8?q?.2=20Fun=20Inp=20=E6=96=87=E6=A1=A3=E7=9A=84=E8=A7=86=E9=A2=91?= =?UTF-8?q?=E5=B5=8C=E5=85=A5=E3=80=81=E5=9B=BE=E7=89=87=E8=AF=B4=E6=98=8E?= =?UTF-8?q?=E5=92=8C=E8=A1=A8=E6=A0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/tutorials/video/wan/wan2-2-fun-inp.mdx | 24 ++++++++++------------- 1 file changed, 10 insertions(+), 14 deletions(-) diff --git a/zh/tutorials/video/wan/wan2-2-fun-inp.mdx b/zh/tutorials/video/wan/wan2-2-fun-inp.mdx index 838a0972c..38b3bdf01 100644 --- a/zh/tutorials/video/wan/wan2-2-fun-inp.mdx +++ b/zh/tutorials/video/wan/wan2-2-fun-inp.mdx @@ -25,11 +25,9 @@ import UpdateReminder from '/snippets/zh/tutorials/update-reminder.mdx' ## ComfyOrg Wan2.2 Fun InP & Control Youtube 直播回放 -对于 ComfyUI Wan2.2 的使用，我们有进行了直播，你可以查看这些回放了解如何使用 -