data-gen-ebd/docs/infrastructure.md
amos c6435255f9 docs: record the user-specified Git remote
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 20:49:41 +08:00

45 lines
5.1 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.

# 基础设施与待验证条件
本项目仅建设真实 rollout 采集系统。已有资源与认证记录见 [onboarding.md](onboarding.md),实际验收见 [progress.md](progress.md) 和 [acceptance.md](acceptance.md)。当前不要求训练 GPU、基座权重、训练框架或 checkpoint 存储。
## 当前执行链路
| 条件 | 当前资源与用途 | 就绪标准 |
| --- | --- | --- |
| Python 3.9+ | CLI、合同、监督事件和回执处理 | doctor 与必要单元测试通过 |
| Linux Docker | 36 主机 Docker 29.5.2;正式镜像校准与真实 Pi/GLM-5.3 单任务闭环通过 | 独立评分、原生证据和清理结论见 [acceptance](acceptance.md);新任务或环境变更重新校准 |
| 固定镜像与 C 工具链 | [Agent Dockerfile](../agent/Dockerfile) 已构建推送 CCR;gold 与三类负例各五次符合预期 | 固定 digest 见 [onboarding](onboarding.md),变更环境重新校准 |
| 已有 Agent | Pi 0.73.1 与原生 adapter;镜像内 SDK 检查及真实多轮因果证据通过 | 每次采集都核对工具反馈进入后续输入、终态与候选绑定,不能沿用首题结果 |
| 模型通道 | GLM-5.3 Chat Completions,经可信 host 私有代理 | 实际模型身份、请求、工具响应、结束事实可核对;上游 key 不进 Agent |
| Pi controller 与代理 | [pi_run](../rollout/pi_run.py) 管理单次专用 bridge、私有 proxy、校准与证据对账 | 私有 key 不进入 Agent;结束后核对 proxy/network 清理,正式评分无网 |
| 唯一证据目录 | host 保留合格原件;Salty `personal:/embedded-rollout` 仅保留一份合格归档 | 上传后下载 SHA-256 一致,临时下载和探针文件已删除;扩量不覆盖历史 |
| 镜像仓库 | CCR 公网 push 成功,namespace `algo`;相同 digest 在 Salty 经 VPC 拉取执行成功 | 正式按 digest 固定,后续镜像变更单独验 |
| Salty | 0.2.3 本人授权成功;CPU 镜像/存储探针及归档复核通过,探针作业和文件已删除 | 正式 Agent 模型通道、候选交接与独立评分后端尚未完成 |
| 来源登记 | task/source/family/version、校准和来源分组 | 每条结果能定位任务、候选、环境及 verifier 摘要 |
可信 host 校准只执行仓库可信样例,不代替 Docker 对不可信 Agent 的隔离。模型费用和轮数当前不设上限;工作容器 2 GiB、1 CPU、默认 900 秒防挂死,评分容器 512 MiB、1 CPU、首题 60 秒。容量按试跑测量后调整,不能直接推导扩量配额。
`doctor` 检查执行命令所在主机的 Docker,不自动连接 36;本机未找到 Docker 与远端 Docker 可用可以同时成立。镜像标签可变,先解析实际身份;环境变化重新校准。工作区与完整日志尚无独立磁盘配额,正式扩量前确认可用容量和留存范围。
## Salty 的准入条件
Salty 使用预先构建并上传的镜像,不假定容器中能启动二层 Docker、访问宿主 socket、使用 privileged 或 KVM。当前通过的是 36 Docker 的真实闭环与 Salty 的 CPU 镜像/存储探针、归档复核;完整证据见 [现场回执](rollout-receipt.json) 与 [运行审阅](runtime-review.md),不代表 Salty 正式 Agent 后端已完成。
Salty 正式 Agent 后端需确认模型认证与网络通道、候选交接、原生事件、取消及清理。正式 grader 继续使用受支持的独立无网环境;直接分成两个 jobs 不足以证明隔离,因为双方可能读取同一个人盘。隐藏 verifier/gold 不上传 Agent 可读目录。
公开 CLI 文档未确认 Secret、workload identity、network-none、capability 或私有 registry 认证参数。`-e/--env-file` 明文保存并回显,不可供给上游密钥。本次 VPC 镜像拉取已有实际成功证据,不能外推为任意仓库均有权限。真实 Salty Agent 的模型通道和隔离仍单独验收。
## 扩量时按任务增加
| 条件 | 启用时机与新增验收 |
| --- | --- |
| Bos-qiao 快照与镜像恢复材料 | 导入正式任务前验证 manifest;原镜像缺失则升环境版本并重新校准 |
| ROS2、ARM 工具链、QEMU 或 SDK | 对应任务准入时才加,分别声明软件与硬件覆盖范围 |
| 更大 CPU/内存和持久容量 | 单并发稳定后按耗时、峰值和证据体积测算,不先采购训练资源 |
| 证据备份与批次索引 | 数据量扩大后核对摘要、去重、读取恢复和来源 |
| 多文件任务合同 | 修改 candidate_files 与冻结规则,增加路径、身份和完整工程验证 |
真板、SFT、在线 RL 和模型更新均不属于当前实施或基础设施清单。历史训练讨论保留在 [chat-history.md](chat-history.md),不构成本项目交付要求。
用户已授权本项目接入与试跑,Git remote 为用户 2026-10-13 指定的 `origin`(`https://gitea.d-robotics.cc/ming01.wang/data-gen-ebd.git`),只推送 main,不改写已推送历史。Salty 只使用 `personal:/embedded-rollout`;临时测试文件、作业、容器、网络和中间镜像核对证据后清理,不动已有作业或其他目录。本轮已清理项与 CCR 初版试验版本的权限例外见 [onboarding.md](onboarding.md)。