# ImageStudio 前端拆分与体验优化(2026-07-10) ## 本轮目标 在不改变后端 API 契约的前提下,拆分大型 Workbench、合并重复代码,并修复真实数据与预览数据边界、键盘操作、移动端导航和弹窗体验问题。 ## 已完成拆分 - `AppNavigationRail.vue`:导航渲染、活动页语义和固定/自动收起控制。 - `MetricCardGrid.vue`:素材、队列、首页和性能页统一指标卡渲染。 - `StateCard.vue`:统一成功、错误、警告状态反馈及 `aria-live`。 - `EmptyState.vue`:统一空态和可选操作入口。 - `ImagePreviewDialog.vue`:统一图片预览、0.5–4 倍缩放、双击缩放、拖拽和 Escape/遮罩关闭。 - `MaterialOperationDialog.vue`:素材 URI、素材包和衣橱操作;补齐焦点管理、焦点循环和移动端布局。 - `MaterialCategoryCreateDialog.vue`:素材分类创建表单与焦点管理。 - `MaterialDetailDialog.vue`:素材详情展示与键盘关闭。 - `features/quick-profile/profile-import.ts`:外部角色卡解析、默认问卷和空问卷纯函数。 - `types/navigation.ts`:导航与模块契约。 ## 已合并的重复代码 - `shared/utils/presentation.ts`:状态标准化、状态文案/颜色、时间、容量、成本、任务等待时间和短 ID。 - `shared/utils/storage-uri.ts`:`storage://` 校验、文件名提取和 PNG/JPEG/GIF/WebP 素材 URI 校验。 - `shared/utils/collections.ts`:`uniqueBy` 与字符串去重。 - `shared/types/ui.ts`:通用指标卡、详情行和动作卡类型。 - 图片预览重复模板、素材分类/详情弹层以及四处指标卡模板已合并为组件。 ## UI/UX 修复 - 桌面导航增加固定/自动收起开关;队列和性能入口重新进入主导航。 - 390px 移动端底部导航显示文字标签,不再只依赖抽象符号和 hover 提示。 - 全局搜索升级为标准 combobox/listbox:支持 Ctrl/Cmd+K、`/`、上下方向键和 Enter。 - 生成与工作流输入支持 Ctrl/Cmd+Enter 提交。 - 原“生成设置”“工作流设置”“附加素材”假按钮已接入真实设置/素材导航。 - 首页队列“查看详情”“重试”按钮已连接真实队列选择与重试动作,并按权限/状态禁用。 - 真实后端已连接但未配置模型时不再伪装成示例/本地模型;提交会被禁用并引导到设置。 - 真实后端空素材库不再自动展示示例素材;预览/错误模式才显示明确标记的样例。 - 素材 URI 前端校验与后端一致,支持 GIF。 - 弹窗补齐遮罩关闭、Escape、自动聚焦、busy 防误关、焦点循环、`100dvh` 与 safe-area。 - 队列 tab、通知筛选和素材分类筛选补齐 `aria-selected`/`aria-pressed`。 - 状态卡统一使用 `role="alert"` 或 `role="status"`,错误不再挤在模型选择器的小区域中。 ## 验证 - `npm.cmd run typecheck`:通过。 - `python -m unittest tests.test_frontend_api_contract tests.test_docs_packaging`:25 项通过。 - 全量 `python -m unittest discover -s tests`:359 项 OK,其中 1 项按环境条件跳过。 - `npm.cmd run build:plugin`:通过。 - `npm.cmd run build:web`:通过。 - 浏览器桌面与 390×844 移动端回归:通过。 - 导航固定、移动标签、明暗主题正常。 - Ctrl/Cmd+K 搜索、方向键和 Enter 跳转正常。 - 队列筛选具备 tab 语义。 - 图片预览缩放、拖拽和键盘关闭正常。 - 页面控制台无应用 error/warn。 最终构建产物: - `pages/imagestudio/assets/index-CF6dVfCE.js` - `pages/imagestudio/assets/index-D4NekmM3.css` - `web/assets/index-djgvYVE7.js` - `web/assets/index-VBJk7aNa.css` ## 剩余边界 - `App.vue` 已拆出组件、纯函数、共享类型和工具,但仍约 18,138 行,主要体积来自生成/角色工作流状态编排和集中样式;后续应继续拆 `useWorkflowStore`、`useWorkflowActions`、通知和异步资源 composable。 - 浏览器回归运行在 Vite 预览模式,未连接真实 AstrBot 后端;真实数据库写入、素材 Vision 与 Provider 调用仍由后端测试和 AstrBot 环境验收覆盖。