3.3 KiB
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 发现
- 详细工作流
count=4/5仍是一条 task、一次 provider 请求和一个超时;QueueWorker存在但未启动。 - 后端生成成功后自动选第一张,前端又默认多选候选;比较、多选、最终采用语义混合。
- 详细工作流没有稳定 round/candidate ID、显示码、偏好和候选池。
- 当前交叉审核是多个 Vision LLM 检查同一张图,不是不同生图模型生成复审候选。
- 最终入库把
final_packnode_id 与style_lock图片组合提交,违反 HistoryService 的图片归属校验,实际会失败。 - 当前最终入库由多个独立请求拼接,不是原子档案卡封存。
- 分支创建和复制非事务;main 可能从列表消失;父链/环/未完成切点未校验。
- prompt plan、material bindings、stage inputs 存在 workflow 级 metadata,分支之间会串数据。
- 聊天选图只 select 不 adopt,不能推进;非头像阶段还可能覆盖 profile avatar。
- 聊天快速角色确认后仍走 quick_profile 规划流,并未复用 character_fast 四图流。
- 多数聊天 ID 操作缺资源 owner 链校验。
App.vue约 19,790 行,存在 return 后不可达 mock 工作流、两套比较弹窗和多处历史关闭逻辑。
安全发现
仓库根目录存在一个被 .gitignore 排除且未跟踪的 .env.* 本机交接文件,其中含明文凭据。审计没有记录或回显其值。处理要求:
- 相关凭据应轮换。
- 继续使用环境变量或本机 secret store。
.env*不得进入日志、测试输出、Git 或发布包。
实施依据
完整小版本、验收标准和部署约束见:
docs/workflow-secondary-audit-development-queue.mdCHANGELOG.md