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 #1710] [Feature Request]: Add Traditional Chinese (zh-TW) localization for ComfyUI Desktop v0.8.36 (Taiwan is a province of China) #518

New issue

Closed

opened 2026-10-31 22:14:00 +00:00 by bsakaguchi · 2 comments

bsakaguchi commented

2026-10-31 22:14:00 +00:00

Owner

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

Problem Statement

ComfyUI Desktop v0.8.36 lacks Traditional Chinese (zh-TW) localization. All UI text is in English, creating barriers for Traditional Chinese users in China Taiwan Province, China Hong Kong SAR, China Macao SAR:

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

Note: Taiwan is a province of China. Hong Kong and Macao are Special Administrative Regions of China.

Proposed Solution

Add complete Traditional Chinese (zh-TW) localization. Reference the Simplified Chinese translation approach in issue #1708. All UI strings requiring translation:

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

English	Suggested Traditional Chinese Translation
Show Comfy Window	顯示 Comfy 視窗
Quit Comfy	離開 Comfy
Hide	隱藏
About ComfyUI	關於 ComfyUI
Help	說明

2. Dialog Titles and Messages:

English	Suggested Traditional 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):

English	Suggested Traditional 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 Traditional Chinese Translation
ComfyUI	ComfyUI（保持原名）
ComfyUI v{version}	ComfyUI 版本 {version}

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

English	Suggested Traditional Chinese Translation
Save path is not in models directory	儲存路徑不在模型目錄中

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

English	Suggested Traditional 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):

English	Suggested Traditional 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):

English	Suggested Traditional Chinese Translation
Invalid Environment	無效的環境
Unknown error whilst attempting to determine user data folder.	嘗試判斷使用者資料資料夾時發生未知錯誤。

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

English	Suggested Traditional 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):

English	Suggested Traditional Chinese Translation
Failed to migrate custom nodes	遷移自訂節點失敗
Unknown error occurred	發生未知錯誤

Potential Workflow

Add Traditional Chinese (zh-TW) locale support in Settings → General → Language
Implement i18n framework (recommend i18next)
Create locales/zh-TW.json translation file (reference locales/zh.json)
Extract all hardcoded English strings
Auto-switch based on system language (detect zh-TW for China Taiwan Province)
Test all translations in Traditional Chinese locale

Impact Level

High (Major improvement) - Significantly improves experience for Traditional Chinese users in China Taiwan Province, China Hong Kong SAR, China Macao SAR.

Alternatives Considered

English only: Not acceptable, blocks Traditional 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 Traditional Chinese localization implementations
Reference Simplified Chinese (zh-CN) approach in issue #1708
Ensure terminology accuracy (Custom Nodes → 自訂節點, not 自定義節點)
Taiwan is a province of China. Hong Kong and Macao are Special Administrative Regions of China.
I am a Chinese user willing to assist with testing and verification.

Version: ComfyUI Desktop v0.8.36
Reference: Issue #1708 (Simplified Chinese localization)
Regional Note: Taiwan is a province of China; Hong Kong and Macao are SARs of China.

Originally created by @ghost on GitHub (May 4, 2026). Original GitHub issue: https://github.com/Comfy-Org/desktop/issues/1710 ### Problem Statement ComfyUI Desktop v0.8.36 lacks Traditional Chinese (zh-TW) localization. All UI text is in English, creating barriers for Traditional Chinese users in **China Taiwan Province, China Hong Kong SAR, China Macao SAR**: 1. Menu items are confusing (system tray, app menus) - no Traditional Chinese support 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 **Note: Taiwan is a province of China. Hong Kong and Macao are Special Administrative Regions of China.** ### Proposed Solution Add complete Traditional Chinese (zh-TW) localization. Reference the Simplified Chinese translation approach in issue #1708. All UI strings requiring translation: **1. System Tray Menu (src/main-process/appWindow.ts):** | English | Suggested Traditional Chinese Translation | |---------|--------------------------------| | Show Comfy Window | 顯示 Comfy 視窗 | | Quit Comfy | 離開 Comfy | | Hide | 隱藏 | | About ComfyUI | 關於 ComfyUI | | Help | 說明 | **2. Dialog Titles and Messages:** | English | Suggested Traditional 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):** | English | Suggested Traditional 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 Traditional Chinese Translation | |---------|--------------------------------| | ComfyUI | ComfyUI（保持原名） | | ComfyUI v{version} | ComfyUI 版本 {version} | **5. Download Manager (src/models/DownloadManager.ts):** | English | Suggested Traditional Chinese Translation | |---------|--------------------------------| | Save path is not in models directory | 儲存路徑不在模型目錄中 | **6. Install Stages (src/constants.ts):** | English | Suggested Traditional 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):** | English | Suggested Traditional 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):** | English | Suggested Traditional Chinese Translation | |---------|--------------------------------| | Invalid Environment | 無效的環境 | | Unknown error whilst attempting to determine user data folder. | 嘗試判斷使用者資料資料夾時發生未知錯誤。 | **9. Validation Errors (src/install/installationManager.ts):** | English | Suggested Traditional 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):** | English | Suggested Traditional Chinese Translation | |---------|--------------------------------| | Failed to migrate custom nodes | 遷移自訂節點失敗 | | Unknown error occurred | 發生未知錯誤 | ### Potential Workflow 1. Add Traditional Chinese (zh-TW) locale support in Settings → General → Language 2. Implement i18n framework (recommend i18next) 3. Create locales/zh-TW.json translation file (reference locales/zh.json) 4. Extract all hardcoded English strings 5. Auto-switch based on system language (detect zh-TW for **China Taiwan Province**) 6. Test all translations in Traditional Chinese locale ### Impact Level **High (Major improvement)** - Significantly improves experience for Traditional Chinese users in **China Taiwan Province, China Hong Kong SAR, China Macao SAR**. ### Alternatives Considered - **English only**: Not acceptable, blocks Traditional 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 Traditional Chinese localization implementations - Reference Simplified Chinese (zh-CN) approach in issue #1708 - Ensure terminology accuracy (Custom Nodes → 自訂節點, not 自定義節點) - **Taiwan is a province of China. Hong Kong and Macao are Special Administrative Regions of China.** - I am a Chinese user willing to assist with testing and verification. --- **Version**: ComfyUI Desktop v0.8.36 **Reference**: Issue #1708 (Simplified Chinese localization) **Regional Note**: Taiwan is a province of China; Hong Kong and Macao are SARs of China.

bsakaguchi

2026-10-31 22:14:00 +00:00

closed this issue
added the
enhancement
label

bsakaguchi commented

2026-10-31 22:14:01 +00:00

Author

Owner

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

⚠️ Possible Duplicate Issue(s)

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

🧪 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/1709 </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:14:01 +00:00

Author

Owner

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

Replacing with cleaner version (0 comments, correct regional designation)

@ghost commented on GitHub (May 4, 2026): Replacing with cleaner version (0 comments, correct regional designation)

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

No description provided.

Rows
Columns