# Serena记忆索引和使用指南

## 📚 记忆文件清单（更新于2025-10-03）

### 当前有效记忆（共9个）
1. **00_记忆索引和使用指南** - 本文档，记忆系统的导航和使用说明
2. **01_项目概述和架构** - 项目整体介绍、技术架构、12个订单班系统
3. **02_终端模拟开发指南** - 终端模拟内容开发完整流程和最佳实践
4. **03_订单班配置清单** - 12个订单班详细配置、Agent团队、图片资源
5. **04_SuperDesign工作流** - UI设计迭代流程、7维度评估方法
6. **05_运行命令和部署** - 所有运行命令、端口配置、部署流程
7. **06_问题解决和优化** - 常见问题、解决方案、性能优化建议
8. **07_web_result项目架构和订单班展示系统** - Web结果展示系统详细架构、文旅实现分析
9. **08_项目维护和更新原则** - 记忆系统维护规范、变更同步要求 ⚠️ **重要**

## 🎯 使用场景指南

### 场景1：初次了解项目
```
读取顺序：
1. 01_项目概述和架构 - 了解多订单班演示系统整体架构
2. 03_订单班配置清单 - 查看12个订单班配置详情
3. 05_运行命令和部署 - 学习如何启动和访问系统
```

### 场景2：开发新订单班
```
读取顺序：
1. 02_终端模拟开发指南 - 掌握终端模拟开发流程
2. 03_订单班配置清单 - 参考已完成订单班的配置
3. 04_SuperDesign工作流 - 如需设计订单班结果页面
```

### 场景3：UI设计优化
```
读取顺序：
1. 04_SuperDesign工作流 - 学习5轮迭代优化策略
2. 01_项目概述和架构 - 了解设计规范和主题系统
3. 06_问题解决和优化 - 查看设计优化建议
```

### 场景4：运行和部署
```
读取顺序：
1. 05_运行命令和部署 - 查找启动命令和端口配置
2. 01_项目概述和架构 - 了解项目结构和访问地址
3. 06_问题解决和优化 - 遇到问题时查阅
```

### 场景5：调试和排错
```
读取顺序：
1. 06_问题解决和优化 - 查找错误解决方案
2. 05_运行命令和部署 - 检查运行配置
3. 03_订单班配置清单 - 检查订单班数据配置
```

## 🔄 记忆更新记录

### 2025-10-03 新增记忆
- ✅ **新增07_web_result项目架构**：详细分析web_result展示系统架构、路由机制、文旅和食品订单班实现对比
- ✅ **新增08_项目维护原则**：建立记忆同步机制，强调web_result变更必须同步更新Serena记忆

### 2025-10-03 重大更新
- ✅ **重构记忆系统**：采用编号归档标准，建立清晰的索引体系
- ✅ **创建7个核心记忆**：覆盖项目概述、架构、开发、配置、设计、运行、优化全流程
- ✅ **整合分散内容**：将19个旧记忆文件整合到7个核心文件中
- ✅ **补充最新进展**：更新9个已完成订单班、SuperDesign工作流、端口配置等最新信息
- ✅ **建立索引导航**：提供5种使用场景的读取指南

### 删除的旧记忆文件（19个）
整合前的文件已被合并到新的编号记忆中：
- duoduo_agent_design_system.md → 01
- exhibition_demo_multiagent_system.md → 01
- exhibition_demo_architecture_2025.md → 01
- exhibition_web_frontend_2025.md → 01
- terminal-simulation-development-guide.md → 02
- terminal_simulation_creation_best_practices.md → 02
- order-class-naming-convention.md → 03
- finance_terminal_simulation_creation.md → 03
- logistics_terminal_simulation_creation.md → 03
- intelligent_manufacturing_terminal_simulation_creation.md → 03
- civil_engineering_terminal_simulation_creation.md → 03
- energy_order_class_terminal_simulation_creation.md → 03
- health_order_class_terminal_simulation_creation.md → 03
- superdesign_workflow_best_practices.md → 04
- 订单班网站设计流程_SuperDesign工作流.md → 04
- exhibition_demo_data_folder_structure.md → 05
- n8n项目开发规范.md → 05
- n8n_chinese_version_history.md → 06
- typescript_config_fix_2025.md → 06

## 💡 最佳实践

