# CyberForge 3D 工程智能体 · 技术白皮书

**仿真训练场与入库前置质检门 —— 面向汽车制造的仿真侧具身基础设施**

Aholo Global 3D AI Hackathon 参赛作品 ｜ 宝琳战队（3FO4K4W12M5W）｜ 成员：法线之建造者（3FO4FN29SJXN）

核心引擎：Aholo Lux3D ｜ 在线资产：52 GLB ｜ 目标奖项：具身智能应用奖 ｜ 交付截止：2026-11-19 19:00 (UTC+8)

---

## 0. 摘要

CyberForge 是一套在浏览器内运行的汽车制造工业仿真系统，定位为 **3D 工程智能体的仿真训练场**。它以「冲压/焊装 → 涂装 → 总装 → 电池 PACK → 下线检测」五段工艺为主线，把 52 件可溯源的 3D 资产、8 台关节机械臂、约 20 米白车身传送带拼装成一个可按真实工业尺度巡检的车间，并以五层闭环架构把「看得见」升级为「跑得通」：感知（SSAO / 景深 / Bloom / 3DGS）→ 决策（OEE 与故障判定）→ 执行（关节动画 + cannon-es 物理）→ 孪生（工位状态映射 + 第一人称巡检）→ 进化（定时任务驱动的资产自治迭代）。

本白皮书的核心主张只有一句：**网页端工业仿真要赢得评审信任，靠的不是特效，而是可复算的真值锚点与可核验的能力边界。** 因此全文给出四组可回溯锚点（ISO 23247 域划分、OEE 算例、协作安全阈值、五维模型），并逐项声明「能力到哪、没到哪」。

---

## 1. 项目定位与边界

### 1.1 定位

面向 Sim2Real 的**仿真侧**基础设施：为机器人策略训练提供一个光照、尺度、工艺布局与交互都向真实工厂对齐的可复用场景，而不是一个静态三维展示页。

### 1.2 边界（前置声明）

本作品**只做仿真侧，不做 real 端闭环**，因此：

- 不称「数字孪生」（无真实产线数据同步，DD 数据为模拟值）；
- 不称「已验证 Sim2Real」（无真机迁移实验）；
- 机械臂关节为受控周期动画，非逆运动学求解。

这一声明贯穿后续所有指标口径，避免评审把仿真结果误读为产线实测。

---

## 2. 五层闭环架构

| 层级 | 职责 | 实现 |
|---|---|---|
| 感知层 Perception | 传感器数据、视觉识别、环境感知 | 焊接工位温度采集、车身位置/速度检测、缺陷视觉识别、车间温湿度与气体浓度；后处理为 SSAO、景深 Bokeh、Bloom、3DGS 点云 |
| 决策层 Decision | 故障检测、路径规划、质量判断 | 阈值异常检测 → 报警；工位节拍调度；焊点合格率统计；OEE 实时计算 |
| 执行层 Execution | 设备运动、物理交互 | 4DOF 关节机械臂、AGV 往返、cannon-es 重力与碰撞；温度异常 → 报警 → 停机链路 |
| 孪生层 Digital Twin | 数据闭环、状态映射 | PBR 场景（46 件 Aholo 生成资产）、3DGS 点云、第一人称巡检、实时产量/OEE/设备状态面板 |
| 进化层 Evolution | 资产自治迭代 | 每小时自治巡检（HTTP 200 验证 + 资产完整性检查）、缺失资产自动 rsync 重部署、经验沉淀上报记忆网关、加载性能回落触发压缩流水线 |

架构可视化见 `architecture.html`，五层之间的箭头为真实数据/指令流向，而非装饰。

---

## 3. 资产生产流水线与压缩工程

### 3.1 资产构成

| 类别 | 数量 | 说明 |
|---|---|---|
| Aholo API 异步生成 | 46 件 | 可由任务号溯源（4793601 起 / 4825620 系列 / 4826084 系列等） |
| CC0 可商用开源件 | 6 件 | CF-047–052：白车身、涂装滑橇、成品车、线边料架、料箱托盘、配料车，用于替换程序化盒式件提升真实感 |
| 合计 | **52 件** | 两类均通过 GLB 结构体检门；在线加载 45 件，浏览器实屏 51/52 |

Aholo 能力矩阵调用：文生 3D 36 件（G1-Turbo / G1）、图生 3D 10 件（高保真旗舰）、World 3DGS 1 次（赛博工业控制室全景，输出 PLY/SPZ）、部件拆分 2 件、关节化动画 3 件（5/6/5 link、4–5 revolute）、多模态生图若干（材质特写与图生参考图）。

### 3.2 三步压缩流水线

| 阶段 | 处理 | 体量结果 |
|---|---|---|
| 原始生成件 | Lux3D 直接输出，贴图最高 2048+ | raw_backup 留存约 527MB（25 件） |
| 减面 / Draco | simplify 减面 + Draco 几何压缩 | 141MB → 101MB |
| 贴图三步 | resize 2048 → WebP q82 → Draco | 101MB → 线上约 14MB（首批） |

