# CHANGELOG

## Unreleased

- [修复] 管理台请求在会话刷新后会复用原幂等键，渠道生成测试会将平台显示模型 ID 转换为对应的供应商请求模型 ID，避免写操作重复或上游模型路由错误。
- [修复] 用户端画布裁剪、切分、旋转和放大遇到损坏图片时会在超时后失败并显示中文错误，不再永久卡在处理中。
- [修复] 用户端账户密码与两步验证请求现在会在弹窗关闭或返回上一步后失效，错误保留在对应弹窗内；找回密码验证码响应绑定发起时的账户目标，避免切换方式后串用结果。
- [修复] 用户端用户菜单改为由 TDesign 下拉组件维护唯一可见状态，路由切换后不会因外部状态与内部状态分叉而无法重新打开；两步验证长内容在窄屏弹窗内可滚动查看。
- [修复] 用户端画布裁剪/蒙版、资产文件选择和认证验证码请求现在会忽略过期异步响应；文件读取或上传失败会保留当前草稿并显示中文错误。
- [修复] 用户端画布放大和切分编辑器现在会忽略过期图片尺寸响应，快速切换图片时不会串用上一张图片的比例或网格尺寸。
- [调整] 图片创作和管理台对账的文件上传入口改用项目 TDesign Button，隐藏文件输入仅保留为浏览器文件 API 适配，上传校验与预览流程不变。
- [修复] 管理台和用户端窄屏抽屉/导航遮罩现在真正可点击关闭；管理台抽屉在手机宽度下保留遮罩区域，关闭后焦点回到触发按钮。

