StandardScene Documentation Hub

01. 项目总览

`StandardScene` 是 AGV/AMR 场景插件库，不是独立 EXE。它依赖宿主 `SimpleComposer.exe` 运行，能力覆盖搬运调度、环线任务、 交通互锁、区域流量控制、充电协同、门控联动，以及 HTTP / MQTT / Modbus 等外围接口。

02. 运行架构

宿主装载流程

1. 编译得到 StandardScene.dll
2. 构建事件将 DLL 复制到 build/plugins
3. 宿主启动后扫描插件目录
4. 通过特性反射识别 MissionType 与 CarType
5. 用户或 API 启动对应场景逻辑

03. 模块地图

04. 构建与运行

本机依赖路径

D:\MDCS\Dependencies\Commons\CommonUsage.dll
D:\MDCS\Dependencies\deps\LessokajiWeaverUtilities.dll
D:\MDCS\Dependencies\Commons\MDCSToolBox.dll
D:\MDCS\Dependencies\Simple\RefSimpleCore.dll
D:\MDCS\Executables\Simple\SimpleComposer.exe

构建步骤

1. 打开 StandardScene.sln
2. 编译 Debug|Any CPU 或 Release|Any CPU
3. 确认构建事件已将插件复制到 build/plugins
4. 运行 build/SimpleComposer.exe

05. 快速开始案例

案例 A：新增 HelloMission

这是推荐的新手第一练。它直接沿用 `Scheduler/HeartBeatMission.cs` 的结构，只保留最小生命周期：`Create()`、`Execute()`、`Stop()`。

using System.Threading;
using Newtonsoft.Json;
using SimpleComposer.RCS;
using SimpleCore;

namespace StandardScene.Scheduler
{
    [MissionType(Name = "Hello Mission", editor = typeof(HelloMission))]
    [I18N.DocumentTranslation(Name = "Hello Mission", locale = "en")]
    public class HelloMission : Mission
    {
        [JsonIgnore] private bool _started;
        [JsonIgnore] private Thread _thread;

        public static Mission Create()
        {
            return new HelloMission();
        }

        public override void Execute()
        {
            if (_started) return;
            _started = true;
            status.status = "已启动";

            _thread = new Thread(() =>
            {
                int count = 0;
                while (_started)
                {
                    Thread.Sleep(1000);
                    count++;
                    status.status = $"tick:{count}";
                }
            });
            _thread.Start();
        }

        public void Stop()
        {
            _started = false;
            status.status = "已停止";
        }
    }
}

1. 新建 Scheduler/HelloMission.cs
2. 确认它已被加入工程
3. 编译并打开 build/SimpleComposer.exe
4. 启动后观察 status.status 是否按秒递增

案例 B：区域流控实验

该案例对应 Scheduler/RegionalTrafficControlMission.cs。给同一区域的站点加字段 Region1=1，即可限制该区域最多同时只有 1 台车。

Region1 = 1

1. 给目标区域内多个站点都加上相同的 Region1 字段
2. 启动“区域流量监控” Mission
3. 让两台车依次申请进入该区域
4. 观察第二台车是否被阻止，日志和状态里会记录拦截次数

06. 配置文件

除了 JSON 文件，很多逻辑还大量依赖站点、车辆和轨道的 fields 与 tags。例如区域流控依赖以 Region 开头的字段，许多调度逻辑依赖 group、giveWay、standby 等字段。

07. API 入口

WebApi.cs 是外部系统最重要的进入点，仓库中已可看到这些典型路由：

08. 开发工作流

1. 先定位功能属于哪个目录
2. 找最接近的现有类作为模板
3. 明确它依赖 JSON 配置还是 `fields` / `tags`
4. 补齐日志、状态和停止逻辑
5. 确认新文件已加入工程
6. 编译后在宿主中验证是否被识别

09. 常见排错