亮点与主要变更
本版本核心解决 Claude Desktop 4.29+(含 Microsoft Store / MSIX 版)Windows 汉化失败 的问题,同时保持对旧版本的完全兼容。
1. 支持 Claude Desktop 4.29+ ion-dist.asar 新前端结构(合入 #220 by @wyqkh,修复 #219)
问题背景:Claude Desktop 4.29 起将前端从目录 app\resources\ion-dist\ 整体打包为单文件 app\resources\ion-dist.asar(约 191 MB)。旧版安装器只识别目录布局,在「查找 Claude Desktop」阶段即报 未找到前端 JS bundle,导致无法汉化。
修复内容:
- 无依赖 ASAR 读写:使用纯原生 PowerShell + .NET 实现 ASAR 头部解析、解包、结构校验与重打包,不引入任何第三方依赖;
- 自动适配两种布局:
- 4.29+(ASAR 模式):备份原包 → 解包到临时
ion-dist工作目录 → 复用既有汉化流程 → 重打包并校验结构 → 替换原文件; - 4.29 之前(目录模式):原有逻辑完全不变;
- 4.29+(ASAR 模式):备份原包 → 解包到临时
- 完整性哈希同步:重打包后自动定位并同步
Claude.exe内嵌的app.asar与ion-dist.asar头哈希(SHA256),解决因完整性校验失败导致的应用无法启动问题; - 备份与卸载恢复:安装前完整备份原始
ion-dist.asar与Claude.exe,卸载时自动恢复为官方原始文件并重新同步官方哈希; - 安全防御:ASAR 路径穿越校验、文件边界校验、安装失败自动清理临时目录、异常中断后重装可自动识别并清理残留工作目录。
兼容性提示:
Claude 4.29+ 需重建
ion-dist.asar并更新Claude.exe内嵌完整性哈希,原有 Authenticode 签名会失效。安装器已备份原始文件,卸载时自动恢复。
新增测试:
Test-AsarFrontend.ps1:ASAR 解包、重打包、结构校验;Test-AsarIntegrity.ps1:Claude.exe内嵌双哈希同步;Test-AsarFrontendWorkflow.ps1:完整安装工作流(备份 → 解包 → 汉化 → 重打包 → 清理);Test-AsarRoundTrip.ps1:真实安装包逐文件无损往返验证(需手动传入包路径)。
验证与测试
- Python 回归测试 16 项全部 PASS;
- Windows PowerShell 5.1 / PowerShell 7 结构替换、斜杠菜单、语言注销测试全部通过;
- 新增 ASAR 检测、完整性、安装工作流测试全部通过;
- 已在 Claude 4.29 真实环境完成简体中文安装、重启与界面验证;
- 真实
ion-dist.asar往返验证 4,535 个条目哈希全部一致。