Agent-n8n/.serena/memories/civil_engineering_terminal_simulation_creation.md

土木订单班终端模拟创建实践记录

创建日期

2025-10-01

项目概述

为土木订单班创建终端模拟内容，项目类型为"120㎡现代简约三居室CAD整体方案设计"。

关键发现

1. Agent名称与头像文件名不匹配问题

问题描述：

• Agent提示词文件：水单设计师.md、3D建模师.md
• Agent头像文件：水电设计师.jpg、3D模型师.jpg

解决方案： 在创建终端模拟时，优先使用头像文件名作为Agent的显示名称，因为头像文件是实际存在的资源。

配置示例：

{
  id: 'civil_mep_engineer',
  name: '水电设计师',  // 使用头像文件名
  avatar: '/data/订单班文档资料/土木/agent头像/水电设计师.jpg',
}

2. orderClasses.json 配置与实际文档不符

问题描述：

• orderClasses.json 中 civil 订单班描述的是"滨河防洪堤加固工程"
• 实际文档是"室内CAD整体方案设计"

解决方案： 更新 orderClasses.json 配置，使其与实际文档内容一致：

{
  "id": "civil",
  "name": "土木",
  "template": {
    "title": "120㎡现代简约三居室CAD整体方案设计",
    "description": "项目类型：室内CAD整体方案设计\n户型面积：120㎡..."
  },
  "agentCount": 8
}

3. Agent配置设计思路

8个Agent的工作流程

1. 需求分析师 → 客户访谈、需求梳理、风格定位
2. 室内设计师 → 功能分区、初稿设计、家具布置
3. CAD制图员 → 施工图绘制、节点详图
4. 暖通设计师 → 顶面布置、灯具点位
5. 水电设计师 → 强弱电布置、给排水设计
6. 灯光设计师 → 灯光效果模拟、照度计算
7. 软装设计师 → 材质选型、色彩搭配
8. 3D建模师 → 3D建模、效果渲染、生长动画

Agent顺序原则

按照室内设计的实际工作流程排列：

• 前期（需求→设计）→ 中期（制图→深化）→ 后期（效果呈现）

4. 图片资源分配策略

图片与Agent的对应关系

Agent	图片资源	展示目的
室内设计师	室内平面设计图	展示功能分区和家具布置
CAD制图员	吊顶收口节点CAD图、地面与墙面收口CAD图、窗帘盒尺寸CAD图	展示施工图纸的细节
水电设计师	CAD绘制强弱电布置图	展示水电点位布局
灯光设计师	实景渲染尺寸标记	展示灯光效果
软装设计师	材质选型、尺寸标注	展示材质和色彩方案
3D建模师	效果渲染图加尺寸标注	展示最终效果

图片分配原则

1. 每个Agent展示与其工作内容直接相关的图片
2. 图片顺序遵循文档章节顺序
3. 关键技术节点配多张图片（如CAD制图员展示3张节点图）
4. 最后一个Agent展示最终成果（效果渲染图）

5. 内容设计亮点

启动序列亮点

{ type: 'system', content: '加载专业知识库: 室内设计/CAD制图/建筑规范/材料工艺' },
{ type: 'system', content: '├─ 《住宅设计规范》GB 50096-2011' },
{ type: 'system', content: '├─ AutoCAD 2024 + 3ds Max + V-Ray' },

• 体现专业性：引用行业规范和专业软件
• 体现技术感：展示工具链

Agent输出序列亮点

// 数据结构化展示
{ type: 'info', content: '动线规划分析:' },
{ type: 'output', content: '  • 生活动线: 入户 → 客厅 → 厨房 → 餐厅' },
{ type: 'output', content: '  • 学习动线: 儿童房 → 书房（避免干扰）' },

// 关键指标突出
{ type: 'success', content: '✓ 原始户型使用率: 85%' },
{ type: 'success', content: '✓ 优化目标: ≥92%（提升7个百分点）' },

完成序列亮点

{ type: 'info', content: '🎯 核心设计亮点:' },
{ type: 'success', content: '✓ 空间利用率从85%提升至92%（提升7个百分点）' },
{ type: 'success', content: '✓ 收纳体积达到35m³（超出行业平均水平）' },

