Repository navigation
Portable Updater
updater/ 是独立编译的原生 Win32 更新器,产物只有一个 SniShaperUpdater.exe。它负责下载、校验、解压更新包,并以正常交互模式启动 Inno Setup 安装包完成覆盖与注册表更新。
- 单文件、静态链接:不依赖 .NET / Java / Python / Node / VC++ 运行库。
- 不启动任何外部进程:
cmd.exe、powershell.exe、reg.exe、tar.exe、7z.exe全部不调用。 - 内置
net/http下载(HTTPS、超时、重试、Range 续传)、archive/zip解压、SHA-256、Ed25519 清单签名、可选 Authenticode 校验。 - 进程管理、提权、等待退出码、延迟替换全部走 Win32 API。
.\build_windows.ps1 -Build all -Silent普通构建即可,不需要额外参数。每个 Windows GUI 目标构建时都会顺带编译对应架构的 SniShaperUpdater.exe、生成 updater.json,并把两者放进 build\bin\gui\Windows\<arch>\。
$env:GOOS='windows'; $env:CGO_ENABLED='0'
go build -trimpath -ldflags "-s -w" -o build/bin/updater/Windows/x64/SniShaperUpdater.exe ./updater产物:build/bin/updater/Windows/<arch>/SniShaperUpdater.exe。CI 的 build-windows 任务会编译三个架构,并为每个架构生成 snishaper-<version>-windows-<arch>-update.zip(Inno 安装包 + 更新器)与 updater-manifest-<arch>.json。若配置了 UPDATER_ED25519_SEED secret,还会生成 updater-manifest-<arch>.json.sig 与 updater-public-key.txt。
SniShaperUpdater.exe
updater.json
updater.json 必备字段见仓库 updater/updater.example.json:manifest_url(HTTPS)、public_key(Ed25519 公钥 base64)、app_id(与 Inno AppId 一致)、arch、channel。app_id 按架构不同:x64、x86、arm64 三个 GUID 在 CI 脚本里固定,不能混用。
日志写在同目录 updater.log(不可写时回退 %TEMP%\snishaper-updater\),临时目录为同目录 updater-work-*,成功后删除。
- 读本地版本:卸载项
DisplayVersion→Package.appxmanifest→version.txt。 - 取清单与签名,验 Ed25519,比较版本与通道。
- 下载 zip、校验 SHA-256、内置解压、定位
setup.exe并核对 MZ 头与哈希。 - MessageBox 提示保存数据 →
WM_CLOSE关闭旧进程 → 超时后询问强制结束。 -
ShellExecuteExW(runas)启动安装包,lpParameters为空:无/SILENT、/VERYSILENT、/SUPPRESSMSGBOXES。 -
WaitForSingleObject+GetExitCodeProcess,按 Inno 退出码 0–8 处理。 - 成功后核对注册表版本、清理临时目录;失败保留下载包与日志,旧版本文件从未被更新器改动。
更新器位于安装目录时会复制自身到 %TEMP% 并以独立进程续跑,避免文件占用;若清单带 updater.name,用 MoveFileExW(DELAY_UNTIL_REBOOT) 延迟替换自身。
安装版更新不再生成或启动任何脚本:GUI 找到同目录的 SniShaperUpdater.exe 就用 ShellExecuteW 启动它(-config 指向同目录 updater.json),更新器自己完成下载、验签、解压,并以正常界面启动 Inno 安装包。旧版本还没有更新器时,.exe 安装包回退为 runas 正常界面启动;便携 zip/7z 则提示手动下载安装包。cmd.exe、powershell.exe、tar.exe、7z.exe 全部不在更新链路里。
安装包、便携 zip 与 MSIX 都会随附 SniShaperUpdater.exe 与 updater.json(配置含 manifest 地址、该架构的 AppId、Ed25519 公钥):三类产物都从 GUI 输出目录打包。便携用户解压后主程序与更新器同目录,GUI 点更新即直接启动更新器。MSIX 里的更新器随包签名,但沙箱应用不能运行时下载执行新文件,MSIX 更新仍由系统商店负责。
publish 任务在 release 发布后自动登录公告后台并发一条公告:先 POST https://jetcpp.ccwu.cc/api/admin/session 取 token,再 POST https://jetcpp.ccwu.cc/api/notices。公告包含中/英/俄三语标题与正文、important/info 级别、发布时间,以及指向具体 release 页面的外链;公告 id 取 release-<tag>,重复发版会替换同一条而不是堆积。凭据放在仓库 secret(ANNOUNCEMENT_ADMIN_EMAIL、ANNOUNCEMENT_ADMIN_PASSWORD),缺失时跳过该步骤,不影响发版。
CI 需要的 secret 还有 UPDATER_ED25519_SEED(清单签名种子,32 字节 base64)。
AppId 稳定({AppId}_is1 卸载项唯一)、PrivilegesRequired=admin(不要 PrivilegesRequiredOverridesAllowed=dialog,否则会出现 HKLM/HKCU 双卸载项)、UsePreviousAppDir=yes、CloseApplications=yes、RestartApplications=no、Uninstallable=yes、[Files] Flags: ignoreversion overwritereadonly restartreplace、[Registry] 写版本与安装目录。完整示例见仓库 docs/inno-setup-upgrade.iss.example 与设计文档 docs/portable-updater.md。
- Home
- 完整使用指南
- CLI 命令参考
- 核心模式详解
- 智能分流详解
- 规则自定义指南
- 界面配置指南
- 证书重新安装
- macOS 菜单栏应用
- Linux 软件包
- 代码结构
- Snishaper-Core 核心库
- CI 与 PR 自动化
- 便携式自动更新器
- 常见问题与排障
- Home
- Usage Guide
- CLI Reference
- Core Proxy Modes
- Auto Routing
- Custom Rules Guide
- GUI Configuration
- Certificate Installation
- macOS Menu Bar App
- Linux Packages
- Code Structure
- Snishaper-Core Library
- CI & PR Automation
- Portable Auto-Updater
- FAQ