亮点与主要变更
本版本由维护者 @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 条保留英文。