19 KiB
Raw Blame History

门禁清单 v1(Gates & Safeguards)

本文档定义 WishForge 面向客户自助修改与发布全流程的防事故门禁(S1–S5、G1–G3、G9)及门禁自我迭代机制(G10)。所有门禁的核心目标是防止平台崩溃、防止客户数据丢失、杜绝「带病上线」与「口头说修好了但实际没验证」。


一、核心防事故安全门禁(S1–S5)

S1:改动分级门禁(Change Risk Classification Gate)

  • 目的:识别改动的影响面与破坏性,把低/中风险交给客户自主快速决策,把高风险(迁移、删改数据、权限、部署配置、测试基线、缩到 0 副本、超节点余量)强制交由平台方把关,杜绝越权改动引发生产事故。
  • 触发条件:每次修改代码生成 Diff 后、进入发布申请(releases.request)前自动触发;检测修改路径、AST/关键字特征(如 deleteMany、migration、permissions、k8s/、replicas: 0、resources.requests)、改动行数及是否超出 Copilot 定位文件范围。
  • 拦下还是只提醒:
    • 低/中风险:不拦死客户,标记风险等级并在界面提醒客户核对对应验证证据后自主批准。
    • 高风险 / 拿不准升档为高风险:硬拦截客户自助发布,冻结客户侧「立即发布」按钮,自动转为「等待平台方审批」状态。
  • 客户看到的提示文案:
    • 判为低/中风险时:「本次修改为【低/中风险】,已完成自动检查,请核对下方检查结果后点击『批准发布』。」
    • 判为高风险拦下时:「这次修改涉及【数据安全 / 权限规则 / 服务器配置】,为防止影响线上运行,已提交平台技术团队审核,审核通过后方可发布。」
    • 拿不准自动升档时:「这次修改超出了原本定位的页面范围,为稳妥起见已按更高安全等级处理,需等待平台技术团队确认。」
  • 来源:
    • WishForge 业务许愿试点差距分析(docs/reviews/2026-10-28-business-wish-pilot-gap-analysis.md:P0 简化业务提报模式、禁止诱导业务用户通过 allowBackend 自行扩围、收口发布审批);
    • WishForge 发布风险与受保护路径契约(packages/contracts/src/release-risk.ts:6-33、packages/contracts/src/change-paths.ts:1-16、apps/api/src/domain/policy.ts:41)。

S2:数据保护门禁(Data Protection & Read-Only Gate)

  • 目的:严防 Copilot 排查、验证或代码修改过程中误删、误改客户线上业务数据,防止无超时约束的慢查询拖垮线上 MongoDB。
  • 触发条件:
    1. Copilot 或诊断工具连接线上 MongoDB / 集群 API 时;
    2. 提交的代码 Diff 中出现数据库删除、批量覆写、删表/删索引(deleteMany、drop、$unset、updateMany 等)或修改只读探针逻辑时;
    3. 列表/聚合查询未携带分页或超时保护(maxTimeMS)时。
  • 拦下还是只提醒:硬拦下(Block)。
    • 线上数据库强制使用只读账号 wishforge_observer(仅 read 权限,写操作在数据库层直接报错拒绝);
    • 集群仅授予只读 ServiceAccount;
    • 代码中检出破坏性写操作或高危无界查询时,直接拦截自助发布。
  • 客户看到的提示文案:
    • Copilot 被要求直接改线上数据时:「为了保护您的数据安全,我只有线上数据的只读查看权限,不能直接修改或删除数据库里的记录。如果您需要调整某项功能,我可以帮您生成修改方案。」
    • 代码包含删改数据操作被拦下时:「检测到本次修改包含批量删除或改写数据的操作,为防止数据丢失,系统已拦截自助发布,请由平台技术团队协助核对并执行。」
  • 来源:
    • WishForge MongoDB 只读账号运维规范(docs/ops/mongodb-readonly.md);
    • droboticflow 看板超时与慢查询事故复盘(docs/verification/claim-dashboard-timeout-20261103.md:镜像 dffba6ca 中 63714753 引入无 maxTimeMS 的 3 次 lookup 聚合,导致 83 个超 2 分钟陈旧 getMore 读操作堆积,最终需人工 killOp 恢复);
    • droboticflow 源数据校验只读探针教训(docs/verification/source-validation-admission.md:GET /tasks/{id}/frame-timeline 会持久化隔离状态,严禁作为生产只读探针,必须用 ?view=status)。

