AI 合同平台 V2 生产外部门禁闭环

日期：2026-08-11

当前结论

六项外部门禁已收敛为一个必须由真实自然人完成的入口：具名法务本人对精确技术包和产品黄金套件作出批准并使用本人控制的 Ed25519 私钥签名。AI 不得代签，也不得把技术通过写成法务批准。

在该签名到位前，正式生产保持 No-Go：yuqei-v2-production 容器数为 0，api.contact.yuqei.com 根路径返回 503，未切换 DNS 或业务流量。签名到位后，余下 finalize、receipt pin、production preflight、备份恢复、双节点 canary、撤销和 kill switch 演练均已有确定命令和基础设施，不再需要新增产品代码。

六项状态

门禁	状态	已完成证据	剩余动作
1. 具名法务签署	外部阻塞	固定包 SHA-256 `ed1830430e8049397800cc75e9c24bac85a093a268bb669cf9d8db862adac9f2`；18 条 Provider 结果、10 张知识卡、31 条合同生成/条款推荐黄金用例均完成技术对账；离线签署/验签工具和 runbook 已完成	法务本人提供真实身份字段，审阅并亲自签名
2. acceptance receipt / promotion	等待门禁 1	receipt Ed25519 私钥只保存在共享预发布主机，公钥 keyring 已放入 production 验证目录；AI 镜像 digest 已固定	运行 `finalize`，生成真实 `acceptance_run_id`、receipt v2 和 promotion bundle
3. production env / TLS / DNS / 备份	准备完成，等待 receipt	`api.contact.yuqei.com` DNS 有效；专用 Let's Encrypt 证书有效至 2026-11-09；production env draft 权限 `0600`；preflight `21/24`，仅 receipt 三项失败；Compose config 通过；阿里云 NFSv4 异地挂载 70GB 可用	写入 receipt 和 SHA pin，将 draft 原子提升为正式 env；启动后执行首份备份及隔离恢复演练
4. 双节点 canary	准备完成，等待 receipt 和主节点	`192.168.3.90` 与阿里云 `47.94.178.212` 为两个独立主机，通过 WireGuard 互联；第二节点已按 digest 拉取 Contract API 和 AI API 镜像并注销 Registry 凭据	主节点迁移完成后启动第二节点只读 AI canary，运行统一指纹、撤销 SLA 和 kill switch 验证
5. support access	生产首发闭环为禁用	运行 OpenAPI 中 `support-access`、`support_access`、`execute` 路径为 0；执行器恒为 false，默认 kill switch 为 true；无破坏性身份写 API	首发不开放该能力。未来启用必须另行接入真实 IdP/MFA/会话设备绑定并取得隐私和法务具名批准
6. 容量	完成	两轮只清理未引用 build cache；BuildKit 可回收量为 0；生产 PostgreSQL、MinIO、合同文件卷绑定到 `/home` 独立 LV（198GB 可用）；异地备份 70GB 可用	上线后纳入磁盘告警；不得清理业务卷或 Registry 包

已发布的不可变镜像

Contract API：git.yuqei.com/yuqei/ai-contract-platform-contract-api@sha256:a6969d90680f866232f1ad2c09607fd63f226476028b6c0f34c3175e7407549f
AI Platform API：git.yuqei.com/yuqei/ai-contract-platform-ai-api@sha256:2924e68c337bc59be6bc45e6183f8dcf239d80151c4ca076ace4feee644f5d67
AI worker：git.yuqei.com/yuqei/ai-contract-platform-worker@sha256:a72d40a5a000e525c1b1d30fb2f2a214db8a32492308198783323be0817dbecc
Contract Web：git.yuqei.com/yuqei/ai-contract-platform-web@sha256:8132c515502668b9348a16dbb2c56154a65582af5c4c8efbae887538f0b59e33
Release ID：c24f7a4f1ee041d92feca96bf147e423e58da17c

生产必须按 digest 拉取，不得只使用 tag 或本地 image ID。

法务 evidence

公开只读地址：

https://api.contact.yuqei.com/provider/legal/provider-legal-review-evidence.json

HTTP 200
TLS 验证通过
重定向数 0
精确大小 33,582 bytes
SHA-256 d3affadde5f3665a619c0424cc9e80c1cc9ee9af4eb157cba3cd558dabbbd7e4

公网重新下载的文件与本地 canonical evidence 逐字节哈希一致。公开 evidence 只证明技术材料固定，不表示已经取得法务批准。

用户最小配合项

唯一人工审核人固定为陈钰麒（总经理）。执行时只需准备：

审核人本人控制的法务公钥 key_id，建议 provider-legal-2026q3；
批准有效窗口，最长 30 天。

陈钰麒本人需在受控电脑上生成并保管 Ed25519 私钥，按 V2-named-legal-offline-signing-runbook-2026-08-11.md 对绑定 18 条 Provider 结果与 31 条产品黄金用例的精确批次作一次审阅、签署。私钥和口令不得上传仓库、聊天、共享预发布或 CI artifact。同一审核人确认公钥指纹后，系统自动校验身份、hash 和签名并安装 trusted keyring；不再增加安全/运维第二审核人。

签名后的固定自动顺序

验证法务签名、trusted keyring 和公网 evidence exact hash。
在共享预发布执行 finalize，生成真实 acceptance_run_id、receipt v2 和 promotion bundle。
将 receipt、公钥 keyring 和 receipt SHA-256 pin 安装到 production，保持 kill switch 为 true 运行正式 preflight。
preflight 全通过后拉取镜像，启动主节点但不接公网流量，完成迁移、备份和隔离恢复演练。
启动阿里云第二只读节点，验证两节点同一 release/image/receipt/key 指纹。
演练 receipt 撤销传播 SLA 和 kill switch；随后恢复到 fail-closed 状态。
由用户单独授权后才修改 API 上游和切换流量；support access 和身份 execute API 继续关闭。

2026-08-12 执行补录

具名法务审批、共享预发布 finalize、production receipt pin、production preflight、备份恢复和双节点只读验证已按上述顺序完成。真实验收运行 ID 为 provider-acceptance-41663d1022d3f656769ed757，receipt 为 provider-receipt-de755dae13b02c79bdce5302，receipt SHA-256 为 6602584347833b389c1d714a4ce08ccffdcbbc8c289657d2d9bd3bff5c6e70c7。

2026-09-27 边界更新：本节 receipt 和签批记录仅作历史审计，未绑定当前固定审核人 chen-yuqi / 陈钰麒 / 总经理 的新规则，不能用于当前 BUILD/RC 候选或公众放行。当前候选必须由陈钰麒对新精确批次重新签名，并重新生成、固定和验签 Provider receipt。

现场演练结果：receipt 公钥撤销在两个节点于 2.64s 内传播；临时关闭 kill switch 后两节点均以 ready、release_allowed=true 和相同 release/receipt/key/image 指纹通过 canary；随后两节点均恢复为 kill switch true、blocked、release_allowed=false。完整证据和文件 SHA-256 见 V2-provider-promotion-field-evidence-2026-08-12.md。

本补录只关闭 Provider promotion 的现场门禁，不代表公网流量切换已获准。edge 未启动，DNS/业务流量未改变，support access、身份执行器和破坏性身份写 API 继续关闭。

6.8 KiB Raw Blame History Unescape Escape