docs: 补充导航页参考图和预览规则

这个提交存在于:
YokiiroBW 2026-07-06 11:59:01 +08:00
父节点 85f0887ab0
当前提交 0da64efa3d
共有 2 个文件被更改,包括 24 次插入 和 4 次删除

二进制文件未显示。

之后

宽度:  |  高度:  |  大小: 2.4 MiB

查看文件

@ -2,14 +2,23 @@
本文件用于在新对话窗口继续 UI 开发。新窗口启动时,先读取本文件,再从 `S130` 开始逐项推进。
## 参考图
参考图已放入仓库:
![ImageStudio 导航页参考图](docs/assets/imagestudio_navigation_reference.png)
新窗口开始开发前必须先查看这张图。开发时以图里的布局节奏和卡片语言作为视觉参考,但不要照搬原图的课程/日程内容,要替换成 ImageStudio 的生成、队列、图库、性能监控和通知场景。
## 新窗口启动口令
```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\docs\assets\imagestudio_navigation_reference.png。
从 S130 开始继续 ImageStudio UI 导航页开发。UI 小阶段不需要每次推送,导航页大项落地后再统一测试、
提交、推送到 Forgejo,并创建中文 tag。除非遇到必须由用户提供的信息,否则不要中途等待确认。
```
## 固定执行规则
@ -18,11 +27,22 @@
- 远端仓库:`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-导航页视觉骨架`
- 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 打开构建后的静态页面。
- 如果某些功能必须依赖后端接口,再临时启动对应服务,并在交接说明里写明。
- 预览时重点检查桌面布局、窄屏布局、主题切换、通知面板、卡片尺寸和文字溢出。
## 用户确认过的导航页设计方向
- 整体视觉参考用户提供的导航页灵感图,采用深色质感、卡片化、信息面板式布局。