**线上全量实测**：GLB 常量表定义 52 项（11 件核心组阻塞加载 + 40 件扩展组 4-worker 并发，1 项未启用），实测发起 50 件请求，Content-Length 求和 **53.2MB**，单件 1.2–2.0MB，分布均匀无畸大件。

> 合规声明：原始件与线上压缩件是**同一资产的两次编码**（几何与贴图内容对应、仅编码与分辨率不同），SHA256 不同属正常现象，非不同资产；原始件留存 raw_backup 备查。

### 3.3 分层加载与弱网兜底

- **核心组 11 件阻塞加载**（10 项显式任务 + 1 件控制环基座，约 17MB），完成即进入场景，保证首屏快速可见；
- **扩展组 40 件**进入后由 4-worker 并发池后台静默加载，逐件放置不阻塞交互；
- **10 秒硬超时 + 错误捕获**兜底，杜绝加载异常黑屏；
- 服务端带宽实测 683KB/s，全量 52 件约 78–95 秒（软件 GL 环境）；
- 3DGS 页面独立：`world.splat` 5.53MB，three.js（1.27MB）与 gaussian-splats-3d（584KB）均为**本站相对路径自托管**，不依赖 CDN；12 秒未完成即提示「正在解析高斯点云」，不假加载。

---

## 4. 四组真值锚点（可核验）

### 4.1 ISO 23247 域映射

参考《面向制造的数字孪生框架》的域划分思路组织层级（作品本身不构成孪生实例）：

| ISO 23247 域 | 本作品对应实现 |
|---|---|
| 可观测制造元素域（OME） | 10 核心工位 + 1 控制环基座 + 34 扩展工位 = 52 件在线资产 |
| 数据采集与设备控制域 | 工位状态采样、故障报警事件（焊接工位 3 温度异常）、设备控制回写 |
| 仿真核心域 | 模型同步、状态渲染、故障可视化、产能看板 |
| 用户域 | 浏览器总览、报告书与评审入口 |

### 4.2 OEE 可复算算例

给定：班次 8h（480min），计划停机 10min，故障停机 30min，设备调整 35min，理论节拍 1min/件，产出 400 件，废品 20 件。

```
计划运行时间 = 480 − 10 = 470 min
实际运行时间 = 470 − 30 − 35 = 405 min
可用率 = 405 / 470 = 0.86 (86%)
表现指数 = 400 / 405 = 0.98 (98%)
质量指数 = (400 − 20) / 400 = 0.95 (95%)
OEE = 0.86 × 0.98 × 0.95 ≈ 0.80 (80%)
```

等价恒等式：`OEE = 合格品理论加工总时间 / 负荷时间 = (1 × 380) / 470 ≈ 80.9%`，与上式互证。

### 4.3 协作工位安全阈值

依据 GB 11291 / ISO 10218、协作机器人 GB/T 36008：

| 参数 | 阈值 |
|---|---|
| 手动引导速度 | ≤ 250 mm/s |
| 法兰/末端最大动态功率 | 80 W |
| 最大静态力 | 150 N |
| 工作单元最小安全距离 | 500 mm（末端速度 > 2 m/s 时按 L = K×T+C 动态计算） |
| 安全相关控制系统 | ≥ PL=d、类别 3 |

超限即触发保护性停止。

### 4.4 五维模型对应

| 维度 | 本作品映射 |
|---|---|
| PE 物理实体 | 工位设备（机械臂、传送带、AGV、检测线） |
| VE 虚拟模型 | 52 件 GLB 构建的场景 |
| Ss 服务系统 | 产能看板、报告书 |
| DD 模拟数据 | 资产清单、门禁结果、故障事件（模拟值） |
| CN 连接 | 页面之间的状态同步 |

---

## 5. 具身仿真训练场

- **真实机器人本体**：云深处 X30 四足 URDF（4 STL mesh）接入安全通道巡检；3 件关节化机械臂（`robot.urdf` + glb mesh，4 revolute）经 urdf-loader 在网页端加载并驱动关节摆动；
- **物理约束**：cannon-es 刚体，具备重力与碰撞，无软体与精确摩擦模型（近似级）；
- **空间表征**：3DGS 真渲染提供高保真空间点云，可用于机器人空间理解与导航；
- **视角**：第一人称 1.7m 人眼巡检 + Raycaster 拾取 + 工位特写切换。

### 5.1 能力边界逐项声明

| 维度 | 状态 | 说明 |
|---|---|---|
| 视觉保真 | 已具备 | PBR 材质、3DGS 全景、52 件资产、软件 GL 真机验证（51/52 入场景） |
| 机器人本体 | 已具备 | X30 URDF + 关节化机械臂，urdf-loader 网页端驱动 |
| 物理约束 | 近似 | 刚体，无软体、无精确摩擦 |
| 具身视角 | 已具备 | 第一人称巡检、拾取 |
| 语义标注层 | 未具备 | 尚无可机读的 grabbable / placeable / workstation / walkable 标注 |
| 可编程动作接口 | 未具备 | 现为 UI 按钮触发，未提供 goto/pick/place/inspect 动作 API |
| 状态判定闭环 | 未具备 | 动作结果未按工艺约束自动回写 PASS/FAIL |
| 传感器模态 | 未具备 | 未导出深度图、实例分割、相机位姿 |
| 真实产线数据同步 | 无 | 无真实数据源，DD 为模拟值 |

