ai-chatbot/docs/更新日志-2026-05-10至2026-05-14.md

Git 更新日志（2026-05-10 至 2026-05-14）

生成日期：2026-05-14
统计分支：main
统计范围：2026-05-10 00:00:00 至当前 HEAD
基准提交：510e3dc323f9cb501f390cb909941ec14d0b5c9d
当前提交：769862c（fix: improve detail stitch and model recovery）

总览

最近 4 天内，当前仓库共包含 29 个提交，主要集中在风格化详情替换、PSD 模板编辑、3D/世界查看器加载、AI 生图模型适配、画布生成结果同步等方向。

整体变更规模：

• 涉及文件：72 个
• 代码增量：5458 insertions
• 代码删减：1440 deletions
• 主要目录分布：lib 30 个文件、app 19 个文件、components 16 个文件、public 3 个文件

按日期提交数量：

• 2026-05-14：15 个提交
• 2026-05-13：5 个提交
• 2026-05-12：4 个提交
• 2026-05-11：5 个提交

核心更新摘要

1. 风格化详情替换与拼合切割流程增强

本轮更新对风格化页面的详情图替换能力做了持续强化，重点在“参考图拼合切割”“长图预览格式”“产品-only 替换”“下载速度”“模型恢复”几个方面。

主要变化：

• 新增/强化详情参考图拼合切割接口与前端弹窗交互。
• 支持将详情参考图按切片结果进入替换流程，并保留当前工作台预览。
• 优化详情替换下载链路，减少等待时间。
• 增加产品-only 详情替换能力，适配只替换主体产品、不重绘整张详情图的场景。
• 修复长图预览格式问题，降低拼合后预览比例异常的概率。
• 优化详情拼合与模型恢复逻辑，提升失败后恢复和继续处理的稳定性。

重点相关提交：

• 769862c：优化详情拼合与模型恢复
• 25d331f：优化风格化图片拼合与预览
• 147f939：支持 product-only 详情替换
• 000ac13：加速详情替换下载
• 5f90dbd：修复详情拼合长预览格式
• d0bb8b7：支持批量商品 ID 填充参考图
• da6cae9：收紧风格化详情 UI

2. PSD 模板编辑器持续修复

PSD 模板编辑器在这几天修复了图层交互、命中测试、预览层级、图层滚动等问题，整体目标是让模板编辑更稳定，减少误点、错层、无法滚动和预览不一致。

主要变化：

• 增强 PSD 图层编辑能力。
• 修复图层列表无滚动条问题。
• 改善图层交互命中区域，减少点不中或点错层。
• 修复 PSD 预览层级堆叠问题。
• 移除不合适的 PSD 图层位置控制，避免用户误操作或造成层级错乱。

重点相关提交：

• 4db458a：改进 PSD 模板图层编辑
• 1ed3184：增加 PSD 图层列表滚动条
• 5e78096：优化 PSD 模板图层交互
• a3a41ef：对齐 PSD 图层命中测试
• 96d9551：恢复 PSD 预览图层堆叠
• 359b964：移除 PSD 图层位置控制

3. 3D / 世界查看器加载与纹理修复

3D 相关模块本轮改动较多，集中解决浏览器加载远程模型、纹理、PBR 贴图、Tripo 资源代理、Basis 转码资源等问题，同时升级世界查看器体验。

主要变化：

• 恢复画布 3D 查看器的 PBR 纹理。
• 加快世界查看器加载速度。
• 增加 3D 归档资源代理，解决浏览器跨域/私有资源加载问题。
• 代理 Tripo 贴图资源，保证模型贴图能在前端稳定加载。
• 加入 Basis transcoder 资源，支持压缩纹理转码。
• 世界查看器升级到 Spark 2。

重点相关提交：

• 89ec01c：恢复 3D PBR 纹理
• dee8019：加速 world viewer 加载
• 2f5c2fc：代理归档 3D 资产供浏览器加载
• 5864e9f：代理 Tripo 纹理资源
• 95572bd：允许 Basis transcoder 资产用于 3D 纹理
• 1c935bf：升级 world viewer 到 Spark 2

