2026-07-10 01:25:15 +08:00
|
|
|
|
# ImageStudio UI / Workflow Progress Handoff
|
|
|
|
|
|
|
|
|
|
|
|
日期:2026-07-10
|
|
|
|
|
|
分支:`codex/ui-navigation-s130-s145`
|
|
|
|
|
|
范围:未提交变更检查、功能验证、静态构建、推送前总结。
|
|
|
|
|
|
|
2026-07-11 21:50:34 +08:00
|
|
|
|
> 历史记录说明:本文保留当日开发与构建状态。当前 AstrBot 生产页面由 `pages/imagestudio/index.html` 自动发现;插件通过 `context.register_web_api` 提供 API,页面 bridge 传相对 endpoint。下文 `/web` URL 是 Vite 预览记录,不表示 AstrBot 注册了该生产入口。
|
|
|
|
|
|
|
|
|
|
|
|
## 后续前端重构更新
|
|
|
|
|
|
|
|
|
|
|
|
本文件后续章节保留当时的阶段记录,当前前端状态以 [前端拆分与体验优化报告](ui-refactor-2026-07-10.md) 为准。本轮已拆出导航、指标/状态原语、图片预览、素材弹窗、外部角色卡解析和共享工具,并完成桌面与 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 项文档打包测试均通过。
|
|
|
|
|
|
|
2026-07-10 01:25:15 +08:00
|
|
|
|
## 推送前状态
|
|
|
|
|
|
|
|
|
|
|
|
- 已执行 `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/` 静态产物。
|
2026-07-11 21:50:34 +08:00
|
|
|
|
- 内置浏览器打开本地 Vite 预览(不是 AstrBot 生产入口):
|
2026-07-10 01:25:15 +08:00
|
|
|
|
- `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 警告,未发现影响构建或测试的行为问题。
|