StandardSence/README.md

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 做了兼容字体设置。