Repository navigation
Releases
v1.2.0
每个版本自包含「一份翻译字典 + 一套替换逻辑档案」(
dictionaries/<版本>/patch.json):注入锚点、右键菜单标签表、更新管控参数都按该版本官方产物实测固化,引擎按版本加载并强校验,不再让一套全局逻辑服务所有版本。9 个版本(3.6.0 / 3.6.4 / 3.6.5 / 3.6.6 / 3.6.7 / 3.6.8 / 3.6.9 / 3.6.10 / 3.6.11)的字典与档案成对入库,获取 / 打包 / GUI 判定 / 自动产出 / CI 全部改为成对语义。
新增
- 每版本替换逻辑档案(
patch.json):新增scripts/version-profile.js——档案的唯一实现与唯一写入口:加载(外部文件 → 内嵌 → 联网)、结构校验、策略解析、锚点断言(按本次操作真正要注入的策略筛)、成对校验(pairStatus/assertPair/listPairVersions)、写入口writeProfile()(先校验再原子落盘,默认拒绝覆盖)、官方两平台产物探测(probeApp/buildProfile/probeVersion,CLIprobe|show|validate|check)。档案是数据、不执行;缺档案 / 锚点次数不符 / 策略名未知一律明确拒绝并给下一步。 - 9 个版本成对资产:
dictionaries/<版本>/patch.json覆盖 3.6.0 / 3.6.4 / 3.6.5 / 3.6.6 / 3.6.7 / 3.6.8 / 3.6.9 / 3.6.10 / 3.6.11,均由官方 Windows + macOS 两平台产物实测生成;证据记录产物名 / 大小 / 文件 sha256 / 锚点实测次数 / 标签来源与字面量次数(evidence.platforms),可复核探测所用产物。 - 成对在线同步:
dict-sync新增fetchPair/writePair——同一个源必须字典与档案都取到且都校验通过(字典走dict-edit.validateDoc、档案走validateProfile)才算成功;.part原子落盘、失败回滚,不留半对;ensureDict改为成对判断且只补缺的那份(不覆盖用户已有文件);syncLatest成对覆盖;prefetchDict文案与错误区分缺哪份。 - 打包与 GUI 成对口径:
build.js内嵌最新一版成对资源(最新版本缺档案时告警并退到最新成对版本,无成对才失败);ElectronseedBundledDicts()逐文件补齐(老用户数据根只有字典、缺档案时能只补档案);check-gui-dist成对校验并把version-profile.js补进 asar 清单;GUI/CLI 的「有没有字典」改成对完整口径(listDictVersions原义保留、新增listPairVersions),本地有字典缺档案单独标「缺替换逻辑档案」。 - dict-auto 成对产出 + 失败可诊断:每版本取到两平台产物后
probeApp+buildProfile生成档案,与字典同一轮落盘(任一步失败两份一起回滚);--on-exist=skip判据改为成对(存量只有字典的版本走「只补产档案」迁移路径,不重跑 AI);失败分类ai-unreachable/ai-quality/product-fetch/profile-probe/dry-run-threshold/dict-validate等,注解带::error title=与各类计数;失败落待译草稿tmp/dict-auto-pending-<版本>.json供 workflow 上传 artifact;--no-ai报告标draftOnly;--dry-run不再掩盖失败;严格质量门禁不降级。 - CI 成对门禁:
dict-auto.yml的提交门禁改用pairStatus/listPairVersions判成对,并逐版本离线跑version-profile validate做结构门禁;新增「待译草稿 + 报告」artifact 上传;提交信息与运行汇总带档案锚点/失败分类。 - 项目架构图:
docs/架构图/(standalone HTML + 候选 JSON)。 - 设计文档:
docs/design/version-profile/design.md——档案 schema、引擎语义、失败与兼容、迁移与流水线清单、探测记录、模块接口与风险。
变更
patch/restore/verify接入档案:写盘前断言锚点、注入参数(标签表 / 注入点 / 方法锚点 / 期望次数)全部来自档案;请求了档案未启用的更新管控 → 明确拒绝;patch先成对补齐资源、再加载档案并断言(本地有字典缺档案时会联网成对取,失败照旧拒绝且不写盘/不建备份)。update-control注入块的「已支持版本上限 / 更新后自动汉化前置」改判成对完整(字典 + 档案都在),避免只有字典的高版本被误判成「工具已支持」而放行更新;restore按组重放补传工具路径(打包态 autoPatch 不再静默丢失)。common.packagedToolPath()收敛「更新后自动汉化」的工具路径取值,patch与restore共用同一份。- 文档同步:AGENTS.md / dictionaries/README.md /
.claude/skills/translation-maintain/references/版本升级.md/ docs/agents/已知坑.md 全面改「成对」口径。
修复
- 独立验收返工:锚点断言按策略筛选(只汉化不被更新管控的锚点变化挡住);
anchorsFor对未知策略名 fail-closed;启用策略引用的锚点必须声明在 main.js;dict-sync 字典校验_meta.version/formatVersion;dict-auto 迁移路径--dry-run不写档案;失败分类改多数类并覆盖「响应结构不认识」;CI 成对门禁走 SSOT + 结构校验。 - 已知坑补录:半对资源不算可用、远端字典目录列表 ≠ 远端有档案、自动产出注入标签与迁移死锁、fail-closed 校验等。
说明
- 按语义化分级规则取中版本 1.2.0:字典组织方式与工具链发生变更(新增
patch.json成对资产与version-profile.js引擎、成对同步/打包/CI),属「大改」;对使用者行为向后兼容(旧版本字典仍可用、缺档案时明确拒绝并给下一步)。 package.json版本号 1.1.3 → 1.2.0
v1.1.3
产物全面瘦身:10 个产物(cli 4 + gui 6)全部压进 Gitee 单文件附件上限 100 MB,mac 侧平台词从内核词 darwin 改成使用者一眼可读的 macos(本次发版双名字过渡一版),Gitee 镜像开始随发行版传附件。构建侧把 mac x64 基底挪到 arm64 机器交叉编译,绕开 intel runner 的整机停摆。
新增
- 产物全面瘦身进 100 MB:单文件产物 mac / Linux 换 small-icu 自编译 node 基底(CI 从源码编译、
actions/cache缓存;官方 node 的 ICU 数据约 28 MB,本仓库零 Intl 使用),GUI 根级compression: maximum(AppImage 走 xz、dmg 转 ULMO/LZMA)、Windows 免安装包 zip 换 7z、语言包裁到中英两个、软渲染与 WebGPU 编译器按平台裁剪。CI 实测:cli 81.4~93.8 MB(Windows 83.6 / mac arm64 81.4 / mac x64 84.8 / Linux 93.8),gui 79.7~91.7 MB(Windows 7z 81.2 / setup 90.8、dmg 79.7 arm64 / 90.8 x64、AppImage 91.7 / deb 91.2)——v1.1.2 唯一超限的 macOS x64 dmg(102.5 MB)就此达标;体积随构建打进 CI 日志(check-gui-dist),超 100 MB 打::warning::,不必下载附件。 - 平台词 mac 侧 darwin → macos(v1.1.3 起):SEA 产物名由
tools/build.js的PLATFORM_WORD映射,GUI 靠electron-builder.yml的mac.artifactName固定;自更新scripts/update.js按「macos 优先、darwin 兜底」双词匹配,新版工具对两代名字的 Release 都更新得动。本次 Release 同时挂 macos 与 darwin 两份名字(release job 的TRANSITION_DARWIN_ALIASES,SHA256SUMS 双名字各一行),v1.1.2 及更早的老工具也能更新;只过渡一版,下一版发版前关掉开关并删复制步骤。 - Gitee 镜像开始传附件:此前产物超 100 MB 只发正文,压缩后全部达标——CI 给最新版传全套产物 + SHA256SUMS,发新版时删旧版附件、旧版正文补上 GitHub 下载链接(1 GB 附件配额让给最新版);darwin 过渡附件不进 Gitee。
- mac x64 基底挪 arm64 机器交叉编译(受迫例外:intel runner 随机整机静默停摆,上游 actions/runner-images#13882,看门狗救不了):
CC/CXX钉-arch x86_64——node 的 make 构建在 mac 上从不传-arch,缺了编译器按 host 的 arm64 出码、编出 arm64 码冒名 x64 的废品;链接用经典链接器-ld_classic绕 nodejs/node#59553(新式链接器产物经 SEA 注入后 dyld 报 thread-local 超 4GB 起不来,Rosetta 下同样复现、产物自检判定有效);缓存 key 按 matrix.name + 链接器区分;自编译基底加process.arch == x64硬校验,产物按基底架构取名不会错标。
变更
tools/build.js新增--node <可执行文件>指定产物基底(默认当前 node);交叉构建不另做特殊命名,产物名架构词一律按基底查询。- 文档口径同步:AGENTS.md(矩阵现状 / 体积实测 / 交叉构建受迫例外)、docs/打包与分发.md(Gitee 新口径、体积数字、检查清单、产物计数 13→10)、docs/agents/发版.md(产物命名、Gitee 段、产物计数)。
说明
- 构建与分发侧的工具链调整(自编译基底、压缩体系、产物命名、Gitee 附件策略、交叉编译),对使用者零行为变化——汉化 / 还原 / 字典逻辑未动,产物命名变更由自更新双词匹配兜底、历史字典与备份完全不受影响;按语义化分级规则取小版本 1.1.3。
package.json版本号 1.1.2 → 1.1.3
v1.1.2
接着 v1.1.1 把 macOS 安装目录识别修到底:GitHub Desktop.app 放在任意位置(桌面 / 下载 / 自定义目录)也能自动识别,不再要求先挪进「应用程序」。
修复
- macOS 任意位置的 GitHub Desktop 自动识别:
candidateRoots()的 darwin 分支此前只认/Applications与~/Applications两个标准位置——app 放在别处就没有候选根,自动探测枚举为空,只能手动--path。现在 darwin 分支经 Spotlight(mdfind按官方 bundle idcom.github.GitHubClient)动态发现任意位置的 GitHub Desktop.app,拼Contents/Resources并入候选根,与标准位置去重(标准位置排前,多份并存时优先用「应用程序」里的正式安装)。mdfind缺失、Spotlight 被禁用或超时(5 秒)一律静默跳过,退回标准位置候选与现有引导文案兜底;不缓存结果,GUI 每次刷新都能发现新装的应用。零依赖实现(execFileSync),按 bundle id 过滤不会把本工具自己误认成 GitHub Desktop。文档口径同步(AGENTS.md 与 README 旧表述仍是「macOS/Linux 走--path」)。
说明
- 缺陷修复,按语义化分级规则取小版本 1.1.2。
package.json版本号 1.1.1 → 1.1.2
v1.1.1
修好 macOS 上识别不到安装目录的一类问题:未识别时的引导文案此前三个平台都给 Windows 形态的例子,GUI「选择」对话框里选中 GitHub Desktop.app 本体也报无效目录——mac 用户照着提示找不到、也选不中正确位置(使用者实测:把 GitHub Desktop 放入「应用程序」即可自动识别)。另把发版运维的两件工具固化进仓库并同步文档口径。
修复
- macOS 识别不到安装目录的引导与选择下探按 .app 形态补齐:官方 macOS 产物是免打包裸目录(
Contents/Resources/app/main.js),校验逻辑本身没错——错在两处引导。其一,locateApp的「未找到安装目录」文案不分平台,现在按平台给对应引导:macOS 提示「先放入『应用程序』文件夹(会自动识别)」并给/Applications/GitHub Desktop.app/Contents/Resources例子,Windows / Linux 维持原例;macOS 的自动探测只认「应用程序」与「~/应用程序」里的 GitHub Desktop,app 放在桌面等位置识别不到属预期。其二,GUI「选择」对话框的候选下探只有<选中>/resources(Windows 形态),mac 用户最自然的「选中 GitHub Desktop.app 本体」必然落空——补上<选中>/Contents/Resources一层,选中 .app 即命中。文档口径同步修正:自动探测三平台标准位置都覆盖(AGENTS.md 与 README 原写的「仅支持 Windows」与实现不符——macOS / Linux 候选根自首个提交就实现了)。 rel-check补 gui 产物后缀口径:非.exe的 gui 附件(dmg / AppImage / deb)不再被误标 ✗。
新增
- 固化发版第 7 步驱动器
tools/ops/update-e2e.cjs:spawn 产物实跑「检查更新 → 下载 → 替换 → 重启」,轮询 stdout 按输出喂 stdin(解决 printf 喂输入撞「readline was closed」的问题),退出码判成败;发版分册同步指向它。
变更
- 发版分册补呈现层版本号扫描与伪装旧版验证的步骤说明;README 与 AGENTS 的跨平台口径按实证修正。
说明
- 缺陷修复与文档 / 运维工具同步,按语义化分级规则取小版本 1.1.1。
package.json版本号 1.1.0 → 1.1.1
v1.1.0
这一版给工具加了「下载并安装本机没有的 GitHub Desktop 版本」的能力(CLI 菜单与 GUI「切换版本」窗口共用入口),网络层改为自动读系统代理(环境变量 → Windows 注册表 → macOS scutil,代理不可用回退直连),GUI 新增「关于」窗口、把「切换版本」改成按钮 + 弹窗列表,并让「检查更新」只管工具自身、字典同步独立成项。另修好按组还原时更新管控模式被静默降级、GUI IPC 三个带参通道把事件对象当业务参数用(K1)两个问题。内部做了几处收敛(cmd 公共逻辑上收 common、拆出
dict-ai.js、GUI IPC 处理器按域拆出、CI 探针联网收敛到lib.js),测试补了 verify / patch / restore 编排层契约测试与冒烟带参通道判据。
新增
- 下载并安装本机没有的 GitHub Desktop 版本(
scripts/cmd/install-version.js,CLI 菜单「安装位置 / 切换版本」下新增d)入口,GUI「切换版本」窗口共用同一入口):取官方 nupkg → 校验 sha256 → 解压lib/net45/*→ 铺到<安装根>/app-<版本>/,装完即切过去。列表只列「有汉化字典、本机未装」的版本,且只在用户明确选d)时才联网取——进菜单这个动作本身不该等一次网络往返。不跑官方 Setup.exe——那是 Squirrel 升级语义、会替换现有版本,与本工具「多版本并存」的模型冲突;解压出来的目录与官方安装逐项同形(实测对照app-3.6.6)。只支持 Windows(官方不发 Linux 产物;macOS 的.app覆盖是另一套)。失败不留半个目录:先铺app-<版本>.part、必需文件齐了才改名。--from <本地包>是下载不通时的降级路径。底座是release-assets.js扩展出的listVersions()(列官方有产物的正式版)与extractLocal()(把下到本地的整包按前缀铺开),zip 解析仍是同一套、不另写一份。 - 自动读系统代理(
scripts/net.js):openStream()是全仓唯一的发请求入口,现在按「环境变量(HTTPS_PROXY等,NO_PROXY排除)→ Windows 注册表 → macOSscutil」的顺序读系统代理,https 走自实现的 CONNECT 隧道(tunnelAgent),代理不可用时回退直连并记住(记一次、在 stderr 说一次)——一个配坏的代理不该让工具彻底断网。这是「直连 15 KB/s vs 走代理 593 KB/s」的本机实测差距背后的自动化解法:之前要手动设环境变量,现在装了系统代理的机器开箱即用。 - GUI「关于」窗口与「切换版本」弹窗:工具栏新增「关于」(工具版本 / 项目地址 / 国内镜像 / 许可证 / 数据目录 + 「检查更新」「同步字典」两个动作);「切换版本」改成按钮 + 弹窗列表选择本机已安装版本。与 CLI 共用
common.setTargetVersion(),切换后默认注入「完全禁止自动更新」;「检查更新」只管工具自身、字典同步独立成syncDict(CLI / GUI 两处语义一致);openUrl只收白名单键(repo/mirror)。「翻译提示词」标签页展示的dict-prompt.js独立成模块、成为唯一来源——GUI 展示与dict-auto调模型共用同一份。
变更
- 按组还原更新管控按记账模式重放:
restore --group只撤其他组时,updateControl组此前被固定按guard模式重放——以「完全禁止自动更新」(--block-update)打的补丁,撤一组无关的组后「完全禁止」会静默变回「没有字典就不更新」。现在setPatchGroups把实际注入模式随组记账(updateControlMode),重放改读getUpdateControlMode,老账(无模式字段)按guard兜底、与原行为一致。记账往返 7 场景实测,npm test142 用例全绿。 - 重构收敛:cmd 公共逻辑上收
common.js、拆开patch/verify的长函数;dict-ai.js独立成 AI 协议适配层、dict-auto.js只留字典领域逻辑;GUI IPC 处理器按域拆到gui/ipc/(patching/versions/updates/misc);CI 探针联网收敛到tools/ops/lib.js,产物命名回归并入npm test;收口对抗性审查发现的死代码与规范问题。 - 文档重组:
AGENTS.md拆出三份按需加载分册(docs/agents/:发版 / 翻译维护 / 已知坑),主文件只留每次都要遵守的规则;README 补充技术栈说明、优化目录与贡献指引、菜单示例去掉会随平台变动的字典条数;docs/design/gui/design.md补「切换版本」弹窗示意(界面图生成脚本tools/make-gui-fig.cjs固化为仓库工具,按显示宽度对齐、幂等);已知坑补条目(字典条数口径 / 冒烟等待窗口 / spawn 双通道 / CRLF 纪律等)。
修复
- GUI IPC 包装剥离 invoke 事件对象,修复三个带参通道(
gui/main.js):ipcMain.handle的 listener 签名是(event, ...args),包装层未剥首参时带参处理器会把事件对象当业务参数用(实测openUrl回显「未知的地址:[object Object]」),而无参通道完全看不出来。现在包装层剥掉事件对象;--smoke-test补「哨兵进去、哨兵回来」的带参通道实参形态判据作回归护栏(只认回显里有没有那个哨兵串,改报错文案不会误报)。 - 自更新 / 重启接住 spawn 的同步抛:Windows 上「文件在、内容却不是有效可执行体」时
spawn在调用处同步抛(spawn UNKNOWN/EFTYPE),此前只在异步error事件上兜——起不来时 GUI 把「安装包已下到哪、请手动打开」这条唯一能照做的补救信息抹掉、报成「检查工具版本失败」。三处调用点按「try { spawn } catch {}+child.on('error', …)」两件套补上。 install-version未知参数改为报错,与其他 cmd 脚本一致;rel-check缺省 tag 改取最新 Release;ci-status对限流等非数组响应恢复静默跳过;界面图生成脚本的仓库地址改取common.jsSSOT;删除restart.launch的无调用方导出。
说明
- 本次是工具链与界面的中幅扩展(新增脚本 + GUI 新窗口 + 在线能力增强),按语义化分级规则取中版本 1.1.0。
package.json版本号 1.0.0 → 1.1.0
v1.0.0
把整个仓库的文件结构按职责重排了一遍:
scripts/分cmd/dict/inject三层,构建与发布工具收进新的tools/,test/按被测模块归目录——对外行为一处未变(npm 命令、CLI 参数、模块导出面、GUI 的 IPC 契约逐项冻结后核对无意外)。字典侧清掉 36 条「不是界面文案」的条目(2154 → 2118):被当成文案收进来的 CSS 类名会打掉renderer.css的规则、机器标识译掉会改行为,另清了 29 条早被整模板键接管的死键、恢复patch告警的信号价值。还修好一个从 v0.1.1 起就没装成过的缺陷——自更新下的是 GitHub 的 API 元数据 JSON 而不是产物(CLI 侧被文件头护栏拦下,GUI 侧会把 JSON 当安装包启动),并给下载物补了一道SHA256SUMS校验。
新增
- 自更新加 SHA256SUMS 校验(
scripts/update.js的verifySha256()):CLI 替换自身与 GUI 启动安装包共用同一条口径,下载物按 Release 里的SHA256SUMS核对 sha256。它是完整性校验而非防篡改——清单与产物同源,能证明「下到的就是发布的那份」(半成品、错版本、被中间层改写都挡得住);能改产物的对手也能改清单,那要靠签名,不在本工具的能力范围内。清单取不到时跳过而不是拒绝更新(Gitee 的发行版只发正文、不带附件),文件头校验仍在;清单在手却没有这个名字、或对不上,都中止。GUI 侧尤其需要它:CLI 有文件头护栏(MZ / Mach-O / ELF),而安装包形态不齐——dmg 的koly在文件末尾那 512 字节 trailer 里、deb 是 ar 归档、AppImage 是追加了 squashfs 的 ELF——魔数表既难写又不强,而校验和证明的是「同一份字节」,强一个量级。 - GUI 不再假报更新成功(
gui/main.js的installGuiUpdate):child.on('error', () => {})把 spawn 失败吞掉后,紧接着无条件返回「已下载安装包并启动安装向导」——JSON 被当安装包启动时,用户看到的是「已启动安装向导」而屏幕上什么都没发生。现在等 spawn 的结果出来再回话:起不来就说清「文件在哪、请手动打开」,下载 / 校验失败同样如实说明(返回{ notes, hasError },两个调用点都按hasError走错误通道)。 - 测试夹具模块与约定(
test/fixtures/scratch.js):收敛临时字典目录的隔离与清理。清理走disposableDir()门禁——算出的删除目标必须是dictionaries/的直接子目录、且名字不是真实版本形态(判据复用生产侧common.DICT_VERSION_RE,不另写正则),挡住误传即毁数据的杀伤半径:cleanup('3.6.6')(指向真实字典)、cleanup('')(指向整个dictionaries/)、cleanup('..')(指向仓库根)三者都被拒。本模块无顶层副作用。
变更
- 全项目文件结构按职责重排(57 个文件):
scripts/分三层——cmd/(6 个入口:locate / patch / restore / verify / scan / restart)、dict/(5 个:dict-edit / dict-groups / dict-auto / dict-sync / release-assets)、inject/(2 个补丁组);新增tools/收拢构建与发布工具(build.js/bundle.js/changelog.js/check-gui-dist.js),CI 探针归tools/ops/,build/只留 electron-builder 钩子;test/按被测模块归common//dict//inject/;历史设计文档归docs/design/。对外行为一处未变——npm 命令与 CLI 参数全部保留,13 个入口的--help归一化后逐字节一致;模块导出面、GUI 的 IPC 契约(handle 8 / push 2 / preload 10 / invoke 8 / on 2)、四版字典、electron-builder.yml的 10 个配置键、零依赖,逐项冻结后核对无意外差异。路径引用残留检查意外 0(终版 65 处命中全部是已登记的白名单项,如历史设计文档正文里的说明性引用)。验收:npm test112 / 0、node --check46 文件 0 失败、相对 require 87 条零悬空、移动配对「旧文件消失 0」。
修复
- 字典删掉 36 条「不是界面文案」的条目(2154 → 2118,
dictionaries/3.6.6/zh-CN.json):这批条目是分批查出来的,每批都先做命中上下文分类,再用「大写版是否已在字典里承担可见文案」交叉验证。① CSS 类名——"description"在 renderer.js 的 22 处里 21 处是className:"description"(含历史列表条目里承载头像与作者行的那层),替换后类名成className:"描述",renderer.css的.description规则不再命中、flex 布局与行距全部失效,这就是「历史的样式被修改」的来源;"archived"同理(可见文案另有"Archived"→ 「已归档」,这条属重复且译法不一致)。查法是把renderer.css的 1028 个类名与字典键求交,只有这两条命中。② 属性值与库内部 token——"difference"(仅 1 处,mixBlendMode:"difference",替换后取值非法、混合模式失效)、"formatting"(30 处里 29 处是 date-fns / CLDR 的context:"formatting"选项,只在库内部流转)。③ 操作名插值的空格与硬译——整模板键Begin ${…}/Confirm abort ${…}/Resolving conflicts for ${…}的译文保留了插值两侧的空格,而操作名已是中文,于是标题渲染成「开始 变基」;分支下拉的状态行'Rebasing branch'硬译成「正在变基分支」;变基文案的两处尾随空格("Rebasing ")与冲突横幅前缀("rebasing"→ 「变基到」)一并修正,让变基与同族的压缩 / 重排 / 摘取四条流程的文案一致。④ 死键——清掉 29 条被整模板键接管的片段键(早期按片段收词如"Fetch the latest changes from ",后来改用整模板键覆盖外层模板;匹配是逐字面量整串相等、同起点长的优先,片段键从此不再参与替换),它们让npm run patch每次都报「0 命中的条目」且逐批累积,真正失效的条目就被淹没;清理前后main.js/renderer.js的 md5 完全一致,证明这 29 条确实从未参与替换。另回退"renderer.js|Abort"——它命中 Dexie 的 errnames 数组(经t+"Error"拼接后既当错误类名又当查表键$M[e.name],译掉会让错误对象的name变中文),代价是cancelButtonText:"Abort"那个取消按钮回到英文,遵循仓库既有规则「机器标识不译,宁可留英文」。 - 自更新下的是 API 元数据 JSON——从 v0.1.1 起就没装成过(
scripts/update.js):pickAsset/pickGuiAsset挑中附件后,url字段一直是 GitHub 的 API 端点(api.github.com/repos/<owner>/<repo>/releases/assets/<id>),那个端点少了Accept: application/octet-stream只回一份资产元数据 JSON(实测 HTTP 200 +application/json)。于是自更新把几十 KB 的 JSON 当产物下了下来——CLI 侧被verifyExecutable的文件头校验拦下(护栏有效、工具没被写坏,但更新从来没装成过),GUI 侧没有那道校验,会把 JSON 当安装包启动。现在两个 pick 函数统一把url归一成browser_download_url(发布页上那条直链;Gitee 的资产对象只有它、本来就走的这条路),取不到直链的极端形态仍退回 API 端点并补上那个 accept 头兜底。真机取证:伪装成 v0.3.0 使用者整条跑通「检查更新 → 下载 → 文件头校验 → 改名替换自身 → 重启」,替换后的文件与官方 v0.4.0 的 win32-x64 附件逐字节相同,新进程启动时把.old残留清掉了。 - 字典版本目录按三段数字形态过滤(
scripts/common.js的DICT_VERSION_RE):listDictVersions()与build.js的collectAssets()原先只判「是目录且有zh-CN.json」,测试夹具0.0.0-test、下载残留3.6.6-beta、临时解包目录都会被当成真实字典版本。后果不是理论的——compareVersions把非数字段按 0 处理,首段数字更高的残留(如9.9.9-x)会排到真实版本之后,而build.js取排序后最后一个当内嵌字典,就会把错版本打进产物。现在由生产侧导出/^\d+\.\d+\.\d+$/作为 SSOT,两处复用同一判据(测试侧引用而非另写)。 - 产物自检清单漏了
scripts/net.js(tools/check-gui-dist.js):net.js与同级的common.js一样是被多个脚本依赖的共享模块(patch联网取字典、update下载自更新都经过它),原先未列进need数组,asar 内容检查漏了这一条。该缺口在重构前即存在、非某次改动引入,作为独立修复单列以便单独回滚。 - 字典与新生成器文案里的旧路径(
scripts/dict/dict-auto.js+ 3 版字典的_meta.notes):目录重排后scripts/dict-auto.js已不存在,而生成器会把这句来源标注写进此后每一版新字典——不改则每新增一版就多一处陈旧路径引用。既有 3.6.0 / 3.6.4 / 3.6.6 三版一并回写(3.6.5 的 notes 是手写的「首个版本字典:…」、本就不含路径,不动),走唯一写入口dict-edit apply <版本> --ops <文件>(ops 为[{"op":"setMeta","notes":…}])而非手工编辑 JSON;_meta.updated有意不动把 diff 压到最小,改前改后validate逐条一致、条目数与组数不变。
说明
- 本次是结构性改造(57 个文件按职责重排,文档与 CI 里的脚本引用整体改写),按语义化分级规则取大版本 1.0.0。
- 目录重排后仓库里所有脚本路径都变了(如
scripts/patch.js→scripts/cmd/patch.js、scripts/build.js→tools/build.js)。npm 命令与 CLI 参数不受影响、照旧可用;仓库外的引用请按新路径更新,新旧对照表见docs/README.md。 - 一次踩到的坑记在这里:
dict-edit的serialize()一律写 LF,而dictionaries/3.6.0、3.6.4的工作区检出形态是 CRLF。写入后已手工转回 CRLF 恢复原形态,转回前后两次git diff --stat完全相同——行尾形态不参与 blob 比对(core.autocrlf=true且无.gitattributes,blob 层面全部为 LF)。 package.json版本号 0.4.0 → 1.0.0
v0.4.0
把界面最后一处常年英文的地方——文本框的右键菜单——也汉化了:那批标签由 Electron 按
role在运行时生成,字典的字面量匹配够不着,于是往产物里注入一段代码先把英文原文造进产物,再由同一次字典替换译掉。GUI 产物这边接着瘦身(运行时裁剪 + 压缩拉满 + 免安装包改 7z + mac 只发 dmg),六个产物里五个已进 Gitee 的 100 MB 附件上限,并给产物加了启动冒烟护栏;自动更新挑错产物(挑中 zip / 7z 这类非可执行文件)的毛病修掉。
新增
- 右键菜单汉化(
scripts/context-menu.js,属i18n组):文本框(分支筛选、提交摘要那些输入框)右键弹出的Undo / Redo / Cut / Copy / Paste / Delete / Select All一直是英文。不是字典漏收,是字典机制够不着——build-context-menu.ts的getEditMenuItems()用Menu.buildFromTemplate([{ role: 'editMenu' }])取展开项,标签由 Electron 在运行时按 role 硬编码生成,官方main.js里Delete这个字面量 0 处(scan也扫不出来)。做法是注入一段包装Menu.buildFromTemplate的代码(锚点与update-control.js同一处,落在产物 IIFE 之外):模板里出现role: 'editMenu'就把展开项 label 按 role 重打成英文原文,再由patch的同一次字典替换译成中文——注入块只带英文、不带中文,翻译资产仍只有字典那唯一一份。标签取build-default-menu.ts菜单栏「编辑」子菜单那一批(非 darwin 带&助记符、darwin 不带),字典没覆盖的保持英文原样;patch把这类命中单独计数(其中右键菜单标签 N 处),verify报注入块与字典覆盖状态。10 条单测,含「vm里用假 Electron 真跑注入块展开菜单」与「块内除标签外的字面量不与任何版本字典的键相撞」。 - 产物启动冒烟护栏(
gui/main.js的--smoke-test,CI 四平台各跑一次):静态自检看不出「删掉的运行时组件是不是启动必需」,于是让产物自己起一次——核对窗口内容区尺寸、界面按钮数与一次真实 IPC 往返,打印SMOKE_OK且退出码 0 才算过,冒烟不过就不上传产物。四个 runner 都没有 GPU,这轮冒烟同时是「软渲染组件删掉后还有没有回退路径」的验证(输出里带 GPU 合成 / WebGL / Vulkan 状态,裁剪前后可直接对照)。不带这个开关时行为与从前完全一致。
变更
- GUI 产物体积:运行时裁剪 + 压缩拉满 + 换打包形态(
electron-builder.yml+build/after-pack.js):三平台各删各的软渲染与 WebGPU 编译器(Windows 的vk_swiftshader.dll/dxcompiler.dll、macOS 的libvk_swiftshader.dylib、Linux 的libvk_swiftshader.so),语言包只留中英两个;compression显式拉满(不设时 AppImage 落在 mksquashfs 的默认 gzip、比同内容的 deb 胖 24 MB,dmg 落在 UDZO/zlib 上);Windows 免安装包由 zip 改 7z(zip 受 deflate 硬限制,同一份内容 7z 81.2 MB、zip 123.6 MB),macOS 只发 dmg、不再出 zip(两者装的是同一份.app,zip 那份纯属重复附件)。四平台实测(裁剪后):Windows 7z 81.2 MB / NSIS 安装包 90.8 MB、macOS dmg 95.9(arm64)/ 102.5(x64)MB、Linux AppImage 91.6 MB / deb 91.1 MB——六个产物里五个已在 Gitee 附件上限内,只剩 macOS x64 的 dmg 超 2.5 MB。逐项压测的结论是「Electron 这条路已经到底」:主程序一个文件占整包 83%、resources.pak占 15% 且几乎压不动,两者合计 98%;两条反直觉的实测——LICENSES.chromium.html未压缩 20.5 MB 但 xz 后只剩 0.19 MB(删了不合规、还省不下 0.2 MB),d3dcompiler_47.dll删不得(删掉后本机冒烟仍SMOKE_OK,但 GPU 合成从enabled掉到disabled_software、硬件加速失效,而这类退化 CI 测不出来)。再降一个量级只能换运行时基底(Tauri / Wails 那类系统 WebView 形态),留待下次重构评估。 - 字典自动产出回填历史版本:
dict-auto链路此前只在 3.6.5 / 3.6.6 上跑过,这次把 3.6.0 / 3.6.4 也各跑一遍(CI 定时任务与人肉回填共用同一条链路),四个版本齐了。 - Gitee 发版只发正文、不传附件(
.github/workflows/build.yml):Gitee 的附件配额(单文件 100 MB、单仓库合计 1 GB)放不下这些产物,正文里那段指向 GitHub Release 的下载指引就是唯一的下载入口;缺GITEE_TOKEN打::warning::后跳过,不阻断发布。 - 文档:
AGENTS.md补分支命名规范(<type>/<内容>-<修改者>-<MMDD>)与 CI 首跑失败的教训、合并约定;docs/打包与分发.md同步裁剪与冒烟的四平台实测数字与「还能再压吗」的结论;dictionaries/README.md与.claude/skills/translation-maintain/补「产物里到底有没有这个字面量」这道零步检查与右键菜单一类的收录判据。
修复
- 自动更新会挑中 zip / 7z 这类非可执行产物(
scripts/update.js):挑附件只看平台与架构词,于是发布页里同一套命名规则下的压缩包可能被选中,下载下来替换自身只会把工具弄坏。现在按平台后缀收口——Windows 只认.exe、macOS / Linux 认.bin(无后缀的老产物仍认,免得还留在旧版本上的使用者更新时找不到附件);GUI 侧另有一套只认名字里带-gui-的,且 Windows 只认-setup.exe、macOS 只认.dmg、Linux 认.AppImage/.deb(免安装包 7z 不是可执行文件,挑中它只会让更新失败;它仍随 Release 分发,手动解压即可)。 - AI 配置错在发请求前就拦下(
scripts/dict-auto.js):配错AI_BASE_URL的失败形态是「未译 11/11 条(100%)超过上限 30%」整版被门槛拦下,结论离原因很远。现在发请求前按 URL 语法再校验一次,并拦下看不见的字符——不换行空格、零宽空格、串内空格(语法上过得去,只是请求会打到别的路径上 404,报错里给出码点);失败原因随结论一并外露(注解 / step summary / 提交信息三处),脱敏 needle 补上主机名(网络层报错只带 host,漏了它脱敏就落空)。 - 右键菜单单测会被并行跑的夹具撞红(
test/context-menu.test.js):dictVersions()把dictionaries/下任何带zh-CN.json的目录都当成一个版本,而dict-edit的临时夹具0.0.0-test正落在同一目录里;node --test并行跑各测试文件,夹具存在的那几百毫秒里被读到——夹具加载得到、只是没有右键菜单标签,断言必然红。谁挂谁绿全看 runner 的并行调度:同一个提交在 windows-latest / macos-latest 上绿、ubuntu-latest / macos-15-intel 上红。现在按目录名形态过滤,只认x.y.z。 - CI 测试日志里的假
::warning::(test/dict-auto.test.js):单测里console.warn打出的行只要以::warning::开头,就会被 Actions 认成一条真注解收进日志,读日志的人以为 Secret 配错了。现在截获并断言,不直接打。
说明
- 本次新增脚本(
context-menu.js)并调整 GUI 打包形态(压缩级别、7z、语言包裁剪),属工具链变更,故取中版本 0.4.0。 - 注入块里的 role 名不得写成字面量:写成带引号的 JSON 键就落进字典的匹配范围,哪天字典收了
copy/delete这样的键就会被译掉、查表静默落空。故把角色名整体塞进一个字符串再JSON.parse,单测有断言钉住。 - 四个版本的字典各加一条作用域键
main.js|Delete(3.6.6 总键 2153 → 2154):官方main.js里Delete字面量 0 处,它只匹配注入块里的标签;renderer.js那 9 处(键盘映射表)靠作用域隔离,不受影响。 - 真机取证:干跑合计 2406 处(
main.js128,其中右键菜单标签 7 处 +renderer.js2278)与实际patch命中完全一致;落地复查用真实 Electron 44.4.1 跑安装目录里已打补丁产物的注入块,展开项标签为["&撤销","&重做","","剪&切","&复制","&粘贴","删除","","全&选"],应用菜单栏自带 label 未被动。 package.json版本号 0.3.0 → 0.4.0
v0.3.0
让汉化跟得上 GitHub Desktop 的更新:给它装一道更新管控闸——字典没跟上就不放行,字典备好了还能自动补打汉化;字典本身改成分段结构 + 唯一写入口并接上定时自动产出,3.6.6 一次补译 292 条(1861 → 2153);Gitee 镜像也能看到发行版了。
新增
- 更新管控补丁组(
scripts/update-control.js):往 GitHub Desktop 的main.js注入一道闸——checkForUpdates一进来先问「放不放行」。两种模式共用同一份注入块(切换模式 = 重新注入,产物里永远只有一套):patch --update-control是没有对应字典就不更新(工具支持的上限高于当前版本才放行,即新版本字典已就位),patch --block-update是完全禁止自动更新(一律不放行,连查都不查);restore --group updateControl恢复自动更新(汉化保留)。放行判据是「字典目录里带zh-CN.json的最大版本号」;判断不了(目录读不到 / 无字典)就放行——宁可让用户更新,也不要因为工具自己的问题把人锁死在旧版本上。注入点在产物 IIFE 之外(那里require是原生的,不受 webpack 运行时拦截),用首尾标记包住、重复注入安全;锚点不唯一时宁可不动(插错地方会让应用起不来)。图形界面同步加了「更新管控」按钮(三选一,与命令行同一套语义,两边不各写一份判定)。 - 更新后自动汉化(
scripts/update-control.js+scripts/patch.js):打包态注入时一并写死工具路径,GitHub Desktop 启动时若「字典已备好当前版本、产物却还是英文」就自动补打一次补丁。判据是补丁组记账里没有i18n——它既是「打过没有」的权威记录,也免得每次启动都白跑一次;spawn失败一律吞掉,这是锦上添花的一步,不能因为它让应用起不来。源码态不注入:那里工具就是仓库本身,用户自己跑npm run patch即可,写死一个 node 路径换台机器反而会指向不存在的东西。 - 补丁组记账(
scripts/common.js):tmp/patch-state.json记「对哪个版本应用了哪几组」——patch写入时并入已有,整份restore销账,restore --group X从官方原文重放保留组(而不是逐组撤销)。 - 字典改分段结构 + 唯一写入口(
dictionaries/*/zh-CN.json+scripts/dict-edit.js):formatVersion 2 顶层分common/windows/macos/linux/groups五段,运行时合并「common∪ 当前平台段」;键跨段重复判为非法并报错,而不是静默覆盖——那是分段格式特有的失效模式,会让人以为改对了、实际生效的是另一段。旧扁平格式按_meta.formatVersion回退,用户手里的自定义字典继续可用;解析差异全部由buildEntries一处吸收,patch/restore/verify/scan/dict-sync一行未改。新增的dict-edit.js是字典的唯一写入口(add/update/remove/set-group/move/merge/regroup/migrate/apply),事务写入:读原文 → 内存中变更 → 校验 → 写.tmp→ 读回重校验 →renameSync→ 写后复核,任一步失败即删.tmp、原文件从未被改动。组名由dict-groups.js读产物 sourcemap 推断。 - CI 定时自动产出字典(
scripts/dict-auto.js+.github/workflows/dict-auto.yml):取两平台官方产物 → 以历史字典的键为锚逐条核对新产物里的形态(继承)→ 官方新增的 JSX 文案走 AI 翻译 →dict-edit事务写入 → 推断组名 → 干跑校验。已有字典的版本直接跳过(幂等),传多个版本按升序逐个产出,可回填历史版本。候选口径只收 JSX 侧:实测 3.6.6 macOS 产物,字面量侧 1714 条候选里 1138 条是枚举值(Canceled)、事件名(PageDown)、注册表配置(VSCodium)、URL 片段这类噪声,JSX 文本节点侧 150 条里 130 条命中既有字典。已有字典另支持--on-exist=diff|overwrite两种重跑模式(diff全程不写盘)。 - 官方产物按需提取(
scripts/release-assets.js):不下载整包,用 HTTP Range 先取尾部窗口解析 zip 中央目录拿到条目偏移与压缩方式,再对目标条目发起 Range 请求 +inflateRaw解压,零依赖。平台产物路径在PLATFORM_SPECS里定死,Linux 置null而不是留个错的占位——官方近 30 个 release 的资产全为 Windows nupkg / exe / msi 与 macOS zip,真遇到该报错而不是猜。 - 图形界面两处:字典面板加**「组名」列**(三列变四列:英文 / 中文 / 组名 / 类型),组名取自字典的
groups段;面板只消费不解析(common.loadGroups()返回「键 → 组名」反查表),外部字典优先与内嵌资源回退那套逻辑仍只有一份。工具自更新也进了界面:启动后延迟检查工具自身版本,有新版才提示(检查失败静默),确认后下载安装包并启动安装——Windows.exe与 Linux.AppImage直接运行,macOS.dmg与 Linux.deb交给系统打开。 - Gitee 镜像发版(
.github/workflows/build.yml):Gitee 的仓库镜像只同步 commit / 分支 / tag,发行版不在同步范围内——releasejob 末尾新增「发布到 Gitee」步骤:按 tag 探测 → 没有就创建,正文取 CHANGELOG 段落并追加一段指向 GitHub Release 的下载指引。只发正文、不传附件:Gitee 的配额放不下这些产物——附件单文件上限 100 MB(13 个产物里 10 个是 106~146 MB,实测传 125 MB 的被拒「文件大小已超出限制:100 MB」)、单仓库附件总容量 1 GB(产物合计 1.38 GB),两项在 SaaS 各档位都一样(企业版单文件同样是 100 MB),只有私有化部署才提供定制配额;所以 Gitee 侧没有产物,正文里那段链接就是唯一的下载入口。两个 Gitee 特有的坑都已在代码里绕开:按 tag 查发行版时用200+ 字面量null表示不存在(不是 404,照搬 GitHub 的判据会把「不存在」读成「查询失败」)、创建后返回的对象没有html_url(按 tag 自己拼)。缺GITEE_TOKEN不阻断发布——check-version打一条::warning::、那一步直接跳过,Gitee 是镜像渠道,不该让它挡住权威源;该步骤失败只让 job 标红,已发布的 GitHub Release 原样保留。 - 检查更新加 Gitee 兜底(
scripts/update.js):GitHub 取不到时退回 Gitee 的/releases/latest;两条来源的资产对象形状不同(Gitee 只有browser_download_url,没有url),取用时归一化补齐。GUI 产物匹配同时认 electron-builder 的 Linux 架构写法(x86_64/amd64/aarch64,与 Node 的x64/arm64不同),否则 Linux 使用者永远找不到自己的安装包。 - 运维探针固化(
build/tools/):把 CI / Release 的中间过程脚本固化成匿名只读、零依赖、路径参数化的探针——CI 运行概览与 job 步骤明细、按 run id 直查、轮询等待、已发布 Release 的附件与上传者核对、产物命名回归(pickAsset只挑 cli、pickGuiAsset只挑 gui,含反向用例)、workflow 体检(run:块逐个bash -n+ YAML 禁忌)、替换判定(打出某处文案的前后上下文,并标出查表 / 比较 / 模块导出名 / switch 分支等高危上下文,判断仍由人做)。路径一律参数化——写死的话换台机器就跑不起来,而「能不能跑起来」正是探针有没有价值的全部。
变更
- 3.6.6 字典补译 292 条(1861 → 2153):补齐与官方正式版产物的形态缺口、内置 Copilot 提示词与冲突输入文档中文化、多提交操作流程与合并对话框的漏译、
Rebase等变基操作标签。其中「显示与逻辑复用同一字面量」的一类(Rebase)按新定的整体替换出口处理——全部出现位置在同一文件、无跨进程 / 持久化 / 上报、比较两侧同源、配套插值模板收尾正确时整组同值同改(34 处一起变「变基」,比较两侧仍同源),判据与实证见dictionaries/README.md与.claude/skills/translation-maintain/references/收录判定.md。 - 3.6.5 字典迁移到 formatVersion 2:条目数不变(1853 条),只改组织形式。
- AI 翻译链路接入思考强度与超时配置(
scripts/dict-auto.js):默认low/ 120 秒;AI_MODEL迁到仓库变量,配置按可见性分两处(可公开的进 Variables、密钥进 Secrets)。 - 文档:
README.md补更新管控按钮与三种模式、Gitee 下载渠道;AGENTS.md补 Gitee 发版与字典组织(formatVersion 2 五段结构 + 唯一写入口约束);dictionaries/README.md重写「字典格式」一节;docs/打包与分发.md增「定时字典」「Gitee 镜像发版」「Secrets 与 Variables 清单」三节;docs/dict-v2/收录字典 2.0 的方案 / 设计与任务清单。
修复
restore --group在记账为空时会把汉化一并还原(scripts/restore.js):补丁组记账是后加的功能,此前的汉化没有记录,按组还原会把它当成「没打过补丁」而恢复官方原文。现在抛错拦截,并给出两条出路(整份还原、或直接重新汉化)。restart.js两处缺陷:spawn的失败是异步的(走error事件,不抛在调用处),未接事件会让整个进程崩掉——产物其实已经写好,用户看到的却是报错;restartApp只按进程名判断在不在运行,目标不存在时会「把用户开着的应用关掉、却起不来还回去」——现在 kill 之前先确认目标存在。- CI 发布流程:发布改走数字 id,并支持「Release 已不在」时续建;Release 正文以
CHANGELOG.md为准(并给 v0.1.0 / v0.1.1 开头补上引用块);修复流程认得出上次中断留下的草稿、续传不再必然 403;checkout会清空工作区,落盘要排在它之后;新增rename-assets任务把 v0.1.0 / v0.1.1 的附件名统一到 cli / gui 命名(只动名字、不动字节,SHA256SUMS随之重算),并挡住「同 tag 还有草稿」时按 tag 寻址的二义。 - 单元测试写死「本机是 win32」,非 Windows runner 必然失败(
test/dict-edit.test.js):字典扁平导出的用例把「省略平台」的期望钉在 windows 段上,而 macOS / Linux 上当前平台段不是 windows,这条断言必然不成立。现按common.currentPlatform()取期望,并给三个平台段各放一条独有键——否则非 Windows 上「省略平台」与「只取 common」完全同形,断言测不到任何东西。产物本身不受影响。
说明
- 本次新增脚本(
update-control.js/dict-edit.js/dict-groups.js/dict-auto.js/release-assets.js)、字典组织方式变更(分段结构 + 唯一写入口)、新增运维探针,属工具链与字典组织的大改,故取中版本 0.3.0。 - 更新管控的两种模式互斥,切换方式是「先还原成官方原文、再按新模式打一遍」,产物里永远只有一份注入块,不会出现两套放行函数抢着赋值。
- 真机实测:在本机安装的
app-3.6.6上打过补丁并取证(记账落盘、产物字节差异、注入块位置与闸门、注入后整文件语法、DICT_DIR内联、源码态不注入TOOL符合设计);注入逻辑另用vm沙箱 mockrequire验过四种放行场景。 package.json版本号 0.2.0 → 0.3.0
v0.2.0
给不碰命令行的使用者一条路:新增 Electron 图形界面——汉化 / 还原 / 选择安装位置 / 检查更新都变成按钮,字典条目在窗口里只读可搜索。界面与命令行是同一套脚本的两种皮:定位 / 替换 / 备份 / 还原没有第二份实现。
新增
- 图形界面(操作面板)(
gui/,Electron 原生窗口):工具栏(汉化 / 还原 / 选择 / 检查更新 / 刷新)+ 只读字典表格(英文 / 中文 / 类型,中英双向、大小写不敏感搜索)+ 底部路径与进度 + 状态栏。操作前有确认框(提示原文件会先自动备份,还原区分「从备份精确还原」与「按字典还原」),完成后窗口内显示命中处数与重启结果,运行期间显示进度阶段;出错时错误与提示在窗口内可见,不弹原始栈。渲染进程无 Node 能力(contextIsolation: true+nodeIntegration: false+sandbox: true),表格只读,不存在字典写盘通道。 - GUI 打包(
electron-builder.yml+npm run dist):产出 Windows(NSIS 安装包,oneClick: false可选安装目录,另有 zip 免安装包)、macOS(dmg + zip)与 Linux(AppImage + deb)产物到dist/gui/。gui/+scripts/+package.json进app.asar,dictionaries/经extraResources进应用的resources/(node:sea在 Electron 里不可用,字典不能像单文件产物那样内嵌),GUI 首次运行时把数据根里缺的版本播种过去——macOS 的.app包内与 Linux 的 AppImage 运行目录都取不到 exe 旁那份;dataRoot()/dictionaries的「外部字典优先」逻辑因此零改动命中。 - CI 构建 GUI 产物(
.github/workflows/build.yml):新增guijob,与单文件产物并行跑同一套四平台矩阵(Windows x64 / macOS arm64 / macOS x64 / Linux x64,releasejob 等两类产物齐了再建 Release)。每平台构建后先跑静态自检(build/check-gui-dist.js:应用包结构、内置字典、Windows 产物是否 GUI 子系统),结构不对就不上传。 - 构建期镜像固化(
.npmrc+electron-builder.yml):Electron 二进制与 electron-builder 的winCodeSign/nsis工具包走 npmmirror,国内构建不必手动设环境变量(electron-builder 取 Electron 走resolveAssetURL、不读ELECTRON_MIRROR,故 yml 里另配一处electronDownload.mirror)。
变更
- 产物改 cli / gui 两套命名(
scripts/build.js+electron-builder.yml):通道词紧跟项目名、置于版本号之前,附件列表里同类相邻、一眼分得出谁是谁——单文件可执行是github-desktop-zh-cn-cli-v<版本>-<平台>-<架构>[.exe|.bin],图形界面是github-desktop-zh-cn-gui-v<版本>-<平台>-<架构>[-setup].<扩展名>(旧名github-desktop-zh-cn-v0.2.0-win32-x64.exe与…-v0.2.0-win32-x64.zip混在一起,看不出通道)。macOS / Linux 的单文件产物补上.bin后缀——此前没有后缀,在下载页里看不出是什么文件。scripts/update.js的自更新随之改为按「-<平台>-<架构>+ 平台后缀」匹配附件(无后缀的老产物也认),build/check-gui-dist.js增加一条产物名自检把命名钉住。 - 运行形态判据扩为两条(
scripts/common.js):新增isElectron()/isElectronPackaged(),与既有isPackaged()互斥地描述「数据根是否落在可执行文件旁」。源码态与 Electron 开发态(npm run gui)数据根仍是仓库根,Electron 打包产物与单文件产物一样取可执行文件所在目录。既有子命令、字典格式与单文件产物行为均未变。 - 文档:
README.md的「使用方式」新增图形界面一节(排在方式一,原「下载现成产物」顺延为方式二、「源码运行」为方式三),目录结构与已知限制同步;AGENTS.md补「界面层」与运行形态两态、打包态进程环境差异(asar 内__dirname、extraResources字典与首次运行播种、macOS 数据根例外、node:sea不可用);docs/打包与分发.md增加「图形界面(GUI)产物」小节、发布前检查项与常见问题;docs/gui/收录方案 / 设计 / 任务清单(含开发态往返一致性取证)。
说明
- 本次新增一整套界面形态与打包流程(工具链能力扩展),既有行为未破坏,故取中版本 0.2.0。
- GUI 产物随 Release 分发:CI 在四个 runner 上分别构建,与单文件产物一并作为 Release 附件(
…-gui-v0.2.0-win32-x64-setup.exe/…-gui-v0.2.0-win32-x64.zip/…-gui-v0.2.0-darwin-arm64.dmg/…-gui-v0.2.0-linux-x86_64.AppImage等),附SHA256SUMS。也可自行npm run dist构建(见README.md「方式一」)。 - 还留在 v0.1.x 的 macOS / Linux 使用者:本版给单文件产物补了
.bin后缀,而旧产物内置的更新逻辑只认无后缀的附件名,故在旧版上点「检查更新」会提示「发现新版本 v0.2.0,但没有本平台产物」——到 Release 页面手动下载一次即可,之后的自更新不再受影响(Windows 侧旧产物按.exe匹配,不受影响)。 - 分发 GUI 请用 zip 免安装包:electron-builder 的 portable 目标会把自身解压到临时目录再运行,
process.execPath指向临时位置,备份与config.json会跟着写进临时目录、退出后可能被清理,本仓库不配置该目标。 - 实测:开发态往返一致性(逆向还原 → 再汉化、GUI 汉化与 CLI 汉化)产物两文件逐字节一致(sha256 取证见
docs/gui/tasks.md);zip 免安装包解压后实机走完整界面链路——首次运行播种字典(表格 1861 条、字典取自数据根)、汉化命中 2242 处、按字典还原 2242 处、再汉化回到同一指纹,数据根与状态栏均落在解压目录。NSIS 安装包未实机安装(会写入系统)。 package.json版本号 0.1.1 → 0.2.0
v0.1.1
让产物不再「一次打包锁死」:字典可在运行时从仓库获取,工具自身也能在线更新;汉化 / 还原后自动重启 GitHub Desktop,没有备份时也能按字典还原成英文。
新增
- 字典在线获取:本地(外部目录 + 内嵌资源)没有对应版本字典时,自动从仓库拉取
dictionaries/<版本>/zh-CN.json(GitHub raw 主源 + jsDelivr 兜底,落盘前校验 JSON、写.part再改名);打包只内嵌最新版本字典,更早版本用到时才下载,产物不再随历史字典增长。 - 菜单第 5 项「检查更新(工具 + 字典)」:拉取当前版本的最新字典;打包态还会检查工具自身版本,发现新版本时下载、校验文件头(MZ / Mach-O / ELF)、替换自身并重启(源码态提示改用
git pull)。 - 汉化 / 还原后自动重启 GitHub Desktop:界面文本在应用启动时载入内存,不重启看不到效果;原本未运行时只提示,不替用户多开窗口。
- 没有备份时的还原:按字典把中文逆向替换回英文(有备份仍走逐字节精确还原)——官方安装包被清理掉也能还原,不必重装。
变更
- 菜单只展示结果:汉化 / 还原 / 更新过程不再刷屏,只留「命中多少处、是否已重启」这类最终结果;要看逐条明细仍可用命令行子命令(
patch --dry-run等)。 - 文档重组:完整使用教程(运行 / 指定位置 / 版本对应 / 文件放哪 / 换自己的字典 / 系统提示 / 卸载还原)与 GitHub Desktop 官网下载指引收录进
README.md;docs/打包与分发.md收敛为分发者视角(构建、跨平台、常见问题)。
修复
- 逆向还原的三处正确性问题(没有备份时的还原路径):无插值模板的整段区间此前未被收集,含反引号的原文塞回文本段会提前闭合反引号、还原后语法错误;译文本身就是空格 / 标点等通用文本(
" "、" / ")的条目参与逆替换会误伤原版同名文本(实测"that " → " "会让原版所有空格字面量变成"that ");英文排版同样会用的 Unicode 标点(省略号…等)参与逆替换会误伤官方原版(实测 11 处省略号被改写)。现按isReversible()判据排除不可辨识的译文,并保证「汉化 → 还原 → 再汉化」往返逐字节一致。 verify.js备份路径:改用common.backupDir(),此前自行拼路径与数据根目录约定不一致。
说明
- 本次按指定的 0.1.1 发布:新增在线能力与使用体验优化,既有子命令接口与字典格式未变。
package.json版本号 0.1.0 → 0.1.1