Third_Dev_Dept/Migu2.0
18
0
Fork 0
Code Issues 2 Pull Requests Packages Projects Releases Wiki Activity

将调度内核标识从 SimpleLite 全面重命名为 Simple3。

Browse Source 
配置段/环境变量、Launcher、健康检查 API、OpenAPI 与前后端文案同步；兼容探测旧 SimpleLite 进程名。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
黄兆尉
2026-08-26 17:46:52 +08:00
co-authored by Cursor
parent 912c44c9bb
commit 3686abdc78
79 changed files with 922 additions and 832 deletions
Download Patch File Download Diff File Expand all files Collapse all files
PLATFORM_V3_CHANGES.md
+26 -26
View File
@@ -1,43 +1,43 @@
# 平台 v3 重构 — 阶段 0~6 实际改动
> 范围：把 SimpleLite WebTerminal 由"全功能浮动 Panel"模式收敛到"纯 3D Canvas"，所有 UI 改由 Vue 平台前端 (`frontends/apps/simple-platform-vue`) 接管；同时补齐反射 / 编辑 / 监控 / 编排 4 大业务面板与撤销栈、AI 生图、报警 SSE 等关键能力。
> 范围：把 Simple3 WebTerminal 由"全功能浮动 Panel"模式收敛到"纯 3D Canvas"，所有 UI 改由 Vue 平台前端 (`frontends/apps/simple-platform-vue`) 接管；同时补齐反射 / 编辑 / 监控 / 编排 4 大业务面板与撤销栈、AI 生图、报警 SSE 等关键能力。
>
> 基线：上一份方案见 `ARCHITECTURE.md` v2/v3 章节；后续以本文件为准。
## 编译验证
- `dotnet build SimpleLite/SimpleLite.csproj` —— 0 警告 0 错误
- `dotnet build Simple3/Simple3.csproj` —— 0 警告 0 错误
- `dotnet build MiGu.Server/MiGu.Server.csproj` —— 0 警告 0 错误
- `build-platform-frontend.bat` —— vite build 46.5s，无 vue-tsc / ts 错误，robocopy /MIR 已同步 MiGu.Server/wwwroot
- 旧 `SimpleComposer` (WinForms) 在 v3 之外，不在本次构建目标里
- 旧 `HttpClientHelper` 提升 LangVersion=latest 修通
## 阶段 0：后端 SimpleLite 平台化（已完成）
## 阶段 0：后端 Simple3 平台化（已完成）
### 新增文件
| 文件 | 作用 |
|------|------|
| `SimpleLite/Web/MapEditApiController.cs` | 写操作 8 路 API：create/delete/batch/copy-to/pick/dashboard/upload/ai-generate；阶段 6 又补：**project/save**、**project/load**、**project/current**、**sample-sites-along-track** |
| `SimpleLite/Web/ReflectionApiController.cs` | 只读 + execute API；listKinds / listObjects / methods-by-type / setField / getBundle / selection 等 |
| `SimpleLite/Web/ReflectionApiDtos.cs` | 反射 API DTO + 统一信封 `ReflectionEnvelope<T>` |
| `SimpleLite/Web/AiCompletionService.cs` | OpenAI Function Calling 调用 + map-generate 工具桥（真实 LLM，不再桩） |
| `SimpleLite/Web/AiConfigController.cs` | AI 服务配置（endpoint/apiKey/model/system prompt/temperature/maxTokens/timeout）读写 |
| `SimpleLite/Web/AlarmStreamService.cs` | 1s 周期 diff `car.status.enums.AlarmInfo`（语义与 `E:\Work\FRLD\StandardScene\Forklift.cs` 的 `Commons.GetCarStatus(this, "AlarmInfo")` 等价），变化时通过 SSE `alarm` 事件推送 raise/update/clear |
| `SimpleLite/Web/ProjectionStreamModule.cs` | 平台 SSE 总线，对外广播 `object-created` / `object-deleted` / `object-patched` / `object-batch-changed` / `alarm` / `pick-result` / `project-saved` / `project-loaded` |
| `SimpleLite/Web/PluginAssemblyScan.cs` | 反射扫描 plugins/*.dll，把 `MethodMember` 标注的方法 + Car/Mission/CarProgram/Site/Track 子类型暴露给反射 API |
| `Simple3/Web/MapEditApiController.cs` | 写操作 8 路 API：create/delete/batch/copy-to/pick/dashboard/upload/ai-generate；阶段 6 又补：**project/save**、**project/load**、**project/current**、**sample-sites-along-track** |
| `Simple3/Web/ReflectionApiController.cs` | 只读 + execute API；listKinds / listObjects / methods-by-type / setField / getBundle / selection 等 |
| `Simple3/Web/ReflectionApiDtos.cs` | 反射 API DTO + 统一信封 `ReflectionEnvelope<T>` |
| `Simple3/Web/AiCompletionService.cs` | OpenAI Function Calling 调用 + map-generate 工具桥（真实 LLM，不再桩） |
| `Simple3/Web/AiConfigController.cs` | AI 服务配置（endpoint/apiKey/model/system prompt/temperature/maxTokens/timeout）读写 |
| `Simple3/Web/AlarmStreamService.cs` | 1s 周期 diff `car.status.enums.AlarmInfo`（语义与 `E:\Work\FRLD\StandardScene\Forklift.cs` 的 `Commons.GetCarStatus(this, "AlarmInfo")` 等价），变化时通过 SSE `alarm` 事件推送 raise/update/clear |
| `Simple3/Web/ProjectionStreamModule.cs` | 平台 SSE 总线，对外广播 `object-created` / `object-deleted` / `object-patched` / `object-batch-changed` / `alarm` / `pick-result` / `project-saved` / `project-loaded` |
| `Simple3/Web/PluginAssemblyScan.cs` | 反射扫描 plugins/*.dll，把 `MethodMember` 标注的方法 + Car/Mission/CarProgram/Site/Track 子类型暴露给反射 API |
### 修改文件
| 文件 | 关键改动 |
|------|----------|
| `SimpleLite/Startup.cs` | EntryPoint 第一步 `EnsureImguiIniFromEmbedded()`；启动 AlarmStreamService、ProjectionStreamModule、AiConfig 加载 |
| `SimpleLite/UI/SimpleUI.cs` | `CreateRemotePanelSetForTerminal` 检测 CanvasOnly 旗标：不创建 Workbench / Toolbar / BottomBar / CAD / Welcome；保留 SelectionAction、SceneInput、SceneDrawable、2DMapView |
| `SimpleLite/Workspace/WorkspaceWebUiContext.cs` | 增加 `IsCanvasOnly(terminal)` 旗标 + `/declareCanvasOnly` 注册器（与 `/declareEmbedUi` 互斥） |
| `SimpleLite/Web/ProjectionWebHost.cs` | `/declareCanvasOnly` 路由注册 |
| `SimpleLite/Web/ProjectionWebApiController.cs` | 现有 projection API 上挂 `selection-detail` SSE hook |
| `SimpleLite/UI/ComposerDockPanel.cs` | CanvasOnly 时 PrepareWelcomePanel 返回空 |
| `SimpleLite/Props/UIHelpers.cs` | 增加 `UI_Image` / `UI_Text` / `UI_Model` PropType。`UI_Model` 用于 CycleGUI 装饰物挂模型（obj/glb/gltf/cyclemodel） |
| `Simple3/Startup.cs` | EntryPoint 第一步 `EnsureImguiIniFromEmbedded()`；启动 AlarmStreamService、ProjectionStreamModule、AiConfig 加载 |
| `Simple3/UI/SimpleUI.cs` | `CreateRemotePanelSetForTerminal` 检测 CanvasOnly 旗标：不创建 Workbench / Toolbar / BottomBar / CAD / Welcome；保留 SelectionAction、SceneInput、SceneDrawable、2DMapView |
| `Simple3/Workspace/WorkspaceWebUiContext.cs` | 增加 `IsCanvasOnly(terminal)` 旗标 + `/declareCanvasOnly` 注册器（与 `/declareEmbedUi` 互斥） |
| `Simple3/Web/ProjectionWebHost.cs` | `/declareCanvasOnly` 路由注册 |
| `Simple3/Web/ProjectionWebApiController.cs` | 现有 projection API 上挂 `selection-detail` SSE hook |
| `Simple3/UI/ComposerDockPanel.cs` | CanvasOnly 时 PrepareWelcomePanel 返回空 |
| `Simple3/Props/UIHelpers.cs` | 增加 `UI_Image` / `UI_Text` / `UI_Model` PropType。`UI_Model` 用于 CycleGUI 装饰物挂模型（obj/glb/gltf/cyclemodel） |
### 关键 API 路径
@@ -119,7 +119,7 @@ SSE /projection/stream # 所有 SSE 事件
- 报警来源走 `useMapEditStream.onAlarm`（订阅 SSE 的 `alarm` 事件，由 AlarmStreamService 1s diff 推送）
- KPI 3 卡：在线车辆 / 运行中任务 / 排队任务
- 实时列表：左侧 Workspace3D + 右侧 VehicleMonitorPanel + SelectionDetailPanel
- 「定位」按钮通过 `reflectionApi.setSelection('car', id)` 让 SimpleLite 3D 高亮该车（视觉上等效 flyTo）
- 「定位」按钮通过 `reflectionApi.setSelection('car', id)` 让 Simple3 3D 高亮该车（视觉上等效 flyTo）
## 阶段 5：OrchestrationView 设计与编排（已完成）
@@ -159,9 +159,9 @@ Tab 状态缓存到 sessionStorage。
### 编译相关清理
- `SimpleLite/Recording/`（之前的录制/回放实验目录）误用 `SimpleLite.Rendering` namespace、`Car` 找不到、`Start(string, out)` 默认参数顺序等 3 个错误 → 修
- `SimpleLite/Props/UISite.cs` 在 `SimpleLite.Props` namespace 下 `Workspace.AddProp` 被解析成 `SimpleLite.Workspace.AddProp` → 改为全限定 `CycleGUI.Workspace.AddProp`
- `SimpleLite/Workspace/WorkspaceBottomBar.cs` 缺 `using SimpleLite.Workspace;` → 补
- `Simple3/Recording/`（之前的录制/回放实验目录）误用 `Simple3.Rendering` namespace、`Car` 找不到、`Start(string, out)` 默认参数顺序等 3 个错误 → 修
- `Simple3/Props/UISite.cs` 在 `Simple3.Props` namespace 下 `Workspace.AddProp` 被解析成 `Simple3.Workspace.AddProp` → 改为全限定 `CycleGUI.Workspace.AddProp`
- `Simple3/Workspace/WorkspaceBottomBar.cs` 缺 `using Simple3.Workspace;` → 补
- `HttpClientHelper.csproj` LangVersion 7.3 → latest
## 已知 TODO（不阻塞 v3 上线）
@@ -176,16 +176,16 @@ Tab 状态缓存到 sessionStorage。
## 启动方式
```
# 1. 后端 build（SimpleLite + MiGu.Server）
dotnet build SimpleLite\SimpleLite.csproj
# 1. 后端 build（Simple3 + MiGu.Server）
dotnet build Simple3\Simple3.csproj
dotnet build MiGu.Server\MiGu.Server.csproj
# 2. 前端打包并同步到 wwwroot
.\build-platform-frontend.bat
# 3. 启动平台 + SimpleLite
# 3. 启动平台 + Simple3
dotnet run --project MiGu.Server # 监听 0.0.0.0:8080
# SimpleLite 端口 8222/8223 由 SimpleLite 自己启动
# Simple3 端口 8222/8223 由 Simple3 自己启动
# 4. 访问
http://127.0.0.1:8080/admin/map-editor # 地图编辑（v3 四栏壳）