4. AI 生图模型、价格与故障恢复

AI 模型层面，本轮主要围绕多服务商模型适配、图像比例参数、GPT Image 尺寸映射、模型健康恢复池和价格配置展开。

主要变化：

• 增加 AI 模型健康恢复池，便于模型失败后进行自动恢复或备用调度。
• 修复/适配 GRSai GPT Image 尺寸映射。
• 保留 GRSai GPT Image 参考图比例。
• 保留 Volcano 图片比例。
• 修复 BLTCY 图片比例参数传递。
• 适配 Ruxa Nano Banana 2 运行时。
• 增加折扣模型价格配置。

重点相关提交：

• 3ebe7db：增加 AI 模型健康恢复池
• 2cf2162：映射 GRSai GPT Image 尺寸
• 44d4a80：保留 GRSai GPT Image 参考图比例
• a0e303a：保留 Volcano 图片比例
• 40e7ecc：传递 BLTCY 图片比例参数
• f0cb1a4：适配 Ruxa Nano Banana 2 运行时
• 1b1ff65：增加折扣模型价格并修复实时 3D 媒体处理

5. 画布生成结果同步与输入体验

画布侧主要改动是让生成结果能更快同步到前端，减少“后端已完成但前端不显示”的体验问题；同时对图片意图判断、输入图尺寸和部分实时媒体处理做了修复。

主要变化：

• 画布生成结果立即同步。
• 改善智能体图片意图识别，减少模型选错工作流。
• 修复实时 3D 媒体处理。
• 修复登录与图片尺寸相关问题。

重点相关提交：

• 86b1ee9：立即同步画布生成结果
• dd4426d：改进智能体图片意图处理
• 1b1ff65：修复实时 3D 媒体处理
• 40848ff：稳定钉钉登录和图片尺寸

按日期提交明细

2026-05-14

提交	时间	说明	规模
769862c	16:35:16	修复详情拼合与模型恢复	7 files, +273/-152
359b964	16:22:59	移除 PSD 图层位置控制	1 file, +4/-107
96d9551	16:15:32	恢复 PSD 预览图层堆叠	1 file, +1/-2
5f90dbd	15:48:48	修复详情拼合长图预览格式	1 file, +5/-4
a3a41ef	15:48:13	修复 PSD 图层命中测试	1 file, +23/-2
5e78096	15:35:54	优化 PSD 模板图层交互	1 file, +78/-46
25d331f	15:28:09	优化风格化图片拼合与预览	4 files, +782/-387
95572bd	15:08:33	允许 Basis transcoder 资源加载 3D 纹理	1 file, +8/-1
1c935bf	14:57:56	世界查看器升级到 Spark 2	4 files, +96/-21
147f939	14:52:01	支持 product-only 详情替换	1 file, +78/-77
000ac13	14:36:37	加速详情替换下载	7 files, +658/-258
5864e9f	14:34:29	代理 Tripo 纹理资源	2 files, +3
2f5c2fc	12:04:45	代理归档 3D 资产供浏览器加载	2 files, +3
dee8019	11:46:16	加快世界查看器加载	6 files, +105/-15
89ec01c	10:48:39	恢复画布 3D PBR 纹理	4 files, +93/-14

2026-05-13

提交	时间	说明	规模
86b1ee9	20:36:08	立即同步画布生成结果	1 file, +202/-2
1b1ff65	20:02:52	增加折扣模型价格并修复实时 3D 媒体处理	20 files, +583/-145
d0bb8b7	18:37:03	支持批量商品 ID 参考图填充	2 files, +293/-6
da6cae9	18:33:43	收紧风格化详情 UI	2 files, +575/-397
f0cb1a4	12:25:16	适配 Ruxa Nano Banana 2 运行时	1 file, +39/-4

2026-05-12