- [修复] 管理员与普通用户的认证引导请求可恢复缺少 CSRF Cookie 的旧会话，刷新成功后补发 CSRF Cookie，同时继续拒绝没有 CSRF 证明的业务写请求。
- [修复] 用户端命令式确认弹窗改用受控 TDesign Dialog 挂载，修复 React 19 下会话撤销、任务取消和结果删除确认弹窗不显示的问题，并保留取消、遮罩、ESC、加载和焦点回收行为。
- [修复] 共享 TDesign Button 适配器为普通按钮显式保留 `button` 标签，禁用态不再退化为无按钮语义的 `div`，同时继续保留链接按钮的自动标签行为。
- [修复] 管理台通用确认操作增加异常兜底，失败时保留确认弹窗并显示中文错误，避免冻结、重试和取消等操作出现未处理请求。
- [修复] 用户端确认弹窗适配器统一捕获异步回调异常，失败时保留弹窗并显示中文错误，避免会话撤销、任务取消和结果删除产生未处理 Promise。
- [修复] 用户端本地存储统计读取失败时显示中文错误并提供加载状态，避免浏览器存储异常产生未处理请求。
- [修复] 管理台编辑、审批、调账、退款和对账弹窗统一捕获异步失败并保留草稿，显示中文错误提示，避免请求异常导致操作无反馈。
- [修复] 用户端首页轮播不再展示旧产品或未纳入 V1 的 3D 宣传横幅，改用当前创作工作台的角色、场景和资产参考图并保留轮播切换。
- [调整] 普通开发环境不再自动注入模拟支付适配器，支付 fixture 仅在测试模式或显式测试模式下启用，避免管理台把模拟业务误认为真实配置。
- [修复] 用户端共享 TDesign Switch 不再生成嵌套 label，带文字开关继续支持文字点击、可读名称和受控状态。
- [修复] 管理台日志大板和详细日志在存在审计权限时按实际动作显示日志详情操作列，并保持右侧固定列宽。
- [优化] 用户端画布项目卡片补齐可聚焦的链接语义和 Enter 键打开行为，管理台品牌 Logo 改用共享 TDesign Button 并保留首页跳转。
- [新增] 用户端主工作台头部补齐浅色/深色主题切换入口，与画布使用同一主题状态和动画按钮。
- [修复] 用户端共享 TDesign 文本输入适配器补齐受控 Input/TextArea 的原生输入事件回写，避免认证、资产、设置和画布草稿输入后回弹为空。
- [调整] 用户端开发组件中心移除未纳入 V1 的三维渲染规划卡，避免展示超出当前产品范围的能力占位。
- [修复] 用户端画布互斥选项组的 ARIA 容器语义与实际的 TDesign 按钮状态保持一致，避免将 `aria-pressed` 按钮错误声明为 `radiogroup`。
- [优化] 用户端画布资源提及菜单补齐 Home/End 导航和垂直 listbox 语义，继续通过 `aria-activedescendant` 保持输入框与活动项同步。
- [优化] 管理台渠道分组的模型产品和供应渠道多选列表补齐 listbox 键盘导航，支持方向键、Home/End、Enter/空格和跳过禁用项，并保持多选状态与 Checkbox 一致。
- [优化] 管理台页面设置的主题色、主题模式和导航布局选项补齐 radio 语义、方向键、Home/End 和焦点轮转，颜色选择器支持键盘打开。
- [修复] 管理台主题色选择器改用明确的受控 `value` 属性，重新打开页面设置时会始终跟随当前主题色。
- [优化] 管理台页面设置抽屉关闭后会将焦点回收到触发按钮，登录页和后台布局的 ESC、遮罩及关闭按钮行为保持一致。
- [修复] 管理台全屏登录页现在也挂载页面设置抽屉，主题模式和布局设置不再因登录路由绕过后台外壳而失效。
- [修复] 共享 UI 包补齐 `@miragenflow/ui/button` 子路径，确保 Button 适配器可按约定的独立入口解析。
- [调整] 用户端任务历史列表改用共享 TDesign Table，保留任务链接、状态标签、模型名称、创建时间和移动端横向浏览行为。
- [优化] 用户端 Select 调用统一改用结构化 options，焦点管理器移除原生 select 分支，继续由共享 TDesign 适配层渲染下拉并保留键盘与受控值行为。
- [修复] 管理台结构化详情现在只渲染已登记的中文字段，未知嵌套字段不会显示为未映射内容。
- [修复] 管理台用户详情各 Tab 的动态表格同步过滤未登记字段，避免异常响应生成“其他信息”列。
- [修复] 管理台登录提交按钮改用普通布局容器，不再作为无名表单字段参与 TDesign Form 状态管理。
- [修复] 用户端资产 ZIP 导入会在取得文件后立即清空选择值，导入进行中或失败后重新选择同一文件也能再次触发。
- [修复] 本地文件快照的同步与异步保存现在使用统一原子写入和唯一临时文件，避免并发保存导致 `/api/ready` 进入不可用状态。
- [修复] 渠道分组任务模式选择器不再展示 `image`、`text` 等内部能力值，仅保留中文模式名称并继续提交真实能力标识。
- [调整] 管理台登录、业务表格、导航布局和设置网格改用共享 TDesign 入口，保持权限、动态列、拖拽排序和表单实例行为不变。
- [修复] 用户端主题化 Select 现在补齐 combobox/listbox 的 ARIA 关系、Enter/空格打开与选择、方向键/Home/End 导航、Escape 关闭和活动项反馈；管理端低风险 Dropdown、Space、Breadcrumb、Popup、日期范围与颜色选择器改用共享 UI 入口。
- [新增] 共享 UI 包新增 Card、Statistic 适配器，管理台看板、业务图表和统计卡片改用共享入口并保留现有样式契约。
- [调整] 管理台错误页、登录页、导航、移动菜单和业务页按钮统一改用共享 TDesign Button 适配器，并保留危险描边与原生表单提交语义。
- [优化] 共享 UI 包新增 Alert、Loading 适配器并迁移管理台告警与加载态；同时修复 Vite 开发模式下 TDesign 动画依赖的 CommonJS 解析，避免页面白屏。
- [修复] 管理台页面设置的主题与布局选项现在整项可点击并支持 radio 键盘操作，跟随系统主题在浅色偏好下也能正确生效。
- [优化] 渠道分组保存后同步刷新模型产品与渠道候选关系，分辨率配置列表改为紧凑矩阵，手机端横向表格更易扫描。
- [优化] 管理台渠道分组改为按“任务模式 → 上层模型产品 → 下层渠道池”配置，列表拆分模型 ID、产品名称、基础价格和分辨率矩阵，编辑时可直接勾选产品与渠道并查看归属、健康状态和层级关系。
- [修复] 渠道分组与模型产品绑定增加能力和归属一致性校验，模式切换不再静默移除产品，跨分组产品也不会被无提示迁移。
- [修复] 管理台模型、套餐、金币单位、存储策略和消息供应商表单现在在提交前校验数值边界与接口地址，非法输入会保留草稿并显示中文提示。
- [调整] 管理台登录页手机端与桌面共用透明左侧内容轨道，标题、表单和页脚按同一左边距构图，不再增加移动端内容容器。
- [修复] 管理台用户冻结、解冻和安全编辑现在使用用户资源版本校验并在事务内递增版本，旧版本提交返回 409，避免并发操作静默覆盖。
- [修复] 用户端 Tabs 的方向键、Home 和 End 切换现在会把真实焦点同步到新的选项，受控值未更新时也不会残留待聚焦目标。
- [修复] 画布图片、媒体和项目导入文件选择器会在读取文件后立即清空值，重复选择同一文件可以再次触发导入。
- [优化] 用户端插件式确认弹窗补齐对话框语义、打开时焦点进入、Tab 循环和关闭后焦点回收。
- [优化] 画布图片、音频和文本设置浮层统一补齐触发状态、对话框语义、焦点进入、Tab 循环及关闭回焦。
- [修复] 画布设置浮层不会再把 TDesign 下拉选项误判为外部点击，选择模型参数后浮层保持可用。
- [优化] 画布节点创建与连线创建菜单补齐方向键、Home、End 的循环焦点导航，并默认聚焦第一个可执行菜单项。
- [修复] 用户端复合字段改用带可访问名称的容器，不再用 `<label>` 包裹提示词引用菜单中的交互按钮。
- [修复] 管理台保存认证策略后会同步刷新当前管理员状态，MFA 启停判断不再依赖旧会话配置。
- [修复] 管理台登录路由现在直接挂载全屏登录主体，桌面与移动端都沿用左侧内容轨道，不再继承后台 Layout/Content 外层容器。
- [修复] 用户端受保护路由在认证初始化和会话失效期间不再短暂渲染旧导航壳层，统一显示完整中文加载/跳转状态。
- [修复] PostgreSQL 快照重载会等待排队中的持久化写入，并在可重复读事务中读取多表状态，避免旧快照覆盖新写入或拼接出混合版本。
- [修复] 管理台任务调用记录请求失败时保留详情抽屉，显示中文错误并提供可重试入口，不再只闪现提示后卸载。
- [优化] 用户端画布资源遮罩、侧栏悬停和设置入口改用当前画布主题令牌，快捷键与实时任务连接错误统一中文显示，并将复制节点的英文副本后缀归一化为中文。
- [修复] 用户端任务详情不再回退显示内部模型产品 ID，账户撤销登录设备增加确认弹窗；首页“我的资产”标签改为展示真实本地图片资产，空态入口与实际功能一致。
- [优化] 用户端首页轮播在手机端始终显示并垂直居中切换按钮，作品卡片补齐键盘焦点反馈，弹层遮罩改用浅深色主题令牌。
- [优化] 用户端登录、账户、任务、创作和预览页面统一移除负字距，独立首页示例改用真实创作素材替代渐变球体装饰。
- [修复] 首页作品灵感列表移除原型演示作品、虚构作者和统计数据，只展示当前用户真实资产并在空库时显示中文空态；审计日志分类改为准确区分 HTTP 小于 400 与异常/业务错误，消息供应商和模板配置写入补齐持久化。
- [修复] 画布创建菜单移到未缩放的覆盖层，平移或缩放画布时不再重复变换位置和尺寸，边界钳制按实际画布视口计算。
- [修复] 管理台页面设置抽屉关闭改为幂等状态更新，主题色选择器改用受控值，重复关闭或切换主题后不再回弹或残留旧色。
- [优化] 画布普通提示词和节点资源提及菜单补齐列表框、活动项和中英文无障碍标签，保持键盘选择与焦点关联一致。
- [新增] 管理台登录页接入本地优化的科技背景图，桌面沿用左侧表单构图，移动端去除多余容器并修正表单宽度。
- [修复] 管理台登录移动端内容层改为纯定位布局，继续沿用桌面左侧主体并保持窄屏左右留白对称，不再命中旧卡片容器样式。
- [修复] 管理台详情请求失败时保留详情抽屉并提供中文重试入口，页面设置与任务调用抽屉显式支持右上角、遮罩和 ESC 关闭。
- [优化] 画布音频/文字设置面板按视口宽度收缩，创建菜单与右键菜单补齐菜单语义、ESC 关闭和窄屏宽度约束。
- [优化] 管理台登录页移动端沿用桌面左侧内容轨道，移除顶部模糊带，短屏允许纵向滚动并让背景固定展示左侧构图。
- [调整] 用户端账户菜单改用 TDesign Dropdown 承载，保留资料视觉、登录态入口和游客态提示，并统一菜单项宽度、ESC 与外部点击关闭行为。
- [修复] 用户端受保护路由认证初始化时显示明确的中文加载状态，避免壳层短暂只剩导航而被误认为空白页。
- [修复] 渠道分组顺序改用 TDesign 支持的整行拖拽，调整优先级后会正确写入分组草稿。
- [修复] 管理台详情与任务调用抽屉增加加载态及关闭时的请求取消/代次保护，避免慢请求在关闭后重新打开抽屉。
- [修复] 用户端路由加载期间显示统一中文加载态，渲染异常提供重新加载与返回首页入口；设备标识在存储受限环境下改用内存兜底，避免认证页白屏。
- [修复] 开发预览路径显式绕过正式用户壳层，桌面和手机预览菜单统一左起布局；移动端账户、同步和任务详情列表取消强制宽度并支持内容换行，避免小屏横向溢出。
- [优化] 图片创作的高级设置改用主题化受控折叠栏，移除浏览器原生 details 控件，移动端展开与收起保持统一交互。
- [修复] 首页作品筛选现在会随本地资产列表变化重新计算，新增或删除资产后不会继续显示旧列表。
- [修复] 用户端资产同步失败时保留编辑弹窗和本地草稿，重试会复用同一条待同步资产；任务等待增加十分钟上限，超时会尝试取消并提示到任务历史查看最终状态。
- [优化] 详细日志收紧桌面列宽，状态、分类、行为、操作人和对象可在首屏完整查看，窄屏仍支持横向浏览。
- [修复] 用户端头像菜单与侧栏底部入口改为左对齐，避免继承通用按钮的居中布局。
- [修复] 用户端菜单与标题保持左对齐，组件中心隔离为开发预览；手机端画布工具栏允许换行、业务列表保持紧凑横滑，认证页适配动态视口，并补齐中文目录错误、任务错误码、文件格式和图片用量展示。
- [修复] 用户端资产页标题统一左对齐，画布与资产页移除内层滚动容器；滚动条和独立组件中心业务卡改用主题变量，避免浅色模式出现近黑色块或双滚动。
- [修复] 开发者组件中心独立挂载用户端主题变量并补齐根级路由加载占位，开发预览不再带正式侧栏，路由启动不再输出 HydrateFallback 警告。
- [修复] 共享用户端 Dialog/Drawer 增加显式 ESC 关闭，移动导航增加遮罩和 ESC 关闭，避免弹层或抽屉打开后无法退出并误操作底层页面。
- [优化] 用户端开关、图标按钮和错误提示改用主题语义色，浅色模式不再出现深灰轨道或白色悬停图标。
- [修复] 用户端侧栏导航强制使用左对齐布局；组件中心仅保留为开发环境独立预览，不再嵌入正式用户壳层或导航。
- [修复] 管理台列表、详情、调用记录、渠道探活和生图测试增加视图代次与主动取消保护，旧页面的异步响应不会覆盖新路由、关闭后的弹窗或当前选中的记录。
- [优化] 用户端画布资源提及输入、节点/侧栏操作、图片创作参考图、资产入口、参数选项和主题切换按钮，以及管理台移动菜单遮罩统一使用 TDesign 适配层，保留选区、拖拽、键盘和主题行为；可见业务源码不再直接渲染原生按钮或文本域。
- [修复] 用户端作品卡片移除无实际播放行为的伪按钮，浅色/深色主题改用媒体语义色，并让移动端收藏、分类和“一键同款”入口无需悬停即可使用；管理台渠道生成测试失败时保留请求路径、状态和中文错误，用户安全编辑后同步刷新已打开的详情。
- [修复] 用户端任务历史列表增加请求代次保护，快速切换状态或定时刷新时过期响应不会覆盖当前列表、加载状态或错误提示。
- [修复] 管理台用户序号与充值目标统一使用同一批次映射，充值改为主题化用户选择器；渠道优先级可编辑、支付适配器启用字段改为开关，布尔筛选统一显示中文，审计日志按时间可靠倒序。
- [修复] 共享 TDesign 开关补齐 `aria-checked` 状态，用户端与管理台弹窗增加遮罩点击兜底，确保点击遮罩、右上角、取消和 ESC 都能结束弹层。
- [调整] 将本轮长期目标收敛为唯一的“前后台真实可用与统一 TDesign”执行入口，明确用户端自定义视觉、管理端独立边界、OpenAI 三 Tab 渠道流程、阶段门槛和证据要求，并消除旧版分步渠道描述冲突。
- [修复] 共享 TDesign 文本输入适配器会过滤负数、非有限和小数长度属性，避免浏览器写入非法 `minLength`/`maxLength` 时触发异常并造成白屏。
- [调整] 本地一体化开发启动默认关闭后台演示数据，只有显式设置 `MIRAGENFLOW_DEMO_DATA=true` 才注入展示记录，避免真实渠道和业务测试被 mock 数据干扰。
- [修复] 用户端用户菜单改为受控弹层，支持点击展开、外部点击和 ESC 关闭，并在路由切换后自动收起；画布库、节点工具栏、快捷键、项目卡片和节点选中态改用画布主题令牌，避免浅深色硬编码不一致。
- [优化] 用户端顶部导航、移动导航、资产选择、生成中状态和 404 页面改用统一主题语义色，减少 Stone/黑白固定颜色在浅深主题之间的偏差。
- [调整] 将本轮前后台统一 TDesign、中文化、真实后台交互、OpenAI 渠道、ECharts 与响应式回归整理为可持续长任务目标，并补充分阶段验收索引；未完成人工验证的页面仍保持待测试状态。
- [调整] 长任务验收新增管理台列表请求代次保护要求，防止快速切换页面时旧响应串入当前业务列表。
- [修复] 管理台列表读取加入请求代次和取消保护，快速切换页面时过期响应不会串入当前业务列表或覆盖加载状态。
- [修复] 系统概览对缺失核心字段的响应改为中文空态，延迟无样本时不再绘制伪零值圆环，避免把不完整数据误显示为真实统计。
- [优化] 前端埋点改为本地空实现，不再注入第三方统计脚本、运行期配置脚本或外部页面访问上报，降低外联请求和首屏资源负担。
- [修复] 审计日志操作人映射统一为普通用户显示用户名、管理员直接显示邮箱，并兼容历史 `admin:` 身份标识。
- [调整] 管理台菜单隐藏尚未接入的消息供应商和消息模板页面，保留认证消息状态与后端适配边界，不把未完成配置暴露给管理员。
- [调整] 用户端与管理端接入同一锁定版本的共享 TDesign Provider 与主题变量桥接，用户端画布项目库开始使用共享 TDesign 按钮适配器，业务路由和管理台视觉保持独立。
- [优化] 用户端工作台、任务筛选和画布图片设置统一改用本地 Lineicons 与自定义下拉弹层，移除浏览器原生下拉框，并保留键盘、关闭和移动端交互。
- [优化] 用户端图片、音频、认证和账户页面的简单文本域统一改用共享 TDesign 文本域适配器，并暴露底层文本框引用，保留图片提示词的光标定位能力。
- [优化] 画布图片尺寸/数量和音频语速输入统一改用共享 TDesign 数字输入组件，并保留步长对齐、范围限制、空值和主题样式。
- [优化] 画布项目选择复选框改用共享 TDesign Checkbox 子路径并沿用画布主题；文件选择器和提及编辑器继续保留原生底座以支持浏览器文件 API、选区、滚动和输入法行为。
- [优化] 画布节点标题编辑框改用共享 TDesign TextInput，并通过适配层暴露真实输入节点，保留自动聚焦、全选、回车/ESC 和外部点击提交行为。
- [优化] 用户端导航、账户菜单、首页轮播控制、快捷入口和作品收藏按钮统一改用共享 TDesign 按钮适配层，并保留原有主题样式、语义图标和键盘焦点行为。
- [优化] 画布资产选择卡、项目标题入口、右键菜单和节点创建菜单统一改用共享 TDesign 按钮适配层，保留画布主题、坐标交互和关闭行为。
- [修复] 用户端与管理台登录、首页和画布的左上角品牌标题、主标题及副标题统一左对齐，避免文字标识居中造成视觉错位。
- [优化] 渠道健康单行测试改为独立结果弹窗，显示加载状态、实际请求路径、请求是否发起、模型数量和中文失败原因，并将最近一次测试结果持久显示在列表中；修复 ECharts 标题文字样式弃用警告。
- [修复] 总览 P50/P95 延迟改为双环图并正确显示无样本状态；渠道生图测试无论成功或失败都会返回真实请求状态、路径和测试时间，编辑渠道不会误清除独立的模型配置。
- [优化] 渠道未执行过测试时显示“未测试”，不再误显示“降级”；总览图表颜色跟随当前主题正确渲染。
- [新增] 余额账本、充值订单和支付事件页面增加基于真实列表数据的统计卡与 ECharts 图表，并补齐财务日期范围筛选。
- [优化] 批量渠道健康检查保留实际请求路径、是否发起和测试时间，健康检查与生图测试使用不同中文动作名称。
- [优化] 管理台请求增加超时、主动取消和网络错误中文提示，供应商异常时不会无限显示加载状态。
- [修复] 管理台日期筛选兼容日期组件返回的 Date、时间戳和日期字符串，避免选择日期后筛选失效。
- [修复] 画布项目页移除冲突的 `vh/svh` 最小高度约束，统一使用动态视口并隔离目录同步副作用；历史项目的异常视口值会自动归一化，避免热更新残留或无效缩放导致白屏和下半屏裁切。
- [优化] 窄屏画布侧栏遮罩不再压住底部工具栏，抽屉打开时仍可看见并使用画布控制项。
- [修复] 画布项目页在加载完成后重新连接尺寸观察器并补齐根节点视口高度，避免下半屏塌陷；窄屏侧栏、小地图、工具栏和缩放控件分层布局，顶栏折叠入口保持可用，画布操作更新增加无变化短路以避免渲染循环。
- [修复] 画布区域补齐父子层级的显式全高和尺寸帧合并，客户端初始化请求只执行一次，降低动态视口下半屏空白和会话刷新重复引起的渲染抖动。
- [修复] 用户端壳层改用动态视口与可收缩内容区，图片工具预览同步增加无变化短路，避免顶部留白叠加或尺寸抖动再次裁切画布并触发更新循环。
- [修复] 画布切换项目时会取消旧的资源恢复与生成请求并阻止旧状态回写新项目，持久化与视口保存只针对当前已加载项目，避免异步更新造成内容串线或重复渲染。
- [修复] 资产平台同步改为只在合并结果实际变化时写入，并避免提示上下文变化触发重复同步，降低资产页的更新深度风险。
- [修复] 管理台设置页的权限提示改为准确显示安全管理范围，存储策略更新增加版本校验，空数字输入不再误显示为 0。
- [修复] 模型产品下架时清空渠道组会显式解除旧绑定，避免停用后仍残留不可见的渠道配置。
- [优化] 账户中心的登录设备列表改为显示“当前浏览器 / 设备 N”等可读名称，保留服务端真实标识用于撤销会话。
- [优化] 管理台侧栏折叠后完全隐藏，窄屏菜单改为遮罩层覆盖；手机端业务列表继续使用紧凑表格并支持横向滑动，同时缩小页面与卡片左右间距。
- [修复] AI 创作与我的资产页面移除硬编码黑色业务容器并统一使用主题语义色；游客侧栏不再显示个人主页和退出登录。
- [优化] 用户端账户、任务和同步设置共用面板、统计卡与弹窗改用主题表面，浅色模式不再出现深色容器。
- [修复] 画布图片裁剪/切分预览改用当前主题背景，节点信息移除原始 JSON 视图并改为字段化展示；首页、样式预览和组件验收页去除非必要英文，演示按钮均提供明确交互。
- [优化] 前后台通用 UI 图标统一迁移为本地化 Lineicons 精选子集，校正撤销、停止、侧栏、分组和收藏等图标语义，放大图形与点击区域并移除 Lucide 及直接业务图标依赖，避免加载远程字体或全量图标目录。
- [修复] 用户金币调账表单补齐输入标签关联；本地自动审批失败时保留原申请并进入审批中心继续处理，避免重复创建调账申请。
- [优化] 用户列表、金币调整页和用户详情把增加/扣减入口直接放在余额旁；本地超级管理员确认后自动完成审批并刷新余额，正式环境继续保留双人审批。
- [修复] 金币调账、人工充值、退款与审批状态在同一事务内持久化，补齐金币批次、MFA 防重放、批准/驳回并发和幂等结果；本地 Docker 仅绑定回环地址并允许超级管理员自审批。
- [修复] 财务管理员新增独立的用户金币调整入口，并使用仅包含脱敏身份与余额的专用列表，避免调账能力被安全管理权限阻断。
- [新增] 管理台用户列表增加独立的增加金币和扣减金币操作，弹窗展示当前余额与审批后预计余额；本地超级管理员可执行自己的调账申请，生产环境继续要求双人审批。
- [修复] 管理台新增与编辑弹窗移除无名称 `FormItem` 对受控字段的错误接管，已保存的渠道基础信息、模型列表和模型映射现在会完整回填。
- [修复] 修复出站 DNS 固定地址回调在 `all: true` 模式下返回格式错误导致真实请求抛出 `ERR_INVALID_IP_ADDRESS` 的问题；现在可正常访问 OpenAI 兼容的 `/v1/models`。
- [调整] 渠道新增和编辑不再隐式请求上游模型列表，保存只校验基础信息与渠道模型；模型列表仅在用户点击“拉取模型”时请求。
- [调整] 渠道模型列表与模型映射完全拆分：拉取结果通过复选框批量添加为渠道模型，映射改为可选别名配置；开发环境不再自动生成展示用 mock 渠道。
- [修复] 模型映射输入行改用稳定的 React 行标识，连续输入不会因组件重建而失去焦点；请求地址示例统一使用 `example.com`。
- [修复] 渠道探活只在真正调用上游 `fetch` 前标记请求已发起；通用供应商和地址校验失败不再虚报健康，关闭或重开弹窗也不会被旧探活结果覆盖。
- [修复] 渠道模型探活增加独立加载状态、实际请求路径和中文失败原因，明确区分未发起请求、地址解析失败与上游接口失败。
- [修复] 渠道请求地址字段补充完整 URL 示例，API Key 只要求非空并取消 16 位最小长度限制，探测、新增、编辑和轮换凭证保持一致。
- [修复] 渠道弹窗 Tab 改为自由切换，基础信息、模型探测结果和模型映射由统一草稿状态保存，切换后不再清空，底部始终使用“保存/取消”。
- [调整] 管理台渠道新增与编辑改为三个 Tab 的统一弹窗：基础信息、拉取模型、显示模型与请求模型映射；非生产环境默认可联调本机/私网地址，显式设为 `false` 可关闭，生产默认继续拦截私网出站。
- [调整] 管理台新增用户弹窗收敛为用户名、邮箱、手机号和初始密码四项，套餐、可用模型、欢迎消息、状态及额度改为创建后的独立配置。
- [测试] 本轮完成服务端全量回归 84 项、用户端与管理台类型检查、管理台 lint 及前后台生产构建；构建仅保留分包体积提示。
- [修复] OpenAI 图片比例矩阵补齐 1.91:1、2.35:1 和 21:9 的 1K 尺寸校验，管理台新建模型的 4K 默认预设改为符合平台上限的 3840×2160。
- [测试] OpenAI 图片端点新增 69 项服务端回归覆盖，包含比例换算、参考对象过期/撤销、异常图片 URL、模型能力声明、幂等请求头和未知任务人工对账元数据。
- [修复] OpenAI 图片、文本和音频请求统一使用标准 `Idempotency-Key`，未知结果会在用户端显示为“待对账”并保留任务历史入口，避免重复提交或误报普通失败。
- [修复] OpenAI 图片供应商适配层补齐参考图序号、缺失引用、50MB 大小和默认参考图提示的兜底校验；仅上传参考图时也允许提交任务。
- [修复] 管理台安全设置入口、审批自审判断和审计分类/操作人中文兜底修正，退出登录不再误跳转到旧路由。
- [优化] 管理台登录、加载和写入失败提示统一中文兜底，认证请求不再对登录接口误触发会话刷新，登录背景移除模板英文装饰。
- [修复] 管理台图表空数据、深色主题文字和模型名称显示；首页统计卡统一传入数值，避免指标被误显示为 0。
- [新增] 管理台系统概览、渠道健康、任务中心、实时指标和日志大板统一接入 ECharts 图表；审计拆分为日志大板与详细日志两页，并增加正常/异常状态统计。
- [优化] 管理台左侧菜单改用语义化差异图标，单项分组直接显示页面入口，减少重复展开层级。
- [优化] 审计日志改为按业务分类展示中文行为和可读操作人名称，管理员仅显示邮箱、普通用户显示用户名，并移除没有实际按钮的操作列。
- [优化] 审计日志默认按最新时间倒序展示，分类、对象和来源字段统一使用中文；业务标识保留原值。
- [调整] 用户列表的 ID 表头仅显示当前列表内的纯数字序号；模型、套餐、渠道等其他标识保留真实值，避免把业务 ID 误显示成编号。
- [优化] 管理台列表补充可用模型名称、余额图标和中文状态兜底；未知状态与权限统一使用中文兜底。
- [修复] 管理台新增资源不再提交空 ID，套餐、用户和模型表单增加服务端约束对应的中文校验，财务配置入口与权限一致，供应商和模板编辑增加版本保护。
- [新增] 渠道管理支持 OpenAI 图片端点供应商方式、模型探测和 1K/2K/4K 分辨率模型映射，图片任务支持文生图、参考图生图、透明背景、格式选择和结构化结果信息。
- [修复] OpenAI 图片请求固定使用渠道配置的模型映射，避免任务参数覆盖分辨率对应的上游模型；开发脚本启动时预留端口，确保前台、管理台和提示地址一致。
- [修复] OpenAI 图片参考图上传改用 multipart，中文长序号引用按完整名称解析，画布比例不再写入非法尺寸，参考图保真度默认改为高。
- [修复] OpenAI 图片端点现在按 `image[]` 顺序提交参考图，并校验 Base64/URL 返回的真实图片格式；未知任务结算失败会保留可对账 attempt，避免预留金币与任务状态脱节。
- [优化] 管理台渠道编辑支持复用已保存凭证探测 `/v1/models`，新增模型产品分辨率矩阵，人工成功对账改用真实图片 multipart 上传并自动关闭成功弹窗。
- [修复] 管理台全页面统一使用中文字段和结构化数据展示，余额不再输出原始 JSON，内部资源编号按列表顺序显示为数字，并过滤嵌套凭证、哈希和幂等标识。
- [优化] 修复管理台限流窗口百分比误显示、设置面板英文文案和审计动作/状态未翻译问题，补齐所有业务字段的中文名称。
- [修复] 管理台系统概览统计卡在指标缺失时不再向 TDesign Statistic 传入 undefined，避免登录后 Dashboard Base 渲染白屏。
- [优化] 管理台分页隐藏无意义的总条数文案，新增和编辑弹窗显式支持遮罩、ESC、取消及右上角关闭，渠道密钥字段统一使用中文。
- [优化] 桌面端登录/注册表单区域改为对称留白并整体上移，品牌中英文标题、表单和底部安全提示在视口中更接近水平垂直居中，减少顶部空白。
- [调整] 用户菜单下拉在未登录状态也显示资料占位容器，展示访客提示和“登录工作台”入口；登录后切换为用户信息与账户操作。
- [优化] 用户菜单下拉改为精致的资料占位容器，保留未来图片插槽、用户身份信息和账户/任务/退出操作；移除直接铺满的头像大图，适配雾紫玻璃风格与窄屏宽度。
- [优化] 通知悬浮窗改为响应式短面板，限制最大高度并适配视口剩余空间；无通知和有通知时均不再占据过高页面区域，原有圆角保持不变。
- [优化] 用户端侧边导航统一加宽至 224px，并轻微压缩导航项与底部链接高度；桌面端内容区和移动端抽屉同步使用同一宽度。
- [调整] 密码登录改为单一“账号”输入框，自动兼容邮箱、手机号和用户名；邮箱注册/手机号注册与手机号验证码登录仍保留各自的方式切换。
- [修复] 管理台路由从绝对站点地址构建时将 Vite base URL 规范化为路径 basename，修复 `/admin/dashboard/base` 在 site 构建下路由不匹配导致的白屏。
- [新增] 用户认证支持密码登录（邮箱/手机号/用户名）与手机号验证码登录；注册支持邮箱/手机号分流并在后台独立控制两种注册验证开关。
- [新增] 迁移 `MiragenFlow-front` 用户控制台视觉基础：新增深色工作台壳层、响应式侧栏、Hero/作品灵感组件和作用域 token；首页作品流改为读取真实资产库，模型广场入口暂不进入用户侧导航。
- [调整] 用户端移除作品搜索框与模型广场入口，登录/注册/验证/重置密码及图片/音频 AI 创作页统一改用组件中心的表单、反馈、状态和结果卡视觉，真实认证与任务 API 保持不变。
- [调整] 登录注册页收敛品牌展示，仅保留紧凑标识，避免宣传文案压过认证表单。
- [调整] 登录奖励入口文案统一改为“登录免费送积分”，恢复原有动效与奖励卡样式，仅替换奖励文字，避免继续使用“算力”表述。
- [调整] 登录注册页紧凑品牌标识恢复为“MIRAGEN FLOW / 元境幻生”，保留原品牌识别同时不恢复大段宣传语。
- [调整] 恢复登录页“MIRAGEN FLOW / 元境幻生”原有的蓝色小字字体与字距样式，避免紧凑布局改变品牌视觉。
- [调整] 登录与注册页移除 MF 图标及顶部品牌容器，将品牌文字放到“欢迎回来/开始你的创作”标题上方并适度放大。
- [优化] 登录奖励 SVG 将“免费”单独使用高亮渐变并拉开字距，扫光动画下文字占位更完整、重点更清晰。
- [优化] 登录奖励按钮重新分配三段文字的宽度与左右间距，并放大“登录 / 免费 / 送积分”，确保整块光效区域被完整填充。
- [优化] 登录奖励“免费”前后采用对称间距和固定文字宽度，保证高亮词在扫光动效中保持居中、填充协调。
- [调整] 登录奖励入口移除大尺寸悬浮奖励卡与透明点击覆盖层，按钮改为透明底白色扫光，移动端按比例缩小，避免黑色底和遮挡内容。
- [调整] 用户头像访客浮图和“加入设计交流群”容器暂时移除，移动端隐藏左侧品牌 logo，仅保留折叠菜单按钮，避免窄屏头部拥挤。
- [调整] 登录奖励按钮取消 GIF 扫光，仅保留 CSS 渐变边框与透明背景，并增加文字阴影提升浅色主题下的可读性。
- [修复] 登录奖励渐变改用遮罩边框实现，确保渐变只出现在边框区域，按钮中心保持完全透明。
- [优化] 登录奖励文字改为与“作品灵感”标签一致的品牌字体、字号和字重，仅保留“免费”高亮，避免粗体导致文字拥挤。
- [调整] 自由画布与一键成稿入口改为使用图片铺满卡片，保留文字叠加和原有跳转，取消原来的纯 CSS 渐变卡片底。
- [修复] 移动端轮播下方的两个工具入口恢复与上方横幅相同的宽高比例，避免四个容器宽度一致但高度不齐。
- [调整] 首页移动端广告轮播和活动图片改用与桌面端一致的原始宽高比例，取消固定高度裁切，保证手机端完整显示素材。
- [新增] 增加 `/style-preview` 用户端配色候选预览页，提供暮光蓝灰、暖纸钴蓝、雾紫玻璃和松石石墨四套方案，暂不写入正式主题。
- [调整] 用户端正式采用“雾紫玻璃”配色：以淡紫背景、白色玻璃卡片和紫色/珊瑚渐变为主，统一首页、登录注册、创作、画布和资产界面的明暗主题。
- [优化] 管理台列表增加按业务维度、状态和日期范围筛选；系统概览增加近 7 日任务趋势与运行告警；数据请求权限不足时进入带角色、所需 scope 和 requestId 的可恢复 403 页面，错误页区分重新登录与切换管理员。
- [修复] PostgreSQL 任务 dispatch worker 在跨实例本地缺少任务投影时按 task_id 回载持久任务后再入队，避免 outbox 长期停留在待重试状态。
- [修复] PostgreSQL 快照写入现在携带捕获时的不可变 revision，避免 direct lease/outbox 更新后旧的异步快照读取新 revision 并回退租约状态。
- [修复] 消息 outbox 支持业务幂等键、Provider `Idempotency-Key` 和 PostgreSQL 发送期租约续期，降低重启窗口的重复发送风险。
- [新增] WebDAV PG worker 增加远端请求期间的 job 租约续期，避免长时间 PUT/DELETE 被其他实例重复认领。
- [修复] PostgreSQL 消息 outbox 在供应商请求期间增加带 owner 的租约续期，避免长请求被第二个 worker 抢占。
- [修复] 任务 worker 心跳现在同时续租 Redis/内存队列与 PostgreSQL generation_tasks 行，过期任务恢复按事务重载并进行租约校验；内存队列拒绝过期 ack/nack，WebDAV 保留期扫描改用 PostgreSQL 行锁入队并按终态重试。
- [修复] PostgreSQL dispatch、消息 outbox、WebDAV 完成接口增加 lease_expires_at fencing；manifest 写入按版本递增，旧 worker 不能覆盖新 manifest 或继续确认过期租约。
- [优化] 管理台供应商消息页面不再注册可直达路由，统一进入 404；列表增加客户端分页，用户调账按钮仅对 finance scope 展示，渠道创建正确提交数值优先级。
- [修复] PostgreSQL WebDAV worker 完成任务时在同一租约事务持久化文件、manifest、保留状态、归档状态和冲突副本，重启后不再丢失远端同步结果；任务 dispatch 支持并发槽并避免缺失本地投影时误确认。
- [优化] 管理台模型产品新增“创建后上架”开关、批量探活按渠道汇总成功/失败、只读管理员可查看任务详情和调用记录；错误页重新登录/切换管理员会清理当前会话。
- [调整] 管理员两步验证设置/验证接口仅在系统增强开关开启后可用；关闭开关会同步清理账户恢复状态，预览登录继续只显示邮箱和密码。
- [新增] 管理台渠道、渠道分组和模型产品增加编辑抽屉，渠道健康支持全部探活，审批列表增加状态标签；列表首列固定、认证消息目标哈希不再返回，管理请求错误保留 409/422/503 上下文并允许重试。
- [修复] 认证增强开关现在严格控制登录挑战：管理员 CAPTCHA 使用独立开关，关闭普通用户 MFA 后会清理遗留挑战；刷新会话、审批 MFA、审计保留和普通用户界面均与开关状态一致。
- [修复] 修复队列并发 claim 串任务、Redis 活跃租约被重复入队、PostgreSQL 验证码快照加载崩溃和消息第五次重试卡死；管理员审计与用户详情继续保持脱敏。
- [新增] 管理台任务中心增加脱敏任务详情抽屉（输入、输出、attempt、事件时间线），审批中心增加带原因和版本校验的驳回流程。
- [新增] 管理台系统设置独立于存储策略，支持版本化 If-Match、认证增强开关、限流、队列和审计保留配置；用户详情新增账户、会话、任务、账本、权益和审计分 Tab。
- [修复] 管理员登录接口同时接受管理台表单使用的 `account` 和 API 契约的 `email` 字段，修复前端填写邮箱密码却返回“账号或密码不正确”的问题。
- [修复] 管理台新增/配置弹窗统一接入套餐、金币单位、换算、支付适配器、存储、消息模板和管理员安全操作，避免确认后静默无动作；用户创建支持套餐、并发、每日上限、可见模型和欢迎消息，渠道健康增加单项探活。
- [新增] 管理台用户详情支持一次性重置密码、重发认证消息、会话与套餐权益查看；系统概览补充 P50/P95、渠道/模型、消息和支付异常指标。
- [优化] 管理台失败写操作保留当前弹窗内容，409/503 等错误可直接重试；认证消息与套餐描述改用多行输入，能力和延迟字段统一摘要显示。
- [调整] 充值订单新增失败标记和退款申请交互；高风险审批仅在管理员 MFA 增强开关开启时要求动态码，默认邮箱密码登录不再被额外字段阻断。
- [新增] 管理台开始落地七组二级菜单、可恢复权限页、用户/渠道/分组/模型/价格新增弹窗及认证消息详情重试。
- [修复] 本地预览会以配置覆盖旧管理员快照，确保 `admin@admin.com` / `admin` 登录不会被旧密码、角色或 MFA 状态阻断；旧会话缺少 scope 时 `/admin/me` 会按角色补齐权限。
- [新增] 管理员可从管理台新增普通用户，初始密码只在创建成功响应中显示一次并写入审计。
- [新增] 新增 `goal.md`，明确管理台重构的页面、布局、业务闭环、实施阶段、验收标准和目标引导提示词。
- [规划] 新增管理台一级/二级菜单、页面 SSII 线框、权限状态、渠道到模型产品交互和逐页验收基线，详见 `admin-plan.md`。
- [调整] 本地预览默认管理员账号改为 `admin@admin.com`，密码改为 `admin`，管理员 MFA 与人机验证码仍默认关闭并可由环境变量重新开启。
- [调整] 普通用户默认关闭邮箱/短信验证、人机验证码和 MFA，注册登录仅需账号密码；相关能力保留为后台可配置增强开关。
- [修复] 本地一体化预览默认使用受保护的文件快照保存账户状态，避免服务端热重载后已创建用户被清空并误报“账号或密码不正确”。
- [新增] 任务结算、释放、未知对账和支付订单/webhook 统一经过 Store 事务边界；新增支付请求指纹迁移，PostgreSQL 重载后继续执行幂等校验。
- [调整] 管理员登录默认仅需邮箱和密码；管理员 MFA 与人机验证码改为默认关闭的后台增强开关，启用后才进入额外验证流程。
- [新增] 账户中心增加已登录修改密码、其他会话撤销和两步验证配置入口；账户注销请求进入异步匿名化清理流程。
- [测试] 增加账户密码修改、旧会话撤销和注销匿名化回归测试，服务端回归测试达到 49 项。
- [修复] 管理台创建已上架模型时校验渠道组绑定并修复请求体重复读取，前台登录、注册和密码重置保留安全 redirect。
- [修复] WebDAV 保留期延长会取消尚未执行的过期删除任务，worker 派发前再次校验最新保留时间。
- [修复] PostgreSQL dispatch outbox 在 worker 事务重载 Store 后重新读取行，避免使用旧对象把已发送任务恢复为 leased；重载 smoke 已确认最终状态为 sent。
- [修复] PostgreSQL 快照 revision 在空库首次写入时启用 fencing，持久化失败后队列可恢复，并修正 bucket 关系表投影；新增公网出站地址解析、DNS 固定、禁止重定向和 provider 基础路径保持。
- [修复] WebDAV 条件写入、冲突副本和归档/删除任务携带明确 intent，服务端与前端可区分同步排队状态；Docker 文档移除旧的单容器无限画布镜像说明。
- [测试] 新增出站 URL 私网拒绝、固定公网地址、WebDAV 到期清理、Store 事务回滚和部分结算 release 测试，当前服务端回归测试达到 50 项。
- [新增] 增加可视化套餐完整配置字段、organization/team nullable scope 预留字段，并在 WebSocket 心跳和消息路径实时校验会话族撤销。
- [修复] 任务首次提交等待持久化快照完成后再投递队列，幂等重放不重复 enqueue；worker 在确认终态持久化后才 ack Redis，并补齐 PostgreSQL 余额版本、任务 lease、attempt 对账和输出计费字段投影。
- [修复] 上传直传、presign 和 complete 接口统一要求 Idempotency-Key，重复请求返回原上传对象；上传幂等键写入 PostgreSQL 唯一索引。
- [新增] PostgreSQL 增加任务 snapshot 与 dispatch outbox 迁移，队列投递状态和任务完整输入快照可在重启后恢复。
- [新增] 生产 PostgreSQL 任务创建路径使用余额账户/ bucket 行锁、原子 reserve ledger、任务事件和 dispatch outbox 事务，公开幂等键仍由任务 snapshot 校验。
- [修复] 验证码挑战改为服务端哈希、IP/设备/目标绑定、失败计数和一次性消费；用户 MFA、管理员 MFA 与人机验证码均由后台增强开关控制，预览默认关闭。
- [调整] 首页删除演示作品、视频/动画/3D宣传入口和假对话框，改为实时公开模型目录与图片、音频、画布、任务工作流入口。
- [新增] 资产库补齐音频文件创建、编辑、播放、导入导出和本地媒体刷新回载；WebDAV 离线写入显示队列状态并支持冲突副本、归档和删除任务。
- [调整] 管理员退款改为二次审批并要求审批 MFA，审计 before/after 递归脱敏，新增管理员 MFA 管理页面和统一权限校验。
- [测试] 新增 10 项 V1 回归测试，覆盖 MFA recovery 接口、会话撤销、套餐权益、审批调账、资产归属去重、WebDAV 保留期、过期 bucket、渠道路由快照、管理契约别名和充值订单状态转换。
- [修复] access token 绑定会话族，撤销设备会话后旧 token 与 WebSocket 订阅立即失效。
- [新增] 补齐管理端金币单位、换算规则、价格规则、存储策略、用户和渠道组的契约写方法及充值订单详情查询。
- [修复] WebDAV 文件写入先缓存并复用单次请求体，确保合法写入路径和内容按预期进入同步记录。
- [修复] 过期 bucket 即使可用余额已被其他流水耗尽也会写入实际扣减额，并保持余额与账本一致。
- [修复] 统一导航文案键并补齐设备绑定验证码流程，注册验证、密码重置和 MFA 登录可在同一浏览器设备完成。
- [新增] 补齐用户套餐查询与登录设备会话撤销 API，返回稳定会话标识并保持会话族撤销审计。
- [修复] 资产保存校验任务及输出归属，重复保存同一任务输出返回原资产而不创建副本。
- [修复] 渠道分组顺序写入任务路由快照，套餐权益按实际 plan bucket 余额校验，过期 bucket 追加幂等 adjustment 流水。
- [新增] WebDAV manifest 支持策略上限内的用户保留期延长，并在服务端保存延长状态。
- [测试] 完成临时 PostgreSQL/Redis 生产配置 smoke、迁移、持久化重载、队列租约和同源路由核验。
- [修复] 用户充值订单响应不再暴露内部支付适配器标识。
- [修复] Docker 前端与管理台构建阶段补齐共享 contracts 包，避免生产镜像构建时找不到本地依赖。
- [优化] PostgreSQL 仓储在同一事务中投影核心用户、余额、目录、渠道、任务、账单、上传、资产、消息和 WebDAV 配置关系表，并保留兼容快照用于未映射扩展字段。
- [优化] PostgreSQL 运行时投影扩展到认证挑战、会话族、管理员幂等/审批、消息与支付供应商、WebDAV 文件/重试任务、对象和密钥引用，新增第十二个 V1 迁移。
- [修复] 管理员 MFA 密钥、恢复码摘要和启停状态纳入加密持久化，服务重启后保持独立管理员认证状态。
- [修复] WebDAV 设置刷新后从服务端恢复脱敏状态，已保存连接可继续测试和同步且不会把密文凭证写入浏览器持久化。
- [新增] 套餐购买订单接入 mock/adapter 签名 webhook，按购买时权益快照幂等到账并写入独立套餐支付事件表。
- [修复] 支付 adapter 支持失败/退款状态校验，退款按原到账 bucket 写入幂等 refund 流水；管理员 MFA 二次登录不再重复要求已消费 CAPTCHA。
- [新增] 用户套餐目录详情和权益查询返回公开模型 ID，任务响应不再回显内部模型产品 ID。
- [修复] 管理台支付适配器凭证改为服务端密文保存，列表和写入响应只返回配置状态。
- [修复] 管理员 MFA challenge 的 CAPTCHA 豁免严格绑定管理员会话，阻止伪造 challengeId 绕过人机校验。
- [修复] 收紧任务未知结果、余额释放/结算、staging 保留期和渠道 SSRF 校验，避免未知任务冻结金币或提前删除结果。
- [调整] 管理台补齐模型产品、价格、渠道顺序、消息供应商/模板和存储策略的真实写入入口；生产 Compose 改为缺少密钥时直接拒绝启动。
- [优化] 公开任务请求优先使用后台发布的公开模型 ID，统一构建脚本加入服务端与管理台类型检查，模板快照移至设计参考目录。
- [修复] 收紧生产 CAPTCHA、用户 MFA、WS refresh 会话、3D 目录、WebDAV 路径和管理路由错误处理，并让持久化适配器在成功响应前完成提交。
- [新增] WebDAV manifest 增加版本、checksum、tombstone 和冲突副本；消息 outbox 支持加密目标与通用 HTTPS provider adapter。
- [修复] 补齐租约心跳、Redis Lua claim/renew/ack/nack 与死信、未知结果自动对账、WebDAV 离线重试、保留期操作和上传扫描外部适配边界。
- [新增] 扩展管理台真实业务入口：渠道探活/凭证轮换、模型分辨率、套餐发布回滚、支付适配器、存储策略、用户详情/调账、WS 指标和共享管理员 DTO。
- [修复] 修正 PostgreSQL 专用连接事务、文件快照原子写/版本校验、provider 输出 MIME 安全、结算失败终态和过期任务重试状态。
- [清理] 删除后台模板 mock/README 残留和前台供应商/自定义脚本死配置文案，更新当前实现摘要与验收状态。
- [修复] 完善 PostgreSQL 领域行投影、迁移互斥锁、revision 冲突检测、持久化故障可观测性，以及 WebDAV manifest ETag 冲突、删除重试和归档队列。
- [调整] 用户端注册验证完成后展示两步验证导入信息；移除前台版本更新面板和管理台未使用的模板结果资源。
- [修复] provider 已提交任务支持调用取消适配器，迟到响应保持取消终态；unknown attempt 保存 provider request ID 以便后续对账。
- [测试] 新增管理员 RBAC/敏感字段脱敏与 WebDAV If-Match 冲突自动化测试，服务端专项测试达到 16 项。
- [新增] 完成 V1 服务端网关关键闭环：独立管理员 audience、多管理员 MFA、审批式人工充值、套餐购买/权益快照、上传 quarantine 扫描、WebDAV manifest 版本和异步拆分/放大任务。
- [调整] 清理 TDesign mock/示例管理页面与用户端扩展插件入口，统一使用真实业务 API、公开模型目录和同源任务 WebSocket。
- [修复] 修正余额 bucket 按 reserve allocation 精确释放/结算/退款，防止管理员重试免费生成、用户自助伪充值和重复管理写入。
- [新增] 补充一期用户端、管理端、系统请求、数据关系和整体架构的 ASCII（SSI）与 Mermaid 图示，统一维护于 `system-diagrams.md`。
- [调整] 收敛一期决策：验证码防刷、用户/管理员两步验证、金币单位与换算、人工/mock 充值、异步队列与 WebSocket、本地+WebDAV、套餐权益、V2 内容治理和模板目录边界。
- [新增] 建立 `packages/contracts` 公共 API/任务事件契约与 `server` 同源网关基础，提供认证、模型目录、余额预扣、任务幂等和 WebSocket 事件骨架。
- [调整] 开发编排新增服务端进程，前后台 `/api` 请求统一代理到本地网关，移除 TDesign 模板对外部示例 API 的开发环境依赖。
- [调整] 前台生成链路统一改为平台任务网关，删除供应商配置、自定义调用脚本和远程模型配置入口，保留 WebDAV/本地存储设置。

