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 #1708] [Feature Request]: Add Chinese (Simplified) localization for ComfyUI Desktop v0.8.36 #515

New issue

Closed

opened 2026-10-31 22:13:57 +00:00 by bsakaguchi · 1 comment

bsakaguchi commented

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

Owner

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

Problem Statement

ComfyUI Desktop v0.8.36 lacks Chinese (Simplified) localization. All UI text is English, creating barriers for Chinese users:

Menu items are confusing (system tray, app menus)
Error messages during installation/config are incomprehensible
Migration interface descriptions are difficult to understand
Dialog boxes (confirmation, error) are all in English

Proposed Solution

Add complete Chinese (Simplified) localization. All UI strings requiring translation:

1. System Tray Menu (src/main-process/appWindow.ts):

English	Suggested Chinese Translation
Show Comfy Window	显示 Comfy 窗口
Quit Comfy	退出 Comfy
Hide	隐藏
About ComfyUI	关于 ComfyUI
Help	帮助

2. Dialog Titles and Messages:

English	Suggested Chinese Translation	Location
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. Migration Interface (src/constants.ts - MigrationItems):

English	Suggested Chinese Translation
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. About Dialog (src/main-process/appWindow.ts):

English	Suggested Chinese Translation
ComfyUI	ComfyUI（保持原名）
ComfyUI v{version}	ComfyUI 版本 {version}

5. Download Manager (src/models/DownloadManager.ts):

English	Suggested Chinese Translation
Save path is not in models directory	保存路径不在模型目录中

6. Install Stages (src/constants.ts - InstallStage):

English	Suggested Chinese Translation
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	错误

7. Configuration Errors (src/store/desktopConfig.ts:147-157):

English	Suggested Chinese Translation
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.	尝试确定用户数据文件夹时发生未知错误。

8. Environment Errors (src/main-process/appWindow.ts:283-290):

English	Suggested Chinese Translation
Invalid Environment	无效的环境
Unknown error whilst attempting to determine user data folder.	尝试确定用户数据文件夹时发生未知错误。

9. Validation Errors (src/install/installationManager.ts:123-127):

English	Suggested Chinese Translation
Validation error: ${error}	验证错误：${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.	检测到安装错误，且无法加载维护页面来解决问题。应用现在将关闭。如果问题持续，请重新安装。

10. Custom Node Migration Errors (src/install/installationManager.ts:317):

English	Suggested Chinese Translation
Failed to migrate custom nodes	迁移自定义节点失败
Unknown error occurred	发生未知错误

Potential Workflow

Add language selection in Settings → General → Language
Implement i18n framework (recommend i18next)
Create locales/zh-CN.json translation file
Extract all hardcoded English strings
Auto-switch based on system language
Test all translations

Impact Level

High (Major improvement) - Significantly improves experience for Chinese users.

Alternatives Considered

English only: Not acceptable, blocks Chinese user adoption
Browser translation plugins: Poor experience, cannot translate system menus/dialogs
Third-party localization: Hard to maintain, may conflict with updates

Additional Information

Reference VS Code/Discord localization implementations
Ensure terminology accuracy (Custom Nodes → 自定义节点)
Consider supporting Traditional Chinese (zh-TW)
Reference ComfyUI Web localization approach

I am a Chinese user willing to assist with testing and verification.

┆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/1708 ### Problem Statement ComfyUI Desktop v0.8.36 lacks Chinese (Simplified) localization. All UI text is English, creating barriers for Chinese users: 1. Menu items are confusing (system tray, app menus) 2. Error messages during installation/config are incomprehensible 3. Migration interface descriptions are difficult to understand 4. Dialog boxes (confirmation, error) are all in English ### Proposed Solution Add complete Chinese (Simplified) localization. All UI strings requiring translation: **1. System Tray Menu (src/main-process/appWindow.ts):** | English | Suggested Chinese Translation | |---------|-------------------------------| | Show Comfy Window | 显示 Comfy 窗口 | | Quit Comfy | 退出 Comfy | | Hide | 隐藏 | | About ComfyUI | 关于 ComfyUI | | Help | 帮助 | **2. Dialog Titles and Messages:** | English | Suggested Chinese Translation | Location | |---------|-------------------------------|----------| | 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. Migration Interface (src/constants.ts - MigrationItems):** | English | Suggested Chinese Translation | |---------|-------------------------------| | 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. About Dialog (src/main-process/appWindow.ts):** | English | Suggested Chinese Translation | |---------|-------------------------------| | ComfyUI | ComfyUI（保持原名） | | ComfyUI v{version} | ComfyUI 版本 {version} | **5. Download Manager (src/models/DownloadManager.ts):** | English | Suggested Chinese Translation | |---------|-------------------------------| | Save path is not in models directory | 保存路径不在模型目录中 | **6. Install Stages (src/constants.ts - InstallStage):** | English | Suggested Chinese Translation | |---------|-------------------------------| | 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 | 错误 | **7. Configuration Errors (src/store/desktopConfig.ts:147-157):** | English | Suggested Chinese Translation | |---------|-------------------------------| | 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. | 尝试确定用户数据文件夹时发生未知错误。 | **8. Environment Errors (src/main-process/appWindow.ts:283-290):** | English | Suggested Chinese Translation | |---------|-------------------------------| | Invalid Environment | 无效的环境 | | Unknown error whilst attempting to determine user data folder. | 尝试确定用户数据文件夹时发生未知错误。 | **9. Validation Errors (src/install/installationManager.ts:123-127):** | English | Suggested Chinese Translation | |---------|-------------------------------| | Validation error: ${error} | 验证错误：${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. | 检测到安装错误，且无法加载维护页面来解决问题。应用现在将关闭。如果问题持续，请重新安装。 | **10. Custom Node Migration Errors (src/install/installationManager.ts:317):** | English | Suggested Chinese Translation | |---------|-------------------------------| | Failed to migrate custom nodes | 迁移自定义节点失败 | | Unknown error occurred | 发生未知错误 | ### Potential Workflow 1. Add language selection in Settings → General → Language 2. Implement i18n framework (recommend i18next) 3. Create locales/zh-CN.json translation file 4. Extract all hardcoded English strings 5. Auto-switch based on system language 6. Test all translations ### Impact Level **High (Major improvement)** - Significantly improves experience for Chinese users. ### Alternatives Considered - **English only**: Not acceptable, blocks Chinese user adoption - **Browser translation plugins**: Poor experience, cannot translate system menus/dialogs - **Third-party localization**: Hard to maintain, may conflict with updates ### Additional Information - Reference VS Code/Discord localization implementations - Ensure terminology accuracy (Custom Nodes → 自定义节点) - Consider supporting Traditional Chinese (zh-TW) - Reference ComfyUI Web localization approach --- I am a Chinese user willing to assist with testing and verification. ┆Issue is synchronized with this [Notion page](https://www.notion.so/Issue-1708-Feature-Request-Add-Chinese-Simplified-localization-for-ComfyUI-Desktop-v0-8-36-3566d73d3650811da6c7ea268fa32bc4) by [Unito](https://www.unito.io)

bsakaguchi

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

closed this issue
added the
enhancement
label

bsakaguchi commented

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

Author

Owner

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

Chinese localization has been implemented in ComfyUI_frontend (PR #11930 was merged). The zh-CN locale files are now fully translated. Please update to the latest version to see the changes.

@ghost commented on GitHub (May 5, 2026): Chinese localization has been implemented in ComfyUI_frontend (PR #11930 was merged). The zh-CN locale files are now fully translated. Please update to the latest version to see the changes.

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#515

No description provided.

Rows
Columns