qinglong/docs/operations/ql3-alpha-stage-index.md

QingLong 3.0 Alpha 阶段交付索引

本目录是一次 alpha_artifact_scope=all 运行的最外层交付入口。它把同一源码、同一 GitHub Actions run/attempt 的 Local Alpha milestone 与 Cluster Alpha milestone 绑定起来，并为 Edge、Standalone 与 Cluster 部署者给出机器可读的最小下载选择。它不是正式 release catalog，也不包含 Docker archive。

先判断设备类型

设备或环境	选择	稳态组件	需要下载
低配路由器、NAS、单机	deploymentSelections.local；默认选择 headless，需要浏览器操作面时显式选择 console	仅 Local Application；Operator 只在 setup/upgrade/recovery 短暂运行	目标架构、目标 variant 的一个 Local Trial Kit
临时 K3s/Kubernetes 集群	deploymentSelections.cluster	control、admin、worker；AI 按需增加 control-ai	目标架构的三个 required artifact；需要 AI 时再下载 optional artifact

不得把四个 Cluster 角色部署到低配路由器，也不需要为一台 amd64 主机下载 arm64 归档。索引固定列出十个可选择 artifact，但每个部署者只下载目标 Profile、架构和角色所需的子集。

验证

1. 在本目录运行 sha256sum --check SHA256SUMS。
2. 检查 manifest.json：
   • schema 为 qinglong/alpha-stage-index@v2；
   • deploymentSelections.local.variant 与 Local milestone、artifact 名和 Profile 一致；
   • maturity 为 alpha_stage_delivery_not_public_release；
   • source revision、run ID/attempt 是准备验证的显式 workflow run；
   • milestones.local 与 milestones.cluster 分别指向同一提交的 milestone artifact。
3. 下载两个 milestone 小索引，比较各自 manifest.json 的长度与 SHA-256 是否等于本索引的记录。
4. 按 deploymentSelections 下载目标大归档，再按对应 milestone 和 bundle README 逐层执行 checksum 与离线审计。

持有同一版本源码与 Node.js 24 时，可以一次复审三层索引：

node scripts/ql3-alpha-stage-index.cjs \
  --mode=audit \
  --stage=/absolute/path/to/stage-index \
  --local-milestone=/absolute/path/to/local-milestone \
  --cluster-milestone=/absolute/path/to/cluster-milestone

该命令拒绝跨 source、version、run/attempt 混用，重新执行两个 milestone auditor，并核对 milestone manifest digest 与部署选择。它不访问 Docker 或网络，也不会重新执行漏洞扫描、真实用户旅程或 Kubernetes live gate。

成熟度和回退边界

本索引只证明一次显式 Alpha 运行同时形成了两个部署档位的闭合候选物。Local 仅供 fresh、隔离、非生产目录试用；Cluster 仅供隔离 registry、临时命名空间和可删除数据库集成。它不提供受保护 tag、公开 GHCR immutable digest、签名、attestation、生产 deployment lock、HA、升级或长期支持承诺。

Local 回退是停止并删除 Alpha 容器和 fresh 测试目录；Cluster 回退是删除临时 workload、测试数据和 credential，并恢复原 deployment lock。任何 2.x 数据迁移或生产写入仍必须走正式 cutover/reconciliation/rollback ceremony。