Comfy-Org/desktop

Fork 0

mirror of https://github.com/Comfy-Org/desktop.git synced 2026-11-04 23:47:43 +00:00

[GH-ISSUE #1705] [Feature Request]: Add Chinese (Simplified) localization support for better Chinese user experience #511

New issue

Closed

opened 2026-10-31 22:13:55 +00:00 by bsakaguchi · 3 comments

bsakaguchi commented

2026-10-31 22:13:55 +00:00

Owner

Originally created by @ghost on GitHub (May 4, 2026).
Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1705

Problem Statement

目前 ComfyUI 桌面版缺少中文（简体）本地化支持，所有界面文本均为英文。这导致中文用户在使用过程中遇到以下困难：

菜单项理解困难 - 系统托盘菜单、应用菜单均为英文
错误消息无法理解 - 安装、配置过程中的错误提示均为英文
迁移界面不清晰 - 首次安装时的迁移选项描述难以理解
对话框内容晦涩 - 各种确认对话框、错误对话框均为英文

Proposed Solution

添加完整的中文（简体）本地化支持，以下是当前所有需要翻译的界面文本及建议的准确翻译：

1. 系统托盘菜单 (src/main-process/appWindow.ts)

英文原文	建议中文翻译	说明
Show Comfy Window	显示 Comfy 窗口	清晰表明功能
Quit Comfy	退出 Comfy	标准退出表述
Hide	隐藏	标准菜单项
About ComfyUI	关于 ComfyUI	标准关于对话框
Help	帮助	标准菜单项

2. 应用对话框标题和消息

英文原文	建议中文翻译	位置
Restart ComfyUI	重启 ComfyUI	src/handlers/AppHandlers.ts:42
Error Opening File	打开文件错误	src/handlers/pathHandlers.ts:186
Could not open file: {path}. Error: {error}	无法打开文件：{path}。错误：{error}	src/handlers/pathHandlers.ts:187
Download git	下载 Git	src/install/installationManager.ts:185
We were unable to find git on this device. Please download and install git before continuing with the installation of ComfyUI Desktop.	未在此设备上找到 Git。请先下载并安装 Git，然后再继续安装 ComfyUI 桌面版。	src/install/installationManager.ts:186
Python Environment Issue	Python 环境问题	src/install/installationManager.ts:253
Failed to create virtual environment	创建虚拟环境失败	src/install/installationManager.ts:292
Update NVIDIA Driver	更新 NVIDIA 驱动程序	src/install/installationManager.ts:411
Your NVIDIA driver may be too old for PyTorch {version}.	您的 NVIDIA 驱动程序版本可能过旧，不支持 PyTorch {version}。	src/install/installationManager.ts:412
Send Crash Report	发送崩溃报告	src/services/sentry.ts:85
An error occurred: {errorType}	发生错误：{errorType}	src/services/sentry.ts:86

3. 迁移界面 (src/constants.ts - MigrationItems)

英文原文	建议中文翻译	说明
User Files	用户文件	标签
Settings and user-created workflows	设置和用户创建的工作流	描述
Models	模型	标签
Reference model files from existing ComfyUI installations. (No copy)	引用现有 ComfyUI 安装中的模型文件（不复制）	描述，需明确说明不复制
Custom Nodes	自定义节点	标签
Reinstall custom nodes from existing ComfyUI installations.	从现有 ComfyUI 安装中重新安装自定义节点。	描述

4. 关于对话框 (src/main-process/appWindow.ts)

英文原文	建议中文翻译
ComfyUI	ComfyUI（保持原名）
ComfyUI v{version}	ComfyUI 版本 {version}

5. 下载管理器 (src/models/DownloadManager.ts)

英文原文	建议中文翻译
Save path is not in models directory	保存路径不在模型目录中

6. 安装阶段文本 (src/constants.ts - InstallStage)

这些文本在安装过程中显示，需要翻译：

英文原文	建议中文翻译
Initializing	正在初始化
Checking existing install	检查现有安装
Hardware validation	硬件验证
Git check	Git 检查
Welcome	欢迎
Install options	安装选项
Creating directories	正在创建目录
Initializing config	正在初始化配置
Python environment setup	Python 环境设置
Installing requirements	正在安装依赖项
Installing PyTorch	正在安装 PyTorch
Installing ComfyUI requirements	正在安装 ComfyUI 依赖项
Installing manager requirements	正在安装管理器依赖项
Migrating custom nodes	正在迁移自定义节点
Maintenance mode	维护模式
Starting server	正在启动服务器
Ready	就绪
Error	错误

Potential workflow

在应用中添加语言选择设置（设置 → 常规 → 语言）
实现 i18n 本地化框架（推荐使用 i18next 或类似方案）
创建 locales/zh-CN.json 翻译文件
将所有硬编码的英文字符串提取到翻译文件中
根据系统语言或用户设置自动切换语言
测试所有翻译文本的显示效果

Impact Level

High (Major improvement) - 这将显著改善中文用户的使用体验，降低使用门槛。

Alternatives Considered

仅提供英文界面：不考虑，这会阻碍中文用户使用
使用浏览器翻译插件：体验差，无法翻译系统菜单和对话框
第三方汉化包：难以维护，可能与版本更新冲突

Additional information

建议参考其他 Electron 应用的本地化实现（如 VS Code、Discord）
翻译应注重技术术语的准确性（如 Custom Nodes 译为自定义节点而非自定义结点）
建议同时支持繁体中文（zh-TW）以满足不同地区用户需求
可参考 ComfyUI Web 版的本地化方案

我是中文用户，愿意协助测试和验证翻译准确性。

┆Issue is synchronized with this Notion page by Unito

Originally created by @ghost on GitHub (May 4, 2026). Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1705 ## Problem Statement 目前 ComfyUI 桌面版缺少中文（简体）本地化支持，所有界面文本均为英文。这导致中文用户在使用过程中遇到以下困难： 1. **菜单项理解困难** - 系统托盘菜单、应用菜单均为英文 2. **错误消息无法理解** - 安装、配置过程中的错误提示均为英文 3. **迁移界面不清晰** - 首次安装时的迁移选项描述难以理解 4. **对话框内容晦涩** - 各种确认对话框、错误对话框均为英文 ## Proposed Solution 添加完整的中文（简体）本地化支持，以下是当前所有需要翻译的界面文本及建议的准确翻译： ### 1. 系统托盘菜单 (src/main-process/appWindow.ts) | 英文原文 | 建议中文翻译 | 说明 | |---------|------------|------| | Show Comfy Window | 显示 Comfy 窗口 | 清晰表明功能 | | Quit Comfy | 退出 Comfy | 标准退出表述 | | Hide | 隐藏 | 标准菜单项 | | About ComfyUI | 关于 ComfyUI | 标准关于对话框 | | Help | 帮助 | 标准菜单项 | ### 2. 应用对话框标题和消息 | 英文原文 | 建议中文翻译 | 位置 | |---------|------------|------| | Restart ComfyUI | 重启 ComfyUI | src/handlers/AppHandlers.ts:42 | | Error Opening File | 打开文件错误 | src/handlers/pathHandlers.ts:186 | | Could not open file: {path}. Error: {error} | 无法打开文件：{path}。错误：{error} | src/handlers/pathHandlers.ts:187 | | Download git | 下载 Git | src/install/installationManager.ts:185 | | We were unable to find git on this device. Please download and install git before continuing with the installation of ComfyUI Desktop. | 未在此设备上找到 Git。请先下载并安装 Git，然后再继续安装 ComfyUI 桌面版。 | src/install/installationManager.ts:186 | | Python Environment Issue | Python 环境问题 | src/install/installationManager.ts:253 | | Failed to create virtual environment | 创建虚拟环境失败 | src/install/installationManager.ts:292 | | Update NVIDIA Driver | 更新 NVIDIA 驱动程序 | src/install/installationManager.ts:411 | | Your NVIDIA driver may be too old for PyTorch {version}. | 您的 NVIDIA 驱动程序版本可能过旧，不支持 PyTorch {version}。 | src/install/installationManager.ts:412 | | Send Crash Report | 发送崩溃报告 | src/services/sentry.ts:85 | | An error occurred: {errorType} | 发生错误：{errorType} | src/services/sentry.ts:86 | ### 3. 迁移界面 (src/constants.ts - MigrationItems) | 英文原文 | 建议中文翻译 | 说明 | |---------|------------|------| | User Files | 用户文件 | 标签 | | Settings and user-created workflows | 设置和用户创建的工作流 | 描述 | | Models | 模型 | 标签 | | Reference model files from existing ComfyUI installations. (No copy) | 引用现有 ComfyUI 安装中的模型文件（不复制） | 描述，需明确说明不复制 | | Custom Nodes | 自定义节点 | 标签 | | Reinstall custom nodes from existing ComfyUI installations. | 从现有 ComfyUI 安装中重新安装自定义节点。 | 描述 | ### 4. 关于对话框 (src/main-process/appWindow.ts) | 英文原文 | 建议中文翻译 | |---------|------------| | ComfyUI | ComfyUI（保持原名） | | ComfyUI v{version} | ComfyUI 版本 {version} | ### 5. 下载管理器 (src/models/DownloadManager.ts) | 英文原文 | 建议中文翻译 | |---------|------------| | Save path is not in models directory | 保存路径不在模型目录中 | ### 6. 安装阶段文本 (src/constants.ts - InstallStage) 这些文本在安装过程中显示，需要翻译： | 英文原文 | 建议中文翻译 | |---------|------------| | Initializing | 正在初始化 | | Checking existing install | 检查现有安装 | | Hardware validation | 硬件验证 | | Git check | Git 检查 | | Welcome | 欢迎 | | Install options | 安装选项 | | Creating directories | 正在创建目录 | | Initializing config | 正在初始化配置 | | Python environment setup | Python 环境设置 | | Installing requirements | 正在安装依赖项 | | Installing PyTorch | 正在安装 PyTorch | | Installing ComfyUI requirements | 正在安装 ComfyUI 依赖项 | | Installing manager requirements | 正在安装管理器依赖项 | | Migrating custom nodes | 正在迁移自定义节点 | | Maintenance mode | 维护模式 | | Starting server | 正在启动服务器 | | Ready | 就绪 | | Error | 错误 | ## Potential workflow 1. 在应用中添加语言选择设置（设置 → 常规 → 语言） 2. 实现 i18n 本地化框架（推荐使用 i18next 或类似方案） 3. 创建 locales/zh-CN.json 翻译文件 4. 将所有硬编码的英文字符串提取到翻译文件中 5. 根据系统语言或用户设置自动切换语言 6. 测试所有翻译文本的显示效果 ## Impact Level **High (Major improvement)** - 这将显著改善中文用户的使用体验，降低使用门槛。 ## Alternatives Considered - **仅提供英文界面**：不考虑，这会阻碍中文用户使用 - **使用浏览器翻译插件**：体验差，无法翻译系统菜单和对话框 - **第三方汉化包**：难以维护，可能与版本更新冲突 ## Additional information - 建议参考其他 Electron 应用的本地化实现（如 VS Code、Discord） - 翻译应注重技术术语的准确性（如 Custom Nodes 译为自定义节点而非自定义结点） - 建议同时支持繁体中文（zh-TW）以满足不同地区用户需求 - 可参考 ComfyUI Web 版的本地化方案 --- 我是中文用户，愿意协助测试和验证翻译准确性。 ┆Issue is synchronized with this [Notion page](https://www.notion.so/Issue-1705-Feature-Request-Add-Chinese-Simplified-localization-support-for-better-Chinese-us-3566d73d3650818a8d88fee2a58afc57) by [Unito](https://www.unito.io)

bsakaguchi

2026-10-31 22:13:55 +00:00

closed this issue
added the
enhancement
label

bsakaguchi commented

2026-10-31 22:13:56 +00:00

Author

Owner

@ghost commented on GitHub (May 4, 2026):

补充遗漏的翻译内容

发现了一些之前遗漏的需要汉化的界面文本：

7. 错误对话框 (src/install/installationManager.ts:128)

英文原文	建议中文翻译
Critical Error	严重错误
An error was detected with your installation, and the maintenance page could not be loaded to resolve it. The app will close now. Please reinstall if this issue persists.	检测到安装错误，且无法加载维护页面来解决问题。应用现在将关闭。如果问题持续，请重新安装。

8. 环境错误 (src/main-process/appWindow.ts:283-290)

英文原文	建议中文翻译
Invalid Environment	无效的环境
Unknown error whilst attempting to determine user data folder.	尝试确定用户数据文件夹时发生未知错误。

9. 配置删除错误 (src/store/desktopConfig.ts:147-157)

英文原文	建议中文翻译
Delete Failed	删除失败
Unknown error whilst attempting to delete config file:\n\n{configFilePath}	尝试删除配置文件时发生未知错误：\n\n{configFilePath}
User Data	用户数据
Unknown error whilst attempting to determine user data folder.	尝试确定用户数据文件夹时发生未知错误。

10. 验证和迁移错误 (src/install/installationManager.ts)

英文原文	建议中文翻译
Validation error: {error}	验证错误：{error}
Failed to migrate custom nodes	迁移自定义节点失败
Unknown error occurred	发生未知错误

11. 配置存储相关 (src/store/desktopConfig.ts:119-131)

需要检查这些对话框中的按钮文本和消息文本是否已包含在上述分类中。

建议开发者在实现本地化时，使用 IDE 的全局搜索功能，搜索所有 dialog.showMessageBox、dialog.showErrorBox、 itle:、message:、label: 等关键词，确保不遗漏任何用户可见的英文文本。

@ghost commented on GitHub (May 4, 2026): ## 补充遗漏的翻译内容发现了一些之前遗漏的需要汉化的界面文本： ### 7. 错误对话框 (src/install/installationManager.ts:128) | 英文原文 | 建议中文翻译 | |---------|------------| | Critical Error | 严重错误 | | An error was detected with your installation, and the maintenance page could not be loaded to resolve it. The app will close now. Please reinstall if this issue persists. | 检测到安装错误，且无法加载维护页面来解决问题。应用现在将关闭。如果问题持续，请重新安装。 | ### 8. 环境错误 (src/main-process/appWindow.ts:283-290) | 英文原文 | 建议中文翻译 | |---------|------------| | Invalid Environment | 无效的环境 | | Unknown error whilst attempting to determine user data folder. | 尝试确定用户数据文件夹时发生未知错误。 | ### 9. 配置删除错误 (src/store/desktopConfig.ts:147-157) | 英文原文 | 建议中文翻译 | |---------|------------| | Delete Failed | 删除失败 | | Unknown error whilst attempting to delete config file:\n\n{configFilePath} | 尝试删除配置文件时发生未知错误：\n\n{configFilePath} | | User Data | 用户数据 | | Unknown error whilst attempting to determine user data folder. | 尝试确定用户数据文件夹时发生未知错误。 | ### 10. 验证和迁移错误 (src/install/installationManager.ts) | 英文原文 | 建议中文翻译 | |---------|------------| | Validation error: {error} | 验证错误：{error} | | Failed to migrate custom nodes | 迁移自定义节点失败 | | Unknown error occurred | 发生未知错误 | ### 11. 配置存储相关 (src/store/desktopConfig.ts:119-131) 需要检查这些对话框中的按钮文本和消息文本是否已包含在上述分类中。 --- 建议开发者在实现本地化时，使用 IDE 的全局搜索功能，搜索所有 dialog.showMessageBox、dialog.showErrorBox、 itle:、message:、label: 等关键词，确保不遗漏任何用户可见的英文文本。

bsakaguchi commented

2026-10-31 22:13:56 +00:00

Author

Owner

@ghost commented on GitHub (May 4, 2026):

补充信息：

当前版本：ComfyUI Desktop v0.8.36

Prerequisites（已确认）：

我已搜索现有 issues，确认此功能未被重复请求
我已阅读文档，确认此功能当前不可用
这是单一功能请求（非多个功能组合）

@ghost commented on GitHub (May 4, 2026): **补充信息：** 当前版本：ComfyUI Desktop v0.8.36 **Prerequisites（已确认）：** - [x] 我已搜索现有 issues，确认此功能未被重复请求 - [x] 我已阅读文档，确认此功能当前不可用 - [x] 这是单一功能请求（非多个功能组合）

bsakaguchi commented

2026-10-31 22:13:56 +00:00

Author

Owner

@ghost commented on GitHub (May 4, 2026):

Closed. English version available at #1706

@ghost commented on GitHub (May 4, 2026): Closed. English version available at #1706

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

Comfy-Org/desktop#511

No description provided.

Rows
Columns