加了一堆模型和一堆功能

.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**: