aps-agent/锐扬演示-操作手册.md

锐扬 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 单例为既有时间炸弹，与本改动无关）。