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

New issue

Closed

opened 2026-10-31 22:13:55 +00:00 by bsakaguchi · 2 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/1706

Problem Statement

ComfyUI Desktop currently lacks Chinese (Simplified) localization support. All UI text is in English, which creates significant barriers for Chinese users:

Menu items are confusing - System tray menu and application menus are all in English
Error messages are incomprehensible - Error prompts during installation and configuration are in English
Migration interface is unclear - Descriptions during first-time setup are difficult to understand
Dialog boxes are cryptic - Various confirmation and error dialogs are in English

Proposed Solution

Add complete Chinese (Simplified) localization support. Below are all UI texts that need translation with suggested accurate translations:

English	Suggested Chinese Translation	Notes
Show Comfy Window	显示 Comfy 窗口	Clearly indicates function
Quit Comfy	退出 Comfy	Standard exit terminology
Hide	隐藏	Standard menu item
About ComfyUI	关于 ComfyUI	Standard about dialog
Help	帮助	Standard menu item

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	Notes
User Files	用户文件	Label
Settings and user-created workflows	设置和用户创建的工作流	Description
Models	模型	Label
Reference model files from existing ComfyUI installations. (No copy)	引用现有 ComfyUI 安装中的模型文件（不复制）	Description, clarify no copying
Custom Nodes	自定义节点	Label
Reinstall custom nodes from existing ComfyUI installations.	从现有 ComfyUI 安装中重新安装自定义节点。	Description

4. About Dialog (src/main-process/appWindow.ts)

English	Suggested Chinese Translation
ComfyUI	ComfyUI (keep original)
ComfyUI v{version}	ComfyUI 版本 {version}

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

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

6. Installation Stage Texts (src/constants.ts - InstallStage)

These texts appear during installation and need translation:

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	错误

Potential workflow

Add language selection in settings (Settings → General → Language)
Implement i18n localization framework (recommend i18next or similar)
Create locales/zh-CN.json translation file
Extract all hardcoded English strings to translation files
Auto-switch language based on system language or user preference
Test all translated texts for display issues

Impact Level

High (Major improvement) - This will significantly improve the experience for Chinese users and lower the usage barrier.

Alternatives Considered

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

Additional information

Reference other Electron apps' localization implementations (VS Code, Discord)
Ensure technical terminology accuracy (e.g., "Custom Nodes" → "自定义节点" not "自定义结点")
Consider supporting Traditional Chinese (zh-TW) for different regions
Reference ComfyUI Web version's localization approach

I am a Chinese user and 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/1706 ## Problem Statement ComfyUI Desktop currently lacks Chinese (Simplified) localization support. All UI text is in English, which creates significant barriers for Chinese users: 1. **Menu items are confusing** - System tray menu and application menus are all in English 2. **Error messages are incomprehensible** - Error prompts during installation and configuration are in English 3. **Migration interface is unclear** - Descriptions during first-time setup are difficult to understand 4. **Dialog boxes are cryptic** - Various confirmation and error dialogs are in English ## Proposed Solution Add complete Chinese (Simplified) localization support. Below are all UI texts that need translation with suggested accurate translations: ### 1. System Tray Menu (src/main-process/appWindow.ts) | English | Suggested Chinese Translation | Notes | |---------|-------------------------------|-------| | Show Comfy Window | 显示 Comfy 窗口 | Clearly indicates function | | Quit Comfy | 退出 Comfy | Standard exit terminology | | Hide | 隐藏 | Standard menu item | | About ComfyUI | 关于 ComfyUI | Standard about dialog | | Help | 帮助 | Standard menu item | ### 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 | Notes | |---------|-------------------------------|-------| | User Files | 用户文件 | Label | | Settings and user-created workflows | 设置和用户创建的工作流 | Description | | Models | 模型 | Label | | Reference model files from existing ComfyUI installations. (No copy) | 引用现有 ComfyUI 安装中的模型文件（不复制） | Description, clarify no copying | | Custom Nodes | 自定义节点 | Label | | Reinstall custom nodes from existing ComfyUI installations. | 从现有 ComfyUI 安装中重新安装自定义节点。 | Description | ### 4. About Dialog (src/main-process/appWindow.ts) | English | Suggested Chinese Translation | |---------|-------------------------------| | ComfyUI | ComfyUI (keep original) | | ComfyUI v{version} | ComfyUI 版本 {version} | ### 5. Download Manager (src/models/DownloadManager.ts) | English | Suggested Chinese Translation | |---------|-------------------------------| | Save path is not in models directory | 保存路径不在模型目录中 | ### 6. Installation Stage Texts (src/constants.ts - InstallStage) These texts appear during installation and need translation: | 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 | 错误 | ## Potential workflow 1. Add language selection in settings (Settings → General → Language) 2. Implement i18n localization framework (recommend i18next or similar) 3. Create `locales/zh-CN.json` translation file 4. Extract all hardcoded English strings to translation files 5. Auto-switch language based on system language or user preference 6. Test all translated texts for display issues ## Impact Level **High (Major improvement)** - This will significantly improve the experience for Chinese users and lower the usage barrier. ## Alternatives Considered - **Keep English only**: Not acceptable, blocks Chinese user adoption - **Browser translation plugins**: Poor experience, cannot translate system menus and dialogs - **Third-party localization packs**: Hard to maintain, may conflict with updates ## Additional information - Reference other Electron apps' localization implementations (VS Code, Discord) - Ensure technical terminology accuracy (e.g., "Custom Nodes" → "自定义节点" not "自定义结点") - Consider supporting Traditional Chinese (zh-TW) for different regions - Reference ComfyUI Web version's localization approach --- I am a Chinese user and willing to assist with testing and verification. ┆Issue is synchronized with this [Notion page](https://www.notion.so/Issue-1706-Feature-Request-Add-Chinese-Simplified-localization-support-for-ComfyUI-Desktop-v-3566d73d365081e289b3dfffe51787f3) 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

@coderabbitai[bot] commented on GitHub (May 4, 2026):

⚠️ Possible Duplicate Issue(s)

https://github.com/Comfy-Org/desktop/issues/1705

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

@coderabbitai[bot] commented on GitHub (May 4, 2026):  <details> <summary>⚠️ Possible Duplicate Issue(s)</summary> - https://github.com/Comfy-Org/desktop/issues/1705 </details> --- <details> <summary> 🧪 Issue enrichment is currently in open beta.</summary> You can configure auto-planning by selecting labels in the issue_enrichment configuration. To disable automatic issue enrichment, add the following to your `.coderabbit.yaml`: ```yaml issue_enrichment: auto_enrich: enabled: false ``` </details> 💬 Have feedback or questions? Drop into our [discord](https://discord.gg/coderabbit)!

bsakaguchi commented

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

Author

Owner

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

Replaced by new issue

@ghost commented on GitHub (May 4, 2026): Replaced by new issue

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

No description provided.

Rows
Columns