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