Duguay/Agent-n8n
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
Agent-n8n/.serena/memories/00_记忆索引和使用指南.md
Yep_Q c579dae90a feat: 完成化工订单班图片处理和项目记忆重组 
详细说明:
- 化工订单班图片已标准化处理（8个图片，文件名与alt text完全一致）
- 完成环保、财经商贸订单班的图片重命名工作
- 重组项目记忆文件，按照功能模块编号（00-09）
- 删除旧的分散记忆文件，统一到新的编号体系
- 添加终端模拟文件：chemical.ts, environmental.ts, finance.ts
- 清理web_result冗余文件（food react-app等）
- 新增playwright截图记录和记忆文档
- 影响模块：订单班文档资料、项目记忆系统、终端模拟系统
2025-10-04 00:34:44 +08:00

7.8 KiB
Raw Permalink Blame History

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. 记录变更：在本索引中更新"记忆更新记录"

🚀 快速操作指令

# 查看项目结构
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或其他端口

访问地址

⚠️ 重要提醒

系统约束

  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