diff --git a/docs/assets/imagestudio_navigation_reference.png b/docs/assets/imagestudio_navigation_reference.png new file mode 100644 index 0000000..5eb7615 Binary files /dev/null and b/docs/assets/imagestudio_navigation_reference.png differ diff --git a/imagestudio_ui_navigation_queue_s130.md b/imagestudio_ui_navigation_queue_s130.md index cc752e6..3cf19f0 100644 --- a/imagestudio_ui_navigation_queue_s130.md +++ b/imagestudio_ui_navigation_queue_s130.md @@ -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 打开构建后的静态页面。 +- 如果某些功能必须依赖后端接口,再临时启动对应服务,并在交接说明里写明。 +- 预览时重点检查桌面布局、窄屏布局、主题切换、通知面板、卡片尺寸和文字溢出。 + ## 用户确认过的导航页设计方向 - 整体视觉参考用户提供的导航页灵感图,采用深色质感、卡片化、信息面板式布局。