工厂数字孪生:产品、设计与技术落地全景
整理日期:2026-10-10。本文汇总项目需求、设计、实现文档与本次会话中的验证记录。部署、性能与连接排查结果主要来自 2026-09-30 的历史验证;本次归档未重新验收线上应用。当前阶段是全局 Mock 的可交互演示,不等同于真实工厂生产系统。
1. 产品定位与核心价值
产品面向五金、汽配、电子组装、注塑等中小型制造场景,让车间主管通过自然语言提出分析目标,查看指标、异常候选、证据和改进建议,并在 3D 车间定位相关设备。
核心闭环是:提出目标 → 明确范围 → 获取并检查数据 → 程序计算 → 组织原因候选 → 校验证据 → 图表与 3D 联动 → 形成报告 → 人工反馈与复查。
3D 负责空间定位和现场理解;Agent 负责组织分析步骤和解释证据;确定性代码负责统计计算。三者共享设备 ID、时间范围、数据快照和指标口径,防止大屏、报告和对话中的数值互相矛盾。
目标用户包括车间主管、运维人员、工厂管理员和大屏访客。首版以单厂、单车间、演示数据与 Excel/CSV 为基础,MES 仅预留接口。3 条线、50 台设备、10 个浏览会话等属于需求容量基线,未视为已经完成的容量验收。
必须纠正的产品承诺
- 任务依赖图与规划—执行—校验是通用工程设计,不声称复刻未经验证的 Manus/Instinct 内部架构。
- 只读接入降低控制风险,但不等于零风险或无合规义务;仍需管理源库负载、数据外发、访问权限和建议误用。
- 校验可检查数据完整性、计算与引用,不能保证现场记录真实,也不能杜绝所有幻觉。
- 参数化车间与免费模型可以支持演示,不等同于经过测绘的 1:1 数字孪生。
- 客户付费意愿、竞品差异和增产收益均是待验证假设,不能当作已证实结论。
2. 业务边界与功能分层
明确不做 PLC 接入、设备控制、工艺参数下发、自动改排班、MES 写回或自动执行生产建议。本系统中的确认、工单、维护和排产操作,在当前版本仅改变本地演示记录。
| 能力 | 当前演示实现 | 生产化方向 |
|---|---|---|
| 数据 | 固定演示快照、CSV/XLSX 解析与导入校验 | 一种真实 MES 只读适配器、增量同步、字段映射 |
| 自然语言分析 | 基础关键词识别、控制类请求检查、模板诊断 | 结构化意图、注册工具、模型网关、预算管理 |
| 任务 | 时间驱动演示进度、取消、刷新恢复、报告去重 | 持久化 DAG、队列、租约、幂等恢复 |
| 3D | 参数化设备、GLB 质检仪器、选择聚焦、状态与动效、2D 降级 | 实际布局标定、授权资产、现场状态同步 |
| 报告 | 冻结结果、HTML、浏览器打印/另存 PDF | 服务端 PDF 队列、授权下载、版本与留存 |
| 存储 | 浏览器 localStorage;可选基础后端为进程内 Mock | MySQL repository、迁移、事务、备份恢复 |
| 身份权限 | 单用户演示,姓名等为记录字段 | 真实登录、角色及车间权限、服务端审计身份 |
| 预测与优化 | 趋势规则、启发式排产演示 | 有标签的预测回测、真实约束与现场验证 |
优先级应围绕可信产能诊断,而非首版同时实现通用 Agent、精确建模、预测维护和全局排产优化。
3. 核心业务流程
3.1 自然语言产能诊断
以“分析今天 A 线产能偏低原因,找出瓶颈工位”为例:
- 明确工厂、产线、产品、生产日、班次和截止时间。
- 展示计划、可用数据、对照窗口和缺失字段。
- 检查重复、缺失、停机重叠、目标版本和工艺计数点。
- 冻结分析快照,由程序计算产量、良率、时段偏离和停机损失。
- 将高损失设备列为候选;只有工序、节拍、在制品及阻塞/饥饿证据足够时,才进一步判断整线瓶颈。
- 输出“事实、可能解释、反证或缺口、建议”四类信息。
- 校验数值和引用,形成报告并定位 3D 工位。
- 人工登记现场原因、采纳或驳回建议、复查结果。
“停机最长”不等于“整线瓶颈”;没有缺料记录也不能推导为“已排除缺料”。人员技能和出勤数据不足时,不输出看似精确的调岗方案。
3.2 告警、报告与历史记忆
告警确认代表有人看到,不代表设备已经恢复。恢复必须有新数据或人工说明支持。历史报告只能作为背景,不能冒充当前状态证据。
报告绑定快照、指标版本、算法规则和证据。重试导出应复用原结果;重新分析则创建新版本。人工经验进入长期知识前,需补充提供者、适用范围、审核状态和有效期。
4. 八项制造业扩展
以下均为本地 Mock 可操作版本,功能完成不代表源系统集成完成。
| 方向 | 已实现操作 | 关键边界 |
|---|---|---|
| 异常闭环 | 告警转单、分派、原因分类、处理、验证、关闭、退回、履历与重复异常统计 | 未确认原因不计入重复根因;不修改遥测 |
| 工单与交期 | 创建、进度、良品、剩余量、定位,结合日历、检修、换模和资源排队估算 ETA | 使用固定演示基准;指定模具未安装不能启动演示记录 |
| 停机与 OEE | 设备/产线/班次筛选、三因子、停机排行、换模及速度/质量损失、班次对比 | 独立演示快照,不简单平均设备 OEE |
| 模具管理 | 档案编辑、模次、模穴、寿命、兼容机台、维修、换模及卸模履历 | 在制工单阻止冲突操作,不能破坏资源约束 |
| 质量追溯 | 工单、产品批次、原料批次、供应商、设备、模具绑定及检验登记 | 一工单一产品批次一原料批次;抽检件次不能外推整批不良率 |
| 交接点检保养 | 待办承接、异常关联、设备二维码、扫码、照片、点检转单、周期保养 | 照片本地保存;真实摄像头需权限与 HTTPS;演示姓名不是认证身份 |
| 能耗成本 | 分时电量、空转电耗、单机单位良品电耗、峰平谷电价与电费估算 | 仅电费;空转是总量子集;跨工序不重复累计良品 |
| 排产模拟 | 交期优先、列表顺序、同模具优先、插单、假设停机、资源互斥、方案比较和导出 | 启发式,无最优保证;确认不改变生产计划或设备 |
演示排产按整单保守占用机台和模具,考虑换模、检修、日历空隙与模具寿命,不覆盖拆单、人员技能、原料到料等完整约束。方案确认前按当前资源重算,发生变化时拒绝确认并要求重新模拟。
5. 指标与数据设计
最小数据应包含组织设备、产出记录、目标、停机区间、班次日历和工艺路线。扩展数据包括材料、人员技能、在制品、理想节拍、维护记录、质量批次和电表区间。
- 整线产量:指定完工计数点的去重数量,不能累加各工序过站数。
- 目标达成率:相同范围实际产量 / 计划产量;未结束班次不能直接与全天目标比较。
- 最终良率:最终良品 /(最终良品 + 最终不良);不等于一次通过率。
- 停机时长:停机区间与有效计划窗口相交后取并集,避免重复计时。
- 分母为零、缺失或不适用时,不伪装为 0%;未知与零必须区分。
- 电费:各计量区间电量 × 对应时段电价,再求和。
当前 OEE 演示按统一时间量定义:P 为扣除休息后的计划时间,R 为运行时间,I 为按标准节拍折算的总产出时间,G 为标准良品时间。
开动率 = R / P
性能率 = I / R
质量因子 = G / I
OEE = G / P
损失拆分:停机 P-R、速度 R-I、质量 I-G、有效产出 G
同设备同周期时质量因子等于良品率;跨设备聚合先汇总对应时间,再求比值。性能超过 100% 等异常应检查数据和节拍,不能截断成“正常”。
导入需识别增量、累计值或单件过站语义;同业务键重复不累加,更正应留修订。当前实现为任何校验错误阻止整批确认,尚未实现原需求中设想的部分成功导入。旧报告结果冻结,后续更正不能污染既有结论。
6. 界面与交互设计
视觉采用深色工业大屏、低对比科技背景、中央 3D 车间与侧边分析图表。最终交互以用户后续调整为准,不能直接将早期草图当作最终实现。
- 总览隐藏左侧业务菜单,优先放大模型区域;告警及业务页恢复导航。
- 头部显示真实年月日时分秒;业务演示快照时间独立管理,实时时钟不意味着生产数据实时。
- 智能分析使用可拖拽浮动圆形入口,点击展开分析面板,移除重复菜单入口。
- 精简模型周围说明和底部冗余信息,减少面板边框,统一上下对齐与间距。
- 趋势、停机排行及告警等分析内容放在侧边区域,避免遮挡主要模型。
- 桌面总览铺满可用视口、不出现整页纵向滚动;小屏使用响应布局与必要的局部交互。360/390px 的结果属于历史浏览器测试。
- 常规最小字体按 12px 设计;模型区域按用户后续要求采用约 10px 的标签尺度,不能把这一例外扩散到所有页面。
- 工人按工位配置,节奏动作、装配、上料、开关门和质检动画用于演示运行感;移除过度外层红色包裹,故障用醒目红色闪灯表达。
设备状态、Agent 诊断标记和历史分析应分层,不能互相覆盖;保留文字和符号,避免只依赖颜色。动画不是现场采集轨迹,也不是经过校准的生产仿真。
7. 技术架构:当前实现与目标方案
前端采用 Vue 3、Vite、TypeScript、Three.js 和按需注册的 ECharts。统一 Gateway 隔离页面与数据源,VITE_DATA_MODE=mock 选择浏览器演示仓库;切到 api 只改变请求路径,不会自动获得真实后端能力。
目标后端采用 FastAPI/Pydantic;MySQL 存业务事实、任务、证据与审计,Redis 用于缓存和唤醒队列;Pandas/NumPy 用于需要的数据处理;MQTT 仅在后续批准的上层只读数据边界内考虑。上述后端生产架构尚未全部实现或部署。
演示 / Excel / CSV / 未来 MES 只读适配
↓
标准化、质量检查、数据修订和快照
↓
确定性指标与注册分析工具
↓
任务计划 → 执行 → 校验 → 报告/反馈
↓
统一 API/Gateway → 大屏、图表、3D、业务面板
本地业务存储使用版本字段拒绝过期编辑,支持 Web Locks 时序列化同源写入;不支持时只是乐观版本检查,不能宣称数据库级并发事务。正式照片应存对象存储及对象键,不能将演示 Base64 存储直接照搬到生产。
8. Agent 设计与可信性
DAG 是“有先后依赖、没有循环”的任务图;PEV 是规划、执行、校验三个阶段。推荐使用受控模板和工具注册表,不允许模型生成任意 SQL、脚本或工业操作。
设计链路:范围解析 → 数据可用性 → 冻结快照 → 并行指标/异常检查 → 候选归因 → 证据核验 → 报告发布。节点应保存输入摘要、快照、状态、attempt、结果与错误;任务区分成功、部分完成、需补充、失败和取消。
生产化需要:MySQL 状态作为事实来源,Redis 只负责唤醒;事务 outbox 防止业务状态与通知不一致;worker 租约应对异常退出;按至少一次执行设计幂等;取消后不再启动新节点;限制任务时限、重试次数、调用预算和并发。
模型只使用授权范围内的聚合数据解释结果。简单统计不需要模型;复杂解释按需调用。模型不可用时仍返回确定性指标和缺口说明。外部备注、导入文本和模型输出都是不可信数据,不能提升工具权限。
校验分为数据结构、时间范围、计算口径、引用一致性和措辞强度。数据完整性、数值正确性与因果可信度分别表达,不能合成未经校准的“置信度百分比”。
9. API 与 SQL 预留
基础 API 前缀为 /api/v1,契约涵盖工作区、设备、指标、分析任务、进度事件、告警确认、导入/回滚、报告反馈与场景绑定。基础 FastAPI Mock 是演示实现;任务事件流不具备生产级持久游标回放。
制造业扩展使用 GET /api/v1/operations 与 POST /api/v1/operations/commands 契约。真实扩展实现尚未启用,合法结构明确返回 501,非法结构返回 422。报告服务端导出入口也为预留,当前通过 HTML 和浏览器打印输出。
SQL 文件划分:
001_schema.sql:组织、数据修订、快照、指标、任务节点、outbox、证据、报告、场景、权限与审计。002_demo_seed.sql:演示种子数据。003_manufacturing.sql:基础制造业务表。004_manufacturing_extensions.sql:班次、停机、模具、质量、交接、点检、能耗、排产等扩展。
这些文件未在本次历史部署中执行迁移。进入生产前必须实现 repository、事务/幂等、真实身份权限、范围过滤、审计、迁移与恢复测试。API 或表存在不代表业务闭环已经落地。
10. 3D 资产与性能优化
车间主体以 Three.js 参数化几何构造,并非全部来自一个 GLB。工业显微镜 GLB 用于 A05/B05 两个质检工位,通过 Promise 缓存下载一次,再复用到两个节点。
模型来源:Poly Haven Industrial Microscope,作者 Lukas Walzer,CC0。保留原始资产与来源记录,生成适合大屏的 Web 派生文件。
历史优化结果:
| 项目 | 结果 | 解释边界 |
|---|---|---|
| 显微镜文件 | 2,454,916 → 332,060 字节,减少 86.5% | Meshopt 几何压缩、512 WebP 贴图;贴图有损,原资产保留 |
| 主入口 JS | 约 378 → 216 KB | 非首屏业务面板与 Excel 解析按需加载 |
| 模型请求 | 单次导航仅 1 次,两处加载成功 | HTML preload 与运行时复用同一个 URL |
| HTTPS 冷加载模型 | 单次实测约 3.4 秒 | 受网络影响,不是固定提速承诺 |
| 模型暖缓存 | 单次实测 20ms、传输 0 字节 | 版本哈希地址与 immutable 缓存生效 |
| 较早的静态场景绘制调用 | 512 → 131 | 特定历史场景的合成测试,不代表新增动画后的所有版本 |
渲染策略包括相机变化触发重绘、保留阻尼收尾、按材质合并静态几何、按需更新阴影、像素倍率上限、页面隐藏与 2D 模式暂停、及时释放 GPU 资源。开启演示动画时仍需要受控刷新,不能把早期静态场景的“完全停止重绘”套用到动态车间。
模型放进构建资产目录后由 Vite 生成内容哈希地址,以便长期缓存和更新失效;GLTFLoader 配置 Meshopt 解码器。ECharts 包仍约 495 KB,不能声称它已显著缩小。
11. 部署、缓存与连接排查
历史交付为纯前端静态站点,入口为 数字车间,未部署生产 Python 服务和数据库。Vite 构建使用 /digital-twin/ base,模型、脚本、样式和图标必须正确处理子路径。
/digital-twin/ 的尾斜杠是目录语义;.glb 文件地址不加尾斜杠。它不是当时加载慢或浏览器断连的原因。
Nginx 优化包括 HTTP/2、TLS 会话缓存、后端连接复用、Docker DNS 重新解析、gzip、合理超时;带哈希静态资源缓存一年,HTML 和未版本化资源重新校验;缺失文件返回真实 404,不附加长期缓存;流式接口关闭缓冲,避免输出被攒住。
发布采用独立版本目录和原子切换,保留历史版本。配置是 Docker 单文件挂载时,必须原地写内容,避免替换 inode 使容器仍读取旧文件;先备份,再 nginx -t,通过后平滑 reload,失败回写备份。保留原业务路由,不删除停止的容器。
ERR_CONNECTION_CLOSED 排查案例
2026-09-30 曾复现浏览器刷新失败、稍后恢复。检查发现 Nginx 无重启/OOM,失败探针未出现在访问日志。本机启用了 xray 代理,分组测试为:
- 代理 + HTTP/2:首轮 5 次失败或超时,后续 3 次恢复。
- 代理 + HTTP/1.1:5 次成功。
- 绕过代理 + HTTP/2:共 8 次成功。
证据指向当时代理链路的间歇性问题,以及与 HTTP/2 相关的兼容性可能;未精确归因到客户端或出口节点。建议为目标域名设置 DIRECT 后复测,而不是看到断连就反复改服务器。
这是一例历史诊断,不能套用到未来每次失败。新的故障仍应比较 DNS/TLS、网络路径、HTTP 协议、服务端日志、资源状态和请求时间。
12. 验证边界与生产化路线
历史记录包括 22 项前端测试、生产构建、两处模型、Mock 工单与缓存浏览器检查;制造业务文档另记录后端 19 项契约测试、八页流程、360/390px 布局与模拟视频扫码通过。模拟摄像头不等于物理手机验收;静态检查也不等于 SQL 迁移、真实权限或 MES 联调。
推荐路线:
- 演示验证:让目标客户完成诊断、异常闭环、质量追溯等真实任务访谈,验证是否有使用意愿。
- 数据试点:选一厂一线,统一完工计数点、班次、产品、停机、标准节拍和数据责任人。
- 服务端闭环:持久化、认证授权、导入修订、证据快照、任务恢复与审计。
- 受控 Agent:白名单工具、结构化输出、预算限制、无模型降级和错误归因评测。
- 现场验收:真实终端性能、断网重连、备份恢复、权限越界、人工复查及口径对照。
- 高级扩展:取得历史标签和约束数据后,再做健康预测、复杂排产与经校准的流转仿真。
原“30 天”计划可用作演示或试点候选版本的时间盒,不是无条件生产上线承诺。私有部署与调用云模型必须区分:允许外发时进行授权、最小化和脱敏;禁止外发时采用本地模型或无模型模式。
商业化可考虑部署实施、年度维护和模型/报表定制收费,但报价需包含数据清洗、现场集成、资产授权、建模、终端适配与售后成本。优先用付费试点证明分析耗时减少和问题闭环价值,再决定精细 3D 投入。
13. 来源与维护
本文来源于项目内的产品需求、技术交互设计、视觉规范、API 边界、GLB 接入、3D 性能、制造业务扩展、八项验收清单、前端部署、Nginx 与首屏优化记录,以及本会话中的发布和网络对照结果。早期文档中的“计划”由后续实现/验收记录覆盖,不能反向把规划全部记为已完成。
后续更新本知识条目时,应附数据、代码或验收版本,并分别维护“需求”“已实现”“已验证”“仍待验证”四种状态。本次知识归档没有重新部署项目、调用付费模型、执行数据库迁移或修改现场设备。