## v0.0.1

- [新增] 拉取 TDesign React 后台模板至 `admin/`，通过统一的 3000 端口提供前台 `/` 和后台 `/admin/`，并补充一体化开发与构建脚本。
- [调整] 移除右上角 GitHub 入口及其前端组件代码。
- [调整] 项目品牌统一为 MiragenFlow / 元境幻生，同步更新前端标题、配置与导出标识、WebDAV 默认目录、本地存储命名空间和内部插件 SDK scope。
- [调整] 收缩产品范围，移除独立图片/视频工作台、全部视频能力、远程提示词、Local Agent/Codex/MCP/Skill、Codex App 与远程插件市场，保留首页、项目库、无限画布、资产库、图文音生成、图片工具、WebDAV 和内部插件 SDK。
- [优化] 同步收缩后的文档导航、插件 SDK 说明和前端依赖，移除已下线功能的死链与构建依赖。
- [修复] 统一开发启动时强制重建后台 Vite 依赖缓存，避免后台入口因过期预构建依赖返回 504 进入白屏。

## v0.16.0 - 2026-08-18

- [新增] 提示词来源新增 Freestylefly GPT Image 2 内置来源。
- [调整] 移除火山方舟协议及 Seedance 专用适配。
- [调整] 画布默认使用移动工具，可直接拖动元素或空白画布，按住 Control 可临时框选节点。
- [调整] 双击多图节点统一放大预览图片，仅通过右上角张数按钮展开或收起图片组。
- [修复] 文本节点和生成配置新增独立的文本生成次数，默认一次且不再误用生图数量。
- [修复] 节点缩放期间暂停渲染提示词面板，避免导入图片后立即缩放导致页面崩溃。
- [优化] 生图、视频和音频请求遇到跨域拦截时明确提示需要通过自己的服务转发。
- [优化] 图片工具条默认仅显示图标并移除图片、文本编辑入口，单击图片、文本或视频节点直接打开下方提示词面板。
- [优化] 画布多图展开状态改为由用户主动控制，操作画布其他区域时不再自动收起。
- [优化] 展开的多图子图支持双击直接放大预览，无需先设为主图。

