已完成:导航与概览视觉调整、生成页三模式入口、图片生成工作台、快速角色卡片与素材弹窗、角色工作流大/小节点、草稿多选对比、节点草稿池联动。 未完成:真实生图与模型配置接入、素材库真实分类读取、生成人设问卷细化、工作流状态机与草稿轮次持久化、完整浏览器视觉回归。详见 docs/ui-progress-2026-07-07.md。
6.3 KiB
6.3 KiB
ImageStudio UI 开发进度交接
日期:2026-07-07
分支:codex/ui-navigation-s130-s145
口令:星图导航-S130
已完成进度
导航与概览页
- 左侧星图导航栏已完成当前视觉稿方向:贴边凸出、柔和圆角、滚动容纳、多图标显示、自动隐藏与鼠标悬停展开。
- 顶部工具区已统一为图标按钮:主题切换、消息中心、日志、调色盘等,并补充了展开/关闭动画。
- 消息中心、日志、图片预览等浮层已支持点击外部区域关闭,后续新增浮层可复用同一套关闭逻辑。
- 日间/夜间主题做过统一调整,修复过夜间中间区域发白、日间卡片色调不一致的问题。
- 概览页重新整理为性能监控、最近图片、当前队列、运行/新建生成等区域,并调整了最近图片卡片比例和底部对齐。
- 性能监控已精简主卡片展示,并预留性能详情页入口。
生成页面总入口
- 生成页面已建立三段式入口:
图片生成、快速角色、角色工作流。 - 三个入口按钮可切换下方内容,左侧介绍会随当前模块变化。
- 生成页面整体视觉风格已经与导航页统一。
图片生成
- 已搭建图片生成工作台:左侧图片队列、中间主图预览、右侧图片信息、底部对话框。
- 底部对话框已改为类似 Codex 输入框的样式,并加入模型选择、最近请求、输入说明。
- 已生成 10 张测试占位图,模拟已生成结果,并填充不同标题、提示词、模型、尺寸、种子、耗时、来源和状态。
- 图片队列不会再拉长整个工作区,工作区高度会跟随浏览器自适应。
- 主图支持完整显示,不再被工作区裁剪。
- 图片可点击打开大卡片预览,支持滚轮缩放、双击放大/还原、拖拽查看细节。
快速角色
- 已完成快速角色页面的主体卡片布局,并按当前认可比例固定外部排布。
- 角色档案改为展示型预览卡,不在此处直接编辑;右上角折角效果作为进入编辑界面的入口占位。
- 角色图片区域支持四张图自动轮播,也支持点击右侧小卡手动切换。
- 角色大图点击后可打开详情卡片:左侧大图,右侧展示介绍、提示词、生成时间等信息。
- 半身照上下留白已用卡片元素进行视觉处理。
- 测试图片已按实际比例重新调整,并通过缩放适配容器。
- 参考素材已支持点击弹出选择卡片。
- 参考素材排序已调整为:风格、构图、服装、鞋袜、配饰。
- 每类参考素材弹窗包含“不使用”、素材候选、添加素材占位卡。
- “不使用参考”已清空对应素材图片状态。
- 配饰弹窗已支持细分类展示,细分类切换有平滑缩放过渡;当前细分类保持单列展示。
- 配饰分类后续需要对接素材库真实分类文件。
- 功能按钮中“生成草稿”已改为“生成人设”,点击后弹出问卷大卡片占位。
- “进入工作流”语义已调整为将粗略人设转入角色工作流继续细化。
角色工作流
- 已建立角色工作流 UI 大卡片:节点流程、图片预览、节点详情、对话框和动作按钮。
- 对话框样式参考图片生成输入框。
- 节点流程已细化为大节点 + 小节点结构。
- 当前模拟大节点包括:
- 前期人设准备
- 头像草稿
- 全身与设定图
- 审核修复并入库
- 小节点已模拟草稿轮次和细节补图流程,例如头像草稿 01/02/03、全身草稿、手部补图、配饰补图、拆分设定图等。
前期人设准备已由原 01/02 合并。- 节点详情已补充轮次、锁定项、本轮结论等模拟字段。
- 草稿阶段已支持一次选择多张图,选中的多张图会一起显示在主预览区域。
- 已增加平铺对比入口,用于大图对比多张草稿。
- 已实现节点草稿池联动:切换不同节点时,底部草稿池、主预览和已选草稿会按当前节点的
imageIds变化。
构建与产物
frontend/shared/api/endpoints.ts已补充quickProfileDraftSave占位接口。- 已运行
npm.cmd run typecheck。 - 已运行
npm.cmd run build:web,并更新web/静态产物。
未完成进度
- 图片生成尚未接入真实生图 API、真实任务提交、真实模型配置和真实生成结果回写。
- 最近请求目前仍是前端模拟数据,需要接入真实请求历史。
- 图片队列、图片信息、图片详情卡仍以模拟数据为主,需要接后端图片记录。
- 快速角色的“生成人设”问卷目前是大卡片占位,字段、校验、LLM 生成逻辑和保存逻辑待细化。
- 角色档案右上角折角入口目前只是 UI 入口,需要真正跳转或打开角色编辑界面。
- 参考素材弹窗目前使用占位素材;后续素材库开发时,需要读取真实素材库文件和配饰细分类文件。
- 添加素材占位卡已经预留入口,但素材库新增素材页面和跳转参数尚未实现。
- 衣橱匹配、每日穿搭、保存角色参考素材等功能语义仍需最终确认后再落地。
- 角色工作流目前是模拟流程,尚未接入真实工作流状态机、节点执行、队列、失败重试和持久化。
- 草稿轮次自动创建小节点的真实逻辑尚未实现;当前只是模拟了多轮草稿数据。
- 多图对比、节点选图、锁定元素、进入下一轮草稿等操作还没有写入真实工作流数据。
- 性能详情页入口已预留,但详情页数据与实际性能采集仍需后端对接。
- 当前 UI 主要通过类型检查和构建验证,浏览器自动化读取页面时曾出现超时,后续需要补一次完整可视化回归。
下次建议优先级
- 先把角色工作流的草稿轮次机制设计成真实数据结构:一次不满意生成新草稿小节点,选定元素后进入下一轮。
- 接入素材库真实文件读取,尤其是配饰分类文件,并让快速角色的参考素材弹窗读取真实分类。
- 细化“生成人设”问卷卡片,明确字段、LLM 提示词、保存接口和转入工作流的数据格式。
- 将图片生成从模拟数据切到真实模型配置、真实任务提交和真实结果展示。
- 做一次完整浏览器视觉回归,确认导航、概览、图片生成、快速角色、角色工作流在常见窗口尺寸下没有错位。