离线交付包

标准离线交付使用 Mac 本地 USB/offline bundle。Windows Build Runner 负责 Windows 原生构建和基础测试；授权 Windows 设备只接收已验证包并执行安装。

交付原则

交付包应使用已验证版本。授权 Windows 设备只执行安装和验证，不参与源码构建、不安装 Jenkins agent、不从 GitHub clone 代码。

标准发布路径

%% avenue: linear-large %%
%%{init: {"theme":"base","themeVariables":{"fontFamily":"Inter, -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif","background":"#FAF9F5","primaryColor":"#F4F1EA","primaryTextColor":"#141413","primaryBorderColor":"#D8CBB8","lineColor":"#6F6B63","secondaryColor":"#FFFFFF","tertiaryColor":"#EAF1F7","clusterBkg":"#FAF9F5","clusterBorder":"#E8E6DC"},"flowchart":{"curve":"basis","padding":14,"nodeSpacing":34,"rankSpacing":44,"htmlLabels":true,"useMaxWidth":false}}}%%
flowchart LR
  A([代码版本]):::start --> B[构建环境]:::system
  B --> C[Smoke 验证]:::preview
  C --> D[离线包]:::step
  D --> E[授权设备安装]:::step
  E --> F([验收检查]):::done


  classDef start fill:#141413,color:#ffffff,stroke:#141413,stroke-width:1px;
  classDef step fill:#F4F1EA,color:#141413,stroke:#D8CBB8,stroke-width:1px;
  classDef system fill:#EAF1F7,color:#141413,stroke:#6A9BCC,stroke-width:1px;
  classDef decision fill:#EFE7DA,color:#141413,stroke:#C58B5A,stroke-width:1px;
  classDef action fill:#F7E4DC,color:#141413,stroke:#D97757,stroke-width:1px;
  classDef done fill:#EDF1E7,color:#141413,stroke:#788C5D,stroke-width:1px;
  classDef module fill:#FFFFFF,color:#141413,stroke:#E8E6DC,stroke-width:1px;

关键原则

项目	规则
Staging validation	直接安装 Jenkins workspace artifact，installedFrom=jenkins-workspace
项目交付	使用 Mac 本地 USB/offline bundle
授权 Windows 设备	不安装 Jenkins agent，不克隆 GitHub，不构建源码
发布判断	比较 target、version、源码版本号、Jenkins build、安装包 SHA-256 校验值
云更新	只在明确启用 lifecycle feed 时使用 R2/下载网关

交付包结构

avenue-agent-install-package/
  Install Avenue Agent.exe
  manifest.json
  artifacts/
    windows-connector/
    setup-wizard/
    email-drafts/
    excel-workflow/
    email-ingest/
    easyview/
    extramile/
    playwright-runtime/
    libreoffice-runtime/
  install/
  docs/
    site/

验收项目

• manifest.json 包含每个 target 的文件名和 SHA-256 校验值。
• 安装器可以校验并安装所有必需 target。
• 安装记录记录 源码版本号、Jenkins build number 和 安装包 SHA-256 校验值。
• 首次配置向导（Setup Wizard） 可以完成首次配置。
• 本地连接服务在线状态、邮件、Excel、EasyView、ExtraMile 按项目启用范围通过验证。

接收检查

收到交付包后，应确认文件完整、manifest.json 存在、SHA-256 校验值与交付记录一致，并确认 docs/site/index.html 可离线打开。