github javaht/claude-desktop-zh-cn 1.4.24

one hour ago

亮点与主要变更

本版本由维护者 @javaht 完成,带来 macOS 提权安装权限自愈与目录属主修复(彻底解决 Issue #240 启动闪退 Failed to get 'crashDumps' path)、修正「Open plan」错译并补齐 4.23118 未汉化语句与第三方推理配置详细注释说明(解决 Issue #239),以及赞助商列表更新与跨平台 CI 兼容性改进。


1. 修复 macOS sudo 安装新建用户数据目录归属 root 导致应用启动崩溃(维护者 @javaht 提交,彻底解决 #240,合入 #242)

问题背景:
当用户全新安装 Claude Desktop 且尚未打开过应用,或在新的 macOS 测试账户中通过 install-mac.command 运行汉化补丁时,脚本在 sudo 提权上下文中执行 mkdir(parents=True, exist_ok=True)。由于进程具有 root 身份,新建的 ~/Library/Application Support/Claude 目录所有权归属于 root:staff(权限 755)。此前脚本仅对内部生成的 config.json 单个文件执行了 os.chown,导致父目录普通用户无写入权限。后续普通用户启动应用时,Chromium Crashpad 尝试在数据目录下创建 crashDumps 目录因触发 EACCES 而报错闪退:
Error: Failed to get 'crashDumps' path(弹窗显示 Claude Desktop failed to launch)。

修复与改进:

  • 修正父目录判断:将 config.name.startswith("Claude-3p") 修正为 config.parent.name.startswith("Claude-3p"),消除由于文件名始终为 config.json 导致跳过分支失效、在未启用第三方模式的机器上凭空创建 Claude-3p 目录的 Bug;
  • 递归修复目录属主:在 sudo/提权运行时,创建数据目录后向上遍历,安全地将数据目录及其新创建的各级中间层父目录属主递归修正回目标普通用户;
  • 属主校准自愈机制:在配置 locale 匹配跳过前优先执行所有权校准。历史曾被误创建为 root 属主的环境,重新运行补丁脚本即可自动修复自愈;
  • 跨平台安全防护:统一封装 safe_chown,在 Windows 等非 POSIX 平台安全短路,杜绝 AttributeError;
  • 测试覆盖:新增 tests/test_user_locale.py,完整覆盖全新目录创建、未启用 3p 跳过、已存在 3p 配置同步、提权下递归 chown 以及 locale 匹配下的属主自愈场景,全量测试已全部通过。

2. 修正「Open plan」错译并补齐 4.23118 未汉化语句与第三方推理详细注释(维护者 @javaht 提交,解决 #239,合入 #241)

问题背景:
根据社区用户在 Issue #239 中提供的多张界面截图反馈,部分菜单选项翻译不准(如设置中的 Plan 操作),且第三方推理配置、插件市场分类、模型输出风格等有多处未汉化或显示为英文占位。

修复与词条补齐:

  • 修正错译:将词条 rFt5FOC0eo("Open plan")由原来字面直译的「开放计划」修正为符合产品上下文的「打开计划」;
  • 合并 dynamic 目录并补全 70 处核心缺失词条:
    • 将此前单独存放的 49 个 dynamic 词条与设置项词条完整合并进主词表 frontend-zh-CN.json,解决 React Intl 在前端加载时因缺少对应 key 回退到英文默认文案的问题;
    • 覆盖「回复字体」、「跟随界面」、「摘要与后续步骤」等关键设置项与安全防护说明;
  • 前端硬编码规则补充 149 处:
    • 第三方推理配置详细注释:在 c6f6cf4c2-mK6FedDX.js 中完整汉化 126 处 long: V(...) Markdown 说明,涵盖超时重试、上下文窗口、流式传输、模型温度等核心说明;
    • 插件市场与分类菜单:补全「由 Anthropic 精选」、「来自合作伙伴」、「Claude 法律版」、「Claude 生命科学版」等展示文案;
    • 模型输出风格标签:安全替换输出风格选择器中的展示标签(「简洁」、「解释型」、「引导学习」、「主动」),且保留内部原始枚举值;
  • 港台繁体词表同步:运行 convert_traditional.py,确保 zh-TW 与 zh-HK 区域词汇完全对齐,保留 ICU 占位符结构与参数完整性。

3. 文档更新(维护者 @javaht 提交)

  • 赞助商列表新增维护者微信赞赏码。

贡献者 (Contributors)

特别感谢为本版本做出贡献的开发者:

  • @javaht(维护者):macOS 用户数据目录属主修复与权限自愈(彻底解决 #240)、修正「打开计划」错译及补齐 4.23118 未汉化语句与第三方推理注释(#239 / #241)、文档赞赏码更新。

验证与测试

  • Python 单元回归测试 31 项全部 PASS;
  • 全量 PowerShell 回归测试在 Windows PowerShell 5.1 与 Linux PowerShell 7 均顺利通过;
  • 跨平台 GitHub Actions CI 检查(Ubuntu / Windows)全部绿灯。

Don't miss a new claude-desktop-zh-cn release

NewReleases is sending notifications on new releases.