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

72 行
3.3 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 角色工作流二次审计报告(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`