Skip to content

windows-unsigned-native-auto-update-2026-08-26.md

Latest commit

 

History

History
123 lines (92 loc) · 17.1 KB

windows-unsigned-native-auto-update-2026-08-26.md

File metadata and controls

123 lines (92 loc) · 17.1 KB
Raw

Windows 无签名原生自动更新与差分下载

创建时间：2026-08-26 最后更新：2026-08-29 当前状态：✅ v0.67.10 Windows updater bootstrap 与后续 v0.67.11 stable 均已 Shipped。v0.67.11 不可变 tag 指向 08f0bb80；正式 run 33230535883 全绿并公开 20 个资产的 Latest Release。Windows 继续采用用户确认过的“无 Authenticode、GitHub 为单一信任根”模型；Linux 保持手动安装。公开 latest-mac.yml / latest.yml、对应完整包、外置 blockmap、checksum 与 provenance 已复核；Windows RC-A → RC-B 真实差分/完整回退 smoke 仍待完成，因此不写 Smoke passed / Release ready。

用户问题与取舍

用户希望先交付 Windows 自动更新，不申请 Microsoft/Azure Trusted Signing，也不配置 PFX 发布者证书。此前讨论已经确认：Windows 的 per-user NSIS 安装不依赖管理员写入权限或证书；证书解决的是独立发布者身份，不是文件写入权限。用户接受不使用独立发布者签名，并以固定的 op7418/CodePilot GitHub Release、HTTPS、builder metadata 中的 SHA-512、不可变 Release、受保护 tag、最小 Actions 权限和完整资产审计作为当前信任模型。

这个取舍仍有明确残余风险：若仓库管理权限、Release workflow 和首次发布同时失守，攻击者可以一起替换 installer、metadata 和 hash；客户端不能像 Authenticode 那样用独立 publisher identity 识别这种情况。GitHub attestation 是人工/外部核验凭据，当前 electron-updater 不会在安装前自动验证它。

状态

Phase 用户会看到什么变化 状态 明确不做什么
Phase 0 结论从聊天记录落成可审计合同 ✅ 已完成 不申请微软签名，不把 SHA-512 宣称为发布者签名
Phase 1 Windows 正式包能发现、下载并在用户确认后安装新版本 ✅ v0.67.10 bootstrap 已 Shipped 既有 v0.67.7 不会凭空获得 updater；第一跳仍需手动安装 bootstrap 版本
Phase 2 后续 Windows 更新优先差分下载，失败时自动回退完整安装包 ✅ 产物链已 Shipped / 真实跨版本待验 不承诺固定节省比例；节省量由两个真实版本的 blockmap 决定
Phase 3 发布者能看到仓库信任门禁和完整 Windows updater 资产审计 ✅ 仓库设置与权限可见性修复完成 门禁未满足时不公开 latest.yml，不把 attestation 冒充客户端强制校验
Phase 4 Windows RC-A → RC-B 的真实升级结果可验收 🟡 v0.67.10 bootstrap 已 Shipped；真实 RC-A → RC-B 待执行 Linux updater、包管理器提权安装与 Linux manifest 不进入本轮

执行清单

Phase 0 — 决策与现状审计

  • 回看此前聊天记录，确认用户选择的是 unsigned Windows auto-update，而不是等待另一类 Windows 证书。
  • 核对当前仓库：Windows stable provenance=0，Release 排除 latest.yml/EXE blockmap；v0.67.7 只能手动 bootstrap。
  • 核对 electron-updater@6.8.3 / electron-builder@26.8.1 精确实现：NSIS 默认支持 installer blockmap 差分，安装器会缓存 installer.exe，差分失败会回退完整下载。
  • 只读核对 GitHub：Immutable Releases=false；main ruleset=disabled；Actions 默认 token=read，但 third-party Action SHA pin 强制项=false。

Phase 1 — Windows official updater 与诚实风险 UI

  • stable Windows 构建嵌入 official updater provenance；fork/local/Linux 继续 no-op。
  • unsigned 模式同时关闭 builder 强制签名与 publisher verification metadata，校验 installer/app 为 NotSigned 且 app-update.yml 不含 publisherName。
  • Main 从 packaged app-update.yml 读取 publisherName 生成真实 publisher breadcrumb；UI 仅在 nsis + none 显示 unsigned 提示，unknown 关闭 native updater，不能由平台常量猜测。
  • 保持 Main-owned feed、窄 IPC、活动任务 fail-closed、用户确认重启与手工 fallback。

