feat: 添加交通物流、智能制造、智能开发终端模拟并优化食品订单班

主要更新:
- 新增3个订单班终端模拟数据 (交通物流、智能制造、智能开发)
- 交通物流: 图片重命名(9张UUID图片→描述性中文名)
- 智能制造: 图片重命名(7张UUID图片→描述性中文名)
- 食品订单班: 完成React应用架构和设计系统
- 新增4个Serena记忆文档 (终端模拟开发指南、订单班命名规范等)
- 优化模态框和工作流页面交互逻辑

文件变更:
- 新增: transportation.ts, intelligentManufacturing.ts, developer.ts
- 新增: 食品订单班完整React应用 (Vite + TypeScript + Tailwind)
- 修改: RequirementModal.tsx, ResultModal.tsx, WorkflowPageV4.tsx
- 图片: 交通物流9张 + 智能制造7张重命名为中文描述性名称
This commit is contained in:
Yep_Q
2025-10-02 20:29:01 +08:00
parent 3b8cb3c568
commit b50d700a2e
67 changed files with 9808 additions and 36 deletions

View File

@@ -0,0 +1,254 @@
# 智能制造订单班终端模拟创建记录
## 创建时间
2025-10-02
## 项目背景
智能制造订单班主题:**物流输送线节拍优化的PLC与机器人联合调试**
核心技术:PLC控制 + 工业机器人 + Profinet通信 + 节拍优化
## Agent配置(4个工业自动化专家)
### Agent列表
1. **自动化控制工程师** (`manufacturing_control_engineer`)
- 职责:系统架构与控制逻辑设计
- 头像:`/data/订单班文档资料/智能制造/agent头像/自动化控制工程师.jpg`
- 工作内容:
- 整体控制逻辑设计(6大模块)
- 设备选型建议(西门子S7-1500 + ABB IRB 2600)
- 节拍优化策略(三条件联锁同步)
- 系统架构文档编制
2. **PLC工程师** (`manufacturing_plc_engineer`)
- 职责:PLC编程与梯形图开发
- 头像:`/data/订单班文档资料/智能制造/agent头像/PLC工程师.jpg`
- 工作内容:
- I/O点位分配(输入11点+输出6点)
- 梯形图程序编制(6个网络)
- 安全联锁逻辑(五合一联锁)
- TIA Portal项目配置
3. **机器人调试工程师** (`manufacturing_robot_engineer`)
- 职责:RAPID编程与机器人调试
- 头像:`/data/订单班文档资料/智能制造/agent头像/机器人调试工程师.jpg`
- 工作内容:
- I/O信号映射(DI3+DO3)
- RAPID程序编写(主循环+故障陷阱)
- 点位定义(Home/Pick/Drop)
- 握手时序协同
4. **数据采集自动化技术员** (`manufacturing_data_technician`)
- 职责:I/O配置与通信调试
- 头像:`/data/订单班文档资料/智能制造/agent头像/数据采集自动化技术员.jpg`
- 工作内容:
- Profinet网络配置(Controller ↔ Device)
- GSDML文件导入与地址映射
- 系统联调测试(通信/握手/节拍)
- 数据记录与追溯
## 图片资源分析
### 图片清单(7张,已全部重命名为描述性名称)
1. **汽车物流产线运输图.jpg** - 汽车零部件物流产线运输场景
2. **传送带上的汽车零部件.jpg** - 输送带上的零部件等待机器人抓取
3. **汽车零部件展示.jpg** - 待分拣的汽车零部件展示
4. **PLC控制器.jpg** - 西门子 S7-1500 PLC控制器
5. **工业机器人.jpg** - ABB IRB 2600 六轴工业机器人
6. **通信程序示意图.jpg** - PLC与机器人Profinet通信架构
7. **Mermaid流程图.jpg** - 系统控制流程图
### 图片使用策略
- 自动化控制工程师 → 汽车物流产线运输图 + 汽车零部件展示
- PLC工程师 → PLC控制器 + Mermaid流程图
- 机器人调试工程师 → 工业机器人 + 传送带上的汽车零部件
- 数据采集自动化技术员 → 通信程序示意图
## 内容创作策略
### 1. 启动序列(15条)
重点营造**工业自动化系统**的专业感:
- 初始化多Agent协作框架
- 加载知识库:PLC控制/工业机器人/Profinet通信/节拍优化
- 连接工业设备:西门子S7-1500/ABB IRB 2600/输送带/传感器网络
- 检测需求:汽车零部件自动分拣
- 技术挑战:PLC-机器人握手协议 + 节拍≥3600件/h
### 2. Agent输出序列(4个Agent)
#### Agent 1: 自动化控制工程师(系统架构设计)
- 系统组成:输送带+PLC+机器人+通信协议
- 6大控制逻辑模块:启停联锁/输送带控制/零件就位/启动允许/动作反馈/故障复位
- 节拍优化策略:三条件联锁同步(RobotReady+PartReady+StartAllow)
- 目标节拍:≥3600件/h(单件周期≤1秒)
- 图片:汽车物流产线运输图 + 汽车零部件展示
#### Agent 2: PLC工程师(PLC编程与梯形图)
- I/O分配表:输入11点(按钮/传感器/机器人反馈)+输出6点(电机/指示灯/握手信号)
- 梯形图程序:6个网络(运行允许/输送带/PartReady/StartAllow/完成处理/报警复位)
- 安全联锁逻辑:五合一联锁(停止+急停+安全门+过载+机器人故障)
- 图片:PLC控制器 + Mermaid流程图
#### Agent 3: 机器人调试工程师(RAPID编程)
- 机器人参数:ABB IRB 2600(12-20kg负载,1.65m半径,±0.04mm精度)
- I/O信号映射:输入DI3(StartAllow/PartReady/PLC_Reset)+输出DO3(RobotReady/PickDone/RobotFault)
- RAPID程序结构:初始化→Home位→循环(等待条件→取件→放置→完成反馈→返回)
- 握手时序协同:PartReady+StartAllow → 抓取动作 → PickDone脉冲 → PLC清握手续行
- 图片:工业机器人 + 传送带上的汽车零部件
#### Agent 4: 数据采集自动化技术员(通信调试)
- Profinet网络架构:PLC S7-1500(Controller主站)+ABB IRC5(Device从站),循环周期10ms
- TIA Portal配置:导入GSDML→添加Device→映射I/O地址→配置IP→下载组态
- 系统联调测试:通信链路(绿灯连接正常)+握手逻辑验证+节拍性能测试
- 实测节拍:3789件/h(超出目标5.3%),单件周期0.95s,同步误差±15ms
- 安全逻辑验证:急停/安全门/过载/复位流程测试全部通过
- 图片:通信程序示意图
### 3. 完成序列(30+条)
总结项目核心价值:
- 系统核心指标(5条):实测节拍3789件/h,单件周期0.95s,定位精度±0.04mm,同步误差±15ms,通信周期10ms
- 技术架构亮点(5条):PLC主控/工业机器人/Profinet通信/梯形图+RAPID/五合一联锁
- 节拍优化策略(4条):三条件联锁/定位即停/完成信号续行/速度匹配机制
- 安全保护机制(4条):故障优先级/联锁响应时间<50ms/报警与复位/防呆设计
- 交付物清单(7项):PLC程序/Robot程序/Profinet配置/I/O表/流程图/调试报告/操作手册
- 技术创新点(4条):Profinet高速通信/智能握手协议/定位即停技术/故障自恢复
## 特殊内容处理
### 1. 工业自动化领域特色
- **技术指标量化**:节拍(3789件/h),周期(0.95s),精度0.04mm),时延15ms)
- **I/O配置细节**:输入11点详细列举,输出6点用途说明,握手信号映射关系
- **梯形图逻辑展示**:6个网络的功能说明,安全联锁的五合一逻辑
- **RAPID程序结构**:主循环WHILE结构,复位检测,握手等待,取放流程,完成反馈
### 2. Profinet通信配置
- **网络架构**:PLC作为Controller主站,Robot作为Device从站
- **循环周期**:10ms高速I/O更新,数据帧6字节输出+3字节输入
- **配置流程**:导入GSDML添加Device映射I/O配置IP下载组态
- **通信诊断**:绿灯连接正常,无通信错误,循环更新正常
### 3. 握手协议时序
- **三条件联锁**:RobotReady(机器人就绪)+PartReady(零件就位)+StartAllow(启动允许)
- **完成反馈**:PickDone脉冲0.2s PLC清PartReady/StartAllow 输送带重启
- **复位机制**:PLC_Reset信号 Robot执行ResetErrors 清除故障 回Home位
### 4. 节拍优化展示
- **目标节拍**:3600件/h(单件周期1秒)
- **实测节拍**:3789件/h(超出目标5.3%)
- **单件周期**:0.95s(取件0.3s+放置0.4s+返回0.25s)
- **同步误差**:±15ms(握手时延控制良好)
## 文档特点分析
### 技术深度
这是一个**高度技术化**的订单班,文档包含:
- 完整的I/O分配表(输入11点+输出6点)
- 详细的梯形图程序(6个网络,含安全联锁逻辑)
- 完整的RAPID程序(主循环+故障陷阱+I/O映射)
- Profinet通信配置流程(GSDML导入+地址映射)
- 系统联调测试数据(通信/握手/节拍性能验证)
### 与能源订单班的相似性
两者都属于**工业自动化**领域,但侧重点不同:
- **能源订单班**:深度学习AOI检测 + PLC控制 + 机器人分拣 + MES追溯
- **智能制造订单班**:PLC-Robot握手协议 + 节拍优化 + Profinet通信 + 安全联锁
### 差异化定位
- **能源订单班**:强调**深度学习视觉检测**(Cognex ViDi缺陷分类7类)
- **智能制造订单班**:强调**PLC-Robot协同**(握手时序+节拍同步优化)
## Agent头像文件与提示词文件一致性
**Agent_prompt文件(4个):**
1. 自动化控制工程师.md
2. PLC工程师.md
3. 机器人调试工程师.md
4. 数据采集自动化技术员.md
**agent头像文件(4个):**
1. 自动化控制工程师.jpg
2. PLC工程师.jpg
3. 机器人调试工程师.jpg
4. 数据采集自动化技术员.jpg
**完全一致,无缺失!**
## 创作心得
### 1. 工业自动化内容呈现策略
- 强调**技术指标**(节拍/精度/周期)而非情感描述
- 展示**系统架构**(PLC/Robot/通信/安全)
- 突出**协同流程**(握手协议/时序同步/节拍优化)
- 体现**安全联锁**(五合一联锁/故障优先/复位机制)
### 2. PLC与机器人协同重点
- **三条件联锁同步**:RobotReady+PartReady+StartAllow缺一不可
- **握手时序控制**:PartReady零件就位StartAllow启动允许PickDone完成反馈
- **节拍匹配机制**:输送带速度 = 机器人周期 × 零件间距
- **故障处理逻辑**:五合一联锁报警锁存复位清除重新启动
### 3. 图片使用策略
- 按照**工作流程顺序**分配图片给Agent
- 自动化控制工程师 产线场景图 + 零部件展示
- PLC工程师 PLC控制器 + 流程图
- 机器人调试工程师 工业机器人 + 输送带场景
- 数据采集技术员 通信架构图
### 4. 内容层次设计
- **启动序列**:系统初始化,连接工业设备,检测需求
- **Agent序列**:系统架构(控制工程师)→PLC编程(PLC工程师)→Robot编程(机器人工程师)→通信调试(数据采集技术员)
- **完成序列**:总结指标架构亮点优化策略安全机制交付物创新点
## 与能源订单班对比分析
### 相同点(都是工业自动化)
1. **设备选型**:都包含西门子PLC + ABB机器人
2. **通信协议**:都使用Profinet通信
3. **控制语言**:都是梯形图(PLC) + RAPID(Robot)
4. **I/O配置**:都有详细的I/O分配表
5. **握手机制**:都有PLC-Robot握手协议
### 不同点
| 对比项 | 能源订单班 | 智能制造订单班 |
|-------|----------|--------------|
| **应用场景** | 光伏电池片AOI检测与分拣 | 汽车零部件物流输送线分拣 |
| **核心技术** | 深度学习AOI检测(Cognex ViDi) | PLC-Robot握手协议+节拍优化 |
| **技术亮点** | 7类缺陷识别,推理300ms,漏检0.3% | 三条件联锁同步,节拍3789件/h,误差±15ms |
| **Agent数量** | 4个(PLC/视觉工程师/视觉技术员/机器人) | 4个(控制工程师/PLC/机器人/数据采集) |
| **视觉检测** | Cognex In-Sight D900深度学习相机 | 仅有光电传感器定位 |
| **分拣逻辑** | ViDi分类结果(OK/RW/NG/UNCERTAIN) | 固定分拣仓位(统一放置) |
| **质量追溯** | MES系统上报(批次号/片ID/缺陷图像) | 数据记录(累计数量/故障代码/节拍时间) |
| **降级模式** | 相机异常人工复判模式 | 故障停机复位后重启 |
### 技术深度对比
- **能源订单班**:视觉检测技术深度更高(深度学习模型训练/缺陷库标注/召回率调优)
- **智能制造订单班**:PLC-Robot协同技术深度更高(握手时序/节拍同步/三条件联锁)
## 文件位置
- 终端模拟文件:`web_frontend/exhibition-demo/src/data/terminalSimulations/intelligentManufacturing.ts`
- 注册到index.ts:`manufacturing: intelligentManufacturingSimulation`
## 后续优化建议
1. 可考虑增加"系统集成工程师"Agent,负责Profinet配置与联调验收
2. 可增加"安全工程师"Agent,负责安全联锁逻辑设计与风险评估
3. 可增加实际测试视频或动图,展示输送带与机器人协同运行效果
4. 可增加"异常场景"的动态演示(如急停触发系统停机复位重启)
## 图片重命名经验
本次图片文件名从通用哈希名重命名为描述性名称:
- `Whisk_3b337cf3682a17e91fa4f9579e54c305dr.jpeg` `汽车物流产线运输图.jpg`
- `Whisk_a78a725c868b013af3e4319602364ac0dr.jpeg` `传送带上的汽车零部件.jpg`
- `50bf518c-1369-4295-bae2-a4361c94fef2.jpeg` `PLC控制器.jpg`
- 等等...
**重命名流程**:
1. 阅读markdown文档,理解每张图片对应的内容
2. 根据图片描述创建描述性文件名
3. 使用bash mv命令批量重命名
4. 使用sed命令更新markdown中的图片引用
5. 统一后缀为.jpg
## 参考资料
- 文档:`data/订单班文档资料/智能制造/notion文稿/物流输送线节拍优化的PLC与机器人联合调试.md`
- Agent_prompt文件夹:`data/订单班文档资料/智能制造/Agent_prompt/`
- agent头像文件夹:`data/订单班文档资料/智能制造/agent头像/`
- 图片文件夹:`data/订单班文档资料/智能制造/notion文稿/image/`

