6.6 KiB
6.6 KiB
ImageStudio UI / Workflow Progress Handoff
日期:2026-07-10
分支:codex/ui-navigation-s130-s145
范围:未提交变更检查、功能验证、静态构建、推送前总结。
历史记录说明:本文保留当日开发与构建状态。当前 AstrBot 生产页面由
pages/imagestudio/index.html自动发现;插件通过context.register_web_api提供 API,页面 bridge 传相对 endpoint。下文/webURL 是 Vite 预览记录,不表示 AstrBot 注册了该生产入口。
后续前端重构更新
本文件后续章节保留当时的阶段记录,当前前端状态以 前端拆分与体验优化报告 为准。本轮已拆出导航、指标/状态原语、图片预览、素材弹窗、外部角色卡解析和共享工具,并完成桌面与 390×844 移动端浏览器回归。
当前构建产物:
pages/imagestudio/assets/index-CF6dVfCE.jspages/imagestudio/assets/index-D4NekmM3.cssweb/assets/index-djgvYVE7.jsweb/assets/index-VBJk7aNa.css
当前前端定向验证:typecheck、Plugin Page/Web 生产构建、18 项前端契约测试及 7 项文档打包测试均通过。
推送前状态
- 已执行
git fetch origin。 - 检查结果:本地分支相对
origin/codex/ui-navigation-s130-s145为0 ahead / 0 behind,也就是没有“已提交但未推送”的 commit。 - 当前待发布内容来自工作区未提交改动,主要集中在完整工作台 UI、素材库工作台、队列工作台、角色工作流闭环、后端 schema/注入服务和对应测试。
已完成内容
前端工作台
frontend/standalone-web/src/App.vue扩展为更完整的 ImageStudio 工作台。- 顶部导航现在聚焦:概览、生成、素材、角色、图库、设置、日志。
- 新增素材库工作台:
- 素材分类筛选。
- 示例素材卡和后端素材卡统一展示。
- 素材详情弹层。
- 添加分类弹层。
- 刷新素材、上传素材、识别、重识别、确认入库、导入素材包、并入衣橱、进入素材绑定等操作入口。
- 新增队列工作台:
- 活跃、失败、完成、全部筛选。
- 任务详情和批量操作入口。
- 角色工作流继续补齐:
- 提示词规划节点页面。
- 参考素材绑定节点页面。
- 阶段审查和候选图采用动作。
- 锁定节点创建分支入口。
- 最终归档入口的 UI 语义。
- 前端 API 客户端补充
PUT请求方法。
后端闭环
- 新增提示词规划 schema 服务:
backend/services/prompt_plan_schema_service.py- 支持 prompt matrix、target/node 索引、继承字段、权重建议、guardrails 和 conflicts。
- 新增素材绑定 schema 服务:
backend/services/material_binding_schema_service.py- 支持 explicit-only 默认策略、rules、active rules、by stage、by node key、by node id 和 node parameters。
- 新增节点注入模板服务:
backend/services/node_injection_template_service.py- 统一生成节点对话注入契约,包含用户原文、节点上下文、素材绑定、提示词规划、阶段输入、草稿图选择和预期返回结构。
WorkflowService:- 保存 workflow/node metadata 时同步规范化 prompt plan 和 material bindings。
- 允许 completed 节点在采用图片时受控进入 selected。
NodeDependencyContextService:- 返回 prompt plan、material bindings 和 injection template。
- 按目标节点过滤上游上下文。
PromptExpansionService:- 注入 prompt plan patch、negative patch 和 node injection。
MaterialService:- 更新分类时校验 parent_id,避免自引用和无效父分类。
- 审查和历史相关服务继续补齐阶段审查、图片采用、分支锁定和 stage input handoff。
静态产物
- 已重新执行
npm.cmd run build:web。 web/index.html已指向新构建产物。- 新产物:
web/assets/index-C91GfaJN.cssweb/assets/index-uM7AKRxw.js
- 旧产物已被构建替换:
web/assets/index-B2NiW3rX.jsweb/assets/index-CPo7NaFF.css
已验证
npm.cmd run typecheck- 结果:通过。
python -m unittest tests.test_prompt_plan_schema_service tests.test_material_binding_schema_service tests.test_workflow_service tests.test_node_dependency_context_service tests.test_prompt_expansion_service tests.test_review_service tests.test_history_service tests.test_material_service tests.test_character_workflow_service tests.test_plugin_entrypoint tests.test_s0_infrastructure- 使用 Codex bundled Python。
- 结果:81 tests OK。
npm.cmd run build:web- 结果:通过,生成最新
web/静态产物。
- 结果:通过,生成最新
- 内置浏览器打开本地 Vite 预览(不是 AstrBot 生产入口):
http://127.0.0.1:5173/api/v1/plugins/extensions/astrbot_plugin_imagestudio/web/?view=materials- 结果:素材页标题、预览模式提示、示例素材卡、素材操作卡正常渲染。
- 控制台:未发现 error/warn。
- 素材详情弹层:点击示例素材卡后可打开。
未完成或仍需补齐
- 当前浏览器验证仍在前端预览模式下完成,没有连接真实 AstrBot 插件后端,因此未覆盖真实落库、文件上传、素材 VLM 识别和衣橱写入。
- 添加分类弹层需要再做一次真实浏览器交互验收;本次自动点击使用的选择器不够稳定,未作为通过项记录。
- 最终入库节点仍需要补齐正式 schema:角色版本、最终图片、提示词、素材引用、审查记录、分支信息和归档元数据。
- 角色图库与素材库的真实联动仍需继续深化。
- 素材上传入口、素材包导入入口目前以 UI/接口入口为主,文件选择、dry-run 预览和导入执行流程还需要后续完整实现。
- 需要在真实后端环境做一次端到端验收:快速角色创建、工作流生成、提示词规划保存、素材绑定保存、阶段审查采用、锁定后分支、最终归档。
备注
- 本次检查开始时没有未推送 commit;推送动作应在提交当前工作区改动后执行。
- 已创建本地提交:
feat: extend workflow and materials workbench。 - 已尝试执行
git push origin codex/ui-navigation-s130-s145,但远端 Git HTTP 返回凭据不正确或已过期。 - Forgejo API 认证仍可用,并确认远端
codex/ui-navigation-s130-s145当前仍停在b61c6274e5a7ddbcbad1d67f0f0fcfe7da7f3264。 - 因此当前状态为:本地分支 ahead 1,等待更新本机 Git 凭据后再次推送。
- Windows shell 提示多处 LF/CRLF 警告,未发现影响构建或测试的行为问题。