claude-localize
Installation
SKILL.md
Claude Desktop 中文汉化 (claude-localize)
把本机安装的 Claude Desktop 桌面客户端汉化为简体中文,并可随时恢复英文原版。
核心理念是自适应。 Claude Desktop 更新非常频繁,写死路径和正则的工具每次更新都会失效。本 skill 改为运行时探测:先读当前安装版本的 i18n 目录结构、语言加载机制和翻译覆盖率,再决定怎么打补丁。所以即使 Claude 改了内部结构,你(运行本 skill 的 Claude)也能现场判断、调整,而不是盲目套用旧步骤。
目前实现:macOS。Windows 见 references/windows.md(规划中)。
它怎么工作(为什么这么做)
Claude Desktop 的界面文案分两层:
- 前端 UI(Electron 渲染层):文案在
Contents/Resources/ion-dist/i18n/{locale}.json,key 是英文原文的哈希。运行时按当前 locale 动态加载对应文件。因为 key 是内容哈希,所以只要英文原文没变,旧译文就还能对上——这让"内置精校译文 + 只翻新增"成为可能。 - 桌面/原生层(菜单、托盘、原生弹窗):在
Contents/Resources/{locale}.json和{locale}.lproj/Localizable.strings。
汉化的关键有三点(细节见 references/mechanism.md):
- 把中文译文写进 app 真正加载的 locale 文件。 实际生效的 locale 由账号/服务端决定(登录英文账号时常是
en-US),而且 app 会把它回写进config.json——所以光设config.locale=zh-CN不管用、会被覆盖。因此本 skill 直接覆盖en-US.json(以及zh-CN.json/zh.json),未译 key 仍回退英文;原始英文存为en-US.original.json以备恢复与重复打补丁。 - 必须开启 Claude 的开发者模式(Settings → Developer)。否则 app 可能加载远程 claude.ai 网页版,本地译文文件根本不会被读取。
- 桌面/原生层:写
Contents/Resources/zh-CN.json和.lproj/Localizable.strings。