# 角色工作流二次审计报告(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 产物不纳入源码语义审计。 ## 总结 项目已经存在完整的角色工作流主线,不应重写: ```text 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`