路线：语义标注 → 可编程动作接口 → 工艺判定闭环 → 传感器模态导出 → RL 环境接口（rl_training / ONNX 策略），与 GLB 入库质检门共用同一套判定规则。

---

## 6. 演进轨迹（精选纪元）

| 纪元 | 时间 | 关键事件 |
|---|---|---|
| ERA 00 | 2026-11-07 01:29 起 | 由物理仿真教学转向工业仿真 3D；首批 10 件 GLB 经文生 3D（G1-Turbo + PBR）落地；踩坑记录：关节化参数名为 `prompt` 而非 `motionPrompt` |
| ERA 01 | 01:47–03:11 | CORS 攻坚：临时 CDN 不支持跨域 → 改为 HTML + GLB 全部同域 rsync 部署；World 3DGS 一次成功，产出全景图、PLY、SPZ |
| 后续纪元 | 至 2026-11-14 | 批次化扩充至 52 件、三步压缩流水线成型、分层加载、3DGS 页、五层架构页与成长轨迹页上线 |

立项 2026-10-19，交付 2026-11-19；起点 0 资产，当前 46 件 API 生成 + 6 件 CC0。

---

## 7. 验收记录（2026-11-14）

| 资源 | HTTP | 字节 |
|---|---|---|
| project-report.html | 200 | 23,876 |
| cyberforge-viewer.html | 200 | 61,262 |
| splat-viewer.html | 200 | 3,094（壳页） |
| splat-viewer-pro.html | 200 | 6,810 |
| architecture.html | 200 | 5,566 |
| growth-timeline.html | 200 | 18,638 |
| world.splat | 200 | 5,533,580 |
| three.module.js | 200 | 1,272,972 |
| gaussian-splats-3d.module.js | 200 | 583,910 |
| ModelScope Studio | 200 | — |
| ModelScope 数据集 | 200 | — |

全部页面与依赖自托管可达，无外部 CDN 单点。

---

## 8. 评审维度自评

| 维度 | 权重 | 对应 | 自评 |
|---|---|---|---|
| 群核技术栈应用 | 30% | 46 件 Lux3D 全链路生成（36 文生 + 10 图生，任务号可溯）+ 6 件 CC0，共 52 件入场景 | 强 |
| 作品有趣程度 | 25% | 第一人称巡检、故障报警、物理演示、3DGS 沉浸场景 | 中良 |
| 创新性 | 20% | 生成式 3D + 工业仿真 + 具身训练场融合 | 中良 |
| 完成度 | 20% | 在线 Demo 稳定、移动端可访问、分层加载 | 中良 |
| 传播 | 5% | 待发布 #Aholo黑客松 | 待补 |

最终得分 = 专家评委 70% + 玩家评委 30%。

---

## 9. 局限与下一步

1. **语义标注层缺失**是最关键短板：没有机读语义，智能体无法「理解」工位，只能「看见」。
2. **动作 API 缺失**：UI 触发无法被策略调用，训练场尚未成为可编程环境。
3. **判定闭环缺失**：拾取/装配结果不产生 PASS/FAIL，无法形成奖励信号。
4. **传感器模态缺失**：无深度图/实例分割/位姿，具身智能的核心输入缺位。
5. **DD 为模拟值**：任何「产能/良率」数字只能作为演示口径，不可当作实测结论引用。

优先级：语义标注 → 动作 API → 判定闭环 → 传感器导出 → RL 接口。传播侧补 #Aholo黑客松 发布与源码打包。

---

## 10. 交付清单与在线地址

| 类别 | 材料 | 链接 |
|---|---|---|
| 必交 | 项目报告书 | https://www.huodouai.com/cyberforge/project-report.html |
| 必交 | 在线 Demo | https://www.huodouai.com/cyberforge/cyberforge-viewer.html |
| 加分 | 3DGS 真渲染 | https://www.huodouai.com/cyberforge/splat-viewer.html ／ splat-viewer-pro.html |
| 加分 | 五层架构 | https://www.huodouai.com/cyberforge/architecture.html |
| 加分 | 成长轨迹 | https://www.huodouai.com/cyberforge/growth-timeline.html |
| 加分 | 魔搭 Studio | https://www.modelscope.cn/studios/zongyuantan/cyberforge-studio |
| 加分 | 魔搭数据集 | https://modelscope.cn/datasets/zongyuantan/cyberforge-digital-twin |
| 本文件 | 技术白皮书 | https://www.huodouai.com/cyberforge/whitepaper.html |

---

**CyberForge Simulated Training Ground · 宝琳战队（3FO4K4W12M5W）**

DID-BR-000002 ｜ Ω₀⊂⊙∞⊂Ω ｜ ZONGYUAN-ROOT 作品档案 CYBERFORGE-3D-AGENT-20261114