[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-1324":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":9,"pushedAt":9,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":15,"starSnapshotCount":15,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},1324,"claude-desktop_win-zh_cn","Jyy1529\u002Fclaude-desktop_win-zh_cn","Jyy1529","Claude Desktop Windows 中文补丁 (zh-CN) - 12700+ keys 翻译 + JS chunk UI 标签汉化。安装python,以管理员身份启动claude-zh-cn.bat",null,"Python",553,46,1,13,0,21,50,211,63,9.02,"MIT License",false,"master",true,[],"2026-06-12 02:00:26","# Claude Desktop 中文资源与 Windows 补丁（zh-CN）\n\n一个面向 Windows 版 Claude Desktop 的中文资源维护项目。\n\n## 效果展示\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\">\u003Cb>Cowork 面板\u003C\u002Fb>\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003Cb>设置页面\u003C\u002Fb>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cimg src=\"README.assets\u002Fscreenshot-cowork.png\" alt=\"主界面\" width=\"400\"\u002F>\u003C\u002Ftd>\n\u003Ctd>\u003Cimg src=\"README.assets\u002Fscreenshot-settings.png\" alt=\"设置页面\" width=\"400\"\u002F>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd align=\"center\">\u003Cb>第三方推理配置\u003C\u002Fb>\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003Cb>Code 面板\u003C\u002Fb>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Cimg src=\"README.assets\u002Fscreenshot-3p.png\" alt=\"第三方推理配置\" width=\"400\"\u002F>\u003C\u002Ftd>\n\u003Ctd>\u003Cimg src=\"README.assets\u002Fscreenshot-code.png\" alt=\"Cowork 面板\" width=\"400\"\u002F>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\n> 截图对应 Claude Desktop v1.3883.0.0 + 本项目补丁。实际界面可能因版本更新略有差异。\n\n## 快速开始\n\n以管理员身份运行 PowerShell，进入项目目录后执行：\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\claude-zh-cn.ps1\n```\n\n会出现交互式菜单，包含：安装、卸载、状态检查。按提示选择即可。\n\n脚本会自动检测 Claude 安装路径，不需要手动填版本号。\n\n如果你更喜欢直接运行单独的脚本：\n\n```powershell\n# 安装\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\install-windowsapps-json-only.ps1\n\n# 卸载 \u002F 恢复英文\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\restore-windowsapps-zh-cn.ps1\n```\n\n## 仓库结构\n\n```\n.\n├── claude-zh-cn.ps1                   # 交互式安装\u002F卸载菜单（推荐入口）\n├── resources\u002F\n│   ├── desktop-zh-CN.json             # 桌面壳层翻译 355 keys\n│   ├── frontend-zh-CN.json            # 前端界面翻译 12326 keys\n│   └── statsig-zh-CN.json             # Statsig 功能描述翻译 46 keys\n├── tools\u002F\n│   ├── validate_resources.py          # 资源 JSON 合法性校验\n│   └── check_i18n_coverage.py         # 疑似未翻译条目检测\n├── patch_windowsapps_json_only.py     # patch 脚本\n├── install-windowsapps-json-only.ps1  # 安装入口（单独使用）\n├── restore_claude_zh_cn_windowsapps.py # 恢复脚本\n├── restore-windowsapps-zh-cn.ps1      # 恢复入口（单独使用）\n├── README.md\n├── CHANGELOG.md\n└── LICENSE.md\n```\n\n## 翻译覆盖率\n\n| 资源文件 | 英文 keys | 中文 keys | 覆盖率 |\n|----------|-----------|-----------|--------|\n| desktop-zh-CN.json | 355 | 355 | 100% |\n| frontend-zh-CN.json | 12325 | 12326 | 100% |\n| statsig-zh-CN.json | 46 | 46 | 100% |\n\n所有可翻译条目均已汉化。品牌名（Claude、Anthropic、Google 等）和格式占位符按惯例保留英文。\n\n## 当前主线\n\n推荐优先使用这两部分内容：\n\n- `resources\u002Fdesktop-zh-CN.json`\n- `resources\u002Ffrontend-zh-CN.json`\n- `resources\u002Fstatsig-zh-CN.json`\n- `tools\u002Fvalidate_resources.py`\n- `tools\u002Fcheck_i18n_coverage.py`\n- `patch_windowsapps_json_only.py`\n- `install-windowsapps-json-only.ps1`\n\n不再推荐作为主线使用的内容：\n\n- 导出副本补丁脚本\n- `patch_claude_zh_cn_windowsapps.py`\n- `install-windowsapps-zh-cn.ps1`\n- `patch_nav_chunk_labels.py`\n- `patch_nav_all_chunks.py`\n- `patch_3p_chunk_labels.py`\n\n这些内容会继续保留在仓库中，作为历史实验和排查记录。\n\n## 项目目标\n\n- 为 Windows 版 Claude Desktop 提供可用的 `zh-CN` 中文界面。\n- 尽量复用现有中文翻译资源，并随上游英文资源变化进行兼容合并。\n- 把主线影响范围限制在语言资源层。\n- 不再以 `Configure Third-Party Inference` 的可用性\u002F汉化为目标。\n\n## 当前建议使用方式\n\n如果你只是要维护翻译资源或给普通界面打补丁，优先走下面这条：\n\n1. 修改 `resources\u002F` 下的翻译文件\n2. 运行资源校验脚本\n3. 使用 `install-windowsapps-json-only.ps1`\n4. 只验证普通界面、设置页和常规文案\n\n不要把下面这些页面当作当前主线验证目标：\n\n- `Configure Third-Party Inference`\n- 其它 3P 专属页面\n- 依赖运行时 chunk 的实验性菜单项\n\n## JSON-only 官方包补丁\n\n当前仓库中，面向官方包的主线脚本是：\n\n```text\npatch_windowsapps_json_only.py\ninstall-windowsapps-json-only.ps1\nrestore-windowsapps-zh-cn.ps1\n```\n\n这条路径只会写入：\n\n- `resources\\zh-CN.json`\n- `resources\\ion-dist\\i18n\\zh-CN.json`\n- `resources\\ion-dist\\i18n\\statsig\\zh-CN.json`\n\n它不会再主动做这些事：\n\n- patch 3P chunk\n- patch 导航 chunk\n- 修改运行时 bundle 结构\n- 把 `Configure Third-Party Inference` 作为兼容目标\n\n## 说明\n\n下面这部分内容对应的是早期的“导出副本补丁”路线。\n\n⚠️ 以下内容仅作为历史记录保留，不代表当前仓库主线实现。\n\n当前仓库主线已经切换为：直接对已安装的 Claude Desktop 资源目录执行 JSON + chunk 补丁，并配套恢复脚本，而不是导出一份可执行副本。\n\n它现在只作为历史记录保留：\n\n- 不再是仓库主线\n- 不建议新使用者优先采用\n- 主要用于回看之前的实现方式和兼容性排查\n\n## 功能特点\n\n- 一键导出 Windows 版 Claude Desktop 的中文补丁副本。\n- 自动给前端语言白名单加入 `zh-CN`。\n- 自动合并当前 Claude 版本的英文前端语言文件与随包中文翻译。\n- 新版本新增但暂未翻译的字段会保留英文，避免界面缺失文本。\n- 不直接修改官方 `WindowsApps` 安装目录。\n- 支持两种运行模式：\n  - 保留 `locale`\n  - 不保留 `locale`\n- 两种运行模式都会继续使用原版 Claude 的用户数据目录，避免切换到一套新的空配置。\n\n## 适用环境\n\n- Windows\n- 已安装 Microsoft Store \u002F Appx 版 Claude Desktop\n- 已安装 Python 3\n\n## 设计原则\n\n- 不直接替换官方安装包。\n- 不依赖修改 `WindowsApps` 目录权限。\n- 安装结果固定输出到用户本地目录，便于更新和删除。\n- 启动时继续使用原版 Claude 的用户数据目录，减少对其它配置的扰动。\n\n## 安装结果\n\n安装完成后，补丁副本会生成到：\n\n```text\nC:\\Users\\\u003Cyour-user>\\AppData\\Local\\Claude-zh-CN\n```\n\n其中包含：\n\n- `app\\`：补丁后的可运行副本\n- `run-windows-zh-cn-keep-locale.ps1\u002F.bat`\n- `run-windows-zh-cn-no-locale.ps1\u002F.bat`\n- `uninstall-windows-zh-cn.ps1\u002F.bat`\n- `README.md`\n\n安装脚本执行完成后，固定安装目录中会自动生成对应的卸载器，无需手动复制。\n\n## 目录结构\n\n仓库目录：\n\n```text\n.\n├─ install-windows-zh-cn.ps1\n├─ patch_claude_zh_cn_windows.py\n├─ resources\u002F\n│  ├─ desktop-zh-CN.json\n│  ├─ frontend-zh-CN.json\n│  ├─ statsig-zh-CN.json\n│  └─ Localizable.strings\n└─ README.md\n```\n\n安装后目录：\n\n```text\nC:\\Users\\\u003Cyour-user>\\AppData\\Local\\Claude-zh-CN\n├─ app\u002F\n├─ run-windows-zh-cn-keep-locale.bat\n├─ run-windows-zh-cn-keep-locale.ps1\n├─ run-windows-zh-cn-no-locale.bat\n├─ run-windows-zh-cn-no-locale.ps1\n└─ README.md\n```\n\n## 使用方式\n\n在当前目录运行：\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\install-windows-zh-cn.ps1\n```\n\n安装完成后，到下面目录启动：\n\n```text\nC:\\Users\\\u003Cyour-user>\\AppData\\Local\\Claude-zh-CN\n```\n\n### 方式 1：保留 locale\n\n```text\nrun-windows-zh-cn-keep-locale.bat\n```\n\n或\n\n```text\nrun-windows-zh-cn-keep-locale.ps1\n```\n\n这个模式会在启动前把原配置里的 `locale` 设为 `zh-CN`。\n\n### 方式 2：不保留 locale\n\n```text\nrun-windows-zh-cn-no-locale.bat\n```\n\n或\n\n```text\nrun-windows-zh-cn-no-locale.ps1\n```\n\n这个模式会在启动前从原配置里移除 `locale`。\n\n## 两种模式的区别\n\n### 保留 `locale`\n\n- 启动前把原配置中的 `locale` 设为 `zh-CN`\n- 更适合希望稳定使用中文界面的场景\n- 属于语言相关配置，不会主动改动第三方推理等其它业务配置\n\n### 不保留 `locale`\n\n- 启动前从原配置中移除 `locale`\n- 更适合测试“只注入语言资源，不显式指定语言”时的行为\n- 如果上游程序未自动切换到 `zh-CN`，则可能回退到英文\n\n## 脚本会做什么\n\n安装脚本会：\n\n1. 识别本机已安装的 Claude 包。\n2. 把官方包中的 `app` 目录复制到固定安装目录。\n3. 写入中文桌面层资源 `resources\\zh-CN.json`。\n4. 合并前端 `ion-dist\\i18n\\zh-CN.json`。\n5. 写入 `statsig\\zh-CN.json`。\n6. 修补前端语言白名单，加入 `zh-CN`。\n7. 生成两套启动器到固定安装目录。\n\n## 不会做什么\n\n- 不会直接修改 `C:\\Program Files\\WindowsApps` 中的官方安装目录。\n- 不会替换你原版 Claude 的可执行文件。\n- 安装脚本默认不会强制写入 `locale`。\n- 不会自动迁移一整套新的用户数据目录。\n\n## 关于配置目录\n\n补丁副本运行时不会使用一套新的空配置，而是继续使用原版 Claude 的用户数据目录：\n\n```text\nC:\\Users\\\u003Cyour-user>\\AppData\\Local\\Packages\\Claude_pzs8sxrjxfjjc\\LocalCache\\Roaming\n```\n\n这样可以尽量减少对其它本地配置的影响，比如：\n\n- 第三方推理配置\n- 本地偏好设置\n- 其它桌面配置\n\n## 第三方推理说明\n\n这部分是旧方案遗留说明，仅供参考。\n\n当前仓库主线已经明确：\n\n- 不再把 `Configure Third-Party Inference` 纳入补丁目标\n- 不再围绕 3P 页面做兼容承诺\n- 不再建议为了 3P 去修改运行时 bundle\n\n以下内容保留为历史资料。\n\n如果你要把 Desktop 接到本地代理，例如 `cc-switch`，推荐走官方的第三方推理入口，而不是直接改内部配置文件。\n\n### 前置条件\n\n在使用补丁版之前，建议确认以下条件：\n\n- 已安装最新版 Claude Desktop。\n- Windows 已启用 `VirtualMachinePlatform`。\n- 如果你要使用 Cowork \u002F VM 相关能力，请确认你的宿主机和虚拟化环境本身支持对应特性。\n- 如果你使用 `cc-switch` 作为本地代理：\n  - `cc-switch` 正在运行。\n  - 你已经在 `cc-switch` 中导入了可用的 Claude provider。\n  - `cc-switch` 已开启本地代理，常见地址为：`http:\u002F\u002F127.0.0.1:15721`\n  - 如果你也在使用 CLI，建议保留 `C:\\Users\\\u003C用户名>\\.claude\\settings.json` 里的代理配置。\n\n这里有一个关键点：\n\n**如果你要通过 Desktop 使用第三方推理或本地代理，`cc-switch` 一定要开启本地代理。**\n\n如果你直接把 Desktop 的 Gateway base URL 填成某个固定 provider，比如：\n\n```text\nhttp:\u002F\u002F127.0.0.1:8317\u002Fv1\n```\n\n那么 Desktop 只会连这个固定后端。之后你在 `cc-switch` 里切换 provider，Desktop 不会跟着切换，你就需要重复手动改配置。\n\n而 `cc-switch` 本地代理的意义是：\n\n- Desktop 固定连本地入口\n- `cc-switch` 负责把请求转发给当前选中的 provider\n- 这样你切换 provider 时，Desktop 无需重复配置\n\n补充说明：\n\n- `newapi` 理论上也可以作为中转层\n- 但在个人场景下，模型映射和配置通常更繁琐\n- 如果你已经在使用 `cc-switch`，一般没有必要再额外套一层 `newapi`\n\n### 打开 3P 设置界面\n\n按官方桌面版菜单路径：\n\n```text\nHelp -> Troubleshooting -> Enable Developer mode\nDeveloper -> Configure third-party inference\n```\n\n这会打开官方的 3P Setup UI。\n\n### Connection 选择\n\n在 Connection 页面中，选择：\n\n```text\nGateway\n```\n\n不建议在这个场景里选择：\n\n- Bedrock\n- Vertex\n- Foundry\n\n因为我们这里的目标是通过本地 `cc-switch` 作为统一入口。\n\n### 推荐填写方式\n\n按下面的方式填写：\n\n- Gateway base URL\n  - 填：`http:\u002F\u002F127.0.0.1:15721`\n  - 具体以你自己的本地代理地址为准\n- Gateway API key\n  - 填：`PROXY_MANAGED`\n- Gateway auth scheme\n  - 选：`bearer`\n- Gateway extra headers\n  - 留空\n- Organization UUID\n  - 留空\n- Credential helper script\n  - 留空\n- Skip login-mode chooser\n  - 建议打开\n- Bootstrap config URL\n  - 留空\n\n### 建议在 Show as JSON 中检查\n\n建议切到 `Show as JSON` 看一眼，确认至少存在这些键：\n\n```json\n{\n  \"inferenceProvider\": \"gateway\",\n  \"inferenceGatewayBaseUrl\": \"http:\u002F\u002F127.0.0.1:15721\",\n  \"inferenceGatewayApiKey\": \"PROXY_MANAGED\",\n  \"inferenceGatewayAuthScheme\": \"bearer\",\n  \"inferenceModels\": [\"sonnet\", \"haiku\", \"opus\"],\n  \"isClaudeCodeForDesktopEnabled\": true\n}\n```\n\n其中最关键的是：\n\n- `inferenceProvider`\n- `inferenceGatewayBaseUrl`\n- `inferenceGatewayApiKey`\n- `inferenceModels`\n- `isClaudeCodeForDesktopEnabled`\n\n### 关于 inferenceModels\n\n`inferenceModels` 本质上是模型下拉框的候选列表。\n\n如果不设置这项，可能会出现：\n\n- 模型无法在 UI 中正常选择\n- `cc-switch` 中对应的几个模型别名拉不出来\n\n通常可以先按这种 Anthropic 风格别名填写：\n\n```json\n[\"sonnet\", \"haiku\", \"opus\"]\n```\n\n它们更像是 UI 侧的 alias，不代表上游一定是真正的 Claude 官方模型名。\n\n![image-20260424201810188](README.assets\u002Fimage-20260424201810188.png)\n\n![image-20260424201856085](README.assets\u002Fimage-20260424201856085.png)\n\n### 关于 isClaudeCodeForDesktopEnabled\n\n```json\n\"isClaudeCodeForDesktopEnabled\": true\n```\n\n建议确认它为 `true`，以确保 Code 页可见。\n\n\n\n## Windows 虚拟化与 VMware \u002F Hyper-V 说明\n\n如果你只关心界面汉化，这一节可以跳过。\n\n如果你要使用 Cowork、VM 或其它依赖虚拟化的平台能力，这一节很重要。\n\n### 1. 启用 Windows 功能\n\n常见命令：\n\n```powershell\ndism \u002Fonline \u002Fenable-feature \u002Ffeaturename:VirtualMachinePlatform \u002Fall \u002Fnorestart\ndism \u002Fonline \u002Fenable-feature \u002Ffeaturename:HypervisorPlatform \u002Fall \u002Fnorestart\ndism \u002Fonline \u002Fenable-feature \u002Ffeaturename:Microsoft-Hyper-V-All \u002Fall \u002Fnorestart\nRestart-Computer\n```\n\n### 2. 验证 Hypervisor 是否启动\n\n```powershell\nbcdedit \u002Fenum | findstr \"hypervisorlaunchtype\"\n```\n\n正常情况下应看到：\n\n```text\nhypervisorlaunchtype    Auto\n```\n\n### 3. 验证相关 Windows 功能是否启用\n\n```powershell\nGet-WindowsOptionalFeature -Online | Where-Object {\n    $_.FeatureName -in @(\n        \"VirtualMachinePlatform\",\n        \"HypervisorPlatform\",\n        \"Microsoft-Hyper-V-All\"\n    )\n} | Select-Object FeatureName, State\n```\n\n如果三项都启用了，通常会看到：\n\n```text\nHypervisorPlatform     Enabled\nVirtualMachinePlatform Enabled\nMicrosoft-Hyper-V-All  Enabled\n```\n\n### 4. VMware 并存场景\n\n如果你在 VMware Workstation 17 中看到类似错误：\n\n```text\nVMware Workstation 在此主机上不支持嵌套虚拟化。\n模块“HV”启动失败。\n未能启动虚拟机。\n```\n\n并且 `vmware.log` 中有类似内容：\n\n```text\nhypervisor.cpuid.v0 = \"FALSE\"\n```\n\n这通常说明：\n\n- 你的 Windows 主机已经启用了 Hyper-V \u002F Hypervisor\n- 但 VMware 当前环境不支持你想要的嵌套虚拟化组合\n\n### 5. 当你要给 VMware 让路时\n\n如果你的目标是优先让 VMware 的嵌套虚拟化正常工作，而不是优先保留 Windows Hypervisor，可尝试：\n\n```powershell\nbcdedit \u002Fset hypervisorlaunchtype off\nRestart-Computer\n```\n\n这会关闭 Hyper-V 的启动，但不会卸载对应 Windows 功能。\n\n### 6. 关于 VirtualMachinePlatform \u002F Hyper-V \u002F VMware 的关系\n\n常见几种情况：\n\n#### 情况 A：只开 `VirtualMachinePlatform`\n\n- 适合只满足某些基础平台要求\n- 对 VMware 干扰通常相对更小\n- 但不保证满足所有 Cowork \u002F VM 场景\n\n#### 情况 B：开 `VirtualMachinePlatform` + `HypervisorPlatform`\n\n- 常见于需要 Windows Hypervisor 能力但不一定启用完整 Hyper-V 的场景\n- 可能仍会影响 VMware 的某些虚拟化能力\n\n#### 情况 C：开 `VirtualMachinePlatform` + `Microsoft-Hyper-V-All`\n\n- Windows 虚拟化能力最完整\n- 与 VMware 并存时最容易遇到嵌套虚拟化问题\n\n#### 情况 D：三个都开\n\n- 对 Windows 原生虚拟化支持最全\n- 但如果你还依赖 VMware 做嵌套虚拟化，这通常也是最容易冲突的一种组合\n\n### 7. 实际建议\n\n- 如果你的目标是使用 Claude Desktop 的相关平台能力，优先确认 `VirtualMachinePlatform` 已启用。\n- 如果你的目标是同时兼顾 VMware 嵌套虚拟化，需要根据自己的虚拟机方案取舍是否关闭 `hypervisorlaunchtype`。\n- 如果看到“此平台不支持虚拟化的 Intel VT-x\u002FEPT”，不要只看 Windows 功能是否已启用，还要检查宿主机 BIOS \u002F UEFI、虚拟机平台类型以及是否处于嵌套虚拟化场景中。\n\n## 更新方式\n\n如果 Claude Desktop 更新后界面资源结构发生变化：\n\n1. 更新本仓库中的中文资源文件。\n2. 重新运行：\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\install-windows-zh-cn.ps1\n```\n\n3. 重新从 `C:\\Users\\\u003Cyour-user>\\AppData\\Local\\Claude-zh-CN` 启动补丁版。\n\n## 注意\n\n⚠️ 本节以下内容主要对应历史“导出副本补丁”路线，不是当前主线安装方式。\n\n- 官方 Claude 更新后，可能需要重新运行安装脚本。\n- 这个方案是“导出副本补丁”，不是“原地替换官方安装包”。\n- 不建议直接修改 `C:\\Program Files\\WindowsApps` 下的官方安装目录。\n- Claude Desktop 更新后，导出的补丁副本不会自动跟随更新。官方版本更新后，通常需要重新运行 `install-windows-zh-cn.ps1`。\n- 这个项目不会重新签名或替换官方 Appx \u002F MSIX 包；请不要尝试手动修改 `WindowsApps` 下的官方文件来“覆盖安装”，否则可能触发系统权限、签名或包校验问题。\n\n## 卸载 \u002F 恢复\n\n⚠️ 本节以下内容主要对应历史“导出副本补丁”路线。当前主线请优先使用 `claude-zh-cn.ps1`、`restore-windowsapps-zh-cn.ps1` 或 `restore_claude_zh_cn_windowsapps.py`。\n\n本项目不会直接改动官方安装目录，卸载方式也比较简单。\n\n### 使用卸载脚本\n\n可以直接运行：\n\n```text\nuninstall-windows-zh-cn.bat\n```\n\n或：\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\uninstall-windows-zh-cn.ps1\n```\n\n如果你还想在卸载时一并从原配置里移除 `locale`，可以运行：\n\n```powershell\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\uninstall-windows-zh-cn.ps1 -RemoveLocale\n```\n\n如果你要恢复到只使用官方 Claude Desktop：\n\n1. 关闭补丁版 Claude。\n2. 删除导出的补丁副本目录：\n\n```text\nC:\\Users\\\u003Cyour-user>\\AppData\\Local\\Claude-zh-CN\n```\n\n3. 如有需要，改回你自己的启动方式，不再使用补丁版启动器。\n\n如果你使用的是“保留 locale”模式，并且希望把语言选择恢复为不显式指定 `zh-CN`，可以运行：\n\n```text\nrun-windows-zh-cn-no-locale.bat\n```\n\n它会在启动前从原配置中移除 `locale`。\n\n## 免责声明\n\n本项目为非官方中文补丁，仅修改本机 Claude Desktop 的导出副本和本地资源文件。\n\nClaude Desktop 更新后资源结构可能变化，若补丁失败，请先更新本项目中的脚本或资源，再重新运行安装脚本。\n\n使用前请自行评估与本地环境、系统策略、公司合规要求以及软件更新机制的兼容性。\n\n## 已知限制\n\n- 当前主线优先面向 Windows 商店 \u002F Appx 版 Claude Desktop，同时支持手动指定解压版 `app` 目录。\n- Windows 安装包目录受保护，运行安装 \u002F 恢复脚本通常需要管理员权限；脚本对部分复制 \u002F 写回点做了 best-effort 重试，但仍建议以管理员 PowerShell 执行。\n- 控制台在某些 Windows 编码环境下可能会把中文输出显示为乱码，但这不一定表示文件内容损坏。\n- 如果上游资源命名或白名单写法发生变化，语言白名单补丁逻辑可能需要调整。\n\n## 文件说明\n\n- 下面这些是当前主线脚本和资源，旧的“导出副本补丁”历史文件仅作为参考保留。\n- `claude-zh-cn.ps1`：交互式安装 \u002F 卸载菜单（推荐入口）。\n- `patch_windowsapps_json_only.py`：写入 JSON 资源、patch 白名单、设置 locale。\n- `patch_chunks_zh_cn.py`：替换 JS chunk 中的硬编码英文 UI 标签，并注入中文字体自定义运行时。\n- `restore_claude_zh_cn_windowsapps.py`：从备份还原 JSON \u002F chunk \u002F locale，并清理字体配置镜像。\n- `resources\\frontend-zh-CN.json`：Claude 前端界面中文翻译。\n- `resources\\desktop-zh-CN.json`：Claude 桌面壳层中文翻译。\n- `resources\\statsig-zh-CN.json`：statsig i18n 资源。\n\n### 当前仓库实际文件清单\n\n| 文件 | 用途 |\n|------|------|\n| `resources\u002Fdesktop-zh-CN.json` | 桌面壳层翻译（菜单、对话框、系统托盘、Cowork 等） |\n| `resources\u002Ffrontend-zh-CN.json` | 前端界面翻译（聊天、设置、计费、项目、Artifacts 等） |\n| `resources\u002Fstatsig-zh-CN.json` | Statsig 功能描述翻译 |\n| `patch_windowsapps_json_only.py` | 主线 patch 脚本：备份 → 写入 JSON → patch 白名单 → 设置 locale |\n| `install-windowsapps-json-only.ps1` | 安装入口：关闭 Claude 进程后调用 patch 脚本 |\n| `restore_claude_zh_cn_windowsapps.py` | 恢复脚本：从备份还原 JSON \u002F chunk \u002F locale，并清理字体配置镜像 |\n| `restore-windowsapps-zh-cn.ps1` | 恢复入口 |\n| `tools\u002Fvalidate_resources.py` | 校验 JSON 资源文件合法性和 key 计数 |\n| `tools\u002Fcheck_i18n_coverage.py` | 检测疑似未翻译条目，输出覆盖率报告 |\n| `CHANGELOG.md` | 变更日志 |\n| `LICENSE.md` | 许可声明 |\n\n## 开发与维护\n\n如果你要继续维护这个项目，建议关注：\n\n- 官方 Windows 包版本号变化\n- `resources\\ion-dist\\assets\\v1\\index-*.js` 中语言白名单写法是否变化\n- `resources\\ion-dist\\i18n\\en-US.json` 的 key 增减\n- 桌面层 `resources\\en-US.json` 的 key 增减\n\n推荐维护流程：\n\n1. 从已安装的官方包中导出新的英文资源。\n2. 与现有中文资源按 key 合并。\n3. 保留未知新 key 的英文回退。\n4. 重新运行安装脚本验证补丁副本是否可启动。\n\n## 参考来源\n\n本项目的中文资源与思路参考自：\n\n- `https:\u002F\u002Fgithub.com\u002Fjavaht\u002Fclaude-desktop-zh-cn`\n\n但本仓库实现的是适配 Windows 的版本，不是对原仓库的原样搬运。\n\n## 许可与风险提示\n\n- 本项目不是 Anthropic 官方发布内容。\n- 请仅在你自己的设备和你能接受的风险范围内使用。\n- 使用前请自行评估与本地环境、公司策略和软件更新机制的兼容性。\n\n## Chunk UI 标签补丁\n\n除了 JSON 语言资源之外，本项目还会对 Claude Desktop 的 JS bundle 文件进行安全的字符串替换，汉化以下区域的硬编码英文 UI 标签：\n\n- 侧边栏导航（聊天 \u002F 协作 \u002F 代码 \u002F 项目 \u002F 已安排 \u002F 自定义 等）\n- Cowork 面板（状态筛选 \u002F 时间筛选 \u002F 分组方式 \u002F 环境 等）\n- 第三方推理设置页（连接方式 \u002F 供应商配置 \u002F 遥测 \u002F 更新 \u002F 插件 等）\n- 会话管理（新建任务 \u002F 编辑会话 \u002F 删除会话 等）\n- Conway 操作菜单（搜索 \u002F 刷新 \u002F 发送消息 \u002F 调试日志 等）\n- 代理 \u002F 连接器 \u002F 插件配置表单\n- PR 状态 \u002F CI 状态标签\n- 加载状态 \u002F 错误消息 \u002F 通用按钮\n- 中文字体自定义（预设字体 \u002F 系统字体名 \u002F 本地 `.ttf` 或 `.otf` 导入）\n\n最近新增的能力包括：\n\n- 中文字体自定义浮动面板：右下角 `字体` 按钮打开 \u002F 关闭设置面板\n- 预设字体切换：内置 `Windows 现代默认`、`微软雅黑`、`等线`\n- 自定义系统字体名：手动输入已安装字体名称后应用\n- 本地字体导入：选择本机 `.ttf` \u002F `.otf` 文件后立即生效\n- 字体配置镜像：运行时配置保存在 `localStorage`，并镜像到 `%APPDATA%\\Claude-3p\\config.json` 的 `claudeZhCnFont`\n- 恢复时清理字体配置：卸载 \u002F 恢复脚本会同时移除 `locale` 和 `claudeZhCnFont`\n- 旧版字体注入自动升级：重复安装时会替换旧注入代码，而不是因为旧标记跳过\n- 解压版 \u002F 非 WindowsApps 运行支持：`claude-zh-cn.ps1` 在自动检测失败时可手动输入 Claude 的 `app` 目录\n\n这些替换由 `patch_chunks_zh_cn.py` 执行，安装脚本会自动调用。原始文件在替换前会自动备份。\n\n字体设置会在运行时写入浏览器 `localStorage` 的 `claudeZhCnFont`，安装时也会在 `%APPDATA%\\Claude-3p\\config.json` 镜像同名字段。导入字体文件会以 data URL 形式保存在本机 localStorage 中，不会写入仓库。\n\n### 桌面壳层菜单与 DevTools 菜单边界\n\n需要特别区分两类菜单：\n\n- 桌面壳层菜单文案：例如顶部 `文件 \u002F 编辑 \u002F 查看 \u002F 开发者 \u002F 帮助`，以及 `打开 MCP 日志文件…`、`重新加载 MCP 配置`、`打开应用配置文件…`、`显示开发者工具` 这类主应用菜单子项。这些文案主要来自桌面壳层资源，可通过 `resources\u002Fdesktop-zh-CN.json` 维护和修正。\n- DevTools \u002F Chromium 原生菜单：例如 `Enable Main Process Debugger`、`Record Performance Trace`、`Write Main Process Heap Snapshot`、`Record Memory Trace (auto-stop)`。这类项通常不走当前仓库可控的桌面资源链路，也不受网页层字体注入控制。\n\n因此：\n\n- 菜单文案可控范围：主应用桌面壳层菜单文案\n- 自定义字体可控范围：Claude 主界面网页层内容、设置页、弹层、列表、按钮、表单等 renderer UI\n- 当前不可安全承诺的范围：系统原生菜单、DevTools 原生菜单及其字体样式\n\n如果继续通过网页层 CSS 强行覆盖原生菜单，通常不会生效，反而更容易影响图标字体和特殊控件显示。\n\n如果你不是通过 Microsoft Store 安装，而是直接运行解压后的 Claude，也可以使用交互脚本安装：\n\n- 运行 `claude-zh-cn.ps1`\n- 当脚本未检测到 WindowsApps 安装时，按提示手动输入 Claude 的 `app` 目录\n- 目录示例：`D:\\Claude\\app`\n- 脚本会校验该目录下是否存在 `resources\\en-US.json`，通过后继续安装 \u002F 卸载\n\n也可以直接用命令行指定 `app` 目录：\n\n- 安装：`powershell -ExecutionPolicy Bypass -File .\\install-windowsapps-json-only.ps1 -AppDir \"D:\\Claude\\app\"`\n- 恢复：`powershell -ExecutionPolicy Bypass -File .\\restore-windowsapps-zh-cn.ps1 -AppDir \"D:\\Claude\\app\"`\n\n### 当前仓库实际文件清单\n\n| 文件 | 用途 |\n|------|------|\n| `claude-zh-cn.ps1` | 交互式安装 \u002F 卸载菜单（推荐入口，支持 WindowsApps 自动检测和手动输入 `app` 目录） |\n| `claude-zh-cn.bat` | BAT 入口（双击运行，自动请求管理员权限） |\n| `patch_windowsapps_json_only.py` | Step 1：写入 JSON 资源 + patch 白名单 + 设置 locale |\n| `patch_chunks_zh_cn.py` | Step 2：替换 JS chunk 中的硬编码英文 UI 标签，并注入中文字体自定义运行时 |\n| `install-windowsapps-json-only.ps1` | 独立安装脚本（自动执行 Step 1 + Step 2，支持 `-AppDir` 指定解压版 `app` 目录） |\n| `restore_claude_zh_cn_windowsapps.py` | 恢复脚本（从备份还原 JSON + chunk + locale，并清理字体配置镜像） |\n| `restore-windowsapps-zh-cn.ps1` | 独立恢复脚本（支持 `-AppDir` 指定解压版 `app` 目录） |\n| `resources\u002Fdesktop-zh-CN.json` | 桌面壳层翻译（355 keys） |\n| `resources\u002Ffrontend-zh-CN.json` | 前端界面翻译（12326 keys） |\n| `resources\u002Fstatsig-zh-CN.json` | Statsig 功能描述翻译（46 keys） |\n| `tools\u002Fvalidate_resources.py` | 校验 JSON 资源文件合法性 |\n| `tools\u002Fcheck_i18n_coverage.py` | 检测疑似未翻译条目 |\n| `tools\u002Ftest_patch_behaviors.py` | 无需管理员权限的主线回归测试（字体注入 \u002F 安装 \u002F 恢复 \u002F 关键文案） |\n\n## 致谢\n\n感谢 [LINUX DO](https:\u002F\u002Flinux.do\u002F) 社区的支持与分享。\n\n本项目的诞生离不开 LINUX DO 社区成员们的讨论、反馈和技术交流。如果你也是 LINUX DO 的一员，欢迎在社区中交流使用体验和改进建议。\n\n同时感谢以下项目提供的参考和灵感：\n\n- [javaht\u002Fclaude-desktop-zh-cn](https:\u002F\u002Fgithub.com\u002Fjavaht\u002Fclaude-desktop-zh-cn) — 本项目的中文翻译资源最初参考自该仓库\n","该项目为Windows版Claude Desktop提供中文界面补丁，包括12700多个键值的翻译及JS chunk UI标签汉化。其核心功能在于通过PowerShell脚本自动化安装与卸载过程，并且支持对桌面壳层、前端界面以及Statsig功能描述进行完整的中文本地化处理。项目使用Python编写，确保了资源文件的有效性和未翻译条目的检测。适合需要在Windows环境下使用Claude Desktop并希望获得全中文操作体验的用户或开发者。",2,"2026-06-11 02:43:04","CREATED_QUERY"]