亮点与主要变更
本版本由社区贡献者 @suiahae 完成,带来 Linux 前端硬编码文案汉化与桌面壳层词表补全、连接器权限界面 39 条新词条,以及 壳层 ASAR 摘要迁移到 XDG 状态目录(不再向归档头写入自定义字段)。
1. Linux 补全前端硬编码文案与桌面壳层翻译(合入 #251)
背景:
1.4.25 已支持 Linux 上的 Claude Desktop 5.x,但安装成功后第三方推理配置中的 Gateway 等前端硬编码文案仍显示英文;桌面壳层也只使用应用自带的中文译文,仓库里已有的补充译文没有生效。
改动:
- 前端硬编码文案:重建
ion-dist.asar或处理旧版目录布局时,复用frontend-hardcoded-*.json的替换规则。Gateway显示为「网关」,供程序使用的gateway标识符保持原值; - 桌面壳层词表:从
desktop-*.json补齐app.asar内所选官方zh-Hans/zh-Hant缺少的译文,只接受当前英文词表中已有的键。保留已有官方译文、英文词表、其他归档条目和原始载荷; - 归档改写方式:新词表追加到载荷末尾并只重指向该条目,其他文件的偏移、外置与可执行标记原样保留;
- 安装与还原:按安装路径加锁,对已改写的
app.asar核对原始 SHA-256 和备份;重复安装从原件生成,卸载时按字节还原前端和壳层。旧版缺少对应的官方中文壳层词表时,继续安装前端补丁; - 词表修正:「文件 经理」→「文件管理器」、「打开 任务」→「打开任务」,
Gateway系列统一为「网关」,并补充文件复制、网关报错、Code 模型切换等 11 条漏译。
2. 补齐连接器权限说明并统一繁体 Artifacts 文案(合入 #252)
- 39 条新词条(简体、台繁、港繁各一份):覆盖连接器的「内置工具」、组织默认规则、权限变更生效时机、手动与自动模式说明,以及相关的登录、保存与反馈提示;
- 默认权限说明由两个词条组成,组织规则句通过
{note}接收「正在运行的任务或会话可能要到下次启动才会生效」的提示,译文保留插值与 ICU 分支; - 繁体 Artifacts 口径统一:台繁与港繁此前把
eW5eoWkxy3译为「生成內容」,现与Y2q5SU8kAQ统一为Artifacts;3gMRgkZSBx的说明改写为繁体并保留产品名。
3. 壳层 ASAR 摘要移至 XDG 状态目录并统一连接器提示(合入 #253)
- 不再向 ASAR header 写入自定义字段:按安装路径在 XDG 状态目录保存原始与补丁
app.asar的 SHA-256,改为desktop@<安装路径摘要>.json; - 中断可续:替换归档前原子记录当前和待安装的摘要,中断后可从任一侧继续;
- 旧字段只读兼容:上一版写入归档头的摘要字段仍可识别,可用于重新安装或卸载时匹配原始备份,重装补丁时会迁移到外部记录;
- 新增守卫:当「前端仍是补丁 + 状态缺失 + 备份对不上」时明确拒绝操作,避免把补丁包误当成原包备份;
- 连接器措辞统一:
LkFzRWh5WL与OMz0S1h1Xu补译infrastructure,与同组提示的「基础设施」用语一致,{name}保留。
贡献者 (Contributors)
特别感谢为本版本做出贡献的开发者:
- @suiahae:Linux 前端硬编码文案与桌面壳层词表补全(#251)、连接器权限说明 39 条新词条与繁体 Artifacts 口径统一(#252)、壳层 ASAR 摘要迁移到 XDG 状态目录与连接器措辞统一(#253)。
验证与测试
- Python 回归测试 49 项全部通过(含 12 项 Linux 安装器 e2e,覆盖重复安装、切换语言、升级、双安装隔离、缺少备份、替换中断与状态无法识别等边界);
- 两个 Linux 安装脚本的
bash -n语法检查与git diff --check均通过; - GitHub Actions
回归测试(ubuntu-latest / windows-latest)双平台全绿,Deploy GitHub Pages正常; - 作者在 Fedora 44 / Claude Desktop
5.11492.5上实测:简体前端合并结果为 38,137 条不同于英文原值、6,081 条保留英文原值,三地壳层各补齐 214 条;简体硬编码扫描触发 3,968 次替换、涉及 423 个 JS 文件,425 个修改后的模块通过 Node 语法检查,并确认服务商标识符仍为gateway; - 使用两份真实归档副本完成旧补丁迁移与卸载,
app.asar和ion-dist.asar均与备份逐字节一致,两份配置的 locale 均恢复为en-US。