跳转至

CPS 数字孪生与仿真系统 · 文档站

本页是文档站首页。现有 md 只做导航编排,内容不迁移、不改写; 仓库根的 README.md 是代码仓库入口,与本页各自独立。 本文所有示例、回放、截图与数值均为确定性仿真数据,非现场实测值(见下方 R5 说明)。

产品定位

CPS = AI 原生 · 确定性 · 实时数字孪生与仿真系统。CPS 不是 SCADA。

词 含义 因此不做
AI 原生 Copilot / MCP / 推演链(影子 → EWMA → 敏感度 → sweep/MC → 解读)是产品本体,不是插件 不做无 AI 语义的裸数据看板
确定性 固定 tick、位级对拍、黄金快照闸门是第一资产 不做墙钟驱动、不做随机联锁干预(R6)
数字孪生与仿真 布局设计 → 虚拟运行 → 推演决策,覆盖全生命周期 不做 SCADA 五件套(实时采集驱动、报警管理台、报表、多站点、HMI 组态)

监控侧由姊妹产品 AIoT-SCADA(Studio 组态 + AIoT-View 运行站)负责:报警管理台、 HMI 组态、工业协议采集都归它;CPS 只产出孪生状态、事件、推演结果,以及确定性的 安全联锁评估 + HITL 提案(这是仿真的智能预警,不是报警台)。分工依据见 EXTERNAL_BENCHMARK_PLAN_2026-11-15.md §0。

确定性是第一资产

同输入必须得到逐位一致的输出。数字孪生用于投资决策,两次同样的输入给出不同结论, 管理层就会拿到互相矛盾的建议。仿真引擎禁止墙钟驱动的状态转移与全局随机调用(R6), 位级对拍与黄金快照闸门是行为偏移的唯一闸门。任何把 CPS 往墙钟、随机或 SCADA 方向拉的改动都要砍掉。 详见确定性专章与 AGENTS.md R6。

五段导航

段 回答什么问题 从这里开始
入门 怎么在 60 秒 / 5 分钟 / 30 分钟内跑通、看懂 GETTING_STARTED.md · BEGINNER_GUIDE.md · DEMO_PLAYBOOK.md
概念 系统怎么设计、为什么可复现 ARCHITECTURE.md · 确定性专章 · ELEMENTS_AND_MODELING.md · ECOSYSTEM_OVERVIEW.md
运维 怎么部署、性能基线、产品化路线 DEPLOYMENT.md · PERFORMANCE.md · PRODUCTIZATION_PLAN.md
API 契约管道怎么走、端点以什么为准 API 与契约总览
安全 三级角色、HITL、演示数据边界 安全模型总览

未列入导航的文档(例如 docs/adr/ 的架构决策、docs/audit/ 的审计与基线记录) 仍保留在仓库中,可在源文件里按需检索。

三条上手路径

以下出自 GETTING_STARTED.md §2.5「三层上手路径与示例场景库」。

路径 目标 动作
L1 · 60 秒 一条命令起全栈,立刻看到 LIVE KPI / 机器人 / 事件流 python scripts/demo_up.py --factory,收工用 python scripts/demo_up.py --stop
L2 · 5 分钟 加载一个示例,让洞察面板出数 用 scripts/examples_cli.py 的 list → show → request 三步;示例库在 config/examples/
L3 · 30 分钟 把一次推演问成一条证据链 用示例绑定的 Copilot 追问样例,跑 what-if 对比或敏感度扫描

scripts/examples_cli.py request 会生成可直接执行的 curl(令牌走环境变量,不进 shell 历史),POST 到既有推演端点,回传 Baseline vs Scenario 的 KPI delta 与解释。 LIVE 引擎不受影响——推演靠复制状态而非 re-seed,这也是同 seed 结果逐位一致 的原因(R6)。示例清单与契约闸门见 GETTING_STARTED.md §2.5。

示例数据边界(R5 诚实降级)

文档站引用的示例库、演示回放、截图与数值全部是确定性仿真数据:固定 seed (示例库为 seed=7)、工艺参数为演示级工业假设,不是现场实测值,禁止混入 生产数据路径。运行视图沿 R5 显示演示数据横幅「正在播放 CPS 产线演示回放 (300s 数据帧 · 4× 速度循环)——非实时数据。」;Copilot 降级路径显式标记 via: "rules",ILESP 离线保留上次快照而非静默清空。

本地构建状态

本仓库当前未安装 mkdocs / mkdocs-material,因此文档站的 mkdocs build / mkdocs serve 尚未在本机执行过;nav 路径与文档内链由零依赖脚本独立校验:

uv run python scripts/check_docs_nav.py

依赖安装与 docs:build / docs:serve 脚本由仓库维护者另行加入,本文件不改动 package.json / pyproject.toml / uv.lock。