S3:验证不过不能发布门禁(Verification Must Pass Gate)

  • 目的:确保任何上线代码都经过与改动范围匹配的独立自动化验证,杜绝「代码编不过、测试跑不通、或者验证超时跳过」的改动混入生产环境。
  • 触发条件:每次 Run 完成代码修改准备进入待发布状态时,以及点击「批准发布」执行 releases.decide / scripts/release.py check 时。
  • 拦下还是只提醒:硬拦下(Block)。只要存在任一验证失败(退出码 1)、超时/跳过/未映射(退出码 2 或 124)、工作区提交不一致(CHECKPOINT_CHANGED)或生产验证配置缺失(verification_unconfigured),一律禁止发布。
  • 客户看到的提示文案:
    • 验证未通过时:「还有检查项未通过,暂时不能发布。您可以点击『让 Copilot 继续修复』,或转交技术团队处理。」
    • 验证超时或环境异常时:「自动检查未能在规定时间内完成,为确保线上稳定,本次修改暂不可发布,请重试或联系技术支持。」
  • 来源:
    • WishForge 独立沙箱验证机制(packages/runtime/src/verify.ts:110 verifyWorkspace、packages/runtime/src/sandbox.ts:34 isolatedVerifierExecutor、apps/api/src/http.ts:252);
    • droboticflow 分层验证与发布规范(docs/agents/verification.md、docs/release/README.md、fanyu-policy.json 强制核对 8 项 requiredEvidence 与 19 项 localChecks)。

S4:发布审批 + 健康检查 + 自动回滚门禁(Release Approval, Healthcheck & Rollback Gate)

  • 目的:保证每次发布都有明确的责任人确认、发布内容与审批内容严格一致(防篡改)、按安全顺序滚动更新,且一旦新版本启动异常或健康检查失败能立即回滚,避免平台长时间中断。
  • 触发条件:
    1. 发起发布申请与点击批准时(校验审批人权限与 bindingDigest 摘要绑定);
    2. 执行集群滚动更新时(拦截全量 kubectl apply,强制按 Coordinator → Worker/Processor → API 顺序,校验 UID/resourceVersion/previous image);
    3. 发布后验证 /api/health.buildCommit 与服务探针状态时。
  • 拦下还是只提醒:硬拦下 + 失败自动回滚(Block & Auto-Rollback)。
    • 未获对应等级审批人批准、或代码摘要 bindingDigest 发生变化的,直接拦下拒绝部署;
    • 严禁设置 autoDeploy=true 绕过人工批准;
    • 发布后若健康检查超时或 buildCommit 不匹配,自动触发回滚至上一稳定镜像 digest,并将状态记为 rolled_back(若回滚异常则记为 needs_reconciliation 并立即告警)。
  • 客户看到的提示文案:
    • 等待审批时:「修改已准备就绪,正在等待【客户负责人 / 平台技术团队】批准发布。」
    • 发布内容变更被拦下时:「待发布的内容发生了变化,请重新查看检查报告后再确认发布。」
    • 健康检查失败触发自动回滚时:「新版本启动检查未通过,系统已自动恢复到修改前的稳定版本,您的线上业务和数据未受影响。」
  • 来源:
    • WishForge 发布绑定与回滚实现(apps/api/src/domain/releases.ts:42 releaseBinding、:280 request、:435 decide、:662 rollback);
    • WishForge POC 驻地交付规范(docs/reference/poc-delivery-profile.md、packages/runtime/src/poc-profile.ts、scripts/poc-release.ts);
    • WishForge 差距分析(docs/reviews/2026-10-28-business-wish-pilot-gap-analysis.md:P0 拆出独立回滚权限、防止 autoDeploy=true 绕过确认);
    • droboticflow 发布脚本防误操作门禁(scripts/deploy-k8s.sh:17-20 硬阻断 fanyu 全量 apply,scripts/release.py 绑定不可变镜像 digest)。

S5:Run 资源隔离与集群余量门禁(Run Isolation & Cluster Capacity Gate)

  • 目的:防止单个自动修复/验证任务(Run)耗尽宿主机或集群算力、网络、磁盘,同时防止服务扩容或算子启动超出集群节点物理余量导致业务 Pod 被驱逐或 OOM 崩溃。
  • 触发条件:
    1. 启动任何 WishForge Run 或独立验证沙箱时;
    2. 修改 K8s 资源配额(requests/limits/replicas)或调度大算子(如 WiLoR、HeadPose、Qwen 粗切)时;
    3. 集群节点 CPU/内存、GPU 或 workspace(200Gi 不可扩容 BOS PVC)水位逼近阈值时。
  • 拦下还是只提醒:
    • 沙箱隔离、超时与重试上限:硬拦下(Linux /usr/bin/bwrap 无网沙箱、单步超时退出码 124、自修复最多 3 次耗尽进入 repair_exhausted 停止自动重试);
    • 水位预警(达 80%):提醒(在资源页与发布页黄字提示);
    • 超出节点余量 / GPU 被占满 / 不可扩容存储达红线(90%):硬拦下,禁止直接扩容或发布。
  • 客户看到的提示文案:
    • 3 次自修复耗尽被拦下时:「Copilot 已尝试自动修复 3 次仍未彻底解决,为避免无效消耗系统资源,已暂停自动尝试。您可以补充更具体的说明,或转交技术团队处理。」
    • 资源请求超节点余量被拦下时:「当前服务器剩余资源不足以支持本次调整,强行发布可能导致线上服务卡顿或中断,已转交平台技术团队统筹调配。」
  • 来源:
    • WishForge 沙箱隔离与预算控制(packages/runtime/src/sandbox.ts:34、packages/contracts/src/index.ts:414 repair_exhausted、tests/run-budget.test.ts);
    • droboticflow 100 人容量基线与 validator 扩容复盘(docs/capacity/source-index-100.md、docs/capacity/validator-scale-20261026.md、docs/fanyu-resource-profile.md)。

