astrbot_plugin_imagestudio/docs/advanced-material-workflow-1.0.21.md

3.9 KiB

进阶素材导入与还原验证工作流

目标

进阶素材用于保存经过“文字提示词可还原性”验证的高可信素材。普通素材流程保持不变;进阶素材拥有独立数据库表、独立文件目录和独立后台任务,不会把验证图写入普通图库或角色工作流候选池。

状态机

上传源图
  -> recognition_queued
  -> recognizing
  -> ready_for_validation
  -> validation_queued
  -> validating
  -> awaiting_review
       |-- 接受 -> accepted -> advanced_materials(active)
       `-- 不接受 -> adjustment_required
                         -> validation_queued(下一轮)

失败状态为 recognition_failed 和 validation_failed,均保留源图、识别结果和已完成轮次,并允许人工重试。验证生图任务不会在插件重启后自动重放,避免重复付费;识别任务可以安全恢复。

运行中取消使用导入与轮次双重 compare-and-set。提供方迟到返回时只保留脱敏后的计费归因,生成文件会被删除,导入和轮次不会被重新改回 awaiting_review。插件启动会处理旧进程留下的全部 running/retrying 进阶任务,不等待五分钟陈旧窗口。

隔离边界

  • 普通素材表:materials
  • 进阶导入会话:advanced_material_imports
  • 进阶验证轮次:advanced_material_validation_attempts
  • 已封存进阶素材:advanced_materials
  • 普通素材目录:storage://materials/...
  • 进阶素材目录:storage://advanced_materials/...
  • 验证图不会创建 generation_images 记录,也不会进入普通图库。
  • 验证生图请求只携带识别提示词,不携带源图作为 input_images。

人工审核规则

  • 只有当前 awaiting_review 且验证图存在的轮次可以封存。
  • 模型或主观评分只作为记录,不能自动封存。
  • “不还原”必须填写调整描述;描述会形成新的提示词修订和验证轮次,旧轮次永久保留。
  • 封存时保存原始素材作为角色引用图,验证图仅作为还原证据。

高优先级规则

统一素材目录通过服务端解析 advmat_ 记录。只有 advanced_materials.status=active 的记录会获得可信的 advanced_verified 标记和优先级加成;普通素材即使伪造同名 metadata 也不会获得加成。用户明确锁定或设为必需的素材仍高于自动进阶加成。

内容安全、路由与预算

  • 规则审核只检查正向需求;负向提示词中的 nudity / gore / child 等排除词不会被当成用户想生成的内容。
  • 恐怖主义、极端主义、现实高危暴力和极端血腥在调用生图提供方前直接禁止并记录高优先级审计。
  • 合法成人内容只有在入口开关、用户/群组白名单和 NSFW 路由同时满足时才会分流。
  • 普通模型只有返回明确的成人/NSFW 内容安全拒绝时才允许向 NSFW 路由回退一次;通用安全错误、未成年人、恐暴或未知原因不会盲目回退。
  • safe/sensitive 内容始终使用 advanced_material_validation_generation 专用模型,不被全局普通生图路由覆盖。
  • advanced_materials.cost_budget 可配置统计窗口、任务/图片/费用上限和请求/图片/Token 单价。自动回退按最坏两次提供方请求预检。

主要接口

  • POST /advanced-material-imports/upload
  • GET /advanced-material-imports
  • GET /advanced-material-imports/{import_id}
  • POST /advanced-material-imports/{import_id}/retry
  • POST /advanced-material-imports/{import_id}/validation-attempts
  • GET /advanced-material-imports/{import_id}/validation-attempts
  • POST /advanced-material-imports/{import_id}/attempts/{attempt_id}/reject
  • POST /advanced-material-imports/{import_id}/attempts/{attempt_id}/accept
  • GET /advanced-materials
  • GET /material-catalog

上传、重试和创建验证轮次均立即返回任务信息;耗时识别和生图由持久 Worker 执行。