init commit

README.md

@@ -1,2 +1,63 @@
-# StandardSence
+# StandardScene
 
+`StandardScene` 是一个基于 `.NET Framework 4.8` 的场景插件库，运行时由 `SimpleComposer.exe` 作为宿主加载。项目面向 AGV/AMR 场内调度与联动控制，覆盖搬运任务、环线任务、区域交通管制、充电管理、门禁联动，以及 HTTP / MQTT / Modbus 等对外通信能力。
+
+## 文档入口
+
+- `DocumentHub.html`：单文件文档门户，双击即可在浏览器中打开
+- `DEVELOPMENT_GUIDE.md`：面向整个仓库的开发指南
+- `QUICK_REFERENCE.md`：高频开发速查表
+- `INDEX.md`：阅读顺序与导航说明
+
+## 项目定位
+
+- 工程类型：类库插件，不是独立 EXE
+- 宿主程序：`SimpleComposer.exe`
+- 目标框架：`.NET Framework 4.8`
+- 主要语言：`C#`
+- 典型场景：仓储搬运、区域流控、充电协同、门控联动、车辆协议接入
+
+## 顶层模块
+
+| 目录 | 作用 |
+| --- | --- |
+| `CarTypes` | 各车型与协议适配，如叉车、Kiva、VDA5050、多车联动 |
+| `Chained` | 链式搬运与环线任务主流程 |
+| `Charge` | 充电策略、充电桩管理、状态监控 |
+| `ChargeStationType` | 充电桩类型实现 |
+| `InterLock` | 区域互锁与交通控制 |
+| `Scheduler` | 场景级辅助任务，如心跳、区域流控、安全信号 |
+| `ExtendDevice/Door` | 门控设备接入与联动 |
+| `Model` | 任务、配置、地图等数据模型 |
+| `TCP` / `Utils` | TCP、JSON、WebAPI、Modbus 等基础工具 |
+
+## 构建与运行
+
+1. 使用 Visual Studio 打开 `StandardScene.sln`
+2. 确认本机依赖路径存在：
+   - `D:\MDCS\Dependencies\Commons\CommonUsage.dll`
+   - `D:\MDCS\Dependencies\deps\LessokajiWeaverUtilities.dll`
+   - `D:\MDCS\Dependencies\Simple\RefSimpleCore.dll`
+   - `D:\MDCS\Executables\Simple\SimpleComposer.exe`
+3. 编译 `Debug|Any CPU` 或 `Release|Any CPU`
+4. 编译后 `PostBuildEvent` 会将 `StandardScene.dll` 复制到 `build\plugins\`
+5. 运行 `build\SimpleComposer.exe`，由宿主加载插件
+
+## 开发阅读顺序
+
+1. 先看 `DocumentHub.html`，快速建立全局认知
+2. 再看 `DEVELOPMENT_GUIDE.md`，熟悉架构、流程与配置
+3. 开发时配合 `QUICK_REFERENCE.md` 快速查常用入口
+4. 新增功能前，先对照 `Scheduler\HeartBeatMission.cs` 或 `Scheduler\RegionalTrafficControlMission.cs`
+
+## 推荐起步文件
+
+- `Scheduler\HeartBeatMission.cs`：最小 Mission 结构参考
+- `Scheduler\RegionalTrafficControlMission.cs`：事件订阅型 Mission 参考
+- `Chained\TransportMission.cs`：搬运任务主流程
+- `Charge\StandardChargeMission.cs`：充电任务骨架
+- `WebApi.cs`：HTTP 接口入口
+
+## 本地打开 HTML 文档
+
+直接双击 `DocumentHub.html` 即可，无需部署。页面已使用 `UTF-8` 编码，并对中文、English 和 emoji 做了兼容字体设置。