## v0.15.1 - 2026-08-07

- [调整] 项目开源协议更换为MIT，允许所有人免费用于开源、闭源和商业场景。

## v0.15.0 - 2026-08-07

- [新增] 画布节点提示词支持弹窗放大编辑和实时同步。
- [新增] 配置页新增本地存储、站点配额与对象仓库占用信息。
- [新增] 画布多图支持失败项重试与删除、创建副本和单图下载。
- [新增] Agent 输入框支持通过 `/` 快速选择 Skill，并通过 `@` 将画布素材按光标位置插入正文，输入及发送后均支持悬浮预览。
- [优化] 画布新增选择与移动模式，并支持 Control 或空格临时反转工具。
- [优化] 画布多图合并为可展开的单节点，支持实时状态、主图切换和四列布局。
- [优化] 从左侧元素列表定位节点时，自动缩放上限调整为 100%。
- [优化] Agent 用户消息元数据改为独立的版本化文件存储，刷新或重启后仍可恢复附件、Skill、画布引用及本地缩略图，未知存储格式不会被覆盖。
- [修复] 关闭输入面板后保留图片与文本节点的编辑提示词。
- [修复] 点击画布空白处时同步收起节点工具条和输入面板。
- [修复] 空格键切换工具时不再误触当前聚焦的按钮。
- [修复] 清理本地图片时保留工作台生成历史引用的文件。
- [修复] 修复画布多图切换主图、重试和调整尺寸时的缩放与状态异常。
- [修复] 统一画布多图操作按钮在不同主题下的颜色与对比度。

