astrbot_plugin_imagestudio/docs/frontend-integration-queue.md

4 KiB

ImageStudio 前端接入队列

更新时间:2026-07-11

本文记录后端已经具备、但前端尚未完整接入的功能,以及当前前后端仍需闭环的能力。实施时按优先级从上到下推进。

P0:核心功能闭环

1. 多适配器真实路由(已完成第一阶段)

  • 后端加载并管理全部生成适配器,而非只使用 generation.provider。
  • 支持默认适配器切换、任务指定适配器和禁用状态。
  • 支持故障切换、路由优先级和不可用适配器跳过。
  • 将模型能力档案绑定到具体适配器与模型。
  • 删除适配器前检查是否仍被任务、路由或配置引用。

2. 配置快照管理(已接入)

  • 展示快照列表、详情、操作人、时间和变更原因。
  • 调用 settings/diff 展示当前配置与快照的差异。
  • 接入 settings/snapshots/{snapshot_id} 和 settings/rollback。
  • 回滚前展示影响范围并要求二次确认。

3. 存储维护(已接入)

  • 接入 storage/status,展示目录可写性、空间与存储状态。
  • 接入 storage/migrate,展示迁移计划、进度和结果。
  • 接入 media/index,支持媒体索引重建。
  • 接入 media/orphans,支持孤儿文件扫描和安全处理。

4. 图库完整管理(已接入)

  • 接入选中、取消选中、归档和批量操作。
  • 接入安全删除与永久删除,并提供二次确认。
  • 展示批量操作进度、失败项和可恢复状态。

P1:工作流与模型能力

5. 工作流生命周期管理(已接入)

  • 接入启动、取消和归档工作流。
  • 增加工作流状态操作栏。
  • 展示节点依赖上下文。
  • 接入工作流整体审查与历史版本恢复。

6. 审查策略页面(已接入)

  • 接入审查策略读取、校验和保存。
  • 配置角色一致性、候选图规则、错误与警告阈值。
  • 展示规则校验错误及影响范围。

7. 模型能力档案(已接入)

  • 展示已探测的适配器、模型和能力档案。
  • 区分生图、文本和视觉模型。
  • 支持重新探测、手动修正和能力状态管理。
  • 接入渲染计划兼容性校验。

8. 实时事件流(已接入增量轮询)

  • 接入 events/stream。
  • 实时更新生成进度、队列状态和日志。
  • 支持断线重连,并保留轮询降级方案。

P2:系统管理能力

9. 私伴插件集成管理(已接入)

  • 展示集成 Token 状态。
  • 支持 Token 轮换、集成启停和最近调用记录。
  • 提供每日穿搭联调测试入口。

10. 成本保护(已接入)

  • 接入 costs/guard。
  • 配置单次、每日和每月预算。
  • 支持超限警告或阻止策略。
  • 按适配器和模型展示费用异常。

11. 完整数据备份(SQLite 与媒体已接入;PostgreSQL 提供 pg_dump 提示)

  • 当前页面仅支持脱敏配置导入导出。
  • 后续增加 SQLite 数据库备份和恢复。
  • 设计 PostgreSQL 导出、恢复和版本兼容方案。
  • 支持图片、素材与清单文件打包,并生成校验值。

12. 系统诊断页面(已接入)

  • 展示 API 合同、前后端版本、Web Manifest 和健康状态。
  • 展示已挂载路由及当前用户权限矩阵。
  • 提供诊断信息复制与脱敏导出。

P3:补充与体验优化

13. 提示词扩写(已接入)

  • 接入 prompts/expand。
  • 支持扩写前后对比、一键采用和历史记录。

14. 素材包导入(已有预检与执行流程)

  • 完善导入预检、内容清单和冲突处理。
  • 展示导入进度、失败项和最终报告。

15. 页面权限统一(已完成主要入口)

  • 根据后端权限隐藏或禁用操作。
  • 统一展示无权限原因和只读状态。
  • 权限变化后自动刷新页面能力。

推荐实施顺序

多适配器真实路由 → 配置快照 → 存储维护 → 图库管理 → 工作流生命周期 → 审查策略 → 能力档案 → 实时事件流 → 系统管理能力