astrbot_plugin_imagestudio/imagestudio_ui_navigation_queue_s130.md

267 行
8.9 KiB
Markdown

2026-07-06 11:52:36 +08:00
# ImageStudio UI 导航页开发队列
本文件用于在新对话窗口继续 UI 开发。新窗口启动时,先读取本文件,再从 `S130` 开始逐项推进。
## 新窗口启动口令
```text
口令:星图导航-S130
请读取 C:\Users\Administrator\Documents\AstrBot ImageStudio\imagestudio_ui_navigation_queue_s130.md,
从 S130 开始继续 ImageStudio UI 导航页开发。每个阶段完成后都要测试、提交、推送到 Forgejo,
并创建中文 tag。除非遇到必须由用户提供的信息,否则不要中途等待确认。
```
## 固定执行规则
- 工作区:`C:\Users\Administrator\Documents\AstrBot ImageStudio`
- 远端仓库:`http://192.168.31.210:18085/YokiiroBW/astrbot_plugin_imagestudio.git`
- 优先开发位置:`frontend/standalone-web/src/App.vue`
- AstrBot 插件简版页面位置:`frontend/plugin-page/src/App.vue`
- 每个阶段完成后执行必要检查,至少包含相关前端 typecheck/build。
- 每个阶段都要单独提交、推送,并打中文 tag,例如:`阶段-S130-导航页视觉骨架`
- 不输出 `.env.imagestudio_codex_handoff.yaml` 中的密钥、密码、token。
- 遇到需要用户介入的事项时,记录到队列文件或新的阻塞清单,然后跳过继续做下一项。
## 用户确认过的导航页设计方向
- 整体视觉参考用户提供的导航页灵感图,采用深色质感、卡片化、信息面板式布局。
- 左侧蓝色区域:图标导航,用小图标切换不同详情页。
- 右侧绿色区域:性能监控栏,用卡片展示运行状态、队列压力、模型调用、存储等指标。
- 中部黄色区域:当前队列;没有任务时显示空状态。
- 下方橙色区域:最近图片;以图片卡片展示缩略图、状态、来源、操作入口。
- 紫色区域:暂定为“智能工作建议区”,展示失败重试、待确认事项、费用提醒、可继续流程、配置建议。
- 顶部工具栏:
- 搜索框:搜索插件内功能,并跳转到对应页面或功能区。
- 日夜切换:小滑块切换白天/夜间风格。
- 消息铃铛:悬停显示小卡片概览,点击打开大通知面板。
- 调色盘:调整全局主色调和副色调。
## UI 开发队列
### S130 导航页视觉骨架
目标:建立导航页第一版布局骨架,让页面区域和用户标注的色块含义一一对应。
范围:
- 搭建应用外壳:左侧导航、顶部工具栏、主内容区、右侧性能栏。
- 建立队列区、最近图片区、智能建议区的基础结构。
- 保持页面第一屏就是可用工作台,不做营销式 landing page。
验收:
- 桌面视口下主要区域不重叠。
- 页面可直接看出导航、性能、队列、最近图片、建议区的位置关系。
### S131 左侧图标导航
目标:实现小图标式导航,并能切换当前详情页。
范围:
- 设计导航项:概览、生成、队列、图库、角色、素材、设置、日志。
- 当前项高亮。
- 保留路由或状态切换接口,后续详情页可接入。
- 图标优先使用现有依赖;没有合适依赖时使用轻量文本符号或 CSS 图标。
验收:
- 点击导航项能切换选中状态。
- 窄屏下导航不挤压主内容。
### S132 顶部搜索框
目标:实现可搜索功能入口的顶部搜索框。
范围:
- 内置功能索引:生成图片、查看队列、最近图片、模型设置、数据库设置、日志、成本、素材。
- 输入关键字显示匹配结果。
- 选择结果后跳转对应导航项或滚动到对应模块。
验收:
- 中文关键字可搜索。
- 无结果时有简洁空状态。
### S133 白天/夜间切换
目标:实现全局明暗主题切换。
范围:
- 顶部小滑块切换日间/夜间。
- 使用 CSS 变量管理背景、文本、边框、卡片、阴影。
- 记住用户选择。
验收:
- 切换后主要区域可读性正常。
- 页面刷新后保持上次主题。
### S134 通知铃铛
目标:实现通知入口和悬停概览。
范围:
- 顶部铃铛显示未读数量。
- 鼠标悬停显示小型通知概览卡。
- 支持完成、失败、警告、系统消息四类。
验收:
- 悬停卡片位置稳定,不遮挡顶部主要操作。
- 无通知时显示空状态。
### S135 通知大面板
目标:实现点击铃铛后的大通知面板。
范围:
- 大卡片容器展示通知列表。
- 每条通知使用“小卡片”:左侧缩略图,右侧标题和详情。
- 支持标记已读、清空已读、按类型筛选。
验收:
- 生图完成消息能显示缩略图占位。
- 错误消息能突出失败原因。
### S136 调色盘主题系统
目标:实现主色调和副色调可调。
范围:
- 顶部调色盘按钮打开主题面板。
- 提供若干预设配色。
- 支持自定义主色和副色。
- 主题写入 CSS 变量并持久化。
验收:
- 更换配色后按钮、导航高亮、重点卡片同步变化。
- 不出现单一色系过度占满页面的问题。
### S137 性能监控栏
目标:实现右侧性能监控卡片。
范围:
- 展示服务状态、队列长度、运行任务、今日调用、今日成本、存储占用。
- 优先接入已有 dashboard summary 数据。
- 缺少数据时使用明确的空值或占位,不伪装真实指标。
验收:
- 卡片尺寸稳定。
- 数据加载、失败、空状态都可读。
### S138 当前队列区
目标:实现当前队列卡片列表。
范围:
- 展示任务标题、状态、模型、等待时间、进度。
- 无任务时显示空状态。
- 为后续取消、重试、查看详情预留操作位。
验收:
- 有任务和无任务两种状态都布局稳定。
- 长任务标题不撑破卡片。
### S139 最近图片区
目标:实现最近图片卡片区。
范围:
- 展示缩略图、任务名称、生成时间、状态。
- 支持失败、生成中、完成三种视觉状态。
- 为后续预览、复制、下载、再次生成预留操作位。
验收:
- 图片比例稳定。
- 图片缺失时有清晰占位。
### S140 智能工作建议区
目标:实现紫色区域的实际功能内容。
范围:
- 展示失败重试建议。
- 展示待补充配置或待确认事项。
- 展示成本或模型调用提醒。
- 展示可继续的工作流入口。
验收:
- 建议内容像操作入口,而不是说明文档。
- 没有建议时显示安静的空状态。
### S141 首页数据适配
目标:把导航页接入真实后端数据。
范围:
- 梳理并复用 `frontend/shared/api/endpoints.ts`。
- 接入 dashboard、queue、images、logs 或 notifications 可用接口。
- 缺失接口先做最小后端补齐或前端兼容层。
验收:
- 真实数据能填充性能、队列、最近图片中的至少两个区域。
- 接口失败时不会导致整页空白。
### S142 空状态和加载状态
目标:统一所有导航页模块的加载、空、失败状态。
范围:
- 统一骨架屏或轻量加载态。
- 统一空状态文案。
- 统一错误卡片和重试入口。
验收:
- 断网或接口失败时页面仍可操作。
- 空状态不显得像未完成页面。
### S143 响应式适配
目标:适配桌面、窄屏、移动宽度。
范围:
- 桌面:左侧导航 + 顶部工具栏 + 多列面板。
- 平板:右侧性能栏可下移或折叠。
- 手机:导航变为底部或紧凑侧栏,卡片单列。
验收:
- 常见宽度下无横向溢出。
- 顶部搜索、铃铛、调色盘仍可触达。
### S144 视觉统一打磨
目标:统一导航页设计语言。
范围:
- 调整间距、字号、边框、阴影、色彩层级。
- 避免卡片套卡片。
- 避免大面积单一紫蓝或深蓝单调主题。
- 控制文字长度和按钮宽度,防止溢出。
验收:
- 页面有明确主次层级。
- 所有卡片、按钮、标签风格一致。
### S145 导航页验收与同步
目标:完成导航页阶段验收,并决定是否同步到 AstrBot 插件页。
范围:
- 运行前端 typecheck/build。
- 检查桌面和移动关键视口。
- 如插件页需要同步,则将核心视觉和中文文案同步到 `frontend/plugin-page/src/App.vue`。
- 更新 README 中的 UI 可用功能概述。
验收:
- 构建产物正常。
- 导航页可作为后续详情页开发入口。
- 代码、文档、提交、中文 tag 全部完成。
## 后续详情页候选队列
以下内容暂不在本轮导航页队列内,等用户确认详情页设计语言后再拆分:
- 生成详情页:提示词、参考图、模型、尺寸、批量参数、成本预估。
- 队列详情页:任务列表、筛选、取消、重试、优先级、失败原因。
- 图库详情页:图片瀑布流、搜索、标签、预览、导出、删除保护。
- 角色详情页:角色档案、服装、素材绑定、生成历史。
- 素材详情页:上传、分类、去重、引用关系。
- 设置详情页:模型站点、数据库、成本上限、隐私选项。
- 日志详情页:事件、错误、接口调用、调试导出。