{ type: 'info', content: '💰 预算控制:' },
{ type: 'success', content: '✓ 总预算: 35万元（严格控制，不超预算）' },
{ type: 'success', content: '✓ 性价比: 2916元/㎡（中等偏上装修标准）' },

• 核心亮点：空间优化、预算控制
• 量化指标：使用率提升7%、性价比2916元/㎡
• 分类展示：设计亮点、预算控制、工期安排、技术创新、交付物清单

6. 特殊内容处理

户型生长动画

{ type: 'info', content: '🎬 户型生长动画制作中...' },
{ type: 'output', content: '  • 动画时长: 60秒' },
{ type: 'output', content: '  • 展示内容: 墙体生长 → 家具摆放 → 材质贴图 → 灯光效果' },
{ type: 'output', content: '  • 输出格式: 1920×1080 MP4' },

• 虽然视频文件存在，但在终端模拟中用文字描述动画内容
• 不直接展示视频文件（终端模拟只支持图片）

技术工具链展示

{ type: 'output', content: '  • CAD精确制图: 1:50比例，施工图纸完整规范' },
{ type: 'output', content: '  • 3D建模渲染: 3ds Max + V-Ray，4K高清输出' },
{ type: 'output', content: '  • Dialux照度计算: 科学灯光布局，节能舒适' },

• 展示专业软件和工具
• 体现技术创新和专业能力

7. 与之前订单班的对比

食品订单班

• 7个Agent（市场→品牌→选址→菜品→运营→人员→财务）
• 财务数据丰富（50万投资、290万营收）
• 图片：店面、菜品、人员

视觉设计订单班

• 5个Agent（总监→编剧→导演→分镜→制片）
• AIGC分镜对比（线稿→AI生成）
• 图片：古镇风光、分镜对比

土木订单班（本次）

• 8个Agent（需求→设计→制图→暖通→水电→灯光→软装→3D）
• 空间优化数据（85%→92%使用率）
• 图片：CAD图纸、节点详图、效果渲染

8. 经验总结

创建前必做检查

• 检查Agent提示词文件数量
• 检查Agent头像文件数量和名称
• 验证头像文件名与提示词文件名的对应关系
• 阅读Markdown文档，理解项目内容
• 检查orderClasses.json配置是否与实际文档一致
• 确认图片文件名是否为描述性名称

创建时的最佳实践

1. 优先使用头像文件名作为Agent名称（因为头像是实际显示的资源）
2. Agent顺序按实际工作流程排列（前期→中期→后期）
3. 每个Agent至少展示1-3张相关图片
4. 数据结构化展示（使用 output 类型配合缩进）
5. 关键指标量化（提升百分比、预算金额、工期天数）
6. 完成序列突出核心亮点（分类展示：设计亮点、预算、工期、技术、交付物）

常见问题解决

1. 名称不匹配：使用头像文件名
2. 配置不符：更新orderClasses.json
3. 图片路径：使用 /data/订单班文档资料/[订单班]/notion文稿/image/[图片名]
4. 视频处理：用文字描述，不直接展示

文件清单

创建的文件

• /web_frontend/exhibition-demo/src/data/terminalSimulations/civilEngineering.ts

修改的文件

• /web_frontend/exhibition-demo/src/data/terminalSimulations/index.ts（添加import和注册）
• /web_frontend/exhibition-demo/src/data/orderClasses.json（更新civil配置）

下一步建议

对于后续订单班

1. 先检查Agent头像和提示词文件的名称对应关系
2. 确认orderClasses.json配置是否与实际文档一致
3. 借鉴本次的Agent配置和内容结构
4. 根据各订单班的特点调整展示重点

需要注意的订单班

• 智能制造：可能涉及PLC、机器人等技术术语
• 智能开发：涉及代码、技术架构等内容
• 财经商贸：涉及电商运营、财务数据
• 大健康：涉及AI心理咨询、医疗数据
• 交通物流：涉及AGV调度、算法优化
• 能源：涉及光伏检测、设备配置
• 化工：涉及实验室建设、检测标准
• 环保：涉及水质监测、治理措施

版本历史

• v1.0 (2025-10-01): 土木订单班终端模拟创建完成