## v0.14.0 - 2026-08-05

- [新增] 文档站支持英文默认与简体中文切换，正文、导航、搜索及 LLM 文档接口按语言独立展示。
- [新增] 前端搭建中英文国际化框架，支持从右上角一键持久化切换全局导航、首页、配置中心、Ant Design 和日期组件语言。
- [修复] 统一 Ant Design 下拉菜单与选择器在浅色、深色主题下的弹层及交互状态颜色。
- [修复] Agent 顶栏在英文模式或可用宽度不足时自适应隐藏标签文字，避免内容被裁切。
- [新增] Agent 支持查看、创建、编辑、删除、启停和显式调用本地 Codex Skill，并同步多标签页变更。
- [新增] Agent 支持从当前对话或当前画布生成可编辑的 Skill 草稿，并在用户确认后保存。
- [调整] Agent 面板连接状态、内容标签和新对话统一排版，窄面板仅隐藏文字并保留图标与数量。
- [优化] Agent 输入区控件随面板宽度在图标与图标加文字之间自适应。
- [修复] Agent Skill 草稿期间保持 MCP 活动画布隔离，支持停止临时生成任务，并禁止并发修改 Skill。
- [修复] Agent 新建或恢复对话时统一同步版本化会话与 MCP 初始化状态，避免多页面竞态误触 `409`、提前发送或任务后残留初始化卡片。
- [优化] 提示词中心缩小卡片、每行展示四张，移除“加入我的资产”按钮边框。
- [优化] 缩小生图与视频工作台的提示词库弹窗，精简卡片。

