加了一堆模型和一堆功能

.cursor/changelog/changelog-full.md

@@ -4,6 +4,328 @@
 
 ## 记录
 
+### [CL-20260416-0830] 2026-04-16 08:30 — 生图按模型预处理 prompt（官网/社区策略对齐）
+- **tags**: 后端, 生图, prompt, SDXL, Flux, GPT Image, Gemini, Replicate, IP-Adapter, image_gen, Agent
+- **affected_files**:
+  - art-agent/backend/app/services/image_prompt_strategy.py
+  - art-agent/backend/app/services/image_gen.py
+  - art-agent/backend/app/agent/tools.py
+- **what**: 为当前注册的全部 7 个生图模型增加「进入 provider 前」的 prompt 预处理层；SDXL 向 Replicate 传入独立 `negative_prompt` 字段（与 stability-ai/sdxl API 一致）
+- **why**: 各后端对 prompt 的惯例不同（如 SDXL 双通道、FLUX 无 negative、IP-Adapter 重参考图语义），原先同一字符串直传难以发挥模型能力
+- **decisions**:
+  - 新模块 `image_prompt_strategy`：策略按 `IMAGE_MODELS` 的 `id` 分发，docstring 注明依据（OpenAI Image 指南、BFL FLUX 文档、Replicate API 字段、Stability 系默认负向词）
+  - SDXL：未拆分时使用模块内 `DEFAULT_SDXL_NEGATIVE`；可选 `default_params.negative_prompt` 覆盖；支持正文内 `---NEGATIVE---` 或 `|||NEG|||`
+  - Flux：剥除误粘贴的 `negative prompt:` 等段，符合 BFL「用正向描述替代负向」的指引
+  - `GenerateResult` 携带 `effective_prompt`/`negative_prompt` 供调试与工具回传
+- **notes**: 未引入二次 LLM 调用；复杂措辞重排仍依赖对话模型在工具参数里写好英文描述
+
+### [CL-20260416-0810] 2026-04-16 08:10 — 对话栏支持剪贴板粘贴图片为参考图
+- **tags**: 前端, ChatInput, 剪贴板, paste, 参考图, UX
+- **affected_files**:
+  - art-agent/frontend/src/components/chat/chat-input.tsx
+- **what**: 在输入区通过 Ctrl+V 或右键粘贴时，若剪贴板含图片文件则自动上传为参考图（与拖拽/点选上传同一路径）
+- **why**: 截图或复制图片后直接粘贴比保存再选文件更快
+- **decisions**: 使用根容器 `onPasteCapture` 在文本插入前拦截；仅当 `clipboardData.items` 中存在 `kind==="file"` 且 `type` 以 `image/` 开头时才 `preventDefault`，避免影响纯文本粘贴
+- **notes**: 依赖浏览器将剪贴板图片暴露为 file item；多图时逐项上传
+
+### [CL-20260416-0745] 2026-04-16 07:45 — Gemini 原生生图：延长超时 + 断连类错误自动重试
+- **tags**: 后端, Gemini, httpx, 超时, 重试, RemoteProtocolError, 向量引擎, 稳定性
+- **affected_files**:
+  - art-agent/backend/app/services/image_gen.py
+  - art-agent/backend/.env.example
+- **what**: 缓解 Gemini 3.1 Flash Image 调用时出现 `Server disconnected without sending a response` 的失败率
+- **why**: 多参考图时请求体大、生图耗时长，上游或本地代理可能在响应返回前关闭连接，httpx 抛出 `RemoteProtocolError`；原先 read 仅 180s 且单次失败即返回
+- **decisions**: 默认 read=600s、write=180s、connect/pool=60s；对 `RemoteProtocolError`、`ConnectError`、`Read/Write/Connect/PoolTimeout` 最多重试 3 次、间隔 1s/2s；可通过 `VECTORENGINE_GEMINI_READ_TIMEOUT` 等环境变量覆盖；`.env.example` 增加注释说明
+- **notes**: 若仍频繁断连，需排查代理 idle 超时或向量引擎侧限流；用户可暂时换 GPT Image 1.5 对比
+- **source_chat**: [Gemini断连重试](eb8bd100-5a4b-439f-bdc9-077311a456ad)
+
+### [CL-20260416-0720] 2026-04-16 07:20 — 修复拖拽参考图到 ChatInput 区域后覆盖层卡住不消失
+- **tags**: bug修复, 拖拽, 覆盖层, ChatInput, stopPropagation, UX, 事件冒泡
+- **affected_files**:
+  - art-agent/frontend/src/components/chat/chat-input.tsx
+  - art-agent/frontend/src/app/page.tsx
+- **what**: 修复拖拽图片到 ChatInput 区域松开后，全屏拖拽覆盖层（"松开以添加参考图"）不消失的 bug
+- **why**: CL-20260416-0620 为防止重复上传在 ChatInput.handleDrop 中加了 stopPropagation，但这也阻止了事件冒泡到 page.tsx 的 main.onDrop，后者负责清除 mainDragging 状态和 dragCounter。覆盖层有 pointer-events-none，不直接接收事件，但它的显示由 mainDragging 控制
+- **decisions**: 新增 onFileDrop 回调 prop 让 ChatInput 在 handleDrop 中通知父组件，而非移除 stopPropagation（移除会导致 CL-20260416-0620 修复的重复上传问题复发）
+- **notes**: 这是 stopPropagation 的典型副作用 — 解决了一个冒泡问题的同时切断了另一个需要冒泡的事件链。onFileDrop 回调模式是解决此类问题的标准方式
+- **source_chat**: [拖拽覆盖层卡住修复](eb8bd100-5a4b-439f-bdc9-077311a456ad)
+
+### [CL-20260416-0700] 2026-04-16 07:00 — 新增 GeminiNativeImageProvider：Gemini 原生 generateContent 接口对接
+- **tags**: 后端, Gemini, Provider, 原生API, generateContent, 多图参考, 架构, 向量引擎
+- **affected_files**:
+  - art-agent/backend/app/services/image_gen.py
+  - art-agent/backend/app/config.py
+- **what**: 新增 `GeminiNativeImageProvider` 类，对接 Gemini 原生 `generateContent` 接口，使 Gemini 3.1 Flash Image 恢复多图参考能力
+- **why**: 向量引擎对 Gemini 不支持 OpenAI 兼容的 `images/edit` 端点（CL-20260416-0620 回退了此方案）。Gemini 原生 API 通过 `generateContent` + `inline_data` 支持文字+图片混合输入，这是唯一可行的路径
+- **decisions**: 
+  - 选择直接 HTTP 调用向量引擎中转的 `/v1beta/models/{model}:generateContent` 端点，而非引入 `google-genai` SDK 新依赖——避免依赖膨胀且向量引擎已提供中转
+  - 新增 `_resolve_image_base64` 公共工具函数统一 data URI / 本地路径到 (mime, base64) 的解析，Gemini inline_data 和未来其他 provider 都可复用
+  - Gemini 响应中同时处理 `inlineData`（camelCase）和 `inline_data`（snake_case）两种字段名，因为向量引擎中转可能改变命名风格
+- **notes**: 
+  - Provider 注册表现有三个：`replicate`、`openai`、`gemini_native`，分发逻辑无需改动
+  - `generate_images` 中 Replicate 独有的"无参考图报错"逻辑已有 `provider_name == "replicate"` 限定，Gemini 无参考图时正常走纯文生图
+  - API key 复用 `VECTORENGINE_API_KEY`，base_url 从 `VECTORENGINE_BASE_URL` 推导（去掉 `/v1` 后拼 `/v1beta/...`）
+- **source_chat**: [Gemini原生Provider实现](eb8bd100-5a4b-439f-bdc9-077311a456ad)
+
+### [CL-20260416-0620] 2026-04-16 06:20 — 修复拖拽上传重复 + Gemini 改回不支持参考图 + images.edit 参数修正
+- **tags**: bug修复, 拖拽, 事件冒泡, Gemini, 向量引擎, images.edit, config, stopPropagation
+- **affected_files**:
+  - art-agent/frontend/src/components/chat/chat-input.tsx
+  - art-agent/backend/app/config.py
+  - art-agent/backend/app/services/image_gen.py
+- **what**: 三个问题修复：拖拽上传重复、Gemini 500 错误、images.edit quality 参数不支持
+- **why**: 用户测试多图上传时发现拖 1 张图显示 2 张；Gemini 使用参考图时 500 报错
+- **decisions**:
+  - 拖拽重复：ChatInput 的 handleDrop/handleDragOver 加 e.stopPropagation()，阻止事件冒泡到 page.tsx 的 onDrop
+  - Gemini 500：向量引擎的 Gemini 图片编辑走原生 `/v1beta/models/xxx:generateContent` 端点，不支持 OpenAI 兼容的 `/v1/images/edits`。Gemini 改回 supports_ref_image=False，有参考图时走纯文生图
+  - images.edit 的 quality 参数：OpenAI SDK images.edit 不接受 quality 参数（那是 images.generate 的），移除避免报错
+- **notes**:
+  - Gemini 图片编辑需要对接原生 generateContent 接口才能支持参考图，作为未来方向
+  - GPT Image 1.5 通过向量引擎 /v1/images/edits 走通的前提是向量引擎正确转发 multipart/form-data
+
+### [CL-20260416-0600] 2026-04-16 06:00 — 多张参考图全链路支持
+- **tags**: 前端, 后端, 参考图, 多图, OpenAI, images.edit, Provider, API, Agent Loop, UX
+- **affected_files**:
+  - art-agent/frontend/src/components/chat/chat-input.tsx
+  - art-agent/frontend/src/app/page.tsx
+  - art-agent/frontend/src/components/chat/chat-messages.tsx
+  - art-agent/frontend/src/lib/api.ts
+  - art-agent/frontend/src/lib/types.ts
+  - 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/backend/app/config.py
+- **what**: 从单张参考图扩展为多张参考图全链路支持（前端上传/显示 + API + Agent Loop + 生图 Provider）
+- **why**: GPT Image 1.5 支持最多 16 张参考图（images.edit 端点），Gemini 支持 14 张，用户需要"保留图1主体+图2视角"等多图组合控制能力
+- **decisions**:
+  - OpenAI Provider 有参考图时从 images.generate 切换到 images.edit 端点（而非统一用 edit）
+  - Replicate IP-Adapter 模型仍只支持单张，取 ref_image_urls[0] 兼容
+  - 后端 API 新增 ref_image_urls JSON 数组字段，保留旧 ref_image_url 单值字段向后兼容
+  - 前端 ChatMessage 新增 refImageUrls 数组字段，保留旧 refImageUrl 兼容已有聊天记录
+  - System Prompt 更新：LLM 需要理解多张参考图各自的角色并在 prompt 中传达
+- **notes**:
+  - 向量引擎中转需支持 /v1/images/edits 端点才能真正生效，待验证
+  - Gemini 走 OpenAI 兼容 API 中转，images.edit 是否被正确转发取决于中转层实现
+  - _load_image_bytes 新函数用于将本地路径/data URI 转为 bytes 供 images.edit 使用
+
+### [CL-20260416-0510] 2026-04-16 05:10 — 生图模型新增 Gemini 3.1 Flash Image
+- **tags**: 后端, 生图模型, Gemini, 向量引擎, config
+- **affected_files**:
+  - art-agent/backend/app/config.py
+  - art-agent/backend/.env
+- **what**: IMAGE_MODELS 注册表新增 gemini-3.1-flash-image 条目，model_id 为 gemini-3.1-flash-image-preview，provider 为 openai
+- **why**: 用户希望使用 Google Gemini 3.1 Flash 的原生生图能力，速度快价格低
+- **decisions**: 复用已有的 OpenAIImageProvider（向量引擎中转兼容 OpenAI images/generations 端点），零代码改动
+- **notes**: 如向量引擎对 Gemini 生图的返回格式有差异（如只返回 b64 不返回 URL），OpenAIImageProvider 已兼容两种格式
+
+### [CL-20260416-0500] 2026-04-16 05:00 — 全区域拖拽添加参考图
+- **tags**: 前端, UX, 拖拽, 参考图, 上传
+- **affected_files**:
+  - art-agent/frontend/src/app/page.tsx
+  - art-agent/frontend/src/components/chat/chat-input.tsx
+- **what**: 将拖拽上传参考图的区域从底部输入栏扩展到整个对话区域（main），拖入时显示全屏半透明覆盖层提示"松开以添加参考图"
+- **why**: 原先拖拽事件只绑在 ChatInput 组件（底部一小条），用户拖图片到对话区域无反应，体验不直觉
+- **decisions**: ChatInput 改为 forwardRef，暴露 `uploadFile` 方法（ChatInputHandle 接口）。page.tsx 的 `<main>` 处理 dragEnter/dragOver/dragLeave/drop，drop 时调用 `chatInputRef.current.uploadFile(file)` 复用已有上传逻辑。用 dragCounter ref 解决子元素 dragEnter/dragLeave 冒泡导致覆盖层闪烁的经典问题
+- **notes**: ChatInput 自身的拖拽处理保留（作为 fallback），两套不冲突
+
+### [CL-20260416-0430] 2026-04-16 04:30 — 接入 GPT Image 1.5 生图模型（向量引擎中转）
+- **tags**: 后端, 生图模型, GPT-Image, OpenAI, 向量引擎, provider
+- **affected_files**:
+  - art-agent/backend/app/services/image_gen.py
+  - art-agent/backend/app/config.py
+  - art-agent/backend/.env
+- **what**: 新增 OpenAIImageProvider，通过向量引擎 API 中转调用 GPT Image 1.5 模型生图。IMAGE_MODELS 注册表新增 gpt-image-1.5 条目，放在列表首位
+- **why**: 用户希望使用 OpenAI 最新的 GPT Image 1.5 模型，该模型在 prompt 理解和文字渲染方面表现最好。通过向量引擎中转可复用已有的 API Key
+- **decisions**: 新建 `OpenAIImageProvider` 类（与 `ReplicateProvider` 并列），使用 OpenAI Python SDK 的 `images.generate` 端点，懒初始化客户端。支持 URL 和 base64 两种返回格式。Provider 注册键为 `"openai"`
+- **notes**: GPT Image 系列不支持参考图（IP-Adapter），`supports_ref_image=False`。如果后续需要接入 gpt-image-1 或 gpt-image-1-mini，只需在注册表新增条目，Provider 代码无需改动
+
+### [CL-20260416-0400] 2026-04-16 04:00 — Session 级参考图自动沿用 + 缺参考图前置校验
+- **tags**: 前端, 后端, 参考图, UX, InstantStyle, 风格迁移
+- **affected_files**:
+  - art-agent/frontend/src/app/page.tsx
+  - art-agent/frontend/src/components/chat/chat-input.tsx
+  - art-agent/backend/app/services/image_gen.py
+- **what**: 发送消息使用参考图后，在 session 级别记住该参考图 URL，后续消息自动沿用。输入框上方显示"沿用上次参考图"提示条（含缩略图+清除按钮）。后端对需要参考图但未收到的模型（InstantStyle/Kolors 等）返回友好错误而非发给模型得到诡异结果
+- **why**: 用户切换到 InstantStyle 模型后输入"再执行一次前面的任务"，因前端每次发送后清除参考图状态，导致 InstantStyle 收不到 style_image 参数，模型返回 "No input, Save money" 文本。高频场景（换模型重试同任务）不应要求重新上传参考图
+- **decisions**: 参考图以 per-session `Map<sessionId, serverUrl>` 存在 `useRef` 中（不持久化到 localStorage），切换 session 时恢复对应参考图。UI 提示条仅在无主动上传且有历史参考图时显示，用户可一键清除。后端在 `generate_images` 统一入口处加前置校验，比在各 provider 内部检查更统一
+- **notes**: 参考图信息不写入 Session 类型定义（不持久化到 localStorage），因为服务端文件可能被清理；如果将来需要持久化，需考虑文件存在性校验
+
+### [CL-20260416-0300] 2026-04-16 03:00 — System Prompt 禁止 LLM 在回复中嵌入图片 Markdown 链接
+- **tags**: 后端, agent-loop, system-prompt, LLM行为约束
+- **affected_files**:
+  - art-agent/backend/app/agent/loop.py
+- **what**: 在 System Prompt 注意事项中新增约束，禁止 LLM 在回复文字中使用 `![](...)` 或 `sandbox:` 等 Markdown 图片语法
+- **why**: GPT 系列模型在收到 generate_image 工具返回的本地路径后，会自行拼凑 `sandbox:/generated/xxx.png` 格式的 Markdown 图片链接嵌入回复。该链接在前端不可渲染（`sandbox:` 不是有效协议），且图片展示已由 `image_result` SSE 事件独立处理，文字中的链接纯属多余
+- **decisions**: 通过 System Prompt 约束解决（而非后端过滤），因为这是 LLM 行为问题，从源头阻止更干净
+- **notes**: 同时排查发现 gpt-5.4 在向量引擎中转后实际调用了 gpt-4o-mini，该问题属于向量引擎 API 侧的模型映射/降级，非代码 bug
+
+### [CL-20260416-0245] 2026-04-16 02:45 — 修复三点菜单被右侧对话区遮挡
+- **tags**: 前端, UI, sidebar, 菜单, z-index
+- **affected_files**:
+  - art-agent/frontend/src/components/sidebar/session-list.tsx
+- **what**: 三点菜单从 fixed 右侧弹出改为 inline 下方展开，模型子菜单改为折叠式内联
+- **why**: 菜单用 fixed 定位弹到侧栏右侧，被主内容区的 stacking context 遮挡
+- **decisions**: 放弃 fixed+绝对坐标的弹出菜单方案，改为在会话项下方 inline 渲染。模型子菜单从右侧 absolute 弹出改为折叠展开式，带 max-h 240px 滚动防止过长
+- **notes**: 移除了 menuPos 状态，简化了定位逻辑
+
+### [CL-20260416-0230] 2026-04-16 02:30 — LLM 模型注册表扩充：新增 5 个前沿模型，默认改为 GPT-5.4
+- **tags**: 后端, config, LLM, 模型注册表
+- **affected_files**:
+  - art-agent/backend/app/config.py
+  - art-agent/backend/.env
+- **what**: LLM_MODELS 注册表从 3 个模型扩充到 7 个，默认模型从 gpt-4o-mini 改为 gpt-5.4
+- **why**: 用户需要使用 2026 年前沿模型（GPT-5.4, Claude Sonnet/Opus 4.6, Gemini 3.1 Pro, GLM-4.7）
+- **decisions**: 所有新增模型走 vectorengine provider，model_id 使用向量引擎确认的名称；gpt-4o-mini 和 deepseek-chat 保留作为轻量/直连选项
+- **notes**: 新增模型的 model_id 需向量引擎实际支持，如有出入需调整
+
+### [CL-20260416-0200] 2026-04-16 02:00 — 接入向量引擎中转 API + 对话级 LLM 模型切换
+- **tags**: 后端, 前端, LLM, 向量引擎, 中转API, 模型切换, config, UI, session
+- **affected_files**:
+  - art-agent/backend/app/config.py
+  - art-agent/backend/app/agent/loop.py
+  - art-agent/backend/app/api/chat.py
+  - art-agent/backend/.env
+  - art-agent/frontend/src/lib/types.ts
+  - art-agent/frontend/src/lib/api.ts
+  - art-agent/frontend/src/lib/app-context.tsx
+  - art-agent/frontend/src/components/sidebar/session-list.tsx
+  - art-agent/frontend/src/app/page.tsx
+- **what**: 接入向量引擎中转 API（OpenAI 兼容格式），实现对话级 LLM 模型切换
+- **why**: 用户需要通过中转 API 使用 OpenAI 系模型（GPT-4o/4o-mini），同时保留 DeepSeek 直连。每条对话应可独立选择不同模型
+- **decisions**:
+  - 后端采用 LLM_MODELS 注册表 + provider 分发的架构（参考已有 IMAGE_MODELS 模式）
+  - provider 分为 vectorengine（向量引擎中转 OpenAI 系）和 deepseek（直连），各有独立的 API key 和 base_url
+  - 移除旧的 OPENAI_API_KEY/OPENAI_BASE_URL 全局配置，改为 provider 级别
+  - vision 能力检测改为从注册表读取，不再子串匹配模型名
+  - 前端对话列表的右键菜单改为显式三点按钮菜单，模型选择作为子菜单项
+  - Session 类型新增 llmModel 字段，llmModel 为空时使用后端默认
+- **notes**:
+  - .env 中 VECTORENGINE_API_KEY 需要用户填入自己的 key
+  - Mem0 记忆系统仍使用 DEEPSEEK_API_KEY，不受影响
+  - 三点菜单预留了分享、归档等功能的扩展位
+  - 旧 localStorage 中没有 llmModel 字段的 Session 自动走默认模型
+
+### [CL-20260416-0030] 2026-04-16 00:30 — 青绿山水风格改造：从 Cyberpunk 霓虹转为千里江山图色调 + 云烟雾气动效
+- **tags**: 前端, UI改造, 视觉风格, 青绿山水, 千里江山图, CSS动画, 色彩体系, 云烟, 雾气
+- **affected_files**:
+  - art-agent/frontend/src/app/globals.css
+  - art-agent/frontend/src/components/layout/top-nav.tsx
+  - art-agent/frontend/src/components/sidebar/sidebar.tsx
+  - art-agent/frontend/src/components/sidebar/session-list.tsx
+  - 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/components/detail/image-detail-panel.tsx
+  - art-agent/frontend/src/components/profile-modal.tsx
+  - art-agent/frontend/src/app/page.tsx
+  - art-agent/frontend/src/app/gallery/page.tsx
+  - art-agent/frontend/src/app/login/page.tsx
+  - docs/art-agent/VISUAL-STYLE-GUIDE.md
+- **what**: 全站视觉风格从 Cyberpunk Dark Neon 改为"青绿山水"——以《千里江山图》矿物质颜料色为灵感的现代演绎。色彩体系、动画效果、背景光晕全面重做
+- **why**: 用户希望美术风格从赛博朋克调整为中国传统青绿山水的现代演绎，发光效果添加"雾气感"
+- **decisions**:
+  - 色彩体系：深墨绿底色（#0C1210）+ 石青绿高亮（#4DB8A4）+ 石绿蓝辅助（#3A8FB7）+ 赭石红（#C4654A）+ 赭金（#B8935A）
+  - 新增 --mist 和 --gold CSS 变量
+  - 背景改为双层漂移云雾（body::before 60s + body::after 45s），inset 负值防漂移露白
+  - .glow-border hover 效果：conic-gradient 弧段从 20% 扩大到 40-50%（更柔和），旋转从 3s 减慢到 6s，blur 从 6px 增到 12px，transition 从 500ms 增到 600ms
+  - .glass-panel 加内层渐变 + blur 从 20px 增到 24px + saturate(1.1)
+  - 新增 .fog-scroll 类（mask-image 渐变遮罩），应用到聊天区和会话列表
+  - 11 个组件文件中的硬编码 rgba(0,229,160,...) 全部替换为 rgba(77,184,164,...)
+  - 动画命名从 glowSpin 改为 mistSpin
+- **notes**:
+  - profile-modal.tsx 也有硬编码颜色，在计划外被一并修复
+  - Logo SVG 中的 #0B0E14 替换为新的 --bg-primary 色值 #0C1210
+  - VISUAL-STYLE-GUIDE.md 完全重写，包含新旧风格对比表
+- **source_chat**: [青绿山水风格改造]
+
+### [CL-20260415-2330] 2026-04-15 23:30 — 用户个人信息 + 记忆查看面板：右上角菜单弹窗
+- **tags**: 前端, 后端, 用户信息, 记忆系统, Mem0, Modal, ProfileModal, API
+- **affected_files**:
+  - art-agent/backend/app/api/memory.py
+  - art-agent/backend/app/main.py
+  - art-agent/frontend/src/components/profile-modal.tsx
+  - art-agent/frontend/src/components/layout/top-nav.tsx
+- **what**: 新增用户个人信息弹窗，展示用户基本信息和 Mem0 记忆系统中按时间分组的记忆列表
+- **why**: 用户希望能查看记忆系统为自己记录了哪些信息，右上角菜单是最自然的入口
+- **decisions**:
+  - 后端新建独立路由文件 api/memory.py（职责分离），暴露 GET /api/memory/list 端点
+  - 使用 Mem0 OSS `Memory.get_all(user_id=..., limit=200)` 获取全部记忆
+  - 同步调用通过 `run_in_executor` 包装避免阻塞事件循环
+  - 前端用居中 Modal（非 Drawer/独立页），复用 glass-panel + Cyberpunk 风格
+  - 记忆按 created_at 时间分组（今天/最近7天/更早），不依赖 Mem0 不稳定的 categories 字段
+  - 只读模式，不实现删除功能
+- **notes**:
+  - TopNav 的 username 行从静态文本改为可点击按钮，点击打开 ProfileModal
+  - TopNav return 改为 Fragment 以容纳 header + Modal 两个顶级元素
+  - ESC 键可关闭弹窗，点击遮罩层也可关闭
+- **source_chat**: [用户个人信息记忆面板]
+
+### [CL-20260415-2230] 2026-04-15 22:30 — 光影流动边框效果：导航活动项 + 活动会话项
+- **tags**: 前端, CSS动画, 视觉效果, conic-gradient, 霓虹边框, 导航, 侧边栏
+- **affected_files**:
+  - art-agent/frontend/src/app/globals.css
+  - art-agent/frontend/src/components/layout/top-nav.tsx
+  - art-agent/frontend/src/components/sidebar/session-list.tsx
+  - art-agent/frontend/src/components/sidebar/sidebar.tsx
+- **what**: 实现 Dribbble 设计图中的边框光影流动效果，应用到导航活动 Tab 和活动会话项
+- **why**: 用户指出按钮/标签缺少设计图中的发光+光影流动感。需要用 CSS 动画实现旋转锥形渐变边框
+- **decisions**:
+  - 用 `@property --glow-angle` + `conic-gradient` 实现旋转光线，3s 一圈
+  - 双伪元素方案：`::before` 做精确渐变边框（mask-composite 裁掉内部），`::after` 做外层模糊扩散光晕
+  - 提供两个 CSS 类：`.glow-border`（动画旋转，用于活动态）、`.glow-border-static`（静态发光，用于 hover）
+  - 导航非活动项 hover 时用静态发光，不抢活动项视觉焦点
+- **notes**:
+  - `@property` 需要浏览器支持 CSS Houdini（Chrome 85+, Edge 85+, Safari 15.4+），对目标用户群体覆盖足够
+  - 光影流动 3s 周期可通过修改 `glowSpin` 动画时长调整
+- **source_chat**: [光影流动边框效果实现]
+
+### [CL-20260415-2200] 2026-04-15 22:00 — 全站 UI 风格改造：Cyberpunk Dark Neon 主题
+- **tags**: 前端, UI改造, 视觉风格, Cyberpunk, Neon, 毛玻璃, 全局样式, 组件重构
+- **affected_files**:
+  - art-agent/frontend/src/app/globals.css
+  - art-agent/frontend/src/app/page.tsx
+  - art-agent/frontend/src/app/gallery/page.tsx
+  - art-agent/frontend/src/app/login/page.tsx
+  - art-agent/frontend/src/components/layout/top-nav.tsx
+  - art-agent/frontend/src/components/sidebar/sidebar.tsx
+  - art-agent/frontend/src/components/sidebar/session-list.tsx
+  - art-agent/frontend/src/components/sidebar/tag-filter.tsx
+  - 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/components/chat/model-selector.tsx
+  - art-agent/frontend/src/components/detail/image-detail-panel.tsx
+  - docs/art-agent/VISUAL-STYLE-GUIDE.md
+- **what**: 参考 SolCasino Dribbble 设计，将全站 UI 从朴素暗色主题改造为 Cyberpunk Dark Neon 风格
+- **why**: 用户希望产品页面更具视觉冲击力，参考了 Dribbble 上的加密赌场 Cases 页面设计，提取其核心视觉语言（霓虹发光、毛玻璃、环境光晕、卡片网格）应用到美术 Agent 工具
+- **decisions**:
+  - 主色从紫色(#6366f1)改为青绿霓虹(#00E5A0)，更符合 Cyberpunk 调性
+  - 新增 CSS 变量：`--bg-card`, `--hot`, `--accent-secondary`, `--border-glow`
+  - 背景加 body::before 环境光晕（两团 radial-gradient 光斑）
+  - 全部面板改为 backdrop-blur 毛玻璃效果
+  - 圆角从 rounded-lg/2xl 统一升级为 rounded-xl/2xl
+  - 新增 `.glass-panel` 和 `.neon-border` 全局 CSS 类
+  - 图片卡片 hover 时有微缩放(1.03) + 霓虹边框发光
+  - 登录页加独立环境光背景 + 毛玻璃表单容器
+  - Gallery 卡片改为 neon-border 风格，选中时霓虹发光阴影
+  - 收藏色从金色改为 accent 青绿色，保持色彩一致性
+- **notes**:
+  - 同时编写了视觉风格文档 `docs/art-agent/VISUAL-STYLE-GUIDE.md`，记录完整的设计规范
+  - annotation-canvas.tsx 未做改动（工具型组件，暗色已适配）
+  - 所有组件保留原有功能和交互逻辑，仅变更视觉层
+- **source_chat**: [Cyberpunk UI 风格改造]
+
+### [CL-20260414-2350] 2026-04-14 23:50 — 修复登录后 useApp must be used within AppProvider 报错
+- **tags**: bug修复, 前端, 认证, AppProvider, 初始化时序
+- **affected_files**:
+  - art-agent/frontend/src/lib/app-context.tsx
+- **what**: 修复登录成功跳转到主页时 useApp() 拿到 null context 报错
+- **why**: AppProvider 在 `!initialized` 时直接渲染 `<>{children}</>`（不提供 AppContext），但已登录用户跳转到 `/` 后 `page.tsx` 立即调用 `useApp()`，而 `useEffect` 中的 `setInitialized(true)` 还没执行，导致 context 为 null
+- **decisions**: 区分两种 `!initialized` 场景——已认证时显示加载状态（不渲染需要 context 的子组件），未认证时渲染 children（供 /login 页面使用）
+- **notes**: 这是 React 的 useEffect 异步特性导致的时序问题，登录跳转瞬间路由已变但 state 还没更新
+- **source_chat**: [修复 AppProvider 初始化时序](a33b7af6-a8c0-4e88-8372-ec4b5b9dd703)
+
 ### [CL-20260414-2340] 2026-04-14 23:40 — 用 pwdlib (Argon2id) 替换 passlib (bcrypt)，彻底解决兼容性问题
 - **tags**: 重构, 安全, 密码哈希, Argon2, pwdlib, passlib, 依赖升级
 - **affected_files**:

.cursor/changelog/changelog-headlines.md

@@ -2,6 +2,26 @@
 
 最近 ~50 次改动的一句话概要，按时间倒序排列。每次会话自动注入上下文。
 
+- [CL-20260416-0830] 生图按模型预处理 prompt：新增 image_prompt_strategy（SDXL 默认负向词+---NEGATIVE---拆分，Flux 剥粘贴的 Negative 段，GPT/Gemini/IP-Adapter 规范化）；GenerateResult 带 effective_prompt/negative_prompt；Replicate SDXL 传 negative_prompt；工具说明 SDXL 分隔符
+- [CL-20260416-0810] 对话输入栏支持剪贴板粘贴图片为参考图：ChatInput根容器onPasteCapture提取image/*文件并走startUpload，placeholder/title提示
+- [CL-20260416-0745] Gemini原生生图：延长读写超时+对RemoteProtocolError等可重试错误自动重试(默认3次指数退避)，环境变量可微调VECTORENGINE_GEMINI_*_TIMEOUT
+- [CL-20260416-0720] 修复拖拽参考图到ChatInput区域后覆盖层卡住不消失：ChatInput的stopPropagation阻止了main.onDrop，新增onFileDrop回调通知父组件清除拖拽状态
+- [CL-20260416-0700] 新增GeminiNativeImageProvider：对接Gemini原生generateContent接口，支持多图参考（最多14张），Gemini恢复supports_ref_image=True
+- [CL-20260416-0620] 修复拖拽上传重复(stopPropagation)+Gemini改回不支持参考图(向量引擎不支持Gemini走images/edits)+images.edit移除不支持的quality参数
+- [CL-20260416-0600] 多张参考图全链路支持：前端多图上传/拖拽/沿用+后端API/AgentLoop/Provider全部改为list[str]，OpenAI走images.edit端点(最多16张)，Replicate取首张兼容
+- [CL-20260416-0510] 生图模型注册表新增Gemini 3.1 Flash Image(gemini-3.1-flash-image-preview)，走向量引擎中转复用OpenAIImageProvider
+- [CL-20260416-0500] 全区域拖拽添加参考图：拖拽区域从底部输入栏扩展到整个对话区域，拖入时全屏覆盖层提示，ChatInput改forwardRef暴露uploadFile
+- [CL-20260416-0430] 接入GPT Image 1.5生图模型：新增OpenAIImageProvider走向量引擎中转，IMAGE_MODELS注册表新增gpt-image-1.5
+- [CL-20260416-0400] Session级参考图自动沿用：发送后记住参考图供后续消息复用+UI提示条+可清除，后端对缺参考图的风格迁移模型返回友好错误
+- [CL-20260416-0300] System Prompt新增禁止LLM在回复中嵌入Markdown图片链接(sandbox:等)，图片展示由image_result SSE事件处理
+- [CL-20260416-0245] 修复三点菜单被右侧对话区遮挡：从fixed右侧弹出改为inline下方展开+模型列表折叠式内联，全部在侧栏内完成
+- [CL-20260416-0230] LLM注册表扩充至7个模型(+gpt-5.4/claude-sonnet-4-6/claude-opus-4-6/gemini-3.1-pro-preview/glm-4.7)，默认改为gpt-5.4
+- [CL-20260416-0200] 接入向量引擎中转API+对话级LLM模型切换：LLM_MODELS注册表(gpt-4o-mini/gpt-4o/deepseek-chat)，provider分发(vectorengine/deepseek)，前端三点菜单模型选择，Session级llmModel
+- [CL-20260416-0030] 青绿山水风格改造：色彩体系替换为千里江山图石青石绿色调，背景改双层漂移云雾，glow-border 柔化为云烟缭绕，新增 fog-scroll 雾气边缘，11 个组件硬编码颜色统一替换
+- [CL-20260415-2230] 光影流动边框改为 hover 触发：常态微弱静态发光，hover 时旋转动画通过 opacity 500ms 平滑淡入/淡出，无跳变
+- [CL-20260415-2330] 用户个人信息+记忆查看面板：右上角菜单弹窗，展示 Mem0 记忆列表（按时间分组，只读），后端新增 /api/memory/list 端点
+- [CL-20260415-2200] 全站 UI 风格改造为 Cyberpunk Dark Neon：主色改为青绿霓虹，新增环境光晕/毛玻璃/霓虹发光边框，13 个组件重构 + 视觉风格文档
+- [CL-20260414-2350] 修复登录后 useApp must be used within AppProvider：AppProvider 未初始化时区分已认证/未认证，避免子组件拿到 null context
 - [CL-20260414-2340] 用 pwdlib (Argon2id) 替换 passlib (bcrypt)：彻底解决兼容性问题，新密码 Argon2id，旧 bcrypt 哈希兼容验证
 - [CL-20260414-2330] 修复 passlib + bcrypt 5.x 兼容性：锁定 bcrypt>=4.0.1,<4.1，解决后端启动 AttributeError + ValueError
 - [CL-20260414-2300] 用户系统：管理员邀请制 + JWT 认证 + SQLite 用户表 + Mem0/localStorage 按用户隔离，所有 API 鉴权，前端登录页 + AuthGuard

.cursor/changelog/changelog-recent.md

@@ -3,6 +3,106 @@
 最近 ~10 次改动的摘要记录，按时间倒序排列。
 当 Agent 检测到当前任务与近期改动相关时自动读取。
 
+### [CL-20260416-0830] 2026-04-16 — 生图按模型预处理 prompt
+- **tags**: 后端, 生图, prompt, SDXL, Flux, Replicate, image_gen, Agent工具
+- **affected_files**: image_prompt_strategy.py, image_gen.py, tools.py
+- **summary**: 新增 `image_prompt_strategy`：按注册表 id 为 7 个生图模型应用策略（OpenAI/Gemini 自然语言规范化；BFL Flux 指南对齐、剥 SD 式 Negative 段；SDXL 默认负向词 + `---NEGATIVE---`/`|||NEG|||` 拆分；IP-Adapter 侧重内容描述）。`generate_images` 统一调用后下发；Replicate 非 Flux 路径写入 `negative_prompt`。`GenerateResult` 增加 `effective_prompt`/`negative_prompt`；工具返回与描述补充 SDXL 分隔符约定。
+
+### [CL-20260416-0810] 2026-04-16 — 对话栏粘贴剪贴板图片为参考图
+- **tags**: 前端, ChatInput, 剪贴板, 参考图, UX
+- **affected_files**: chat-input.tsx
+- **summary**: 在 ChatInput 根容器上使用 onPasteCapture：从 clipboardData.items 收集 kind===file 且 image/* 的项，调用 getAsFile 后复用现有 startUpload。无图片文件时不拦截，纯文本粘贴照常。placeholder 与 textarea title 提示可粘贴图片。
+
+### [CL-20260416-0745] 2026-04-16 — Gemini 原生生图：超时与断连重试
+- **tags**: 后端, Gemini, httpx, 超时, 重试, 向量引擎, image_gen
+- **affected_files**: image_gen.py, .env.example
+- **summary**: 用户遇到 `Server disconnected without sending a response`（httpx RemoteProtocolError 等）。将 Gemini generateContent 默认 read 超时提高到 600s、write 180s、connect/pool 60s；对 RemoteProtocolError/ConnectError/ReadTimeout 等可恢复错误默认最多重试 3 次（指数退避 1s/2s）；失败时错误信息附带调优提示。可通过 VECTORENGINE_GEMINI_* 环境变量覆盖。
+
+### [CL-20260416-0720] 2026-04-16 — 修复拖拽参考图到 ChatInput 区域后覆盖层卡住不消失
+- **tags**: bug修复, 拖拽, 覆盖层, ChatInput, stopPropagation, UX
+- **affected_files**: chat-input.tsx, page.tsx
+- **summary**: 文件拖拽到 ChatInput 区域时，ChatInput.handleDrop 的 stopPropagation 阻止事件冒泡到 main.onDrop，导致 mainDragging 状态无法重置为 false，拖拽覆盖层（"松开以添加参考图"）卡住不消失。修复：ChatInput 新增 onFileDrop 回调 prop，在 handleDrop 中调用，page.tsx 传入回调重置 dragCounter 和 mainDragging。
+
+### [CL-20260416-0700] 2026-04-16 — 新增 GeminiNativeImageProvider：Gemini 原生 generateContent 接口对接
+- **tags**: 后端, Gemini, Provider, 原生API, generateContent, 多图参考, 架构
+- **affected_files**: image_gen.py, config.py
+- **summary**: 新增 GeminiNativeImageProvider，通过向量引擎中转调用 Gemini 原生 `/v1beta/models/{model}:generateContent` 接口（非 OpenAI 兼容的 images/edit）。支持文字+图片混合输入（最多 14 张参考图），图片以 inline_data base64 内联传入。新增 `_resolve_image_base64` 工具函数统一处理 data URI 和本地路径到 (mime, b64) 的解析。config.py 中 Gemini 模型改用 `gemini_native` provider 并恢复 `supports_ref_image: True`。Provider 注册表新增 `gemini_native` 条目。
+
+### [CL-20260416-0620] 2026-04-16 — 修复拖拽上传重复 + Gemini 改回不支持参考图 + images.edit 参数修正
+- **tags**: bug修复, 拖拽, Gemini, 向量引擎, images.edit, config
+- **affected_files**: chat-input.tsx, config.py, image_gen.py
+- **summary**: 三个问题修复：(1) 拖拽到 ChatInput 区域时事件冒泡导致 page.tsx 和 ChatInput 各触发一次上传 → ChatInput handleDrop/handleDragOver 加 stopPropagation；(2) 向量引擎 Gemini 图片编辑走原生 generateContent 接口而非 OpenAI 兼容 images/edits，对 Gemini 调用 images.edit 返回 500 → Gemini 改回 supports_ref_image=False；(3) images.edit 端点不支持 quality 参数 → 从 _edit_with_refs 中移除。
+
+### [CL-20260416-0600] 2026-04-16 — 多张参考图全链路支持
+- **tags**: 前端, 后端, 参考图, 多图, OpenAI, images.edit, Provider, API, Agent Loop
+- **affected_files**: chat-input.tsx, page.tsx, chat-messages.tsx, api.ts, types.ts, chat.py, loop.py, tools.py, image_gen.py, config.py
+- **summary**: 从单张参考图扩展为多张参考图全链路支持。前端：ChatInput 改为多图状态数组+file input multiple+多图预览/删除/拖拽；API层 sendChat 改为 ref_image_urls: string[]；消息气泡和沿用逻辑适配多图。后端：chat.py 新增 ref_image_urls JSON 数组参数（兼容旧 ref_image_url）；Agent Loop 多图注入 vision LLM 上下文；OpenAIImageProvider 有参考图时改用 images.edit 端点（支持最多16张）；Replicate 取首张兼容；GPT Image 1.5 和 Gemini 注册表标记 supports_ref_image=True。
+
+### [CL-20260416-0510] 2026-04-16 — 生图模型新增 Gemini 3.1 Flash Image
+- **tags**: 后端, 生图模型, Gemini, 向量引擎, config
+- **affected_files**: config.py, .env
+- **summary**: IMAGE_MODELS 注册表新增 gemini-3.1-flash-image（model_id: gemini-3.1-flash-image-preview），provider 为 openai，复用 OpenAIImageProvider 走向量引擎中转。无需新增 Provider 代码。
+
+### [CL-20260416-0500] 2026-04-16 — 全区域拖拽添加参考图
+- **tags**: 前端, UX, 拖拽, 参考图, 上传
+- **affected_files**: page.tsx, chat-input.tsx
+- **summary**: 拖拽上传参考图区域从底部输入栏扩展到整个对话区域。ChatInput 改为 forwardRef 暴露 uploadFile 方法，main 区域处理拖放事件并调用。拖入时显示全屏覆盖层提示，用 dragCounter 防止子元素冒泡导致闪烁。
+
+### [CL-20260416-0430] 2026-04-16 — 接入 GPT Image 1.5 生图模型（向量引擎中转）
+- **tags**: 后端, 生图模型, GPT-Image, OpenAI, 向量引擎, provider
+- **affected_files**: image_gen.py, config.py, .env
+- **summary**: 新增 OpenAIImageProvider，通过向量引擎 API 中转调用 `/v1/images/generations` 端点。IMAGE_MODELS 注册表新增 gpt-image-1.5（provider: openai），支持 size/quality 参数和 URL/base64 双格式返回。
+
+### [CL-20260416-0400] 2026-04-16 — Session 级参考图自动沿用 + 缺参考图前置校验
+- **tags**: 前端, 后端, 参考图, UX, InstantStyle, 风格迁移
+- **affected_files**: page.tsx, chat-input.tsx, image_gen.py
+- **summary**: 用户发送带参考图的消息后，前端在 session 级别记住该参考图 URL，后续消息自动沿用（输入框显示"沿用上次参考图"提示条，可清除）。解决切换 InstantStyle 后无参考图导致 "No input, Save money" 的问题。后端对需要参考图但未收到的模型统一返回友好错误。
+
+### [CL-20260416-0300] 2026-04-16 — System Prompt 禁止 LLM 嵌入图片链接
+- **tags**: 后端, agent-loop, system-prompt, LLM行为约束
+- **affected_files**: loop.py
+- **summary**: LLM（GPT 系列）在收到 generate_image 工具返回的本地路径后，自行拼凑 `sandbox:/generated/xxx.png` Markdown 图片链接。前端图片展示由 image_result SSE 事件独立处理，文字中的链接无效且多余。在 System Prompt 注意事项中新增禁止嵌入图片 Markdown 的约束。
+
+### [CL-20260416-0245] 2026-04-16 — 修复三点菜单 z-index 层级问题
+- **tags**: 前端, UI, sidebar, 菜单, z-index
+- **affected_files**: session-list.tsx
+- **summary**: 三点菜单原用 fixed 定位在侧栏右侧弹出，被主内容区遮挡。改为 inline 在会话项正下方展开，模型子菜单改为折叠式内联列表（带 max-h 滚动），全部在侧栏内部完成，不再溢出。移除了 menuPos 状态和 fixed 定位逻辑。
+
+### [CL-20260416-0230] 2026-04-16 — LLM 注册表扩充 + 默认模型改 GPT-5.4
+- **tags**: 后端, config, LLM, 模型注册表
+- **affected_files**: config.py, .env
+- **summary**: LLM_MODELS 从 3→7 个：新增 gpt-5.4、claude-sonnet-4-6、claude-opus-4-6、gemini-3.1-pro-preview、glm-4.7，全部走 vectorengine provider。默认模型从 gpt-4o-mini 改为 gpt-5.4。gpt-4o-mini/deepseek-chat 保留。
+
+### [CL-20260416-0200] 2026-04-16 — 接入向量引擎中转 API + 对话级 LLM 模型切换
+- **tags**: 后端, 前端, LLM, 向量引擎, 中转API, 模型切换, config, UI, session
+- **affected_files**: config.py, loop.py, chat.py, .env, types.ts, api.ts, app-context.tsx, session-list.tsx, page.tsx
+- **summary**: 新增 LLM_MODELS 注册表（gpt-4o-mini/gpt-4o/deepseek-chat），provider 分发为 vectorengine（中转）和 deepseek（直连）。loop.py 改为按 provider 创建 AsyncOpenAI 客户端，vision 检测从注册表读取。chat.py 新增 llm_model 参数和 GET /api/llm-models 端点。前端 Session 新增 llmModel 字段，侧栏三点菜单支持模型选择子菜单，sendChat 传递 llm_model。
+
+### [CL-20260416-0030] 2026-04-16 — 青绿山水风格改造：千里江山图色调 + 云烟雾气动效
+- **tags**: 前端, UI改造, 视觉风格, 青绿山水, 千里江山图, CSS动画, 色彩体系, 云烟
+- **affected_files**: globals.css, top-nav.tsx, sidebar.tsx, session-list.tsx, chat-messages.tsx, chat-input.tsx, image-grid.tsx, image-detail-panel.tsx, profile-modal.tsx, page.tsx, gallery/page.tsx, login/page.tsx, VISUAL-STYLE-GUIDE.md
+- **summary**: 全站从 Cyberpunk 霓虹改为青绿山水风格。色彩替换为石青绿(#4DB8A4)/石绿蓝(#3A8FB7)/墨绿底色(#0C1210)。背景改为双层漂移云雾(60s+45s)。.glow-border hover 效果柔化为云烟缭绕(6s/宽弧段/blur 12px)。.glass-panel 加绿底渐变+增强模糊。新增 .fog-scroll 雾气滚动边缘。11 个组件硬编码颜色全部替换。VISUAL-STYLE-GUIDE.md 完全重写。
+
+### [CL-20260415-2330] 2026-04-15 — 用户个人信息 + 记忆查看面板：右上角菜单弹窗
+- **tags**: 前端, 后端, 用户信息, 记忆系统, Mem0, Modal, ProfileModal
+- **affected_files**: api/memory.py, main.py, profile-modal.tsx, top-nav.tsx
+- **summary**: 后端新建 GET /api/memory/list 端点（Mem0 get_all + run_in_executor），前端新建 ProfileModal 组件（glass-panel 风格居中弹窗），展示用户信息 + 按时间分组的记忆列表（只读）。TopNav 的 username 行改为可点击按钮，点击打开弹窗。
+
+### [CL-20260415-2230] 2026-04-15 — 光影流动边框效果：导航活动项 + 活动会话项
+- **tags**: 前端, CSS动画, 视觉效果, conic-gradient, 霓虹边框
+- **affected_files**: globals.css, top-nav.tsx, session-list.tsx, sidebar.tsx
+- **summary**: 用 @property + conic-gradient 实现旋转光影边框效果。双伪元素方案：::before 做渐变边框（mask-composite 裁内部），::after 做模糊扩散光晕。提供 .glow-border（动画）和 .glow-border-static（hover 静态发光）两个类，分别应用到导航活动 Tab 和活动会话项。
+
+### [CL-20260415-2200] 2026-04-15 — 全站 UI 风格改造：Cyberpunk Dark Neon 主题
+- **tags**: 前端, UI改造, 视觉风格, Cyberpunk, Neon, 毛玻璃, 全局样式
+- **affected_files**: globals.css, page.tsx, gallery/page.tsx, login/page.tsx, top-nav.tsx, sidebar.tsx, session-list.tsx, tag-filter.tsx, chat-messages.tsx, chat-input.tsx, image-grid.tsx, model-selector.tsx, image-detail-panel.tsx, VISUAL-STYLE-GUIDE.md
+- **summary**: 参考 SolCasino Dribbble 设计，全站从朴素暗色改为 Cyberpunk Dark Neon 风格。主色从紫色改为青绿霓虹(#00E5A0)，新增环境光晕背景、毛玻璃面板(backdrop-blur)、霓虹发光边框。所有组件统一升级圆角和过渡效果，图片卡片加 hover 缩放+发光。同时编写了完整的视觉风格文档。
+
+### [CL-20260414-2350] 2026-04-14 — 修复登录后 useApp must be used within AppProvider 报错
+- **tags**: bug修复, 前端, 认证, AppProvider, 初始化时序
+- **affected_files**: app-context.tsx
+- **summary**: AppProvider 在 `!initialized` 时不提供 context 但渲染了需要 useApp() 的子组件。修复：已认证但未初始化时显示加载状态，未认证时才渲染裸 children（/login）。
+
 ### [CL-20260414-2340] 2026-04-14 — 用 pwdlib (Argon2id) 替换 passlib (bcrypt)，彻底解决兼容性问题
 - **tags**: 重构, 安全, 密码哈希, Argon2, pwdlib, passlib, 依赖升级
 - **affected_files**: auth.py, requirements.txt, docs/art-agent/USER-SYSTEM.md

.cursor/deferred/registry.md

@@ -21,16 +21,17 @@
 - **chosen_alternative**: 路线 A — 本地运行 + 内网穿透（Cloudflare Tunnel / ngrok）
 - **deferred_reason**: 当前阶段只需自己和朋友试用，内网穿透足够
 
-### [style-pipeline-layered] 分层组合风格一致性产线
+### [style-pipeline-layered] 分层组合风格一致性产线（含便利选取 + LoRA 训练）
 - **status**: deferred
-- **tags**: 风格一致性, IP-Adapter, LoRA, ControlNet, 量产, 美术产线, InstantStyle
+- **tags**: 风格一致性, 风格选取, IP-Adapter, LoRA, ControlNet, 量产, 美术产线, InstantStyle, 风格库, 训练
 - **recorded**: 2026-04-12
-- **updated**: 2026-04-13
+- **updated**: 2026-04-16
 - **source_chat**: [风格一致性技术方案讨论](style-consistency-discussion)
 - **prerequisite**: EPEEKit 进入美术资源量产阶段（风格方向已确定、需要批量产出同风格素材）
 - **related_files**:
   - art-agent/backend/app/services/image_gen.py
   - art-agent/backend/app/config.py
+  - art-agent/frontend/src/app/page.tsx
 - **context**: |
     分层组合的风格一致性产线：
     1. 探索期（当前）：Prompt + 参考图，快速试错确定风格方向
@@ -45,9 +46,64 @@
     - Style IPAdapter for NoobAI-XL（CivitAI）：最强画风迁移（线条+着色技法），需 ComfyUI
     - ICAS 框架（学术前沿 2025.04）：IP-Adapter + ControlNet 组合，多主体风格一致性最优
     锁定期的最佳方案：迁移到 HF Inference Endpoints 后，用 NoobAI-XL + Style IPAdapter + ControlNet
+    
+    2026-04-16 补充 — 便利的风格选取和 LoRA 训练 UI：
+    - 风格库 UI：预设风格卡片（缩略图+标签+描述），一键选取即注入对应 Prompt 模板/参考图/LoRA
+    - LoRA 训练流程集成：在 Agent 内上传训练素材 → 触发云端 LoRA 训练 → 训练完成后自动入库为新风格
+    - 风格组合：支持多风格叠加（如"水墨 + 赛博朋克"），前端可视化混合权重
+    - 风格管理：用户自建/收藏风格，按项目/标签分类，团队共享
 - **chosen_alternative**: 当前使用 Prompt Engineering + LLM 参考图理解（探索期方案）
 - **deferred_reason**: 风格方向尚未确定，过早引入 LoRA/ControlNet 是过度优化
 
+### [doc-gen-management] 文档生成和管理系统
+- **status**: deferred
+- **tags**: 文档生成, 项目大纲, 游戏风格文档, 美术规范, GDD, 模板, 导入
+- **recorded**: 2026-04-16
+- **source_chat**: [接下来要做的三件事](next-features-planning-0416)
+- **prerequisite**: 基础对话生图能力稳定后
+- **related_files**:
+  - art-agent/frontend/src/app/page.tsx
+  - art-agent/backend/app/agent/loop.py
+  - art-agent/backend/app/agent/tools.py
+- **context**: |
+    文档驱动的美术资源生产流程：
+    1. 项目大纲导入：支持上传/粘贴项目大纲（GDD、策划案等），Agent 解析结构
+    2. 游戏风格文档生成：基于大纲 + 对话交互，自动生成美术风格指南
+       （色彩体系、质感定义、元素规范、参考图收集等）
+    3. 文档模板：预设多种文档模板（美术风格指南、UI 规范、角色设定集、场景规范等）
+    4. 文档管理：按项目组织，版本历史，团队共享，与生图任务关联
+    5. 文档 → 生图联动：风格文档中的规范自动注入生图 Prompt，确保产出一致性
+- **chosen_alternative**: 当前无文档管理能力，美术规范靠口头约定或外部文档
+- **deferred_reason**: 当前阶段聚焦核心生图能力，文档系统是生图能力稳定后的自然延伸
+
+### [asset-spec-presets] 资产规格快速选取系统
+- **status**: deferred
+- **tags**: 资产规格, icon, UI资产, 3D资产, 尺寸, 比例, 安全区, 底色, 预设, 美术标准
+- **recorded**: 2026-04-16
+- **source_chat**: [接下来要做的三件事](next-features-planning-0416)
+- **prerequisite**: 基础生图能力稳定后
+- **related_files**:
+  - art-agent/backend/app/agent/tools.py
+  - art-agent/backend/app/services/image_gen.py
+  - art-agent/frontend/src/app/page.tsx
+- **context**: |
+    资产规格预设系统——选取资产类型即自动套用全部技术标准：
+    1. 资产类型库：Icon / UI按钮 / 头像框 / 背景图 / 角色立绘 / 场景原画 / 3D贴图 等
+    2. 每种类型包含完整规格定义：
+       - 尺寸（输出分辨率、DPI）
+       - 比例（1:1 / 16:9 / 自定义）
+       - 安全区（内容区 vs 出血区）
+       - 底色/透明度要求
+       - 文件格式（PNG / SVG / PSD 等）
+       - 风格约束（该类资产的通用风格要求，如 icon 需要简洁辨识度高）
+       - 导出规格（多尺寸自动导出，如 @1x @2x @3x）
+    3. 项目级自定义：允许在预设基础上调整，保存为项目专属规格
+    4. 3D 资产扩展：未来覆盖 3D 模型的面数/贴图分辨率/UV规范等
+    5. 一键应用：选取资产类型后，尺寸/比例/后处理参数自动注入生图调用
+    6. 游戏全品类覆盖：目标是游戏中所有美术资产类型都有对应的规格预设
+- **chosen_alternative**: 当前生图参数完全由用户在对话中手动指定或由 LLM 推断
+- **deferred_reason**: 当前阶段聚焦核心生图和风格探索，规格系统是进入量产阶段的必备基础设施
+
 ### [hf-inference-endpoints] 迁移到 Hugging Face + Inference Endpoints
 - **status**: deferred
 - **tags**: 基础设施, Hugging Face, Inference Endpoints, ComfyUI, 自定义模型, 风格迁移

.cursor/hooks/check-changelog.ps1

@@ -1,4 +1,4 @@
-# Changelog sync guard — 统一 stop hook（合并了原 prompt hook 和 command hook）
+# Changelog sync guard — 统一 stop hook
 #
 # 用确定性逻辑检查：
 #   1. 源文件是否比 changelog 更新（mtime 比较）
@@ -10,6 +10,7 @@
 #   3. changelog 文件不存在
 #   4. .changelog-ack 标记文件存在且足够新（本会话已确认过 changelog 状态）
 #   5. 没有源文件比 changelog 更新
+#   6. stdin 上下文中没有文件编辑操作的证据（防止跨会话残留 mtime 误触发）
 
 $input = [Console]::In.ReadToEnd()
 
@@ -58,6 +59,20 @@ if ((Test-Path $ackFile) -and (Get-Item $ackFile).LastWriteTime -ge $clMtime) {
     exit 0
 }
 
+# === 豁免检查 6：stdin 中无文件编辑证据 ===
+# 防止跨会话残留 mtime 差异导致误触发：如果 ack 文件不存在（或过旧），
+# 但 stdin 上下文中也没有任何文件写入/编辑操作的痕迹，说明本次会话
+# 没有进行代码改动，不应触发提醒。
+$hasEditEvidence = (
+    $input -match 'StrReplace|Write\s*tool|edit_file|file_write|write_to_file' -or
+    $input -match 'Created file|Modified file|Wrote contents' -or
+    $input -match '"tool"\s*:\s*"(str_replace|write|edit)"'
+)
+if (-not $hasEditEvidence) {
+    Write-Output '{}'
+    exit 0
+}
+
 # === 核心检查：是否有源文件比 changelog 更新 ===
 $extensions = @("*.py", "*.tsx", "*.ts", "*.css")
 $excludeDirs = @("node_modules", ".next", "__pycache__", "venv")

.cursor/skills/epee-orchestrator/registry.md

@@ -51,8 +51,8 @@
 
 ### project-launcher
 - **类型**: 项目级
-- **能力**: 一键在独立可见终端窗口中启动 Art Agent 前端和后端服务
+- **能力**: 一键启动 Art Agent 全部服务（Ollama + 后端 FastAPI + 前端 Next.js），自动检测已运行的服务并跳过
 - **触发场景**: "启动项目"、"运行项目"、"跑起来"、"打开前端和后端"、"启动服务"、"start"、"launch"、"run dev"、"启动前端"、"启动后端"
-- **输出**: 两个独立的终端窗口（前端 Next.js + 后端 FastAPI）
+- **输出**: Ollama 后台服务 + 两个独立的终端窗口（前端 Next.js + 后端 FastAPI）
 - **路径**: .cursor/skills/project-launcher/SKILL.md
-- **备注**: 项目专属 Skill；窗口必须可见，用户可直接查看日志和手动关闭
+- **备注**: 项目专属 Skill；Ollama 必须先于后端启动（Mem0 embedding 依赖）；前后端窗口必须可见

.cursor/skills/project-launcher/SKILL.md

@@ -22,13 +22,15 @@ description: >-
 
 | 组件 | 路径 | 启动命令 |
 |------|------|---------|
+| Ollama | 系统级服务 | `ollama serve` |
 | 后端 | `art-agent/backend` | `uvicorn app.main:app --reload --host 0.0.0.0 --port 8000` |
 | 前端 | `art-agent/frontend` | `npm run dev` |
 
 ## 前置条件
 
-后端需要激活 Python 虚拟环境（`art-agent/backend/venv`）。
-前端需要 Node.js >= 18。
+- 后端需要激活 Python 虚拟环境（`art-agent/backend/venv`）
+- 前端需要 Node.js >= 18
+- **Ollama 必须在后端之前启动**：Mem0 记忆系统依赖 Ollama 提供本地 embedding 服务（`nomic-embed-text` 模型），端口 `11434`
 
 ## 环境 PATH 须知
 
@@ -48,18 +50,43 @@ description: >-
 
 2. 确定操作系统和 Shell 类型（Windows / macOS / Linux）
 
-3. 启动后端（在独立可见终端窗口中）：
+3. 检查并启动 Ollama：
+   - 检测 Ollama 是否已在运行（请求 http://localhost:11434/api/tags）
+   - 未运行 → 启动 Ollama 服务，等待就绪
+   - 已运行 → 跳过
+
+4. 启动后端（在独立可见终端窗口中）：
    - Windows（PowerShell 或 CMD 均适用）：
      使用 `Start-Process` 或 `start cmd` 打开新的终端窗口
    - macOS/Linux：
      使用对应的终端打开方式
 
-4. 启动前端（在另一个独立可见终端窗口中）：
+5. 启动前端（在另一个独立可见终端窗口中）：
    - 同样在新的终端窗口中启动
 
-5. 确认两个服务正在运行，告知用户访问地址
+6. 确认三个服务正在运行，告知用户访问地址
 ```
 
+### Ollama 启动（跨平台通用）
+
+先检测 Ollama 是否已在运行，未运行则启动：
+
+```powershell
+# 检测（PowerShell）
+try {
+    Invoke-WebRequest -Uri "http://localhost:11434/api/tags" -UseBasicParsing -TimeoutSec 3 | Out-Null
+    # 已运行，跳过
+} catch {
+    # 未运行，启动
+    Start-Process "ollama" -ArgumentList "serve" -WindowStyle Normal
+    # 等待就绪（最多 10 秒）
+    Start-Sleep -Seconds 3
+}
+```
+
+> Ollama 启动后会常驻后台，不需要独立终端窗口。如果用户系统已将 Ollama 设为开机自启，
+> 则检测会直接通过，不会重复启动。
+
 ### Windows 启动命令
 
 **关键要求**：必须在**新的、可见的终端窗口**中启动，不能在 Cursor 内置终端后台运行。
@@ -118,6 +145,7 @@ osascript -e 'tell application "Terminal" to do script "cd FRONTEND_PATH && npm
 ## 访问信息
 
 启动完成后告知用户：
+- Ollama：http://localhost:11434（Mem0 embedding 服务）
 - 后端 API：http://localhost:8000
 - 后端文档：http://localhost:8000/docs
 - 前端页面：http://localhost:3000
@@ -129,3 +157,4 @@ osascript -e 'tell application "Terminal" to do script "cd FRONTEND_PATH && npm
 ### 已知必要检查
 
 1. **Node.js PATH 注入** — 本机 Node.js (`C:\Program Files\nodejs\`) 未加入系统 PATH，新开的终端窗口默认找不到 `npm`。启动前端时必须先将此路径注入到会话 PATH 中。
+2. **Ollama 必须先于后端启动** — Mem0 记忆系统依赖 Ollama 的 `nomic-embed-text` 模型做本地 embedding（端口 11434）。Ollama 未运行时后端能启动但对话会报 502 错误。启动流程必须在后端之前检测并启动 Ollama。