Files
webup-cloud/docs/CODE-REVIEWS.md
T

4.5 KiB
Raw Blame History

独立 AI 代码验收

费用核算与代码验收为两个独立流程。费用报告不代表源码或构建通过;代码验收也不能更改钱包。两类报告均只在管理员 /admin/tasks 中展示。

实际流程

  1. 项目最新一轮开发完成后自动排队。管理员也可说明原因重新验收,重复请求使用幂等键,旧版本保留。
  2. 从真实开发工作区导出最多 10MB / 2000 文件的源码快照,计算逐文件 SHA256 和整体指纹;排除环境凭证文件、私钥、符号链接、依赖、Git 和构建产物。
  3. 导入全新 UUID 的验收工作区。验收在独立 platform-reviews 命名空间的 gVisor Pod 执行,不挂载用户原 PVC、平台凭证或 Kubernetes 服务账户令牌。原工作区不安装依赖,不执行验收构建命令。
  4. 运行可信检查器:HTML 解析、本地资源与锚点检查;npm 项目的依赖安装、实际 build / test 脚本;Python 语法检查。记录命令、退出码、超时、输出截断及源码是否被构建修改。
  5. 把需求、实际源码样本和真实检查结果交给独立 AI 会话。不给它开发 AI 的对话或工具权限,可以在后台单独选择其他验收模型;默认沿用开发模型但使用全新验收上下文。
  6. AI 输出结构化中文报告:需求覆盖、文件 / 行号 / 严重程度 / 问题证据、未验证项。系统规则再约束结论:构建失败、明确缺失需求或 HIGH 问题不能判通过;源码变化为 STALE;浏览器未执行、抽样不全或测试缺失不得判完整通过。
  7. 再次检查原项目源码指纹,保留报告和原始检查证据,清理验收 Pod / PVC / NetworkPolicy。清理失败有独立重试,不会删除用户开发命名空间的资源。

管理员配置与接口

  • GET /api/admin/code-reviews/config:查看自动验收开关、可选独立模型和配置版本。
  • PUT /api/admin/code-reviews/config:models:write / settings:write;enabled、modelId(null 表示默认模型)、version、reason。乐观版本检查,变更只影响新任务。
  • GET /api/admin/tasks/{task}/code-reviews:tasks:manage / finance:write / audit:read,查看各版本实际源码指纹、AI 建议、系统结论、检查记录和费用。
  • POST /api/admin/tasks/{task}/code-reviews:tasks:manage / models:write;idempotencyKey、reason。管理员明确发起新版本,不覆盖旧报告。自动验收关闭时仍可手动请求。

普通任务所有者无权读取报告或验收配置。接口不返回 Worker 租约、供应商密钥或内部配置快照。全局同时执行一份独立验收,每日最多 100 份,单份模型预计计价上限 1 元;报告费用由平台承担,不写入用户账本。模型配置与价格在排队时快照,后续改配置不影响已排队任务。

验收边界

当前独立环境支持静态 HTML 检查、npm 项目和 Python 语法检查。npm 依赖 / 构建 / 测试共用最多 100 秒执行窗口,超时明确标注;非 npm 锁文件、未配置测试和不支持的构建工具显示未验证,不以空命令或模拟结果冒充成功。浏览器、视觉和端到端交互尚未运行时明确标为 NOT_RUN,整体最多 PARTIAL。

源码样本最多 14000 字符,单文件最多 7000 字符;因上下文压缩或抽样而不完整时不能判完整通过。完整快照用于隔离构建,AI 只读取报告标明的样本;构建日志发送 AI 前缩短,完整有界日志保留在管理员凭据中。

部署与实际验证

应用 infra/k8s/review-rbac.yaml;网关镜像必须包含 review_tools.py。本机脚本已集成该资源,按 本机部署 重建和部署。独立验收调度在启用 AI Worker 后自动运行。

scripts/local/smoke-code-review.py 已通过真实 K3s 检查:快照复制、排除凭证、192KB UTF-8 stdin 传输、独立 gVisor / runsc、HTML 资源检查、未执行浏览器不伪报、原工作区不变、拒绝任意 shell 工具、真实 npm 构建 / 测试成功,以及真实失败构建。报告 .runtime/local-cluster/code-review-isolation.json,测试只删除自己生成的随机 UUID 资源。

现有 About 项目已实际生成两版独立 AI 报告:第一版发现缺失区块,修复后第二版无代码问题。系统保留 PARTIAL,明确浏览器和视觉检查未执行;旧问题报告不被覆盖。后台将实际检查 / 退出码单独制表,AI 对构建成功的文字自述不能替代该表。