Files
WebUp Cloud db82325ed7
Verify control plane / verify (push) Canceled after 0s
Initial import of WebUp Cloud
2026-11-07 13:31:14 +08:00

37 lines
4.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 独立 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`。本机脚本已集成该资源,按 [本机部署](LOCAL-DEVELOPMENT.md) 重建和部署。独立验收调度在启用 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 对构建成功的文字自述不能替代该表。