astrbot_plugin_imagestudio/docs/frontend-integration-queue.md

115 行
3.6 KiB
Markdown

# 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 导出、恢复和版本兼容方案。
- 支持图片、素材与清单文件打包,并生成校验值。
### 12. 系统诊断页面
- 展示 API 合同、前后端版本、Web Manifest 和健康状态。
- 展示已挂载路由及当前用户权限矩阵。
- 提供诊断信息复制与脱敏导出。
## P3:补充与体验优化
### 13. 提示词扩写
- 接入 `prompts/expand`。
- 支持扩写前后对比、一键采用和历史记录。
### 14. 素材包导入
- 完善导入预检、内容清单和冲突处理。
- 展示导入进度、失败项和最终报告。
### 15. 页面权限统一
- 根据后端权限隐藏或禁用操作。
- 统一展示无权限原因和只读状态。
- 权限变化后自动刷新页面能力。
## 推荐实施顺序
`多适配器真实路由 → 配置快照 → 存储维护 → 图库管理 → 工作流生命周期 → 审查策略 → 能力档案 → 实时事件流 → 系统管理能力`