astrbot_plugin_imagestudio/docs/workflow-secondary-audit-2026-07-15.md

3.3 KiB

角色工作流二次审计报告(2026-07-15)

审计范围

本次以源码而非构建产物为准,完成了仓库全部业务源码、配置和 Markdown 的覆盖阅读:

  • 268 个文本源码/配置/Markdown 文件
  • 约 60,523 行
  • Python:160 个文件,约 27,945 行
  • Vue:27 个文件,约 25,505 行
  • TypeScript:38 个文件,约 2,045 行
  • SQL:13 个迁移,约 308 行
  • Markdown:20 个文件,约 2,799 行
  • JSON/YAML/HTML:10 个文件

生成后的 pages/imagestudio/assets 与 web/assets 作为构建一致性产物核对,不作为业务逻辑来源;node_modules、运行数据和 release 产物不纳入源码语义审计。

总结

项目已经存在完整的角色工作流主线,不应重写:

character profile
→ character_gradual workflow
→ workflow nodes
→ generation tasks / images
→ history / stage handoff
→ sequential progression

已有能力包括:

  • 人设导入后逐节点解锁;未来节点可查看不可操作。
  • 提示词规划、素材绑定、上游图片依赖和节点模型路由。
  • 节点候选池、多选展示、图片采用和阶段交接。
  • 节点/任务失败、重试、取消、死信与清理。
  • 快速角色四图的独立节点和身份一致性锁。
  • 分支表、分支节点复制、历史快照和切换接口。
  • VLM 视觉质检、提示词治理、NSFW 路由和恐暴禁止。
  • AstrBot /影棚、/yp 命令与白名单骨架。

此次调整的正确方式是在现有链路上补齐“轮次/候选聚合层”和修复现有接线,不建立第二套工作流。

P0 发现

  1. 详细工作流 count=4/5 仍是一条 task、一次 provider 请求和一个超时;QueueWorker 存在但未启动。
  2. 后端生成成功后自动选第一张,前端又默认多选候选;比较、多选、最终采用语义混合。
  3. 详细工作流没有稳定 round/candidate ID、显示码、偏好和候选池。
  4. 当前交叉审核是多个 Vision LLM 检查同一张图,不是不同生图模型生成复审候选。
  5. 最终入库把 final_pack node_id 与 style_lock 图片组合提交,违反 HistoryService 的图片归属校验,实际会失败。
  6. 当前最终入库由多个独立请求拼接,不是原子档案卡封存。
  7. 分支创建和复制非事务;main 可能从列表消失;父链/环/未完成切点未校验。
  8. prompt plan、material bindings、stage inputs 存在 workflow 级 metadata,分支之间会串数据。
  9. 聊天选图只 select 不 adopt,不能推进;非头像阶段还可能覆盖 profile avatar。
  10. 聊天快速角色确认后仍走 quick_profile 规划流,并未复用 character_fast 四图流。
  11. 多数聊天 ID 操作缺资源 owner 链校验。
  12. App.vue 约 19,790 行,存在 return 后不可达 mock 工作流、两套比较弹窗和多处历史关闭逻辑。

安全发现

仓库根目录存在一个被 .gitignore 排除且未跟踪的 .env.* 本机交接文件,其中含明文凭据。审计没有记录或回显其值。处理要求:

  • 相关凭据应轮换。
  • 继续使用环境变量或本机 secret store。
  • .env* 不得进入日志、测试输出、Git 或发布包。

实施依据

完整小版本、验收标准和部署约束见:

  • docs/workflow-secondary-audit-development-queue.md
  • CHANGELOG.md