65 lines
3.6 KiB
Markdown
65 lines
3.6 KiB
Markdown
# 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 后进行
|