zhaowei.huang
a0dc1e6cd0
将 StandardScene 各插件的配置/监控窗体从 WinForms 迁移到 CycleGUI（删除 .Designer.cs/.resx，重写为 PanelBuilder 立即模式 UI，新增 CycleUiHelper 统一对话框）。 同时修复代码审核中的问题： - 后台文件写入加锁 + try/catch（ButtonBoxManager / DoorManager，对齐 LoopViewer.SaveTasks 模式） - CoderFieldsMetadata.cs 启用 #nullable enable，消除 CS8632 警告 - DummyCar 移除已废弃的 rightClickAction()/SetPosition() - CarRemoteHelper.OpenVehicleWebPage 的 Process.Start 加 try/catch - 重命名名不副实的 Mstsc()（现为打开网页） - 统一弃元命名为 _ - TrafficInterlockViewer 改用稳定 Id（GUID）做选择/编辑，替代行索引 - csproj 改用 $(CGUILibDir) 解析 CycleGUI，绝对路径收敛到 Directory.Build.props 构建：dotnet build StandardScene.sln → 0 错误，30 警告（均为历史遗留）。 注：static 单例状态重构（审核第 8 项）暂未处理，留待单独任务。
60 lines
2.2 KiB
Markdown
60 lines
2.2 KiB
Markdown
# StandardScene 文档导航
|
|
|
|
## 1. 文档入口
|
|
|
|
| 文档 | 适合谁 | 用途 |
|
|
| --- | --- | --- |
|
|
| `DocumentHub.html` | 所有人 | 单文件浏览入口，双击直接打开 |
|
|
| `README.md` | 第一次接触仓库的人 | 快速了解项目定位与运行方式 |
|
|
| `ARCHITECTURE.md` | 工程师 / AI Agent 接手 | **整体代码架构**、模块地图、扩展点、接手清单 |
|
|
| `DEVELOPMENT_GUIDE.md` | 要开始开发的人 | 系统化理解架构、模块、配置、案例 |
|
|
| `QUICK_REFERENCE.md` | 正在写代码的人 | 快速查入口、路径、配置、排错点 |
|
|
|
|
## 2. 推荐阅读路线
|
|
|
|
### 路线 A：第一次接触仓库
|
|
|
|
1. 打开 `DocumentHub.html`
|
|
2. 阅读 `README.md`
|
|
3. 阅读 `ARCHITECTURE.md`（建立架构全局观）
|
|
4. 阅读 `DEVELOPMENT_GUIDE.md`
|
|
5. 打开 `Scheduler\HeartBeatMission.cs`
|
|
6. 动手做 HelloMission 案例
|
|
|
|
### 路线 B：已经会跑工程，准备开发
|
|
|
|
1. 阅读 `QUICK_REFERENCE.md`
|
|
2. 根据目标定位目录
|
|
3. 找最接近的参考类
|
|
4. 写代码
|
|
5. 回到 `DEVELOPMENT_GUIDE.md` 查配置与调试建议
|
|
|
|
### 路线 C：准备改真实业务逻辑
|
|
|
|
1. 先确认变更属于哪个模块
|
|
2. 如果是调度，看 `Chained\`
|
|
3. 如果是联动控制，看 `Scheduler\` 或 `InterLock\`
|
|
4. 如果是设备或协议，看 `CarTypes\`、`Charge\`、`ExtendDevice\Door\`
|
|
5. 如果是外部系统接入，看 `WebApi.cs`
|
|
|
|
## 3. 按目标查文件
|
|
|
|
| 目标 | 直接打开这些文件 |
|
|
| --- | --- |
|
|
| 了解插件怎么被宿主识别 | `Scheduler\HeartBeatMission.cs` |
|
|
| 做区域流量限制 | `Scheduler\RegionalTrafficControlMission.cs` |
|
|
| 做搬运调度 | `Chained\AbstractChainedDeliveryMission.cs`、`Chained\TransportMission.cs` |
|
|
| 做充电策略 | `Charge\AbstractChargeLogicMission.cs`、`Charge\StandardChargeMission.cs` |
|
|
| 查 API | `WebApi.cs` |
|
|
| 查通用工具 | `Commons.cs` |
|
|
|
|
## 4. 本地打开 HTML 文档
|
|
|
|
直接双击 `DocumentHub.html` 即可，无需任何部署。页面已内嵌样式与脚本，并显式声明 `UTF-8` 编码。
|
|
|
|
## 5. 建议的第一个练习
|
|
|
|
1. 按 `DEVELOPMENT_GUIDE.md` 的案例 A 新建 `HelloMission`
|
|
2. 编译后部署到宿主 `plugins\`，运行 `SimpleLite.exe`
|
|
3. 启动 Mission，确认状态每秒递增
|
|
4. 再按案例 B 给站点添加 `Region1=1`，体验区域流控 |