ilesp — Tomas 同枢（ILESP 标准版）

双枢同源，预演万线 —— 海神双芯，智造同频。

统一物流设备调度平台：一个代码库内实现 WCS（仓库控制系统）+ RCS（机器人调度系统）+ 内置仿真， 通过适配器缝向真实设备平滑过渡——模拟与真实是同一接口的两种实现，切换 = 换配置，代码零分叉。

📖 完整使用说明（含专业版塔台）：docs/USAGE.md —— 安装启动 · 控制台与塔台图解 · 任务状态机 / 三层交通管制 / 事故 WarRoom 概念详解 · API 速查 · FAQ（配 8 张界面截图 + 5 张 SVG 图）。 🌐 官网：https://ilesp.123aiot.com ｜ 家族产品：Nereus 同衡 · CPS 数字孪生（体系：海神双芯，智造同频） 📚 文档：docs/USAGE.md · docs/DEPLOY.md · 源码：https://github.com/123AIoT/ILESP 🛠 生产部署运维手册：docs/DEPLOY.md —— 环境变量全集 · TLS/反代 · 备份恢复 · 升级回滚 · 安全清单。 📋 发布记录：CHANGELOG.md · 安全报告：SECURITY.md

设计决策与演进规划

见 docs/ARCHITECTURE.md（统一 vs 分散）与 docs/ROADMAP.md（三阶段生产化：试点 → 交通管制内核 → 多厂商矩阵）。结论：模块化单体——WCS/RCS/SIM 是三个有界上下文， 内部通过任务契约通信（与将来拆分后对外的契约同形）；模拟层实现与真实设备驱动相同的 Adapter 接口。

能力边界（先说清不做什么）

ILESP 只做设备调度与执行：站台拓扑、路径规划、设备级推进、车队派工与交通管制。 它不做仓库/库存仿真——货架、库位、巷道、料箱、托盘、入出库、拣选、盘点、移库、库存台账 都不在 ILESP 的模型里（payload 是任意字典，无容器类型模型）。 物理场景与生产仿真是姊妹产品 Nereus 同衡（CPS） 的定位（万物同衡，虚实相应）；ILESP 与它通过标准协议对接。 误把 ILESP 当仓库仿真工具用，会期待它根本不具备的能力。

标准版 vs 专业版：本包为标准版——调度服务 + 内置仿真 + 控制台（零构建链， pip install 即用）。专业版 3D 塔台、事故 WarRoom、数字实验台、Copilot、生态集成 随源码仓库交付，见 仓库。

架构

WMS / MES / Aethon ──HTTP(幂等任务接口)──► ┌─────────── ILESP ───────────┐
                                          │ wcs: 站台拓扑/**加权路由**/   │
                                          │      **故障重规划**/设备级调度│
                                          │ rcs: 车队注册/**多目标派工**   │
                                          │      (预留+TTL+**L1按段路权**)│
                                          │ core: 任务状态机/幂等账本/事件  │
                                          │ adapters: ◄─ 适配器缝 ─►      │
                                          │   ├── simulated/（内置仿真）    │
                                          │   └── modbus 等（真实驱动）     │
CPS 数字孪生 ◄──遥测/状态(标准协议)──────────└─────────────────────────────┘

快速开始

pip install -e ".[api]"
uvicorn ilesp.api:app --port 8800     # 或 python -m ilesp.api
pytest                                # 测试（含端到端竖切）

Docker（可选）

docker compose up -d                      # 仅 app（内置仿真，零外部依赖）
docker compose --profile mqtt up -d       # 额外起 mosquitto（接真车 VDA5050 时需要）
ILESP_API_KEY=... docker compose up -d    # 生产：务必配鉴权

⚠️ 未构建验证：本机没有安装 docker（实测 docker: command not found）， Dockerfile / docker-compose.yml 是按规范手写并做了静态校验（多阶段、非 root、 健康检查、数据卷、密钥排除），但尚未 docker build 跑通。 首次使用请先 docker compose build；本地开发不需要 Docker（见上方 pip 方式）。

端到端语义（竖切）

POST /api/v1/tasks（幂等）→ WCS 依站台拓扑规划路径 → 逐站设备级执行 （simulated 输送线状态机）→ 需要搬运时创建 RCS 搬运腿 → 派给模拟 AMR（行驶/电池）→ 到达 → 下一腿 → 任务 COMPLETED。全程迁移进 SQLite 事件账本（WAL），来源归因。

确定性

仿真适配器以固定 tick + 可传 seed 的 Random 驱动——相同 seed + 相同任务序列 ⇒ 相同结局 （对拍/回归友好，与 CPS 的确定性文化一致）。

生产化路线

鉴权（升级必读）

2026-10-07 起写面默认拒绝；配了凭据后读写都要凭据：

角色：viewer（只读）/ operator（任务与仿真操作）/ admin（布局热重载、车队扩缩容、鉴权）。 凭据形式：X-ILESP-API-Key、Authorization: Bearer <token>、 或 RCS-2000 风格签名（X-ILESP-Key + X-ILESP-Timestamp + X-ILESP-Signature）。 生产部署务必配置凭据，否则写操作会被拒——这是安全目标的修正，不是缺陷。

浏览器里怎么填凭据

控制台与塔台顶栏都有 🔑 凭据 按钮，点开粘贴 API Key 或 Bearer 令牌即可 （存 sessionStorage，关标签页即失效）。未填时界面显示「只读」， 写操作会给出明确提示而不是静默失败。

SSE / WebSocket 受浏览器限制无法自定义请求头，凭据通过 ?key= 查询参数传递 （与 WS 命令鉴权既有做法一致）。SSE 虽在中间件白名单里，但端点内会再校验一次， 不构成绕过鉴权的后门。

测试

pytest tests/ -q