二、研发与交付质量门禁(G1、G2、G3、G9)

G1:代码与基线新鲜度门禁(Freshness Gate)

  • 目的:防止基于过时的旧分支或旧代码修改,导致上线后把别人刚修好的功能覆盖掉(代码回退回归),或者因工作区有未清理的脏改动导致构建结果与源码不一致。
  • 触发条件:Run 启动前、验证执行前(核对 HEAD)、以及打包发布前(源码审计)。
  • 拦下还是只提醒:硬拦下(Block)。
    • 验证过程发现 HEAD 变化报 CHECKPOINT_CHANGED 立即中止;
    • 改动分支落后于目标发布基线且存在冲突或触碰相同模块、或构建镜像的 buildCommit 与源码 commit 不一致时,直接拦截发布。
  • 客户看到的提示文案:「线上系统刚刚有其他更新上线,为了防止冲掉最新功能,系统正在基于最新版本重新核对您的修改,请稍候确认。」
  • 来源:
    • droboticflow d7201ebf 领取功能回归与 worktree 分叉治理复盘(多个陈旧 worktree 基于旧基线修改,若不核对最新基线直接合入会导致已修复的随机领取与审核池逻辑回归);
    • droboticflow 发布源码一致性审计(scripts/release_source_audit.py、scripts/release-build-api-image.sh 强制绑定 DROBOTICFLOW_BUILD_COMMIT);
    • WishForge 验证工作区快照检查(packages/runtime/src/verify.ts:110 CHECKPOINT_CHANGED)。

G2:分层验证证据门禁(Verification Evidence Gate)

  • 目的:确保不同范围的改动必须拿到真实跑通的测试证据(日志、退出码、耗时、接口响应与页面多角色状态检查),杜绝「只改代码不跑测试」或「用口头保证代替实测证据」。
  • 触发条件:根据改动文件路径映射 scripts/verification-scopes.json 执行对应层级的验证(verify:plan / verify:quick / verify:task / verify:integration),并在生成发布申请单时核对证据包。
  • 拦下还是只提醒:硬拦下(Block)。缺少改动范围对应的必选测试报告(如 local-data/test-results/verify-*)、或未记录所检查的角色与页面状态(加载/空态/错误/只读)时,禁止进入发布批准环节。
  • 客户看到的提示文案:「系统正在为您本次修改的功能做实测验证,全部检查通过并生成验证报告后即可发布。」(若缺失证据被拦:「本次修改缺少完整的自动测试记录,暂不能发布。」)
  • 来源:
    • droboticflow 分层验证规范(docs/agents/verification.md、scripts/verification-scopes.json);
    • droboticflow 审核池搜索与源数据准入验证复盘(docs/verification/review-pool-search.md、docs/verification/source-gate-pool-search.md、docs/verification/owned-source-exceptions-20261102.md);
    • droboticflow UI 文案与交付核对规范(docs/ui/copy-guidelines.md:交付必须注明检查过的角色、状态及验证证据)。

G3:测试基线保护门禁(Baseline Protection Gate)

  • 目的:严防智能体或开发人员为了「让红灯变绿灯」而偷偷修改测试放行标准、把新写出的 Bug 塞进「已知失败清单(known-failures.json)」、注释断言或禁用 Git Hooks。
  • 触发条件:每次提交或验证时,检查 tests/known-failures.json、scripts/verification-scopes.json、测试文件中的 .skip / only 标记以及 Git 配置。
  • 拦下还是只提醒:硬拦下(Block)。
    • 独立验证器强制设置 core.hooksPath=/dev/null 并导出干净工作树;
    • 任何扩大 tests/known-failures.json 失败列表、缩减 verification-scopes.json 或跳过断言的改动,直接拦下并判为违规(若确需调整测试基线,必须按 S1 高风险走平台方人工审批)。
  • 客户看到的提示文案:「检测到自动测试标准被改动,为确保检查真实有效,系统已拦截本次操作并转交平台技术团队核查。」
  • 来源:
    • droboticflow 分层验证铁律(docs/agents/verification.md:使用 test:frontend:gate 与 test:go:gate 对照 tests/known-failures.json,严禁扩大 known-failures 基线或手工忽略断言);
    • WishForge 独立验证防作弊沙箱(packages/runtime/src/verify.ts:110 导出兄弟目录 ${workspace}-tree、禁用 hooks)。

