266 行
8.9 KiB
Markdown
266 行
8.9 KiB
Markdown
# 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 全部完成。
|
||
|
||
## 后续详情页候选队列
|
||
|
||
以下内容暂不在本轮导航页队列内,等用户确认详情页设计语言后再拆分:
|
||
|
||
- 生成详情页:提示词、参考图、模型、尺寸、批量参数、成本预估。
|
||
- 队列详情页:任务列表、筛选、取消、重试、优先级、失败原因。
|
||
- 图库详情页:图片瀑布流、搜索、标签、预览、导出、删除保护。
|
||
- 角色详情页:角色档案、服装、素材绑定、生成历史。
|
||
- 素材详情页:上传、分类、去重、引用关系。
|
||
- 设置详情页:模型站点、数据库、成本上限、隐私选项。
|
||
- 日志详情页:事件、错误、接口调用、调试导出。
|