astrbot_plugin_imagestudio/docs/ui-progress-2026-07-10.md

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。下文 /web URL 是 Vite 预览记录,不表示 AstrBot 注册了该生产入口。

后续前端重构更新

本文件后续章节保留当时的阶段记录,当前前端状态以 前端拆分与体验优化报告 为准。本轮已拆出导航、指标/状态原语、图片预览、素材弹窗、外部角色卡解析和共享工具,并完成桌面与 390×844 移动端浏览器回归。

当前构建产物:

  • pages/imagestudio/assets/index-CF6dVfCE.js
  • pages/imagestudio/assets/index-D4NekmM3.css
  • web/assets/index-djgvYVE7.js
  • web/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.css
    • web/assets/index-uM7AKRxw.js
  • 旧产物已被构建替换:
    • web/assets/index-B2NiW3rX.js
    • web/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 警告,未发现影响构建或测试的行为问题。