53 lines
3.9 KiB
Markdown
53 lines
3.9 KiB
Markdown
# 锐扬 APS 演示操作手册（2026-08-06 更新）
|
||
|
||
## 0. 演示数据
|
||
|
||
工程目录：`%RUIYANG_DEMO_DIR%\APS演示数据`（01 物料 / 02 设备 / 03 工艺 / 04 BOM / 05 订单 / 06 班历，共 5 张订单 SO-001~005、45 物料、15 设备、42 条 BOM）。
|
||
|
||
## 1. 演示前准备
|
||
|
||
1. 启动后端（8000）与前端，或启动桌面端「工业智核 APS」。
|
||
2. 左侧「新建任务 / 新建项目」→ 工程目录选择 `%RUIYANG_DEMO_DIR%\APS演示数据`。
|
||
- 若用 **Web 端**演示：浏览器不能直接读本机文件夹，请在项目「文件」区点「上传」，
|
||
多选本机 `.xlsx/.xlsm/.csv/.txt/.sql` 数据文件；系统自动落到服务端项目目录，
|
||
随后第 2 节流程不变。
|
||
3. 如需重新演示多智能体：右侧栏「多智能体编排」→ 看门狗区先点一次恢复（或调 `POST /api/mesh/reset`）。
|
||
|
||
## 2. 对话式全流程（三句话）
|
||
|
||
在左侧对话框依次输入：
|
||
|
||
| 步骤 | 输入 | 预期 |
|
||
| --- | --- | --- |
|
||
| ① 解析文件夹 | `分析一下数据文件` | 项目深度分析：订单 5 · 物料 45 · 工艺 15 · 设备 15 · BOM 42，并自动导入世界 |
|
||
| ② MRP 分解 | `执行MRP分解` | 自制建议 5 项、采购建议 6 条、委外 0 条；订单页「采购订单」立即可见 6 条草稿 |
|
||
| ③ 下达 | `下达MRP建议单` | P2 确认卡 → 批准 → 6 条采购单转 RELEASED（自动补预计到料日） |
|
||
| ④ 柔性排产 | `跑一版柔性排产` | 5 条虚拟产线 / 25 个工单；订单页「生产订单」出现 5 条；柔性甘特可切「虚拟线预演」 |
|
||
|
||
> ②③④ 修过的坑：排产前置净算曾重复生成 DRAFT 采购草稿 → 被判 UNTRUSTED_DRAFT_SUPPLY 硬阻断；
|
||
> 下达草稿没有到料日 → MATERIAL_NOT_READY 硬违规。两处均已修复（mrp.py）。
|
||
|
||
## 3. 多智能体编排演示（右侧栏「多智能体编排」图标）
|
||
|
||
1. **按需创建智能体**：输入名字（如「小扬」）选角色「数据解析智能体」→ 创建。
|
||
2. **挂 Goal**：标题「锐扬排产全流程」→「挂 Goal」（模板 5 任务：解析→分解→下达→排产→报告），看门狗立即开始监控。
|
||
3. **分发执行**：点「分发执行」。看门狗把任务按能力边界分发给空闲智能体；没有合适智能体时**自动新建**（MRP分解智能体-1、柔性排产智能体-1、报告智能体-1）。
|
||
4. **智能体沟通**：消息总线实时显示接力（「完成 ✅ …@下一个任务 请接棒」）；底部可选手动给任意智能体发消息，对方会回报自己的状态与能力边界。
|
||
5. **看门狗**：监控 RUNNING 超期（默认 45s）→ 收回重排 → 重试耗尽升级 ATTENTION；全部任务 DONE 自动结案 ACHIEVED。可一键把阈值调成 10s 演示停滞检测。
|
||
6. 排产被阻断时任务诚实落 FAILED 并升级 Goal（不会假装成功）；重复演示时已下达供应幂等跳过。
|
||
|
||
## 4. 桌面端安装包
|
||
|
||
- 安装包：仓库内 `apps\desktop\release\aps-agent-desktop-0.1.0.exe`（NSIS，约 169 MB，含全新 sidecar 与多智能体编排）。
|
||
- 已通过打包冒烟：Electron 启动、sidecar 健康、工作台加载、mesh 端点可用。
|
||
- 桌面端数据落 `C:\Users\<用户>\.aps`，与开发环境互不影响。
|
||
|
||
## 5. 本次改动清单（两个代码副本同步）
|
||
|
||
- `server/aps_domain/mrp.py`：分解净算扣除已下达采购供应（不再重复 DRAFT）；下达时补 `expectedArrivalDate`。
|
||
- `server/agent_core/mesh.py`（新）：多智能体编排（智能体/Goal/任务/消息/看门狗/分发执行/身份绑定/世界钉扎）。
|
||
- `server/gateway/app.py`：`/api/mesh/*` 路由 + 看门狗后台节拍。
|
||
- `server/agent_core/harness.py`：mesh.* 权力等级注册（P1）。
|
||
- `apps/web`：`mesh/MeshPanel.tsx`（新）+ App.tsx 右侧栏入口 + types/client/styles。
|
||
- 回归：golden 1042 passed（test_preference_features 单例为既有时间炸弹，与本改动无关）。
|