github javaht/claude-desktop-zh-cn 1.4.25

one hour ago

亮点与主要变更

本版本由维护者 @javaht 与社区贡献者 @suiahae 共同完成,带来 Linux 对 claude-desktop-rpm(Fedora 等 RPM 发行版)与 Claude 5.x 前端的完整支持、Windows 支持 Scoop / 自定义目录安装、AppX 多版本与商店版识别修正,以及 应用未退出时中止安装、预检 asar 占用的稳定性加固。


1. Linux 适配 claude-desktop-rpm 与 Claude 5.x 前端(合入 #248 by @suiahae,解决 #247)

问题背景:
Linux 安装器此前只支持官方 deb 包,写死 /usr/lib/claude-desktop 与 unpacked 的 ion-dist/ 目录,且始终要求 sudo。通过社区脚本 claude-desktop-rpm(Fedora 等没有官方 deb 的 RPM 发行版)安装时会找错目录,还会调用已被移除的 app.asar DOM 补丁,直接报错失败。

改动:

  • 自动识别安装位置:优先正在运行的实例 → CLAUDE_DESKTOP_PREFIX → ~/.local/lib/claude-desktop(rpm)→ /usr/lib/claude-desktop(官方 deb),也支持 CLAUDE_RESOURCES 显式指定;
  • 按需 sudo:resources 可写时完全不调用 sudo(rpm 安装目录属于当前用户),只有只读目录才提权;
  • 备份迁出应用目录:原始前端备份改存 $XDG_STATE_HOME/claude-desktop-zh-cn/,rpm 的目录式升级不会连带删除;每次安装都从原始备份重新生成,可重复运行;
  • 状态按安装隔离:备份与 locale 记录以「版本 + 安装路径摘要」为键,同机多份安装不会互相覆盖;版本号取不到时(如 CLAUDE_RESOURCES 指向手工目录)改用 app.asar 摘要作备份键,升级后不会复用旧备份;
  • 5.x 前端:解包 ion-dist.asar,把当前版本 en-US 词表与随包中文词表合并为 zh-Hans / zh-Hant,注册语言白名单后重新打包;旧版 ion-dist/ 目录布局继续兼容;
  • 港台词表不再串味:zh-TW 与 zh-HK 都输出 zh-Hant,但分别使用各自的词表(两份词表约 1.35 万条术语差异);
  • 不改写 app.asar:5.x 桌面壳层自带官方 zh-Hans / zh-Hant 词库,Linux 也不校验 asar 完整性,因此无需重签名;
  • 卸载按字节还原:用同版本备份还原 ion-dist.asar 或 ion-dist 目录,并恢复安装前记录的 locale(安装后才生成的 Claude-3p 配置也会一并复位);若当前前端已含补丁但备份缺失,会提示先重装而非把旧版前端装回去;
  • 防静默失败:打完补丁校验词表与语言白名单确实写入,结构不符时报错退出;
  • 4.x 提示:4.x 没有 zh-Hans / zh-Hant 壳层词库,脚本会明确告警「前端中文、菜单栏与账号页可能回落英文」。

测试:新增 7 项安装器状态机 e2e(重复安装、版本升级、多安装隔离、locale 回退边界、缺少备份时拒绝),外加 5 项 asar 布局/语言映射用例。


2. Windows 支持 Scoop 与自定义目录安装(合入 #203 by @javaht,来源 issue #203 by @YOUIMARK)

  • 自动检测 Scoop 安装:Get-ScoopClaudePaths 覆盖 %USERPROFILE%\scoop\apps\claude\current(含 junction 解析)与版本子目录,apps\claude / claude-desktop / AnthropicClaude 三种目录名都识别;
  • 自定义路径:新增 -ClaudePath 参数与 CLAUDE_PATH 环境变量,install-windows.bat 在 UAC 提权时把原用户的 SCOOP 与 CLAUDE_PATH 一并传入管理员会话;
  • 进程识别与重启:Test-ClaudeDesktopProcessPath 增加 Scoop 路径匹配;非 WindowsApps 安装改为直接启动 exe,不再误走 AppX 激活;
  • 未找到安装时的报错也会提示可用 CLAUDE_PATH 指定目录;
  • 新增 tests/Test-AppxPathResolution.ps1 覆盖 Scoop 与自定义路径检测。

3. Windows AppX 多版本与商店版识别修正(合入 #214 by @javaht,来源 issue #214 by @A42Null)

  • 按版本号选最新:Find-ClaudePath 不再依赖 Get-AppxPackage 的返回顺序,改为按 [System.Version] 降序取最新;WindowsApps 兜底扫描也从「按目录时间」改为「先按安装目录名里的版本号、再按时间」;
  • 版本读取支持 app\ 子目录:Get-ClaudeExeProductVersion 统一走 Get-ClaudeExePath,能定位 AppX 布局下的 app\Claude.exe;
  • 双 Cowork 服务:Stop-CoworkVMService / Start-CoworkVMService 同时处理 CoworkVMService 与商店版使用的 CoworkVMServiceStore;
  • 新增 tests/Test-AppxPathResolution.ps1。

4. Windows 应用未退出时中止安装并预检 asar 占用(合入 #245 by @javaht,解决 #244)

问题背景:
MSIX/WindowsApps 安装时,若 Claude 仍在另一个会话或账户下运行,旧实现会因 MainModule 读取失败而静默跳过进程并打印「已停止」,随后替换 app.asar 命中 Windows 的 ERROR_ALREADY_EXISTS,报「Cannot create a file when that file already exists」,安装中断在半完成状态。

改动:

  • 改用 Win32_Process / CIM 枚举桌面进程,可跨用户会话识别;读不到句柄时保留 PID 交给 taskkill 兜底;
  • Stop-ClaudeProcesses 增加 -RequireStopped:停止失败时抛出可操作错误,不再假报成功;
  • 新增 Test-FileReplaceable / Assert-AsarReplaceable:写 asar 前独占探测目标,提前失败;
  • 新增 Move-FileWithRetry:替换 app.asar / ion-dist.asar 时带退避重试,失败保留源文件并给出明确提示;
  • 安装 [1/7]、[3/7]、[6/7] 与卸载路径全部接入停止校验与可替换预检;
  • 新增 Test-ProcessStop.ps1、Test-AsarReplace.ps1,并接入 CI。

5. 文档更新(@javaht)

  • Linux 一节标注 claude-desktop-rpm 的仓库地址与 Fedora Magazine 出处,运行时提示改用 owner/repo 形式,避免按提示重装时认错项目;
  • 统一「以 5.x 为基准 / 4.x 可安装但部分界面回落英文」的表述口径。

贡献者 (Contributors)

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

  • @javaht(维护者):Windows Scoop / 自定义目录安装支持(#203)、AppX 多版本与商店版识别修正(#214)、应用未退出时中止安装与 asar 占用预检(#245)、Linux 文档与发布;
  • @suiahae:Linux 适配 claude-desktop-rpm 与 Claude 5.x 前端,含 7 项安装器 e2e 用例(#248)。

同时感谢提交问题反馈的 @YOUIMARK(#203)、@A42Null(#214)、@jackgun(#244)、@suiahae(#247)。


验证与测试

  • Python 回归测试 44 项全部通过(含 Linux 7 项安装器 e2e 与 5 项 asar 用例);
  • Windows PowerShell 5.1 与 Linux PowerShell 7 跨平台测试全部通过,新增 Test-ProcessStop.ps1、Test-AsarReplace.ps1、Test-AppxPathResolution.ps1 已接入 CI;
  • GitHub Actions 回归测试(ubuntu-latest / windows-latest)双平台全绿,Deploy GitHub Pages 正常;
  • 作者在 Fedora 44 / Claude Desktop 5.11492.5 / Electron 45.2.1 上实测:真实 199 MB ion-dist.asar 完成 install → --check-patched → uninstall,卸载后 SHA-256 与原始文件一致;zh-CN → zh-Hans 为 38,124 条翻译、6,094 条保留英文。

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

NewReleases is sending notifications on new releases.