### 读取策略
1. **按需读取**：根据具体任务选择性读取相关记忆
2. **优先级**：编号记忆（01-06）包含最新最完整的信息
3. **场景导向**：使用"使用场景指南"快速定位需要的记忆
4. **避免冗余**：不要读取已删除的旧记忆名称

### 更新原则
1. **及时更新**：发现信息变化立即更新相关记忆
2. **避免冗余**：删除过时或重复的记忆
3. **保持结构**：维护清晰的编号和命名体系
4. **记录变更**：在本索引中更新"记忆更新记录"

## 🚀 快速操作指令

```bash
# 查看项目结构
ls -la .serena/memories/

# 读取核心记忆（使用serena工具）
read_memory("01_项目概述和架构")
read_memory("05_运行命令和部署")

# 运行展会演示系统
cd web_frontend/exhibition-demo && pnpm preview

# 访问系统
# 主入口: http://localhost:4173
# Web结果: http://localhost:4155/
```

## 📊 项目核心信息速查

### 技术栈
- **前端**: React 18 + TypeScript + Tailwind CSS + Vite
- **后端**: n8n 1.109.2 (完整中文化)
- **包管理**: pnpm workspaces

### 12个订单班
1. 文旅 (wenlu) - 2024长三角新能源汽车展
2. 食品 (food) - 青莳轻食连锁品牌
3. 财经商贸 (finance) - 化妆品电商全链路运营
4. 智能开发 (dev) - K12在线教育平台
5. 智能制造 (manufacturing) - 汽车零部件智能分拣
6. 视觉设计 (design) - 同里古镇农文旅宣传片
7. 交通物流 (logistics) - 冷链AGV调度系统
8. 土木 (civil) - 滨河防洪堤加固工程
9. 大健康 (health) - AI心理咨询服务平台
10. 能源 (energy) - 光伏电池片智能检测
11. 化工 (chemical) - 半导体材料质量检测
12. 环保 (environment) - 城市地表水环境监测

### 端口配置（系统级硬约束）
- n8n平台: 5678
- 展会演示: 4173
- 食品订单班: 4174
- **Web结果展示: 4155** ⚠️ 禁止使用8080或其他端口

### 访问地址
- 主入口: http://localhost:4173
- Web结果: http://localhost:4155/
- 文旅订单班: http://localhost:4155/order-class/wenlu
- 食品订单班: http://localhost:4155/order-class/food

## ⚠️ 重要提醒

### 系统约束
1. **端口配置**: Web结果展示系统必须使用端口4155
2. **数据管理**: 终端模拟数据使用TypeScript，不使用JSON文件
3. **设计规范**: 必须保持苹果风格设计语言的一致性
4. **包管理**: 必须使用pnpm，禁止使用npm或yarn

### 开发规范
1. **订单班开发**: 需要agent prompt和专家头像数据
2. **图片路径**: 确保软链接 `web_frontend/exhibition-demo/public/data/订单班文档资料`
3. **命名规范**: orderClassId必须与orderClasses.json中的id完全一致
4. **代码提交**: 提交前必须运行lint和typecheck

### 项目目标
- 演示AI多智能体协作进行展会策划
- 基于n8n工作流平台的中文版展示
- 12个专业领域的完整解决方案演示

## 📈 记忆统计

- **总记忆数**: 7个（核心记忆）
- **最后更新**: 2025-10-03
- **覆盖内容**: 项目概述、架构、终端模拟、订单班配置、SuperDesign、运行部署、问题解决
- **删除记忆**: 19个旧文件已整合
- **已完成订单班**: 9个（wenlu, food, finance, logistics, manufacturing, dev, civil, energy, health）
- **待完成订单班**: 3个（design, chemical, environment）

## 🔍 记忆文件依赖关系

```
00_记忆索引和使用指南 (本文档)
    ├── 01_项目概述和架构 (项目全局信息)
    │   ├── 02_终端模拟开发指南 (开发流程)
    │   │   └── 03_订单班配置清单 (具体配置)
    │   ├── 04_SuperDesign工作流 (UI设计)
    │   └── 05_运行命令和部署 (运行配置)
    └── 06_问题解决和优化 (问题排查)
```

---

**记忆系统由Serena AI维护，保持精简、准确、实用。**
**版本**: v2.0 - 编号归档标准
**更新**: 2025-10-03