## v0.13.0 - 2026-08-03

- [优化] Agent 进入空白对话或点击新对话后后台预热 Codex 与 MCP。
- [优化] Agent 排查日志改为筛选栏结构化滚动列表，支持筛选、展开详情并折叠连续重复事件。
- [优化] Agent 日志统一使用居中的回到底部入口，向上浏览时暂停跟随并可快速返回最新内容。
- [优化] Agent 对话将同一轮连续命令合并为按数量折叠的命令组，默认隐藏冗长命令预览。
- [修复] MCP 初始化期间禁用 Agent 按钮与回车发送，避免首条消息提前清除服务加载状态。
- [修复] Agent 对话代码块关闭行号后多行内容被拼接为一行的问题。
- [修复] 统一 Agent 实时事件与线程历史的消息归属，避免多窗口或刷新后出现过程重复等问题。
- [修复] 节点缩放期间暂停渲染跟随节点的浮层工具条高频更新导致页面崩溃。

## v0.12.1 - 2026-07-31

- [新增] 画布右侧Agent支持按当前账号可用范围选择Codex 模型与推理强度。
- [优化] Canvas Agent 升级至最新 Codex，启动时检查版本更新，
- [优化] 统一通过公共日志输出 Info 以上信息，美化转发日志时间。
- [优化] Agent高速流式回复取消逐词动画排队和当前消息离屏占位。
- [修复] Agent首次发送消息时立即保留并展示用户内容，不再晚于思考状态。