View File

@@ -0,0 +1,188 @@
# 交通物流订单班终端模拟创建记录
## 项目信息
- **订单班**: 交通物流
- **项目**: 某冷链智慧共配中心"百车级"AGV全局交通管制与充电调度系统设计项目
- **核心技术**: 120台AGV、全局交通管制、智能充电调度、冷链环境适配(-25°C)
- **创建日期**: 2025-10-02
## Agent配置 (10个专业角色)
### 1. 需求分析师
- **ID**: req_analyst
- **职责**: 业务需求建模与系统目标拆解
- **图标**: 📋
- **颜色**: #3B82F6
- **关键输出**: 业务痛点分析、系统目标拆解、功能清单
### 2. 系统架构师
- **ID**: sys_architect
- **职责**: 系统总体架构设计与技术选型
- **图标**: 🏗️
- **颜色**: #8B5CF6
- **关键输出**: 五层架构体系、技术选型方案
### 3. AGV算法与调度工程师
- **ID**: agv_algorithm
- **职责**: AGV导航与路径调度算法设计
- **图标**: 🤖
- **颜色**: #10B981
- **关键输出**: 导航系统、路径规划、交通管制算法
### 4. 能源与充电系统工程师
- **ID**: energy_engineer
- **职责**: 智能充电调度与能源管理
- **图标**: ⚡
- **颜色**: #F59E0B
- **关键输出**: 双模式充电策略、低温充电保护
### 5. 冷链设备技术总监
- **ID**: coldchain_director
- **职责**: 冷链环境适配与温控系统
- **图标**: ❄️
- **颜色**: #06B6D4
- **关键输出**: 环境感知系统、AGV低温适配方案
### 6. 技术研发工程师
- **ID**: rd_engineer
- **职责**: 软件/嵌入式/PLC功能实现
- **图标**: ⚙️
- **颜色**: #EC4899
- **关键输出**: 上位平台、嵌入式控制、PLC逻辑
### 7. 系统集成工程师
- **ID**: integration_engineer
- **职责**: 多系统集成与接口联动
- **图标**: 🔗
- **颜色**: #14B8A6
- **关键输出**: 集成架构、通信协议、接口规范
### 8. 视觉设计工程师
- **ID**: visual_designer
- **职责**: 技术文档与图文输出
- **图标**: 🎨
- **颜色**: #F97316
- **关键输出**: 技术文档、监控面板设计
### 9. 技术审批专家
- **ID**: tech_reviewer
- **职责**: 技术方案评审与风险控制
- **图标**: ✅
- **颜色**: #EF4444
- **关键输出**: 架构评审、技术选型评估、风险评估
### 10. 项目经理
- **ID**: project_manager
- **职责**: 项目规划与任务协调
- **图标**: 📊
- **颜色**: #6366F1
- **关键输出**: WBS、排期计划、RACI矩阵
## 图片资源分配 (12张图片)
### 1. 冷链方案示意图.jpg
- **分配给**: 需求分析师
- **用途**: 展示项目背景和冷链物流场景
### 2. 物流业务架构图.jpg
- **分配给**: 系统架构师
- **用途**: 展示五层架构体系设计
### 3. 仿真模拟平台示意图.jpg
- **分配给**: AGV算法与调度工程师
- **用途**: 展示AGV仿真验证平台
### 4. AGV逻辑图.jpg
- **分配给**: AGV算法与调度工程师
- **用途**: 展示AGV导航与路径规划逻辑
### 5. 交通管制系统逻辑图.jpg
- **分配给**: AGV算法与调度工程师
- **用途**: 展示全局交通管制机制
### 6. 充电管理系统逻辑图.jpg
- **分配给**: 能源与充电系统工程师
- **用途**: 展示智能充电调度策略
### 7. 系统控制架构图.jpg
- **分配给**: 系统集成工程师
- **用途**: 展示系统集成控制架构
### 8. 系统集成与调度.jpg
- **分配给**: 系统集成工程师
- **用途**: 展示多系统集成方案
### 9. 后台监控与管理.jpg
- **分配给**: 视觉设计工程师
- **用途**: 展示后台监控管理界面
### 10. 周期实施计划.jpg
- **分配给**: 项目经理
- **用途**: 展示项目周期规划
### 11. AGV故障排查检修.jpg
- **分配给**: 项目经理
- **用途**: 展示运维支持计划
### 12. 技术支持与指导.jpg
- **分配给**: 项目经理
- **用途**: 展示技术支持体系
## 重要处理心得
### 1. Agent命名一致性问题
- **问题**: 发现"需求分析师"(prompt文件)与"需求分析工程师"(avatar文件)命名不一致
- **解决**: 使用prompt文件中的"需求分析师"作为标准名称,与Agent_prompt文件保持一致
### 2. 新旧格式转换
- **新格式**: logistics.ts采用更清晰的结构(id/name/sequences等)
- **旧格式**: index.ts中的SimulationData格式
- **解决**: 创建convertToSimulationData转换函数,实现格式自动转换
### 3. 图片路径规范
- **路径格式**: `/data/订单班文档资料/交通物流/notion文稿/image/图片名称.jpg`
- **注意**: 所有图片已统一重命名为描述性.jpg格式
### 4. Agent输出设计策略
- **需求分析师**: 聚焦业务痛点和系统目标,展示冷链方案示意图
- **系统架构师**: 展示五层架构设计和技术选型
- **AGV算法工程师**: 最多输出(5个),覆盖导航、路径、交通、仿真等核心算法
- **能源工程师**: 聚焦双模式充电和低温保护
- **冷链总监**: 聚焦环境感知和设备适配
- **研发工程师**: 覆盖上位平台、嵌入式、PLC三个层次
- **集成工程师**: 展示系统集成架构和通信协议,使用2张架构图
- **视觉设计师**: 聚焦文档和监控界面
- **技术专家**: 三维度评审(架构/技术/风险)
- **项目经理**: 最多输出(4个),覆盖周期规划、任务分工、运维和技术支持,使用3张图
### 5. 项目成果总结
- **核心价值量化**: 效率提升40%、成本降低60%、日出件量18万件
- **技术亮点**: 120台AGV、全局交通管制、智能充电、-25°C低温运行
- **合规性**: GSP/GDP认证要求
## 文件结构
```
web_frontend/exhibition-demo/
├── src/data/terminalSimulations/
│ ├── logistics.ts (新创建)
│ └── index.ts (已更新)
└── public/data/订单班文档资料/交通物流/
├── Agent_prompt/ (10个.md文件)
├── avatar/ (10个.jpg文件)
└── notion文稿/
├── image/ (12张重命名的.jpg图片)
└── 某冷链智慧共配中心"百车级"AGV...md
```
## 技术要点
- **导航技术**: 激光SLAM + IMU + 二维码融合
- **路径算法**: A*/Dijkstra
- **通信协议**: MQTT + RESTful API + WebSocket
- **充电策略**: 快充1.5C + 慢充0.5C
- **架构模式**: 五层架构(接入/业务/调度/设备/算法)
## 后续建议
1. 可考虑添加更多动态效果到终端输出
2. 可为关键技术点添加更多可视化图表
3. 可考虑添加实时数据监控的动画效果
4. 可为AGV路径规划添加交互式演示