Phase 2 — 差分资产与回退

  • builder 显式生成 NSIS differential package；Main 显式保持 differential download 开启。
  • Windows artifact/checksum/attestation/release graph 包含同版本 latest.yml、NSIS installer 与 installer blockmap。
  • central verifier 要求 metadata URL 是当前版本裸 basename，校验 SHA-512、size、外置 blockmap 存在性和精确 checksum 集合；拒绝旧版本/额外 payload 与所有 Linux updater metadata。blockMapSize 只用于嵌入式 blockmap，不能强加给 Mac ZIP/完整 NSIS 的 builder 原生 metadata。
  • source-contract 覆盖缺 metadata、缺 blockmap、错 hash、外部 URL、旧版本 payload、checksum 前缀蒙混、Linux feed 混入和 full-download fallback pin。

Phase 3 — GitHub 单一信任根门禁

  • 所有 workflow 的 uses: 固定到完整 40 位 commit SHA，并由测试禁止恢复 mutable tag。
  • stable Release 发布前 fail-closed 核对：Immutable Releases 管理员确认只接受当天/前一 UTC 日；默认分支与 v* tag ruleset 各恰好一个、active、无 bypass/exclude，并分别禁止删除/非快进与删除/更新。
  • 保持 workflow 顶层 contents: read，仅 release job 获得 contents/OIDC/attestation 写权限，完整资产先 draft 后一次公开。
  • 用户授权发版后启用 active main 与 stable-release-tags ruleset，并设置新鲜的 Immutable Releases 管理员确认。
  • 修复 v0.67.8 正式 run 暴露的权限语义：Actions GITHUB_TOKEN 不会返回敏感 bypass_actors；管理员完整响应先生成 CODEPILOT_RULESETS_CONFIRMED_STATE，CI 再以 live id / updated_at 精确匹配，缺状态或任何漂移都 fail closed。

Phase 4 — 验证与发布前人验

  • Claude 审查修复后重新完成 targeted tests、npm run test、production build、Electron bundle 与 workflow YAML 解析。
  • 首个 Windows updater 版本升级版本号时同步当版 RELEASE_NOTES.md；v0.67.8 / v0.67.9 未公开且不可复用，v0.67.10 已作为 bootstrap 公开，不回写已发布的 v0.67.7 历史说明。
  • Windows clean VM 手动安装 RC-A（bootstrap），保留自定义安装目录和用户数据。
  • RC-A → RC-B 从 latest.yml 自动发现、下载；分别收集差分成功与 blockmap 不可用时完整下载回退证据。
  • 更新下载后存在 active chat/bridge/task 时拒绝退出；idle 后确认重启，安装 handoff 成功且新版本可启动。
  • SmartScreen 的真实表现记为产品限制，不把“可能提示”写成“不会提示”。

详细设计

信任边界

official stable Windows app
  → 固定 GitHub provider: op7418/CodePilot
  → latest.yml（同一 draft→public Release）
  → installer SHA-512 + external blockmap
  → 下载完成后用户确认重启
  → unsigned NSIS 安装

latest.yml 与 installer 的一致性由 central audit 保证；HTTPS/GitHub、immutable Release、rulesets 与 SHA-pinned Actions 共同构成唯一信任根。客户端不会声称验证了 Microsoft/Authenticode publisher。

Bootstrap 与差分语义

  • 已发布的 v0.67.7 编译时 official updater provenance 为 0，不能通过远端 metadata 改造成 updater 客户端。因此用户必须手动安装首个开启 Windows updater 的版本。
  • 标准 NSIS 安装器会把本次 installer 缓存为 updater cache 的 installer.exe。从该 bootstrap 版本开始，下一版本可以利用旧/新 blockmap 请求差异区间。
  • “增量更新”是优先路径，不是独立的小补丁格式。blockmap 缺失、旧 installer 不可用或 Range 下载失败时，electron-updater 自动下载完整 installer；更新不能因差分不可用而永久卡住。

发布边界

  • stable：macOS 保持签名/公证的 ZIP updater；Windows 增加 unsigned NSIS updater；Linux 仍只有手动包。
  • preview：本轮不扩 Windows prerelease feed，避免在没有真实 Windows RC smoke 前扩大渠道。
  • tag/Release 不覆盖、不移动、不复用；坏版本只发更高 patch。