## v0.12.0 - 2026-07-30

- [新增] 画布 Agent 支持三档 Codex 权限，并可在对话中审批操作。
- [新增] Canvas Agent 支持 `--debug` 日志并按日期保存。
- [新增] Agent 新增可折叠任务进度，实时显示各步骤处理状态。
- [调整] Agent 工具确认模式移至输入框并默认自动确认。
- [调整] 进入画布后默认开启空白对话，历史对话改为主动恢复。
- [修复] Agent 默认通过节点生成，明确指定时才使用 Codex 内置生图。
- [修复] Agent 本地路径改为在文件管理器定位，不再拼接 localhost。
- [修复] Agent 启用 Codex 思考摘要，并修复历史恢复后过程记录缺失。
- [修复] 修复 Agent 图片预览打开后产生额外空行的问题。
- [修复] Canvas Agent 停止任务仅中断 turn，不终止服务进程。
- [修复] Agent 修复运行提示闪退和回复需切换标签页才显示的问题。
- [修复] Agent 任务失败时立即结束等待，并在对话和历史中显示中文原因。
- [修复] Agent 修复图片附件偏移，历史恢复保留缩略图且不回显内部说明。
- [修复] 修复画布复制快捷键拦截 Agent 对话和节点详情文本复制。
- [优化] Agent「新对话」立即清空并后台同步，不再等待创建 Codex 线程。
- [优化] Agent「读取画布」按节点类型和连线分类展示内容概览。
- [优化] Agent 发送后立即清空输入框并展示消息，避免内容滞留或草稿被清空。
- [优化] Agent 动态工具卡片显示名称、状态和失败原因，替代「工具操作」。
- [优化] Agent 面板标题、功能标签和新对话操作合并为单行顶栏。
- [优化] Agent Markdown 代码块与外链确认弹窗改为紧凑中文样式。
- [优化] Agent 思考摘要支持 Markdown 渲染，改善列表和代码阅读。
- [优化] Agent 思考摘要和命令改为无边框折叠行，保留实时返回内容。
- [优化] Agent 用户图片改为紧凑缩略图并支持单击放大。
- [优化] Canvas Agent 的 Codex CLI 升级至 0.145.0。
- [优化] Canvas Agent Debug 日志改为纯文本单行格式。
- [优化] 精简 Agent HTTP 诊断日志，过滤轮询、流式重复事件和原始响应。
- [优化] Agent 对话移除头像，工具活动紧凑展示，Token 用量支持数字动画。
- [优化] Canvas Agent 流式回复改为增量传输，减少长对话重复渲染。
- [优化] Agent 新增过程时间线，工具卡片改为中文摘要和可读详情。
- [优化] Agent 长时间等待时显示阶段、时长和停止提示，避免空会话读取失败。
- [优化] Agent 历史记录支持多选批量删除，点击记录可直接进入对话。
- [优化] Agent 优先操作当前画布，不再无故查询列表或重复导航。
- [优化] Canvas Agent 独立维护工作区指令，不再重复拼接提示词。
- [优化] Canvas Agent 目录按 Agent、画布、服务和工具拆分职责。

## v0.11.0 - 2026-07-28

- [新增] 画布文本生成新增推理强度设置，支持默认调用与自定义调用脚本读取所选档位。
- [新增] 生图与视频工作台的参考资产区域支持直接拖动文件上传。
- [新增] 配置与用户偏好支持通过配置文件导入和导出。
- [新增] 模型渠道新增火山方舟协议。
- [优化] 画布左侧元素列表新增图片放大预览操作。
- [优化] 图片遮罩、切图与裁剪编辑支持常用快捷操作并修复高分辨率图片预览闪烁。
- [优化] 提示词详情弹窗改为上下布局并限制显示尺寸。
- [修复] 画布组装提示词浮层限制正文高度，长提示词改为区域内滚动查看。
- [修复] 修复画布节点提示词过长时无法使用鼠标滚轮滚动的问题。
- [修复] 修复画布重试时组装提示词重复以及切换类型调用模型不一致的问题。
- [修复] 修复生成完成后再次选中画布节点时提示词不再回显的问题。

## v0.10.0 - 2026-07-25

- [新增] 提示词来源新增BananaPromptQuicker，并支持添加自定义标准 JSON 来源。
- [新增] Agent 新增统一状态查询，支持查看画布、生图工作台和视频工作台任务进度。
- [调整] 内置提示词来源改为读取ImagePrompts 统一JSON 数据，不再由画布端分别解析。
- [调整] 提示词来源配置保留卡片式交互，并展示来源数量、同步状态和上次成功时间。
- [优化] 提示词来源支持独立缓存和更新，更新失败时保留上一次成功内容。
- [优化] Agent 对话区分用户与 AI 消息，并优化会话切换和回到最新消息的交互。
- [优化] 画布生成完成后保留提示词输入，并改善提示词库和资产面板的交互性能。
- [优化] 提示词中心标题居中、搜索输入增加防抖，并采用左侧筛选、右侧内容的双栏布局。
- [修复] 本地 Agent 完善多标签页请求隔离、结果归属、焦点回退和 Codex 会话状态同步。
- [修复] 本地 Agent 上传的图片附件可正确创建画布图片节点并连接生成流程。
- [修复] 画布提示词库支持跨来源搜索，插入节点时保留提示词标题。

## v0.9.0 - 2026-07-17

- [新增] 左侧面板「资产」Tab 支持上传添加图片/视频资产、卡片悬停移除资产。
- [新增] 左侧画布面板支持拖拽调整宽度、展开/收起(带动画),顶栏菜单左侧新增面板开关按钮。
- [新增] 顶栏菜单新增「导出当前画布」,导出为包含全部资源的压缩包。
- [新增] 左侧画布元素列表支持多选并批量导出选中元素为压缩包。
- [新增] 可选的网站统计分析:支持 Google Analytics 4 与百度统计。
- [调整] 画布节点名称默认不再显示,仅在选中/悬停/编辑时出现,画布更简洁。
- [优化] 左侧面板「画布/资产」切换改为带滑动下划线的动画,移除非图片元素图标的灰色底色。
- [优化] 画布节点提示词面板 `@` 引用图片时,输入框内直接显示真实缩略图。
- [优化] 移除画布节点右上角的「图片1/文本1」资源角标,引用改在对话面板 `@` 直接选取。
- [修复] 连接本地 Codex Agent 后,拖拽画布节点边框缩放等高频编辑导致页面崩溃。

