Repository navigation
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