EPEEAIKit/.cursor/changelog/changelog-full.md

Dev Changelog — Full

完整的开发改动记录，按时间倒序排列。作为主动 RAG 的数据源，用户手动唤醒时读取。

记录

[CL-20260411-1500] 2026-04-11 15:00 — 完成美术 Agent 产品决策和技术选型

• tags: art-agent, 产品决策, 技术选型, 规划
• affected_files:
  • docs/art-agent/DECISIONS.md
  • docs/art-agent/TECH-STACK.md
• what: 通过 5 轮结构化讨论确定了美术 Agent 工具的产品决策（产品形态、交互模型、AI 架构、风格管理、资源 Pipeline），并完成全部 8 个维度的技术选型
• why: 项目从零开始，需要先把产品方向和技术基准定下来再动手写代码
• decisions:
  • 产品形态选 Chat-first Web App（排除纯 Bot 和桌面应用）
  • 前端 Next.js / 后端 Python FastAPI / 自建 Agent Loop（不用 LangChain）
  • 数据库 PostgreSQL / 图像生成 Replicate / 部署 Vercel + Railway
  • 对象存储 MVP 先用本地文件系统
• notes: 技术选型中图像生成 API、部署方案、异步任务三项用户未明确选定，采用了推荐方案

[CL-20260411-1600] 2026-04-11 16:00 — 搭建美术 Agent MVP 全部前后端代码

• tags: art-agent, MVP, 前端, 后端, FastAPI, Next.js, Agent Loop
• affected_files:
  • art-agent/README.md
  • art-agent/backend/requirements.txt
  • art-agent/backend/.env.example
  • art-agent/backend/app/main.py
  • art-agent/backend/app/api/chat.py
  • art-agent/backend/app/agent/loop.py
  • art-agent/backend/app/agent/tools.py
  • art-agent/backend/app/services/image_gen.py
  • art-agent/frontend/package.json
  • art-agent/frontend/src/app/page.tsx
  • art-agent/frontend/src/app/layout.tsx
  • art-agent/frontend/src/app/globals.css
  • art-agent/frontend/src/components/chat/chat-messages.tsx
  • art-agent/frontend/src/components/chat/chat-input.tsx
  • art-agent/frontend/src/components/chat/image-grid.tsx
  • art-agent/frontend/src/lib/api.ts
  • docs/art-agent/MVP-PLAN.md
• what: 从零创建了完整的 MVP 前后端代码，包括 FastAPI 后端（Agent Loop + Replicate 图像生成 + SSE 流式推送）和 Next.js 前端（Chat UI + 参考图上传 + 图片下载），后端已验证可正常启动
• why: 以最小流程跑通端到端闭环（对话 → 生图 → 迭代 → 保存），快速暴露集成问题
• decisions:
  • MVP 范围刻意砍掉：数据库/持久化、Skill/Rules 机制、风格库、用户认证、云端部署
  • Agent Loop 硬编码 system prompt，不走 Skill 扩展（最简化）
  • 图像模型选 flux-schnell（快速版），优先验证流程通畅
  • OpenAI 客户端延迟初始化，避免无 Key 时模块加载失败
• notes:
  • 前端使用 Tailwind CSS v4 + PostCSS 配置方式（非 tailwind.config.ts）
  • 参考图在 MVP 阶段仅通过 GPT vision 理解风格后融入 prompt，未直接传给图像模型做 img2img

[CL-20260411-1630] 2026-04-11 16:30 — 完成开发环境搭建和依赖安装

• tags: art-agent, 环境搭建, Node.js, Python
• affected_files:
  • art-agent/backend/venv/
  • art-agent/frontend/node_modules/
• what: 通过 winget 安装 Node.js v24.14.1，创建 Python 虚拟环境并安装后端依赖（9 个包），安装前端 npm 依赖（46 个包），后端启动验证通过
• why: 代码写好后需要实际运行环境来验证
• decisions:
  • Node.js 用 winget 安装 LTS 版本
  • Python 虚拟环境放在 backend/venv/ 下
• notes:
  • 遇到 3 个环境问题已解决：OpenAI 延迟初始化、PowerShell 不支持 &&、脚本执行策略限制
  • 端到端完整测试待用户配置 API Key 后进行