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