# ImageStudio UI 导航页开发队列 本文件用于在新对话窗口继续 UI 开发。新窗口启动时,先读取本文件,再从 `S130` 开始逐项推进。 ## 参考图 参考图已放入仓库: ![ImageStudio 导航页参考图](docs/assets/imagestudio_navigation_reference.png) 新窗口开始开发前必须先查看这张图。开发时以图里的布局节奏和卡片语言作为视觉参考,但不要照搬原图的课程/日程内容,要替换成 ImageStudio 的生成、队列、图库、性能监控和通知场景。 ## 新窗口启动口令 ```text 口令:星图导航-S130 请读取 C:\Users\Administrator\Documents\AstrBot ImageStudio\imagestudio_ui_navigation_queue_s130.md, 并先查看 C:\Users\Administrator\Documents\AstrBot ImageStudio\docs\assets\imagestudio_navigation_reference.png。 从 S130 开始继续 ImageStudio UI 导航页开发。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` - UI 开发按“大项”提交和推送,不再按每个小阶段推送。 - 导航页大项建议覆盖 `S130` 到 `S145`,完成落地和验收后统一提交、推送,并打中文 tag,例如:`UI大项-S130-S145-导航页落地` - 中途可以本地保留工作进度,但不要为了每个 UI 小阶段都推送远端。 - 大项提交前执行必要检查,至少包含相关前端 typecheck/build。 - 不输出 `.env.imagestudio_codex_handoff.yaml` 中的密钥、密码、token。 - 遇到需要用户介入的事项时,记录到队列文件或新的阻塞清单,然后跳过继续做下一项。 ## UI 预览方式 - 用户希望使用 VSCode 的 Live Preview 插件预览 UI。 - 注意:本项目是 Vue/Vite 前端,`.vue` 源码不能只靠 Live Preview 直接编译。 - 开发实时预览优先使用 `frontend` 目录下的 `npm run dev:web`。 - 大项验收时执行 `npm run build:web`,再用 VSCode Live Preview 打开构建后的静态页面。 - 如果某些功能必须依赖后端接口,再临时启动对应服务,并在交接说明里写明。 - 预览时重点检查桌面布局、窄屏布局、主题切换、通知面板、卡片尺寸和文字溢出。 ## 用户确认过的导航页设计方向 - 整体视觉参考用户提供的导航页灵感图,采用深色质感、卡片化、信息面板式布局。 - 左侧蓝色区域:图标导航,用小图标切换不同详情页。 - 右侧绿色区域:性能监控栏,用卡片展示运行状态、队列压力、模型调用、存储等指标。 - 中部黄色区域:当前队列;没有任务时显示空状态。 - 下方橙色区域:最近图片;以图片卡片展示缩略图、状态、来源、操作入口。 - 紫色区域:暂定为“智能工作建议区”,展示失败重试、待确认事项、费用提醒、可继续流程、配置建议。 - 顶部工具栏: - 搜索框:搜索插件内功能,并跳转到对应页面或功能区。 - 日夜切换:小滑块切换白天/夜间风格。 - 消息铃铛:悬停显示小卡片概览,点击打开大通知面板。 - 调色盘:调整全局主色调和副色调。 ## 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 全部完成。 ## 后续详情页候选队列 以下内容暂不在本轮导航页队列内,等用户确认详情页设计语言后再拆分: - 生成详情页:提示词、参考图、模型、尺寸、批量参数、成本预估。 - 队列详情页:任务列表、筛选、取消、重试、优先级、失败原因。 - 图库详情页:图片瀑布流、搜索、标签、预览、导出、删除保护。 - 角色详情页:角色档案、服装、素材绑定、生成历史。 - 素材详情页:上传、分类、去重、引用关系。 - 设置详情页:模型站点、数据库、成本上限、隐私选项。 - 日志详情页:事件、错误、接口调用、调试导出。