QingLong 3.0 Local Alpha Trial Kit

本目录是绑定一个 QingLong 3.0 源码提交、一个 Linux 架构和一次显式 GitHub milestone run 的阶段试运行套件，不是公开 release 或生产升级承诺。它同时包含常驻 Application 镜像和短生命周期 operator 镜像；两者共享的 OCI layer 只在同一个 Docker archive 中保存一次。

一套 Trial Kit 只有被同一 run 的 ql3-alpha-<sourceRevision>-local-<variant>-milestone 跨架构索引收录后才是可交付阶段产物。单个矩阵 job 提前上传、另一架构或完整 CI 随后失败时留下的 artifact 只是中间文件。先按 milestone manifest.json 选择 variant 和本机架构并核对本 bundle manifest digest，再执行下述离线验收。

适用范围

amd64 或 arm64 Linux Docker 主机；
低配路由/NAS 的 Edge profile，或资源较充足单机的 Standalone profile；
fresh、隔离的测试数据目录；
离线导入、设备兼容验证和 3.0 Alpha 用户旅程验证。

headless 是默认且最小的低配设备变体，不打开端口。console 是显式选择的 Linux-only 变体，携带离线 Web Console，并仅通过宿主 127.0.0.1:5700 提供操作面。二者是独立 archive，不应同时下载；远程 Console 只允许经 SSH tunnel 访问，不得暴露到 LAN 或公网。

不要把它直接用于生产数据、2.x 唯一数据目录或生产 Secret。Cluster/Kubernetes 节点应使用 Cluster Integration Candidate；本套件不包含 PostgreSQL HA、Worker 或 Cluster Admin。

离线验收

先在解压目录中执行不依赖 Node.js 的文件校验：

sha256sum --check SHA256SUMS

manifest.json 必须满足：

schema 为 qinglong/alpha-local-trial-kit@v4；
variant 为 headless 或 console，并与 milestone、application SBOM 和 artifact 名一致；
sourceRevision 是你准备试用的完整 40 位 commit；
architecture 与主机相同；
maturity 为 alpha_candidate_not_public_release。

manifest.json.verification 必须指向同目录的 verification-evidence.json。该 evidence 的 subject 必须与 manifest 中的版本、源码、架构和两个 image ID 完全一致；workflow 必须是 whyour/qinglong 的 ql3-ci.yml@refs/heads/next、workflow_dispatch、local-image。使用 workflow.runId 和 workflow.runAttempt 打开对应 GitHub Actions run，确认 source 和结论；JSON provenance 是可交叉检查的阶段证据，不是 Cosign/GitHub attestation。

如果同时持有 QingLong 源码和 Node.js 24，可执行严格的闭合文件集、manifest、SBOM 和 checksum 审计：

node scripts/ql3-local-alpha-trial-kit-bundle.cjs \
  --mode=audit \
  --bundle=/absolute/path/to/this-directory

任一校验失败都不要加载或运行 archive。

一条命令完成 Fresh 试运行

v4 bundle 内的 quickstart.sh 不依赖宿主 Node.js、jq 或 Compose，只需要 POSIX shell、sha256sum 和已启动的 Docker。必须选择一个尚不存在、与 2.x/生产数据完全隔离的绝对路径：

sh quickstart.sh edge /opt/qinglong3-alpha-data

资源较充足的单节点可以把 edge 改为 standalone。第三个可选参数用于指定容器名：

sh quickstart.sh standalone /srv/qinglong3-alpha-data ql3-alpha-standalone

脚本会自动执行全包 checksum、加载 archive、核对 exact image ID/source/architecture、以当前 UID:GID 和无网络的短生命周期 operator 完成 fresh setup 与首 Owner 建立，随后按 Profile 资源上限启动 Application。只有容器日志出现结构化 active 事件才返回成功。 Owner delivery 保留在新数据目录的 owner-delivery/，operator command 结果保留在 results/；两者都位于 0700 私有根内，不会打印 Secret 到终端。

成功输出会给出当前容器的 logs、graceful stop 和 remove 命令。停止/删除容器不会自动删除数据目录；确认不再需要诊断后由操作者显式删除该 fresh 测试目录。脚本拒绝既有目录，不能用于升级、迁移或接管 2.x。

Headless Application 是无外部 listener、AI-excluded 的最小 Alpha runtime。Console 变体同样 AI-excluded，但 quickstart 会在 Linux 上使用 host network，让容器内仍严格绑定 127.0.0.1:5700 的 Local API 可由宿主浏览器访问。成功后打开 http://127.0.0.1:5700/；远程主机必须建立 SSH tunnel。两种变体都只用于 fresh Alpha，不是 2.x Web UI 的生产替代版本。Console 能力和凭据边界见 Local Web Console。

手工加载与最小 smoke

从 manifest.json.archive.file 找到 archive 后加载：

docker load --input qinglong3-local-trial-kit-<arch>.docker.tar
# Console 变体使用 qinglong3-local-console-trial-kit-<arch>.docker.tar

以 manifest 中 images.application.reference 和 images.operator.reference 为准，分别核对 docker image inspect 返回的 image ID。然后执行无网络、只读 smoke：

docker run --rm --read-only --network none --cap-drop ALL \
  --security-opt no-new-privileges \
  <application-image> --help

docker run --rm --read-only --network none --cap-drop ALL \
  --security-opt no-new-privileges \
  <operator-image> --version

docker run --rm --read-only --network none --cap-drop ALL \
  --security-opt no-new-privileges \
  <operator-image> setup --help

Fresh 试运行边界

完整 fresh setup、首 Owner ceremony、Application active、SIGTERM drain、SQLite integrity 和原生 cancellation 必须在 verification-evidence.json 指向的同架构 milestone job 中验证。Console 还必须证明首页返回 200、未认证 API 返回 401。v4 artifact job 必须从将要上传的目录实际执行 quickstart.sh 并完成 graceful stop。实际部署时仍必须使用独立目录，并让 operator 以最终数据文件 POSIX owner 的 UID/GID 运行；operator 默认无网络且每次只执行一个命令后退出，不应作为 sidecar 或 daemon 常驻。

Edge 的验证上限为 Application 128 MiB、0.5 CPU、64 PID；Standalone 为 256 MiB、0.5 CPU、256 PID；operator 为 128 MiB、0.5 CPU、32 PID。这里的数值是试运行门，不是所有 workload 的容量承诺。

停止并删除 Alpha 容器即可回退 fresh 测试环境。若触碰 2.x 数据或进行迁移，必须使用项目既有 reconciliation/cutover/rollback 流程，不能只替换镜像。

6.4 KiB Raw Blame History Unescape Escape