提交	时间	说明	规模
40e7ecc	17:18:26	传递 BLTCY 图片比例参数	1 file, +7/-8
a0e303a	16:40:21	保留 Volcano 图片比例	1 file, +264/-17
4db458a	14:44:29	改进 PSD 模板图层编辑	5 files, +693/-60
44d4a80	14:36:56	保留 GRSai GPT Image 参考图比例	1 file, +52/-2

2026-05-11

提交	时间	说明	规模
2cf2162	21:03:53	映射 GRSai GPT Image 尺寸	4 files, +123/-6
dd4426d	20:31:17	改进智能体图片意图处理	9 files, +413/-60
3ebe7db	20:27:21	增加 AI 模型健康恢复池	7 files, +274/-17
1ed3184	15:01:27	增加 PSD 图层列表滚动条	1 file, +29/-8
40848ff	14:24:34	稳定钉钉登录与图片尺寸	5 files, +157/-78

高频改动文件

以下文件在最近 4 天内被多次修改，属于本轮迭代的重点区域：

• components/agents/AgentPsdTemplateEditorDialog.tsx：7 次，PSD 模板编辑器核心交互。
• app/(chat)/api/chat/route.ts：4 次，聊天/生图请求主链路。
• app/api/canvas/3d/model-proxy/route.ts：4 次，3D 模型与纹理资源代理。
• components/agents/AgentDetailReferenceStitchDialog.tsx：3 次，详情参考图拼合切割弹窗。
• app/api/agent-workflow/detail-stitch/route.ts：3 次，详情拼合切割后端接口。
• components/canvas/CanvasChatPanel.tsx：3 次，画布聊天与生成结果同步。
• lib/db/queries.ts：3 次，数据库查询与任务/模型状态相关逻辑。

重点影响面

用户侧

• 风格化详情替换流程的可用性明显增强，尤其是拼合切割、参考图替换、长图预览和产品-only 替换。
• PSD 模板编辑体验更稳定，图层滚动、命中、预览层级等问题被集中修复。
• 3D/世界查看器加载更稳定，贴图丢失和远程资源加载失败问题被重点处理。
• 画布生图结果同步更及时，减少等待或刷新才能看到结果的情况。

管理侧

• AI 模型配置能力增强，包括健康恢复池、价格配置和多服务商比例参数适配。
• PSD 模板和详情替换相关后台接口更完整。
• 钉钉登录回调和图片尺寸处理更稳。

技术侧

• 新增 app/api/agent-workflow/detail-stitch/route.ts，说明详情拼合切割进入了独立 API 化阶段。
• 新增 lib/ai/image-model-pricing.ts 和模型健康恢复相关逻辑，说明模型调度正在从“单次调用”走向“可配置、可恢复、可计费”的系统能力。
• 新增 public/three/basis/*，说明 3D 纹理加载开始引入浏览器侧转码资产。
• lib/ai/providers/* 多个供应商适配被修改，近期如果新增模型，需要重点检查比例、尺寸和参考图参数是否一致。

建议验证清单

上线或回归时建议重点验证以下路径：

• 风格化详情模式：搜索详情图、拼合切割、标记不处理、生成替换、结果预览、下载。
• PSD 模板：图层点击、文字编辑、预览层级、图层列表滚动、导出结果一致性。
• 画布生图：生成完成后是否自动显示结果，不需要刷新页面。
• 3D 查看器：不同来源的模型、PBR 纹理、Tripo 贴图、归档资源是否能正常加载。
• AI 模型：GRSai GPT Image、Volcano、BLTCY、Ruxa Nano Banana 2 的比例与尺寸参数是否符合预期。
• 登录：钉钉登录、回调页、图片尺寸处理是否正常。

注意事项

• 这份日志基于本地 main 分支 Git 历史生成，没有包含未提交文件。
• 当前统计范围从 2026-05-10 00:00:00 开始，但该日没有查询到提交，实际提交集中在 2026-05-11 至 2026-05-14。
• 当前工作区存在构建缓存/未跟踪文档类文件时，不影响本日志对已提交历史的统计。