大活

.cursor/changelog/changelog-full.md

@@ -0,0 +1,64 @@
+# 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 后进行