View File

@@ -0,0 +1,66 @@
# 订单班命名规范和映射表
## 命名统一原则
所有订单班的命名必须在以下三个地方保持一致:
1. **orderClasses.json** 中的 `id` 字段
2. **simulationMap** 中的 key
3. **终端模拟文件名**和**导出函数名**
## 当前订单班中英文映射表
| 中文名称 | 英文ID | 文件名 | 导出函数名 | 状态 |
|---------|--------|--------|-----------|------|
| 食品 | `food` | `food.ts` | `foodSimulation` | ✅ 已实现 |
| 文旅 | `wenlu` | `wenlu.ts` | `wenluSimulation` | ✅ 已实现 |
| 智能制造 | `manufacturing` | `intelligentManufacturing.ts` | `intelligentManufacturingSimulation` | ✅ 已实现 |
| 智能开发 | `developer` | - | - | ⏸️ 未实现 |
| 财经商贸 | `finance` | - | - | ⏸️ 未实现 |
| 视觉设计 | `visual` | `visualDesign.ts` | `visualSimulation` | ✅ 已实现 |
| 大健康 | `health` | `health.ts` | `healthSimulation` | ✅ 已实现 |
| 交通物流 | `transportation` | `transportation.ts` | `transportationSimulation` | ✅ 已实现 |
| 能源 | `energy` | `energy.ts` | `energySimulation` | ✅ 已实现 |
| 化工 | `chemical` | - | - | ⏸️ 未实现 |
| 环保 | `environmental` | - | - | ⏸️ 未实现 |
| 土木 | `civil` | `civilEngineering.ts` | `civilEngineeringSimulation` | ✅ 已实现 |
## 最近修改记录 (2025-10-02)
### 交通物流订单班统一命名
**问题**:
- orderClasses.json 中 ID 为 `transportation`
- simulationMap 中 key 为 `logistics`
- 导致点击"交通物流"模版无法触发终端模拟
**解决方案**:
1. 重命名文件:`logistics.ts``transportation.ts`
2. 更新函数名:`logisticsSimulation()``transportationSimulation()`
3. 更新变量名:`logisticsAgents``transportationAgents`
4. 更新 orderClassId`'logistics'``'transportation'`
5. 更新 index.ts 导入语句和 simulationMap 注册
### 智能制造订单班ID修正
**问题**: orderClasses.json 中 ID 为 `manufacture`,但 simulationMap 中为 `manufacturing`
**解决方案**: 修改 orderClasses.json 中的 ID`"manufacture"``"manufacturing"`
## 关键文件位置
- **订单班配置**: `/web_frontend/exhibition-demo/src/data/orderClasses.json`
- **模拟数据映射**: `/web_frontend/exhibition-demo/src/data/terminalSimulations/index.ts`
- **各订单班模拟数据**: `/web_frontend/exhibition-demo/src/data/terminalSimulations/*.ts`
## 添加新订单班的流程
1.`orderClasses.json` 中添加订单班配置,设定统一的 `id`
2. 创建 `/terminalSimulations/{id}.ts` 文件
3. 导出函数命名为 `{id}Simulation`
4.`index.ts` 中导入并注册到 `simulationMap`
5. 确保 orderClassId 与配置文件中的 id 一致
## 注意事项
- ⚠️ **切勿使用不同的命名**orderClasses.json 的 ID 必须与 simulationMap 的 key 完全一致
- ⚠️ **函数命名规范**:导出函数应命名为 `{id}Simulation`,如 `transportationSimulation`
- ⚠️ **变量命名规范**Agent 数组应命名为 `{id}Agents`,如 `transportationAgents`
-**ID 使用英文单词**:优先使用完整、直观的英文单词,如 `transportation` 而不是 `logistics`