## v0.8.2 - 2026-07-16

- [新增] 图像设置新增「透明背景」开关,开启后生成无背景的透明图像。
- [优化] 画布节点输入区域移除灰色底色与边框、美化样式。
- [修复] 画布节点提示词输入框补上悬停文本光标。

## v0.8.1 - 2026-07-16

- [新增] 插件 SDK 扩展:AI 生成能力、面板控制能力。
- [优化] 3D 全景(1.1.0)支持上传与 AI 生成并升级查看器;
- [优化] HTML 节点(1.2.0)迁移到统一交互开关;
- [优化] 便利贴(1.1.0)可拖动移动、自选颜色、移除资源角标与衍生功能;
- [优化] SVG 节点(1.1.0)透明背景融入画布、可拖动、去除默认值;
- [优化] 画布节点渲染性能:memo 化节点回调,交互时不再全量重渲染;
- [修复] 修复 Markdown 节点在点击/移动视角时重复渲染导致图片反复请求的问题;
- [修复] 修复插件版本号显示不更新，插件面板新增可升级绿点提醒。

## v0.8.0 - 2026-07-15

- [新增] 画布节点插件系统:支持通过 URL 动态安装/启用/更新/卸载远程节点插件。
- [新增] 插件开发 SDK,可用 TypeScript 开发画布节点插件。
- [新增] 新增 Markdown、SVG、HTML、3D 全景、便利贴等示例插件。
- [新增] 官方插件注册表:节点插件面板可从项目仓库读取官方插件列表并一键安装。
- [新增] 在画布右上角工具栏新增「节点插件」入口。
- [新增] 支持自定义生图/视频接口调用方式以适配不同中转站。

## v0.7.1 - 2026-07-15

- [修复] 修复页面白屏报错的问题。

## v0.7.0 - 2026-07-14

- [新增] Agent 对话消息改用 streamdown 流式渲染，提升Markdown 内容展示效果。
- [新增] Agent 新增画布、工作台、提示词库和素材等站点级工具。
- [新增] Agent 面板改为全站常驻右侧栏，开关时同步推动顶栏和页面内容。
- [新增] Agent 新增 `site_navigate` 工具，支持页面跳转。
- [新增] Agent 对话运行中支持一键停止，中断当前 Codex turn。
- [新增] 画布节点支持统一维护名称字段，默认显示在节点上方，并可直接双击名称编辑。
- [新增] 画布新增组节点，支持节点拖入/拆出分组、拖拽高亮吸附和移动组时带动子节点。
- [新增] 画布空白区域支持双击打开节点选择菜单，并在点击位置创建节点。
- [调整] Codex 会话改为站点级连续线程，跨页面和跨画布保持同一上下文。
- [调整] 移除仅前端调用 OpenAI responses 接口，统一走 MCP + 本地 Codex 链路。
- [调整] 画布节点顶部工具条改为点击选中节点后显示，避免鼠标经过节点时频繁弹出。
- [优化] 本地 Agent 连接说明明确区分插件 / 手动 MCP 才会增加 Codex token 消耗。
- [优化] 优化本地 Agent 连接说明，区分 Codex 插件启动和直接运行 Agent 两种方式。
- [修复] 修复 Gemini 格式生图时因内置比例列表触发误报导致生成失败的问题。

## v0.6.0 - 2026-07-09

- [新增] 新增Codex App插件支持。
- [新增] 配置与用户偏好新增独立页面和 Codex 连接配置 Tab。
- [新增] 新增GitHub Pages 前端静态站点发布 workflow。
- [新增] 图片切图支持等分线直接拖拽调整，并可新增、删除和重置横向 / 纵向切图线。
- [调整] Docker 运行镜像改为 nginx 静态托管。
- [调整] 移除网站Agent模式，专注于连接Codex Agent操作画布
- [修复] 修复生图工作台重试成功结果刷新后丢失的问题。
- [修复] 修复 Gemini 调用格式生图未传递尺寸比例配置的问题。
- [修复] 修复前端 TypeScript 构建报错。
- [修复] 修复画布生成配置切换文本/视频/音频模式时模型仍显示为生图模型的问题。
- [修复] 兼容中转站视频任务直接返回视频 URL 且没有 `/content` 接口的情况，并优化失败原因展示。

## v0.5.0 - 2026-07-05

- [新增] 渠道兼容Gemini格式。
- [调整] 前端从 Next.js 迁移到 Vite，项目改为静态前端构建。
- [调整] 移除已 404 的 EvoLinkAI 提示词来源。

## v0.4.0 - 2026-06-16

- [新增] 新增网页版Agent Loop模式。
- [新增] 支持Vercel一键部署。
- [调整] 移除后端，项目定位为个人画布工具。

## v0.3.0 - 2026-06-15

- [新增] 新增canvas-agent通过codex操作画布。

## v0.2.5 - 2026-06-08

- [新增] 新增图片切图功能。
- [新增] 支持webdav同步数据。
- [修复] 修复画布文字节点错误问题。

## v0.2.4 - 2026-06-04

- [新增] 新增图片反推提示词功能。

## v0.2.3 - 2026-06-04

- [新增] 新增图片蒙版局部修改功能。
- [优化] 优化配置节点@图片功能。

## v0.2.2 - 2026-06-04

- [新增] 新增图片放大工具。
- [优化] 优化图片工具条，增加自定义功能。
- [修复] 修复端口冲突问题、pg/mysql未初始化问题。

## v0.2.1 - 2026-06-03

- [新增] 新增文档站点页面。
- [优化] 优化画布连线交互。
- [优化] 优化模型选择用户偏好。

## v0.2.0 - 2026-06-01

- [新增] 支持通过火山方舟AgentPlan接入。
- [新增] 视频生成支持声音、水印及图片/视频/音频参考输入。
- [新增] 画布新增音频节点。
- [优化] 图片/视频素材支持 `图片1`编号注入提示词。

## v0.1.1 - 2026-05-30

- [新增] 支持New API跳转并自动填入Base URL和API Key配置。

## v0.1.0 - 2026-05-26

- [优化] 优化我的画布、我的素材导出功能
- [修复] 修复画布撤销，配置节点等bug问题

## v0.0.9 - 2026-05-26

- [新增] 新增视频创作台页面。
- [修复] 修复图片节点size参数传递问题。

## v0.0.8 - 2026-05-24

- [新增] 新增用户账号与算力点体系，支持账号密码注册登录、Linux.do OAuth。
- [新增] 管理后台公开配置支持设置模型算力点、支持计费查询。
- [新增] 画布右上角展示用户算力点余额，生成按钮会展示本次预计消耗算力点。
- [新增] 新增视频生成节点。

## v0.0.7 - 2026-05-23

- [新增] 管理后台提示词管理支持多选批量删除。
- [新增] 新增定义拉取GitHub提示词源功能。
- [新增] 新增awesome-gpt-image2-prompts提示词来源。
- [优化] 优化模型下拉选择样式、优化生图编辑设置

## v0.0.6 - 2026-05-22

- [新增] 管理后台支持配置模型渠道，前端当前无需鉴权即可直接使用后端渠道能力。
- [优化] 统一整理后端错误提示、AI 代理、图片节点生成与重试、参考图缺失处理等细节。
- [优化] 后端模型代理路径调整为 OpenAI 风格。

## v0.0.5 - 2026-05-20

- [新增] 右上角版本号支持点击查看版本更新弹窗，展示当前版本、最新版本和按时间线整理的更新日志。
- [新增] 设置弹窗支持配置系统提示词，AI 生图、编辑图和文本请求会自动携带。

## v0.0.4 - 2026-05-20

- [调整] Docker 运行入口改为 Next.js 对外提供页面，`/api/*` 由 Next.js 代理到内部 Go 服务。
- [修复] 文本复制在局域网 IP 访问时可能失败的问题。

## v0.0.3 - 2026-05-19

- [修复] 更新 nanoid 依赖并修改 ID 生成方式，防止其他ip无法使用crypto模块导致的ID生成失败问题。

## v0.0.2 - 2026-05-19

- [新增] 增加生图工作台功能，支持文生图、图生图、查看历史记录，并增加移动端适配。
- [修复] 画布生成尺寸控件支持选择更多常用比例，并可直接输入自定义比例。
- [修复] 生成配置节点恢复拖拽操作，避免面板控件拦截整块节点拖动。
- [文档] 增加 Render 部署说明。

## v0.0.1 - 2026-05-19

- [新增] 首次开源版本，包含无限画布能力：多画布项目、节点拖拽缩放、连线、小地图、撤销重做、导入导出。
- [新增] AI 创作能力：支持 OpenAI 兼容接口的文生图、图生图、参考图编辑和文本问答。
- [新增] 画布助手能力：支持围绕选中节点和上游节点对话、生图，并把结果插回画布。
- [新增] 提示词库能力：抓取多个 GitHub 开源项目，按案例整理数百个图片提示词。