G9:客户版四栏交付报告门禁(Delivery Report Gate)

  • 目的:让客户在批准发布前,一眼看清这次修改「哪些检查通过了、哪些失败了、哪些还需要人工看一眼、哪些没做」,杜绝报喜不报忧或用满屏英文日志糊弄客户。
  • 触发条件:每次 Run 结束准备交付客户确认、或发起发布审批前。
  • 拦下还是只提醒:
    • 缺少四栏报告或「失败」栏不为 0:硬拦下(Block),不允许点批准发布;
    • 「失败」栏为 0,但「待验证 / 没做」栏有内容:强提醒(Remind & Confirm),在批准按钮上方高亮展示待客户人工确认的事项,客户知情勾选/确认后可批准(低/中风险)。
  • 客户看到的提示文案:「请查看本次修改的交付报告(已通过 / 未通过 / 需您确认 / 本次未改),确认无误后即可批准发布。」(详细模板见 docs/product/copy/delivery-report.md)
  • 来源:
    • WishForge 业务页面与技术页面分层改造(docs/reviews/2026-10-28-business-wish-pilot-gap-analysis.md:隐藏底层冗余日志,提供清晰的中文业务总结);
    • droboticflow 极简文案与交付透明规范(docs/ui/copy-guidelines.md、docs/ui/error-messages.md)。

三、门禁自我迭代机制(G10 预留规则)

随着线上运行的许愿单、拦截记录和事故复盘不断积累,门禁规则支持通过 G10(Gate Self-Iteration) 持续演进,既避免规则僵化,又防止门禁被随意放水。

1. 提议来源(Proposal Sources)

系统在以下四类事件发生时,自动分析并生成「门禁规则调整提议卡」:

  1. 线上回滚或故障复盘:某次发布通过了现有门禁,但上线后触发了健康检查回滚或报错告警(说明现有门禁漏检,自动提议新增或收紧规则)。
  2. 高频重复修复失败(repair_exhausted):某类文件或接口连续多次出现相同的测试失败模式(自动提议补充前置检查或细化路径风险定级)。
  3. 误拦反馈:某类纯展示或常规修改连续多次被判为「拿不准」升档,但人工复核 100% 安全通过(自动提议明确其判定信号)。
  4. 集群容量与慢查询新特征:监控发现新的慢查询模式或资源瓶颈(如新的算子或新聚合接口,自动提议纳入 S2/S5 扫描特征)。

2. 分类管控:收紧类 vs 放松类

调整类型 定义举例 试运行要求 谁有批准权限
收紧类(Tightening) - 新增一条高/中风险代码特征(如新增某个危险函数拦截)
- 缩短某类接口的超时阈值
- 为某个模块增加必跑的验证用例
先「只提醒」试运行 1–2 周(Shadow / Remind Mode):
试运行期间命中新规则时,只记录日志并在报告中给出温和提醒,不直接阻断发布;观察 1–2 周确认无大面积误伤后,再切换为正式拦截。
客户负责人批准(平台方提供试运行数据说明,由客户业务负责人拍板启用)
放松类(Relaxing) - 将某类路径从高风险降为中/低风险
- 放宽改动行数上限或移除某项必跑检查
- 调高资源告警阈值或放宽 known-failures
不允许直接试运行放行:
在平台方正式批准前,仍按原严格标准执行。
必须平台方批准(严禁客户侧或智能体自行放松安全底线)

3. 每月门禁健康报告(Monthly Gate Report)

系统每月自动向客户负责人与平台方团队生成一份简明《门禁运行与演进月报》,包含四项核心内容:

  1. 本月拦截与保护统计:共拦截多少次高危修改、避免了几次潜在数据删改或资源超限、触发了几次自动回滚。
  2. 试运行中的新规则表现:当前处于 1–2 周试运行期的「收紧类」规则命中了多少次、是否有误报、是否建议转正。
  3. 误拦与耗时分析:哪些检查项耗时最长、哪些修改触发了「拿不准升档」,是否存在优化空间。
  4. 待审批提议清单:列出下月建议启用的收紧规则(待客户负责人批准)与精简提议(待平台方审批)。