View File

@@ -0,0 +1,275 @@
# 终端模拟内容开发指南
## 开发流程
### 1. 前期准备
- **阅读文档资料**:仔细阅读 `/data/订单班文档资料/{订单班名}/notion文稿` 下的文档
- **分析图片备注**:查看文档中图片的插入位置和备注说明,理解图片与内容的对应关系
- **检查资源文件**:确认 `agent头像``Agent_prompt``image` 文件夹是否完整
### 2. Agent设计原则
#### Agent数量规划
- 根据项目复杂度确定Agent数量通常6-10个
- 覆盖项目全生命周期的关键角色
- 确保每个Agent有明确的职责边界
#### Agent配置要素
```typescript
{
id: 'unique_identifier', // 唯一标识符(蛇形命名)
name: '中文角色名', // 显示名称
icon: '📋', // emoji图标
avatar: '/data/订单班文档资料/{订单班}/agent头像/{角色名}.jpg',
model: 'GPT-4', // 模型名称
role: '简短的职责描述', // 一句话职责
status: 'waiting', // 初始状态
}
```
#### 命名规范
- **文件名**`{orderClassId}.ts`(如 `developer.ts`
- **函数名**`{orderClassId}Simulation`(如 `developerSimulation`
- **变量名**`{orderClassId}Agents`(如 `developerAgents`
- **orderClassId**:与 orderClasses.json 中的 id 完全一致
### 3. 内容结构设计
#### 启动序列startupSequence
目的:营造项目启动氛围,介绍项目背景
```typescript
startupSequence: [
{ type: 'system', content: '初始化{项目类型}开发环境...' },
{ type: 'system', content: '加载项目需求:{项目名称}' },
{ type: 'info', content: '核心信息1' },
{ type: 'info', content: '核心信息2' },
{ type: 'system', content: '' }, // 空行分隔
{ type: 'system', content: '正在组建{N}人团队...' },
{ type: 'success', content: '✓ {Agent1}就位' },
// ... 所有Agent就位确认
{ type: 'system', content: '' },
{ type: 'system', content: '开始多Agent协作流程...' },
{ type: 'system', content: '════════════════════════════════════' },
]
```
#### Agent执行序列agentSequence
目的展示每个Agent的具体工作内容和成果
**标准结构**
```typescript
{
agent: () => {orderClassId}Agents[index],
outputs: [
{ type: 'info', content: '{icon} {Agent名}开始{动作}...' },
{ type: 'system', content: '' },
// 工作内容展示
{ type: 'output', content: '{工作模块标题}:' },
{ type: 'output', content: ' • {具体工作项1}' },
{ type: 'output', content: ' • {具体工作项2}' },
{ type: 'system', content: '' },
// 图片插入(如果有)
{ type: 'image', imageSrc: '/data/订单班文档资料/{订单班}/notion文稿/image/{图片名}.jpg', imageAlt: '{图片说明}' },
{ type: 'system', content: '' },
// 成果总结
{ type: 'success', content: '✓ {成果1}' },
{ type: 'success', content: '✓ {成果2}' },
]
}
```
#### 完成序列completionSequence
目的:项目总结和成果展示
```typescript
completionSequence: [
{ type: 'system', content: '════════════════════════════════════' },
{ type: 'system', content: '' },
{ type: 'success', content: '🎉 {项目名}圆满完成!' },
{ type: 'system', content: '' },
{ type: 'output', content: '项目成果总结:' },
{ type: 'output', content: ' • {成果亮点1}' },
{ type: 'output', content: ' • {成果亮点2}' },
{ type: 'system', content: '' },
{ type: 'output', content: '交付物清单:' },
{ type: 'output', content: ' ✓ {交付物1}' },
{ type: 'output', content: ' ✓ {交付物2}' },
{ type: 'system', content: '' },
{ type: 'success', content: '感谢{N}位Agent的协作{项目名}已成功上线!' },
{ type: 'system', content: '════════════════════════════════════' },
]
```
### 4. 图片插入技巧
#### 图片位置选择
- **概念/架构图**:放在介绍该概念/架构的Agent输出中
- **界面设计图**放在UI设计师或前端开发的输出中
- **数据分析图**:放在数据分析或测试的输出中
- **流程图**:放在系统架构师或项目经理的输出中
#### 图片插入格式
```typescript
{ type: 'image', imageSrc: '/data/订单班文档资料/{订单班}/notion文稿/image/{图片名}.jpg', imageAlt: '{简短描述}' },
{ type: 'system', content: '' }, // 图片后加空行
```
#### 图片与内容的对应关系
根据文档分析建立映射:
- **首页.jpg** → 数据库架构/系统架构部分
- **用户信息后台数据.jpg** → 用户系统设计
- **课程信息后台数据.jpg** → 课程系统设计
- **API配置界面.jpg** → 接口设计/后端开发
- **注册界面.jpg** → 用户认证/前端开发
- **课程直播间.jpg** → 直播系统/互动功能
### 5. 内容撰写技巧
#### 信息密度控制
- 每个Agent输出3-5个工作模块
- 每个模块2-4个具体工作项
- 避免过于冗长的描述
#### 专业术语使用
- 使用行业通用术语(如 Vue3、Spring Cloud、JWT
- 避免过于晦涩的技术细节
- 数字要具体(如"10万+并发"而非"大量用户"
#### 成果量化表达
- **好的示例**
- ✓ 前端开发完成65个组件28个页面
- ✓ 接口性能平均响应时间200ms
- ✓ 测试通过率98.5%
- **避免的表达**
- ✓ 前端开发完成
- ✓ 性能很好
- ✓ 测试基本通过
#### 分隔符使用
- 使用空行 `{ type: 'system', content: '' }` 分隔不同模块
- 使用分隔线 `════════════════════════════════════` 标记重要节点
### 6. 开发实例参考
#### 智能开发订单班developer.ts
**文档结构**
- 6大章节项目概述、功能模块、数据库设计、开发实现、测试、运维
- 9张图片首页、用户数据、智能分析、课程数据、课程内容、直播间、注册界面、热门课程、API配置
**Agent设计**
1. 需求文档撰写专员 - 需求调研与文档输出
2. 产品经理 - 产品规划与功能设计
3. 平台架构师 - 技术架构与数据库设计
4. UI设计师 - 界面设计与交互体验
5. 前端开发工程师 - Vue3前端开发
6. 后端开发工程师 - Spring Cloud后端开发
7. 软件测试工程师 - 功能/性能/安全测试
8. DEMO生成助手 - 演示原型与文档生成
9. 项目经理 - 项目总结与成果汇报
**图片分配**
- 产品经理:首页.jpg
- 平台架构师:用户信息后台数据.jpg、课程信息后台数据.jpg
- UI设计师注册界面.jpg、热门课程.jpg、课程直播间.jpg
- 前端开发工程师:课程内容.jpg
- 后端开发工程师API配置界面.jpg
- 软件测试工程师:智能学习数据分析.jpg
### 7. 常见问题
#### Q1: Agent数量如何确定
A: 根据项目规模和文档内容:
- 小型项目如轻食品牌5-7个Agent
- 中型项目如教育平台8-10个Agent
- 大型项目如AGV系统10-12个Agent
#### Q2: 图片应该放在哪个Agent
A: 遵循"谁产出谁展示"原则:
- 数据库设计图 → 架构师
- 界面设计图 → UI设计师或前端工程师
- API文档图 → 后端工程师
- 测试报告图 → 测试工程师
#### Q3: 如何避免内容重复?
A: 每个Agent聚焦自己的职责
- 需求分析师:需求调研、文档撰写
- 产品经理:功能规划、原型设计
- 架构师:技术选型、架构设计
- 开发工程师:具体实现、代码编写
- 测试工程师:测试执行、问题发现
- 项目经理:进度管理、成果总结
#### Q4: 输出内容的详细程度?
A: 保持"概览+亮点"原则:
- 不要列举所有细节
- 突出关键技术点和创新点
- 用数据说话(如"65个组件"比"很多组件"更好)
### 8. 注册流程
完成文件创建后,需要在 `index.ts` 中注册:
```typescript
// 1. 导入
import { {orderClassId}Simulation } from './{orderClassId}';
// 2. 注册到映射表
export const simulationMap: Record<string, SimulationGenerator> = {
// ... 其他订单班
{orderClassId}: {orderClassId}Simulation,
};
```
### 9. 验证清单
创建完成后检查:
- [ ] 文件命名符合规范({orderClassId}.ts
- [ ] Agent数量与 agentCount 一致
- [ ] 所有头像路径正确
- [ ] 图片路径正确且图片存在
- [ ] orderClassId 与 orderClasses.json 一致
- [ ] 已在 index.ts 中正确注册
- [ ] TypeScript 编译无错误
### 10. 最佳实践总结
**DO推荐做法**
- 深入阅读文档,理解项目全貌
- 图片与文字内容强关联
- 使用具体数字量化成果
- 每个Agent职责清晰、不重叠
- 使用空行和分隔符优化阅读体验
**DON'T避免做法**
- 不看文档凭想象编写内容
- 随意插入图片,与内容无关
- 使用模糊表述(如"很好"、"很多"
- Agent职责重叠或遗漏关键角色
- 内容冗长、缺少分段
### 11. 工具函数提示
在开发过程中可以使用以下bash命令快速检查
```bash
# 查看文档资料结构
ls -la "/path/to/订单班文档资料/{订单班}/"
# 查看图片文件
ls -la "/path/to/订单班文档资料/{订单班}/notion文稿/image/"
# 查看agent头像
ls -la "/path/to/订单班文档资料/{订单班}/agent头像/"
# 检查orderClasses.json中的配置
grep -A 15 '"id": "{orderClassId}"' orderClasses.json
```
---
**备注**本指南基于智能开发订单班developer.ts的开发经验总结适用于所有订单班的终端模拟内容开发。