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

## 创建日期
2025-10-01

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

## 关键发现

### 1. Agent名称与头像文件名不匹配问题
**问题描述**：
- Agent提示词文件：`水单设计师.md`、`3D建模师.md`
- Agent头像文件：`水电设计师.jpg`、`3D模型师.jpg`

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

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

### 2. orderClasses.json 配置与实际文档不符
**问题描述**：
- `orderClasses.json` 中 civil 订单班描述的是"滨河防洪堤加固工程"
- 实际文档是"室内CAD整体方案设计"

**解决方案**：
更新 `orderClasses.json` 配置，使其与实际文档内容一致：
```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. 内容设计亮点

#### 启动序列亮点
```typescript
{ type: 'system', content: '加载专业知识库: 室内设计/CAD制图/建筑规范/材料工艺' },
{ type: 'system', content: '├─ 《住宅设计规范》GB 50096-2011' },
{ type: 'system', content: '├─ AutoCAD 2024 + 3ds Max + V-Ray' },
```
- 体现**专业性**：引用行业规范和专业软件
- 体现**技术感**：展示工具链

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

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

#### 完成序列亮点
```typescript
{ 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. 特殊内容处理

#### 户型生长动画
```typescript
{ type: 'info', content: '🎬 户型生长动画制作中...' },
{ type: 'output', content: '  • 动画时长: 60秒' },
{ type: 'output', content: '  • 展示内容: 墙体生长 → 家具摆放 → 材质贴图 → 灯光效果' },
{ type: 'output', content: '  • 输出格式: 1920×1080 MP4' },
```
- 虽然视频文件存在，但在终端模拟中**用文字描述**动画内容
- 不直接展示视频文件（终端模拟只支持图片）

#### 技术工具链展示
```typescript
{ 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): 土木订单班终端模拟创建完成