Skip to content

Releases: skyecx/compositor-zh-hans

v1.5.3-1 · 适配 Compositor 1.5.3

Choose a tag to compare

@skyecx skyecx released this 19 Oct 00:58

外挂式简体中文汉化包,适配 Compositor 1.5.3(CFBundleVersion 49)。

不改上游源码:语言包以 zh-Hans.lproj/Localizable.strings 形式注入 App 包,
配合 CFBundleDevelopmentRegion = zh-Hans 与仅针对外层 App 的 ad-hoc 重签。

上一次 Release 是 v1.0.4-2。本次一次性跨过 1.4.6 → 1.5.3 共 9 个上游版本:
CMYK 印刷、⌘F 命令面板、画布旋转、扫描线滤镜、渐进模糊、16 位 / HDR 图层、
全新「导出为…」面板、Sparkle 更新窗口、导航器缩略图等。

包含内容

  • 语言包 926 条词条(上一版 523 条),术语遵循 Adobe Photoshop / Affinity Photo 简体中文版
  • 本次新增覆盖:
    • CMYK 印刷:CMYK / 校样颜色 / 色域警告 / 配置文件 / 载入配置文件…
    • 导出为…面板(⇧⌥⌘W):格式 / 位深 / 页面 / 每通道 16 位 / 更多格式 / 缩放导出 等
    • 命令面板(⌘F):搜索命令… / 搜索命令与工具 / 没有匹配的命令
    • 导航器、画布顺时针 / 逆时针旋转 90°
    • 扫描线滤镜全套参数与 tooltip、渐进模糊起止点与保留透明度
    • 16 位 / HDR 图层、快捷键清除、Camera Raw 分组重置、形状平滑拐角
  • 一键汉化.command — 双击即可汉化并安装自动恢复守护
  • 汉化.sh — 汉化脚本本体,支持 --check 只读检查
  • 安装自动恢复.command + watchdog.sh — App 自动更新覆盖后自动重新汉化
  • 卸载汉化.sh — 一键还原为英文界面
  • tools/ — 提取待翻译词条、校验占位符一致性、生成术语对照表
  • docs/研究报告.md — 注入原理、三个关键坑、A/B 类覆盖率分析

已实测

  • ✅ 汉化后 App 正常运行(签名不被系统杀掉;原厂 entitlements 完整保留)
  • ✅ Sparkle 自动更新链路完好(能正常拉取 appcast 检查更新)
  • ✅ App 更新覆盖后,守护脚本自动重新汉化
  • ✅ 通过 CI 校验(.strings 语法 + 中英占位符一致性 + 术语对照表同步)
  • ✅ tools/extract-missing.py 高置信度缺失 0 条

工具修复

  • extract-missing.py 改用状态机解析字符串字面量,正确处理「插值里还嵌着字符串」的写法
    (如 .help("…\(flag ? ", and EXR…" : "")"))。旧正则会在插值里第一个引号处截断,
    把真词条算成不存在的 key,导致译好的词条被误报缺失。
  • 修正语言包中两处占位符类型错误(%@ → %lld):源码里是 Int,写成 %@ 会静默失效。

已知限制

A 类(SwiftUI 里以字面量出现的文案)已 100% 覆盖,且可校验:每次扫出的高置信度
待翻译清单为空,CI 会跑。

B 类无法通过语言包覆盖 —— 上游把它们写在枚举 rawValue、计算属性 / 三元表达式、
AppKit 菜单项与 tooltip 里,最终走 SwiftUI 的「逐字渲染」通道,压根不会查语言包
(如 Normal、Exposure…、图层右键菜单、Camera Raw 面板标签)。要覆盖只能改源码重编译。

从本版起,新功能的 B 类文案也会先翻译入库(见 CHANGELOG
的「准备项说明」):现在不生效,但上游把这些调用点改成 LocalizedStringKey 后即可自动生效。

使用

git clone https://github.com/skyecx/compositor-zh-hans.git
cd compositor-zh-hans
bash 一键汉化.command

本仓库不包含、不分发 Compositor 程序本体,请从
官方 Release 获取。

v1.0.4-2 · 适配 Compositor 1.0.4

Choose a tag to compare

@skyecx skyecx released this 20 Sep 14:39

外挂式简体中文汉化包,适配 Compositor 1.0.4(CFBundleVersion 5)。

不改上游源码:语言包以 zh-Hans.lproj/Localizable.strings 形式注入 App 包,
配合 CFBundleDevelopmentRegion = zh-Hans 与仅针对外层 App 的 ad-hoc 重签。

包含内容

  • 语言包 523 条词条,术语遵循 Adobe Photoshop / Affinity Photo 简体中文版
  • 一键汉化.command — 双击即可汉化并安装自动恢复守护
  • 汉化.sh — 汉化脚本本体,支持 --check 只读检查
  • 安装自动恢复.command + watchdog.sh — App 自动更新覆盖后自动重新汉化
  • 卸载汉化.sh — 一键还原为英文界面
  • tools/ — 提取待翻译词条、校验占位符一致性、生成术语对照表
  • docs/研究报告.md — 注入原理、三个关键坑、A/B 类覆盖率分析

已实测

  • ✅ 汉化后 App 正常运行(不会因签名失效被系统杀掉)
  • ✅ Sparkle 自动更新链路完好(能正常拉取 appcast 检查更新)
  • ✅ App 更新覆盖后,守护脚本自动重新汉化
  • ✅ 通过 CI 校验(.strings 语法 + 中英占位符一致性)

已知限制

约 5% 的界面文本(枚举 rawValue 派生的下拉项如混合模式、滤镜名,以及
Text(三元表达式) 形式的文案)走的是 SwiftUI 的逐字渲染通道,无法通过语言包
覆盖,需改源码才能解决。详见 README「已知限制」。

使用

git clone https://github.com/skyecx/compositor-zh-hans.git
cd compositor-zh-hans
bash 一键汉化.command

本仓库不包含、不分发 Compositor 程序本体,请从
官方 Release 获取。