验收标准

  1. Windows official stable 包的 updater snapshot 为 supported=true、packageType=nsis、publisherVerification=none；签名 fixture 为 authenticode，缺失/畸形 packaged config 为 publisher_verification_unknown 并禁用 native；Linux 仍返回 linux_trust_not_enabled。
  2. Release graph 同时有 latest-mac.yml、latest.yml、Mac ZIP blockmap 与 Windows EXE blockmap；没有任何 latest-linux*.yml。
  3. unsigned Windows 包的两个 CodePilot EXE 均为 NotSigned，客户端配置无 publisherName，UI 明示没有独立发布者签名。
  4. 仓库保护未启用、Immutable 确认过期、ruleset 有 exclude/重名时 release job 在公开 Release 前失败；main 禁删除/force-push，v* tag 禁删除/更新，不能留下用户可见的半套 feed。
  5. 真实 Windows RC-A → RC-B 完成差分尝试、完整下载 fallback、活动任务拦截、安装接管和数据保留 smoke，之后才能标 Release ready。

Smoke Ledger（真实凭据 / UI / E2E 验证记录）

Date Runtime Provider Model 凭据形态 场景 Result Evidence
2026-08-26 GitHub repository op7418/CodePilot n/a 只读 gh api，未读取 secret value unsigned updater trust prerequisites ❌ 发布阻断 Immutable Releases=false；main ruleset disabled；Actions SHA policy=false；default workflow token=read
2026-08-26 local macOS workspace Node 22 / Electron bundle n/a 无真实发布凭据 Claude findings 修复后 source contract + 全量单测 ✅ Tests pass targeted 26/26；npm run test 5389 pass / 0 fail / 1 skip；首次沙箱运行的 localhost EPERM 通过沙箱外原命令复验消除
2026-08-26 isolated local build Next 16 / esbuild n/a official-build compile-time fixture production build + Electron Main/Preload bundle ✅ Build pass 原工作区 dev lock 保留；隔离副本 next build 与 official updater bundle 成功，产物固定 differential=true / web installer=false / officialBuild=true，并包含 packaged publisher breadcrumb fail-closed 逻辑
2026-08-26 GitHub Actions macOS + Intel + Windows + Linux stable v0.67.8 n/a 正式 Apple secrets；Windows signer 全缺；Actions GITHUB_TOKEN 正式三平台 package + single-trust-root publish gate ❌ Release blocked，未公开 run 32989409053：source、Windows unsigned package、Linux 双架构、Mac 签名/公证/Intel ABI 全绿；release job 因 API 不暴露 bypass_actors 在公开前 fail-closed。tag 保留，不创建/不修改 Release
2026-08-26 GitHub repository API op7418/CodePilot n/a 管理员 token + anonymous read；未记录 token value no-bypass 管理员确认状态生成与 Actions 等价防漂移复验 ✅ Gate fixture pass 管理员响应确认两条 ruleset 的 bypass_actors=[]；公开响应隐藏该字段但 live id / updated_at 与 CODEPILOT_RULESETS_CONFIRMED_STATE 精确一致；定向契约 8/8
2026-08-27 GitHub Actions macOS + Intel + Windows + Linux stable v0.67.9 n/a 正式 Apple secrets；Windows signer 全缺；Actions GITHUB_TOKEN 正式三平台 package + central asset audit ❌ Release blocked，未公开 run 32995824925：所有 source/package/Intel ABI job 与 single-trust-root gate 全绿；central audit 错把外置 ZIP blockmap 要求成 metadata blockMapSize，在 draft/public Release 前阻断。锁定 builder 类型与公开 v0.67.7 metadata 均确认该字段只属嵌入式 blockmap；tag 保留
2026-08-27 GitHub Actions macOS + Intel + Windows + Linux stable v0.67.10 n/a 正式 Apple secrets；Windows signer 全缺；Actions GITHUB_TOKEN 正式三平台 package、Intel universal 启动、single-trust-root、20 资产 central audit、draft → public ✅ Shipped；workflow 全绿；Latest Release 公开 Actions / Release。tag 精确指向 1bf6ff31；20 资产含 Mac 3 DMG + 3 ZIP + 3 ZIP blockmap + latest-mac.yml、Windows unsigned NSIS + EXE blockmap + latest.yml、Linux 6 手动包及 checksum。公开 metadata 均为 0.67.10、各恰好一个完整包目标，size 与公开资产一致；19 个非 checksum 资产全部进入 SHA256SUMS.txt，无 latest-linux*.yml。真实 Windows RC-A → RC-B 未跑，不记 Smoke passed
2026-08-29 GitHub Actions macOS + Intel + Windows + Linux stable v0.67.11 n/a 正式 Apple secrets；Windows signer 全缺；Actions GITHUB_TOKEN bootstrap 后首个 stable 后继版本、single-trust-root、20 资产 central audit、attestation、draft → public ✅ Shipped；workflow 7/7 jobs 全绿；Latest immutable Release 公开 Actions / Release。tag 精确指向 08f0bb80；latest.yml 只引用同版本完整 NSIS，size 与公开资产一致，EXE blockmap 存在；19/19 checksum 与 20/20 provenance 独立复核通过，无 Linux updater metadata。未在 installed v0.67.10 上执行真实差分/完整回退，因此仍不记 Smoke passed
待执行 Windows packaged Electron GitHub Release n/a unsigned NSIS RC-A bootstrap → RC-B differential/full fallback ⏳ clean VM run / installer logs / version+data checks

决策日志

  • 2026-08-26：用户明确“先做 Windows，Linux 延后，不申请微软签名”。采用此前讨论过的 GitHub single-trust-root unsigned updater；不再把 Windows auto-update 与 signer 配置绑定。
  • 2026-08-26：基于当前工作树 a5450197 完成现状审计。发现三项仓库保护尚未满足，因此实现采用 publish-time fail-closed，而不是先发布 unsigned feed 再补门禁。
  • 2026-08-26：差分更新沿用 exact-pinned electron-updater@6.8.3 的 NSIS blockmap 机制；显式固定 differential 开启并保留完整 installer fallback，不自造 patch 协议。
  • 2026-08-26：在未提交工作树完成实现与本地验证；保留正在运行的 Next dev 进程，通过隔离副本完成 production build。当前状态只能报 Tests pass，必须等仓库保护启用和 Windows RC-A → RC-B 真实 smoke 后才能报 Release ready。
  • 2026-08-26：Claude 只读审查报告 2 个 P2、4 个 P3，逐项复核均成立；本轮不以 tech-debt 关闭，直接修复真实 publisher breadcrumb、当前版本资产白名单、裸 metadata URL、精确 checksum 集合、ruleset exclude/重名/分页与短时 Immutable acknowledgement，并补负例测试。
  • 2026-08-26：用户授权发版后，启用 Immutable Releases 管理员 acknowledgement、active main no-delete/no-force 和 v* no-delete/no-update ruleset；v0.67.8 正式 run 的所有平台构建通过，但 final release job 发现 Actions GITHUB_TOKEN 因没有 ruleset write access 而不返回 bypass_actors。这是权限可见性与 verifier 假设不匹配，不是规则缺失；按不可变发布纪律保留失败 tag，不重跑/移动。
  • 2026-08-26：不把缺失 bypass_actors 降级为空，也不把管理员 PAT 放进 Actions。改为管理员完整响应验证 no-bypass 后生成短时确认状态，CI 实时核对同一 ruleset 的 shape、id 与 updated_at；任何规则改动都会要求管理员重新确认。修复版本递增为 v0.67.9。
  • 2026-08-27：v0.67.9 已通过 ruleset gate，却在 central audit 暴露 blockMapSize 语义错误。锁定的 builder 类型定义说明该字段用于嵌入式 blockmap，公开 v0.67.7 的原生 latest-mac.yml 也只包含 sha512/size；Mac ZIP 与完整 NSIS 使用外置 sidecar。修复保留 sidecar 存在性与 checksum fail-closed 门禁，不手写 metadata，候选递增为 v0.67.10。
  • 2026-08-27：不可变 v0.67.10 tag 精确指向 1bf6ff31，正式 run 33001442911 的 source、Windows unsigned package、Linux 双架构、Mac Developer ID/公证/staple、Intel universal SQLite、single-trust-root、精确版本资产审计、attestation 与 draft → public 全绿；公开 Release 为 Latest 且资产图与 updater metadata 复核通过。首个 Windows updater bootstrap 因此记为 Shipped；它证明正式产物链可发布，不替代下一版本 RC-A → RC-B 的真实差分、完整回退、活动任务拦截与安装接管 smoke。
  • 2026-08-29：后继 stable v0.67.11 正式发布，tag 08f0bb80 与 run 33230535883 全绿；公开 latest.yml、完整 NSIS、外置 blockmap、checksum、immutable/Latest 状态与 provenance 复核通过。它证明 bootstrap 后续版本资产已公开，但由于未在 installed v0.67.10 上真实执行下载/安装，本计划仍保留差分、完整回退、活动任务拦截与安装接管 smoke。