67 行
4.1 KiB
Markdown
67 行
4.1 KiB
Markdown
# 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 环境验收覆盖。
|