Skip to content

build(windows): 签名 MSIX 安装、升级、卸载与发布证明 #57

Closed as not planned

Description

@Qiyuanqiii

Parent: #37

问题概述 / Summary

Prayu 尚无正式安装包、代码签名和可验证升级/卸载流程。需要完成 per-user MSIX(或经 ADR 论证的等价方案)、证书管理、CI 签名、数据保留与回滚策略。

当前基线 / Current baseline

  • Desktop 目前是 unsigned portable preview。
  • 仓库不应保存私钥或测试 API key。
  • 注册表、文件关联、自动启动和后台服务不是第一版默认需求。

范围 / Scope

  • 通过 ADR 确定 MSIX identity、per-user 安装范围、版本与升级规则。
  • 建立图标、manifest、WebView2 prerequisite、安装目录和用户数据目录合同。
  • 在受保护 CI 环境使用代码签名证书/硬件或托管签名,不导出私钥。
  • 验证安装、同/升级、降级拒绝、repair、卸载、重装和用户数据保留/删除选择。
  • 生成签名验证、certificate chain、artifact hash、source commit 和 provenance。
  • Release 页面提供下载、签名校验、安装、升级、卸载和诊断说明。
  • 保持 portable ZIP 作为明确区分的替代发布物。

非目标 / Non-goals

  • 不默认增加系统服务、开机自启、文件关联、自定义 URL protocol 或 machine-wide 权限。
  • 不做 Microsoft Store 发布或企业 MSI;可在后续单独规划。
  • 不把签名私钥放入仓库、普通 CI secret 输出或开发机文件。

涉及目录 / Affected directories

  • cmd/cyberagent-desktop/
  • internal/desktop/
  • web/
  • packaging/windows/
  • scripts/
  • .github/workflows/
  • docs/
  • README.md

依赖 / Dependencies

  • 依赖 portable release metadata/SBOM 合同。
  • 最终 release sign-off 依赖 Windows 实机矩阵。

验收条件 / Acceptance criteria

  • MSIX identity/version/upgrade/data paths 有 ADR 与稳定 manifest。
  • CI 签名密钥不可导出且日志不泄露证书 Secret。
  • 安装、升级、降级拒绝、repair、卸载、重装矩阵在 Windows 10/11 通过。
  • 默认卸载不会意外删除用户 Workspace/API 配置;删除数据必须单独明确确认。
  • WebView2 缺失/不兼容时给出安全、可操作诊断。
  • Authenticode/package signature、certificate chain、SHA-256 和 provenance 可由用户验证。
  • SmartScreen/Defender、时间戳服务不可用和签名失败时发布 fail closed。
  • GitHub Release 文档中英文完整,portable 与 installer 风险/用途区分清楚。

人工配合 / Human assistance

需要仓库所有者选择并配置正式代码签名方案、保护 CI Environment,并在真实 Windows 机器上验收安装生命周期。

Activity

  1. added
    enhancementNew feature or request
    help wantedExtra attention is needed
    github_actionsPull requests that update GitHub Actions code
    desktopDesktop client and Windows distribution
    securitySecurity boundary or high-risk capability
    on Aug 13, 2026
  2. Qiyuanqiii commented on Aug 21, 2026

    @Qiyuanqiii
    MemberAuthor

    自签开发验证收尾 / Self-signed development closeout

    按当前产品仍会改名、前端与 Store identity 尚未冻结的现实,本 issue 以“开发阶段 MSIX 生命周期已验证,生产信任范围延期”收口。正式公开签名与 Microsoft Store 发布已迁移到 #123;本关闭不声称自签证书满足公开 CA、SmartScreen 或正式 release sign-off。

    本次实测

    • Source revision: d80a5ce
    • Host: Windows 11 Pro, build 26200
    • 隔离 clean worktree 完整构建通过:
      • 65 个前端测试文件、288 项测试通过
      • npm audit 0 vulnerabilities
      • Windows 自动兼容检查通过
      • 连续两次 Desktop 构建字节一致
      • unsigned reproducible EXE SHA-256: be17b649ae456e1006ca983460763d95f0aaadb8168b561940b25bd26db7dbb2
    • 短期测试证书:
      • Subject: CN=Prayu
      • SHA-1 thumbprint: 305793E038A48761C9B224930B3899E12AD10DFB
      • CNG export policy: None;私钥导出尝试被拒绝
      • 未生成或保存 PFX
      • EXE 与 MSIX 均使用 SHA-256,并取得 DigiCert RFC 3161 时间戳
    • 签名后验证:
      • EXE signature status: Valid
      • 0.1.57.1 MSIX SHA-256: b6e23e1edb96d10e85f9e4384fcb7ddfa7b140c61262c543a2cdb889acfca690
      • 0.1.57.2 MSIX SHA-256: ad554fe782404ac3c8b3a2d255547b85b320de462f4bd17b9678fa35c49e8653
      • 两个 MSIX signature status: Valid(仅在显式信任该测试证书时)
    • 真实 AppX 生命周期全部通过:
      • fresh install 0.1.57.1
      • same-version install 幂等 no-op
      • upgrade 0.1.57.1 -> 0.1.57.2
      • downgrade 0.1.57.2 -> 0.1.57.1 被 Windows 拒绝,已安装版本保持 0.1.57.2
      • manifest re-register repair
      • uninstall
      • reinstall 0.1.57.2
      • 默认用户数据目录卸载前后只读内容指纹完全一致
    • 测试后清理:
      • PrayuDesktop package count: 0
      • LocalMachine/CurrentUser 中该精确指纹证书 count: 0
      • 测试包未上传、未加入 GitHub Release

    延期边界

    以下原生产验收不以本 issue 完成论处,统一由 #123 在品牌与前端冻结后完成:

    • Microsoft Store/正式 package identity 和正式图标;
    • Store 重签或 Store 外公开受信任 EXE/MSIX 签名;
    • 受保护 CI Environment、托管/HSM 私钥与 artifact attestation;
    • SmartScreen/Defender、正式时间戳服务故障与发布 fail-closed;
    • 品牌冻结后的同一正式候选 Windows 10/11 最终矩阵和 release 文档。

    因此本 issue 以 superseded/not planned 关闭,而不是把未满足的生产签名检查框误标为完成。开发阶段的实现基线仍由已合并 PR #84 保留。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    desktopDesktop client and Windows distributionenhancementNew feature or requestgithub_actionsPull requests that update GitHub Actions codehelp wantedExtra attention is neededsecuritySecurity boundary or high-risk capability高难度

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions