Skip to content

Repository files navigation

Claude Desktop 简体中文汉化补丁

一键将 Claude Desktop Windows 版界面汉化为简体中文。新版脚本会自动发现当前安装的 Claude Desktop 版本,扫描资源文件并应用稳定补丁,不再依赖固定版本号或 JS 文件名哈希。

使用方法

  1. 完全退出 Claude Desktop(包括系统托盘里的 Claude)。
  2. 可先运行 兼容性检测.bat,确认当前 Claude 版本的资源结构和关键补丁是否可用。
  3. 右键 汉化应用.bat,选择以管理员身份运行。
  4. 重新打开 Claude Desktop,在设置里选择中文。

需要恢复英文界面时,右键 汉化回滚.bat 并以管理员身份运行。

版本自适应

脚本会扫描 C:\Program Files\WindowsApps\Claude_*,选择包含 app\resources\app.asarion-dist\i18nion-dist\assets\v1 的最新安装版本。也可以在 config.jsoninstallDiscovery.manualInstallRoot 中手动指定 app\resources 目录。

Runtime 补丁来自 patches/main-ui-patches.json。补丁规则只包含稳定的 find / replace 文本,不要求指定 bundle 文件名;应用时会遍历所有 JS/CSS 资源并报告命中、已应用和未命中数量。关键补丁未命中时脚本会停止并提示需要维护,避免静默写坏未知版本。

额外的可见界面文案翻译来自 locales/runtime-zh-CN.translations.json。脚本会把这个人工确认的翻译表自动转换成 defaultMessagelabeltitleplaceholder 等运行时补丁,用来覆盖设置页、按钮、提示、侧边栏等没有进入官方 locale 文件的英文。

缺失汉化清单

还有英文残留时,运行:

powershell -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\scripts\scan_missing.ps1

它会生成 locales\missing-zh-CN.json 缺失汉化清单,列出可见英文候选、来源文件和待填写的 translation 字段。确认翻译后,优先把稳定条目整理进 locales/runtime-zh-CN.translations.json;只有需要特殊精确匹配时,再放进 patches/main-ui-patches.json

常用脚本

  • scripts/detect_install.ps1:检测当前 Claude Desktop 版本和资源路径。
  • scripts/diagnose_compatibility.ps1:生成兼容性报告,判断当前版本是否建议应用。
  • scripts/apply_localization.ps1:备份、复制中文资源、应用 runtime 补丁并生成兼容报告。
  • scripts/verify_localization.ps1:验证关键补丁是否命中或已应用。
  • scripts/rollback_localization.ps1:按最近一次备份回滚。
  • scripts/scan_missing.ps1:生成缺失汉化清单。

安全策略

应用前会备份原始 locale、JS/CSS 和对应 .zst 文件。对被修改的 JS/CSS,如果存在 .zst 缓存,脚本会改名为 .bak,让 Claude 加载明文补丁文件;回滚脚本会恢复最近一次备份。

About

Claude Desktop Windows 版简体中文汉化补丁

Resources

Stars

56 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages