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。