astrbot_plugin_imagestudio/审计/02-BUG清单.md

796 行
87 KiB
Markdown

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

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

# 02 · BUG 清单(缺陷类发现汇总)
**范围**:`_raw.json` 中 category ∈ {bug, security, perf} 的全部 106 条发现,剔除被对抗式复核推翻的 12 条,**本清单收录 94 条**。
**严重度**:以复核结论为准(复核对 P0/P1 逐条重定级),未经复核的沿用原判。
**基线事实**:后端 263 个 pytest 全部通过(188 秒),前端 26 个 node:test 全部通过。**代码跑得起来,问题在设计边界与信任边界,不在语法与冒烟。**
| 最终严重度 | 条数 |
| --- | --- |
| P0-致命 | 1 |
| P1-严重 | 10 |
| P2-中等 | 64 |
| P3-轻微 | 19 |
| **合计** | **94** |
---
## 0. 立即处置(今天就要动手,按紧迫度排序)
### 0.1 【P0】凭据泄露:轮换 + 清理,两件事都要做,缺一无效
`.env.imagestudio_codex_handoff.yaml`(仓库根,3506 字节)含 5 类可直接使用的真实凭据。该文件**已被 `.gitignore:39` 的 `.env*` 规则覆盖,`git ls-files` / `git log --all --diff-filter=A` 均确认从未入库** —— 但泄露通道根本不走 git:打包脚本用整目录复制而非 `git archive`,`.gitignore` 对它零约束。
实测确认的扩散面(本次审计逐个 `tar -tf` / `unzip -l` 验证):
| 载体 | 数量 | 说明 |
| --- | --- | --- |
| `.tmp/*.tar.gz` / `*.tar` 归档 | **19** | 1.0.35/36/37、1.0.38~41-*、1.0.64/65、1.0.67-*/68-*、imagestudio-1.0.66-deploy-*、imagestudio-material-*(5 个)、nas-deploy-worktree-20260724(.clean).tar |
| `.tmp/*.zip` 归档 | **2** | 1.0.62.zip、1.0.63.zip(原报告未计入,本次补充确认) |
| `.tmp/*.zip.b64` | 1 | `astrbot_plugin_imagestudio-1.0.62.zip.b64`(56 MB,base64 编码的同一份泄露) |
| `.tmp/deploy-*` 暂存目录 | 8 | 各含一份 3506 字节副本 |
| 仓库根原始文件 | 1 | — |
`.tmp/deploy_remote.sh:3` 指明推送目标为 NAS 上的 `/volume2/Dockers/qqbot/astrbot-ops-pro/data/plugins/astrbot_plugin_imagestudio`,`.tmp/upload_via_ssh.py` / `deploy_imagestudio_10*.sh` 用 ssh/scp 执行推送 —— 即这些归档已经离开本机。
讽刺点:该文件第 80 行自己写着 `rules.redact_secrets: true`;`grep -rn "redact_secrets" --include=*.py` 全仓零命中,它只是给 AI 看的自然语言备注,没有任何代码强制。
#### 轮换清单(按此顺序执行,**不要只删文件**)
> 归档已上传 NAS,必须假定凭据已泄露。删除文件不能撤销泄露,只有轮换可以。
| # | 凭据 | 文件位置 | 特征(不复述真值) | 处置动作 |
| --- | --- | --- | --- | --- |
| 1 | LLM API Key A | `:25` `model_sites.site_a.api_key_plaintext` | 67 字符,前缀 `sk-3`,weilai.chat | 在该站点控制台**作废旧 key**并签发新 key;检查账单是否有异常调用 |
| 2 | LLM API Key B | `:45` `model_sites.site_b.api_key_plaintext` | 51 字符,前缀 `sk-B`,botcf.com | 同上 |
| 3 | PostgreSQL 口令 | `:57-61` host/port/database/user/password | 主机 `192.` 段内网地址、端口 5 位、用户 9 字符、口令 11 字符明文 | `ALTER ROLE ... WITH PASSWORD`;同时确认该 PG 是否可从 NAS 网段直连,必要时收紧 `pg_hba.conf` |
| 4 | AstrBot 管理员 JWT | `:73` `astrbot.admin_token_plaintext` | 136 字符 HS256 JWT,前缀 `eyJh`,exp≈2026-07-12(已过期) | **仍需更换 AstrBot 的 JWT signing secret** —— token 过期不等于安全,持有 #5 即可随时重签新 token |
| 5 | AstrBot 管理员口令 | `:75-76` `admin_username` / `admin_password_plaintext` | 用户名 9 字符前缀 `Yoki`,口令 13 字符明文,**永不过期** | 立刻改密;该账号托管本插件全部 166 条 API |
#### 清理命令
```bash
cd "D:/CODEX/projects/AstrBot ImageStudio"
# 1) 先确认清单(不要盲删)
for f in .tmp/*.tar.gz .tmp/*.tar; do
tar -tf "$f" 2>/dev/null | grep -q '\.env\.imagestudio' && echo "LEAK: $f"
done
for z in .tmp/*.zip; do
unzip -l "$z" 2>/dev/null | grep -q '\.env\.imagestudio' && echo "LEAK: $z"
done
# 2) 删除全部泄露归档 + base64 副本 + 8 个 staging 目录
rm -f .tmp/astrbot_plugin_imagestudio-1.0.3{5,6,7}.tar.gz \
.tmp/astrbot_plugin_imagestudio-1.0.{38,39,40,41}-*.tar.gz \
.tmp/astrbot_plugin_imagestudio-1.0.6{4,5}.tar.gz \
.tmp/astrbot_plugin_imagestudio-1.0.6{7,8}-*.tar.gz \
.tmp/astrbot_plugin_imagestudio-1.0.6{2,3}.zip \
.tmp/astrbot_plugin_imagestudio-1.0.62.zip.b64 \
.tmp/imagestudio-1.0.66-deploy-*.tar.gz \
.tmp/imagestudio-material-*.tar.gz \
.tmp/nas-deploy-worktree-20260724*.tar
rm -rf .tmp/deploy-1.0.35 .tmp/deploy-clean-1.0.3{5,6,7} .tmp/deploy-stage-1.0.4{0,1}-* .tmp/deploy-stage-1.0.3{8,9}-*
# 3) NAS 侧:删除已上传的同名包与解包目录内的副本
# (HOST 换成 deploy_remote.sh 里实际使用的目标)
ssh "$HOST" 'PLUGIN_DIR=/volume2/Dockers/qqbot/astrbot-ops-pro/data/plugins/astrbot_plugin_imagestudio; \
rm -f "$PLUGIN_DIR"/.env.imagestudio_codex_handoff.yaml; \
find /volume2/Dockers/qqbot -maxdepth 4 -name "astrbot_plugin_imagestudio-*.tar.gz" -o -name "imagestudio-*.tar.gz" | xargs -r rm -f'
# 4) 本地原始文件(轮换完成后再删,删之前先记下要迁移哪些字段)
rm -f .env.imagestudio_codex_handoff.yaml
```
#### 防复发(同一天做完)
打包脚本改用 git 视角,并加硬断言:
```bash
git archive --format=tar.gz --prefix=astrbot_plugin_imagestudio/ \
-o "dist/plugin-$(git describe --always).tar.gz" HEAD
tar -tf "dist/plugin-$(git describe --always).tar.gz" | grep -qE '(^|/)\.env' \
&& { echo "SECRET LEAK IN ARCHIVE"; exit 1; }
```
凭据改走环境变量注入 —— `_conf_schema.json` 已有 `*_api_key_env_var` 字段,设计上本就支持,配置文件里只留变量名。
> **本节的严重度标签说明**:0.2 与 0.3 的最终定级是 **P2**(复核把它们从 P1 降级,理由见 §5 对应行与 §2 链路 A 的第 ⑥ 环说明)。它们之所以仍排在"立即处置",是因为**修复成本极低(各十几行)而断链收益极高**,不是因为严重度高。0.1 是唯一的 P0,0.4 是 P1(对应 §4 的 P1-8)。
### 0.2 【P2·但优先做】把 `storage.*` 纳入配置校验(堵住宿主机任意文件读取)
`settings_service.validate()`(`backend/services/settings_service.py:240` 起)只校验 `generation` / `vision` / `database` / `prompt_governance` / `advanced_materials` 五段,**`storage` 段一次都没出现**(该文件 `grep -i storage` 仅命中 `:195` 的 schema 描述行)。配合 `core/runtime_paths.py:43-45` 对绝对路径原样放行,`VfsStorage` 的沙箱边界完全由可写配置决定。详见 §2 攻击链。
最小修复(一处即可断链):在 `validate()` 中加 storage 段校验,或在 `VfsStorage._root_paths()`(`core/storage.py:105-108` 的锚点来源)强制把每个 root 收敛到 `get_runtime_data_root().resolve()` 之下。
### 0.3 【P2·但优先做】给 `storage/migrate` 加覆盖确认与审计
`core/storage.py:51-53` 计算了 `will_overwrite` 却**只放进返回体、没有任何分支用它阻断**;`_copy_path`(`:182-200`)用 `shutil.copy2` 静默覆盖。`backend/routes/storage_routes.py:46` 的 `dry_run=as_bool(payload.get("dry_run"), default=True)` 可由请求体传 `false`。该路由未 import AuditService,全程无审计记录。
### 0.4 【P1】PostgreSQL 部署当场不可用 —— 3 行字面量 `%`
`database/repositories/profile_repository.py:46 / :73 / :99` 三份逐字重复的 `LIKE '%"final_archive_history_id"%'`,在 `backend: postgresql` 下会被 psycopg 当作 %-format 模板展开而报错,`get()` 与 `list()` 两个最核心读接口 100% 失败。`config.yaml:153-167` 把 postgresql 作为受支持配置对外暴露 —— 只要有人切过去,角色列表和详情立刻全挂。改成参数绑定即可,工作量 S。
---
## 1. P0 汇总表
| # | 标题 | 位置 | 影响一句话 | 修复工作量 |
| --- | --- | --- | --- | --- |
| P0-1 | 真实 API Key / DB 口令 / 管理员 JWT / 管理员明文口令被打进 19 个 tar 归档 + 2 个 zip 并推送到 NAS | `.env.imagestudio_codex_handoff.yaml:25/45/57-61/73/75-76`;打包链路 `.tmp/deploy_remote.sh:3`、`.tmp/upload_via_ssh.py` | 任何拿到部署包的人可盗刷两个模型站点额度、直连业务 PostgreSQL 读写、以管理员身份接管托管全部 166 条 API 的 AstrBot 实例 | **M**(轮换 5 类凭据 + 清理 NAS + 改打包脚本,均为运维动作,无代码改动) |
### 1.1 原判 P0,经复核降级(不再计入 P0,但必须知道它们被降级的理由)
| 原判 | 现判 | 标题 | 位置 | 降级理由(复核结论原意) |
| --- | --- | --- | --- | --- |
| P0 | **P1** | 桥接层给所有登录用户发放全部权限 | `main.py:104-106`、`main.py:2337` | 未登录时权限为空集,`require_authenticated` 会拒绝 —— 这是"已认证用户之间缺乏权限分级",不是未授权访问。单管理员 dashboard 部署下影响退化为无 |
| P0 | **P1** | workflow/node/image/job/history 五条链路无归属校验(IDOR) | `backend/routes/workflow_routes.py:50` 等 | 复核确认成立、无上游守卫,但同样受限于"必须先通过 AstrBot 面板认证" |
| P0 | **P2** | `dispatch_extension_request` 从不检查 `RouteMatch.permission` | `adapters/astrbot_adapter.py:171-187` | 技术事实全部核实,但 handler 内的 `require_*` 守卫齐整存在(复核逐条验过 round/data_backup/settings/integration/media/storage 各路由),矩阵不强制是纵深防御缺失而非当前可利用漏洞 |
| P0 | **P1** | `displayMediaUrl()` 在 computed/render 中产生副作用 | `frontend/standalone-web/src/App.vue:11146` | 缺陷成立且行号逐条核对无误;降级仅因它是性能/内存问题而非数据正确性或安全问题 |
---
## 2. 可利用攻击链
### 链路 A:已认证用户 → 宿主机任意文件读取
每一环都有代码支撑,环环相扣,任何**一环**被堵住即断链。
```
① 通过 AstrBot 面板登录(任意账号)
main.py:2337 permissions = BRIDGE_PERMISSIONS if username or user_id else frozenset()
main.py:104-106 BRIDGE_PERMISSIONS = {"can_write","can_manage_config","can_manage_materials","can_retry_tasks"}
→ 只要能取到 username/user_id,就拿到 can_manage_config
↓
② POST settings/save,把 storage.temp_path 改为 "/" 或 "C:/"
route_registry.py:156 settings/save → "config" 档
backend/services/settings_service.py:240 起 validate() 完全不校验 storage 段
core/config_service.py:74-84 storage.*_path 直接 str() 落库,无 sanitize;load() 无缓存,改完立刻生效
main.py 的 _RUNTIME_PATH_TO_ASTRBOT_KEY 白名单里没有 storage.temp_path,不会被 _restore_runtime_managed_fields 还原
↓
③ resolve_data_path 对绝对路径原样放行
core/runtime_paths.py:43-45
resolved = Path(path).expanduser()
if resolved.is_absolute():
return resolved # ← 无白名单、无前缀约束
↓
④ VfsStorage 的越界检查被架空
core/storage.py:105-108
resolved_root = resolve_data_path(root_path).resolve()
resolved_path = (resolved_root / relative).resolve()
if resolved_path != resolved_root and resolved_root not in resolved_path.parents:
raise ApiError(ErrorCode.FORBIDDEN, "storage uri escapes its root", {"uri": uri})
→ 该检查只保证"不越出 root",而 root 本身已被②改成 /
实测(未改任何源码):
StorageConfig(temp_path='C:/Windows')
VfsStorage(...).resolve_uri('storage://temp/System32/drivers/etc/hosts')
-> C:\Windows\System32\drivers\etc\hosts exists=True
↓
⑤ GET media/index?root=temp 枚举全盘 → GET media/sign 为任意路径签发令牌
route_registry.py:169 media/sign → "read"
route_registry.py:170 media/index → "read"
core/media_proxy.py:49-51 签名 URL 形如 /api/plug/.../media/fetch?token=<payload>.<sig>,payload 内不含签发者标识
↓
⑥ GET media/fetch 取走文件内容
route_registry.py:173 RouteSpec("GET","media/fetch",...,"public_token")
route_registry.py:28 "public_token": {"auth_required": False, "required_permission": None, ...}
→ 全仓唯一 auth_required: False 的路由
```
**关于第 ⑥ 环,必须如实说明(这是复核推翻的部分)**:`PERMISSION_MATRIX` 里的 `auth_required` 是一份**说明性清单**,不是执行开关 —— 全仓 `grep "auth_required"` 只命中 `route_registry.py` 自身,消费者仅 `adapters/webui_adapter.py:19` 与 `backend/services/contract_service.py:17-18`,两者都只是把它塞进 manifest/contract 返回给前端。真正的鉴权是两层:handler 内的 `require_authenticated`(`core/security.py:9`)+ 宿主 AstrBot 的中间件。`backend/routes/media_routes.py:56-62` 的注释明确说明 `media/fetch` 仍走宿主已鉴权的扩展路由面(浏览器 `<img>` 拿不到 JWT 才另开 `media/payload`)。
因此**"把签名 URL 交给任何未认证第三方去取"这一步不成立,链路终点是"已认证用户读取宿主机任意文件",不是"无认证外传"**。这也是复核把该条从 P1 降到 P2 的唯一理由。但请注意:由于第 ① 环,"已认证用户"在插件内部等价于"配置管理员",且插件自身文档 `docs/final-release-audit-2026-07-22.md:36-42` 已把同类问题记为 P1-1,并写明"当前可接受边界:仅限明确声明的可信 AstrBot 管理员工作台" —— 只要部署里存在第二个 WebUI 账号,或面板被反代给多人,这条链就有实际受害者。
**推荐断链点(按性价比排序)**:③ 或 ④(一次改动堵死全部 storage 相关接口)> ② > ①。
### 链路 B:同一入口的任意写 → 宿主机代码执行
```
①(同上)拿到 can_manage_config
↓
② POST storage/migrate {"source_uri": ..., "target_uri": ..., "dry_run": false}
route_registry.py:168 storage/migrate → "config"
backend/routes/storage_routes.py:36-47 只有 require_config_manager(ctx);dry_run 由请求体控制
↓
③ 覆盖保护是空的
core/storage.py:51-53
will_overwrite = target_path.exists()
if not dry_run:
_copy_path(source_path, target_path) # will_overwrite 从未参与任何判断
core/storage.py:182-200 _copy_path -> shutil.copy2,目标已存在时静默覆盖
唯一守卫是 :188-191 的 "target 不能在 source 之内",与覆盖保护无关
↓
④ 结合链路 A 的 ②③④,source/target 的 root 均可指向任意绝对路径
→ 覆盖 AstrBot 配置、投毒其他插件目录、写入启动脚本目录
全程无审计(storage_routes.py 未 import AuditService)
```
**复核修正**:`resolve_uri` 内的 `split_uri`(`core/storage.py:127-128`)会拒绝 `..` 与绝对相对路径,所以"任意路径写入"必须先经 root 改配置这一步 —— 该链**依赖链路 A 的第②③环**,两条链应一起修,修好 root 约束后 B 链的危害同步收敛为"仅在受限根之间复制"。
---
## 3. P0 逐条详述
### P0-1 · 真实凭据被打进部署归档并推送到 NAS
**位置**
`.env.imagestudio_codex_handoff.yaml:25`(API Key A)、`:45`(API Key B)、`:57-61`(PostgreSQL 连接串)、`:73`(管理员 JWT)、`:75-76`(管理员账号/口令)
打包与推送:`.tmp/deploy_remote.sh:3`、`.tmp/upload_via_ssh.py`、`.tmp/deploy_imagestudio_10{35,36,37,64}.sh`
**问题**
文件本身被 `.gitignore:39` 的 `.env*` 正确忽略 —— `git check-ignore -v` 返回 `.gitignore:39:.env*`,`git ls-files | grep env` 只有 `frontend/env.d.ts`,`git log --all --diff-filter=A` 为空。**这恰恰制造了误导性的安全感**:泄露不走 git,走的是"整目录复制打包"。8 个 `.tmp/deploy-*` 暂存目录各留一份 3506 字节副本,19 个 tar/tar.gz + 2 个 zip 归档各封装一份,其中一份还被 base64 展开成 56 MB 的 `.b64`。
**真实证据**
```
$ git ls-files | grep -i env
frontend/env.d.ts # 仅此一条,泄露文件从未入库
$ tar -tf .tmp/astrbot_plugin_imagestudio-1.0.35.tar.gz | grep env
astrbot_plugin_imagestudio/.env.imagestudio_codex_handoff.yaml
$ tar -tf .tmp/astrbot_plugin_imagestudio-1.0.41-20260720-101338.tar.gz | grep env
./.env.imagestudio_codex_handoff.yaml
# 本次审计复测(19 tar/tar.gz + 2 zip 命中,8 个 staging 目录各含一份)
# .tmp/deploy_remote.sh:3
PLUGIN_DIR=/volume2/Dockers/qqbot/astrbot-ops-pro/data/plugins/astrbot_plugin_imagestudio
# 文件内自称的保护措施(第 80 行),全仓 grep --include=*.py 零命中:
rules.redact_secrets: true
```
**影响**
拿到任意一个部署包即可:盗刷两个模型站点额度;直连内网 PostgreSQL 读写业务库(角色档案、生成记录、审计日志、配置快照 —— 而配置快照本身又是明文密钥的第二个副本,见 P2 表 `settings_service.py:614`);用管理员口令登录 AstrBot 并重签 JWT,接管托管本插件 166 条 API 的整个实例。JWT 已过期不构成缓解 —— 明文口令永不过期。
**修复**
按 §0.1 执行:先轮换 5 类凭据(这一步不可省略,删文件不能撤销已上传的副本),再清理本地 21 个归档 + 1 个 b64 + 8 个 staging 目录 + 根文件,再清理 NAS,最后把打包脚本换成 `git archive` 并加 `tar -tf | grep -qE '(^|/)\.env' && exit 1` 断言。凭据长期改走 `_conf_schema.json` 已有的 `*_api_key_env_var` 环境变量注入。
---
## 4. P1 逐条详述
### P1-1 · 桥接层给所有登录用户发放全部权限,PERMISSION_MATRIX 在运行时被架空
**位置** `main.py:104-106`(定义)、`main.py:2337`(赋权);受影响执行点 `core/security.py:17-37`、`backend/route_registry.py:9-29`
**问题** 插件页是前端唯一通路,其 `RequestContext` 构造只有一个分支:能取到 username/user_id 就给满四项能力,否则给空集。于是 `config`(22条)+`materials`(38条)+`retry`(8条) 共 68 条路由的权限档,对桥接通路全部塌缩成 `read`。
**真实代码**(逐字核对,含原有注释)
```python
# main.py:104-106
BRIDGE_PERMISSIONS = frozenset(
{"can_write", "can_manage_config", "can_manage_materials", "can_retry_tasks"}
)
# main.py:2333-2337
# AstrBot authenticates extension routes before invoking the plugin, but
# PluginRequest currently exposes only the authenticated username. Grant
# the capabilities that exist today explicitly instead of a wildcard so a
# future permission cannot become enabled accidentally.
permissions = BRIDGE_PERMISSIONS if username or user_id else frozenset()
```
**这不是疏忽。** 注释本身写明了原因(上游 `PluginRequest` 只暴露 username,读不到角色)与取舍(显式列举而非通配符 `*`,避免未来新增权限被意外打开)。仓库文档 `docs/final-release-audit-2026-07-22.md:36-42` 也已把它记为 P1-1 并声明"当前可接受边界:仅限明确声明的可信 AstrBot 管理员工作台"。**这是一个被记录在案、有边界声明的技术债,不是不懂安全。** 问题在于这个边界声明没有任何机制强制 —— 部署方多开一个 WebUI 账号,或把面板反代出去,边界就静默失效了。
**影响** 已认证用户之间零权限分级:任意登录用户可 `POST settings/save`(改数据库后端与密钥环境变量名)、`POST settings/rollback`、`POST backups/{id}/restore`(覆盖全量数据)、`POST integrations/private-companion/token/rotate`、`POST jobs/failed/clear`。这也是 §2 两条攻击链的第一环。另:`resource_access_service.py:82` 的 `ctx.has_permission("can_manage_all_profiles")` 子条件在 Web 通路上恒假(`RequestContext.system()` 的 `"*"` 分支仍有效,不是整段死代码)。
**修复**
1. 短期、当天可做:在 `config.yaml` 增加显式白名单(如 `security.config_admin_users`),`main.py:2337` 改为按 username 命中白名单才追加 `can_manage_config` / `can_manage_materials`,未命中只给 `can_write` + `can_retry_tasks`。这不需要上游改 `PluginRequest`。
2. 中期:从 AstrBot 请求上下文尝试解析角色(`g` 上的 role/claims),解析失败时**降级到最小集**而非最大集。
3. 配套:把这条边界写进启动自检 —— 若白名单为空且检测到多个不同 username 访问过,打一条 warning。
### P1-2 · workflow / node / image / job / history 五条链路无归属校验(IDOR)
**位置** `backend/routes/workflow_routes.py:50`;同类散布于 `node_routes.py:79`(get_node)、`image_routes.py:22`(list_images)、`job_routes.py:19`(list_jobs)/`:44`(get_job)、`history_routes.py:35`;根因在 `backend/services/workflow_service.py:146-164`、`:960` 与 `backend/services/queue_service.py:91`
**问题** 仓库里明确存在归属链服务 `backend/services/resource_access_service.py`(模块 docstring:调用方必须拥有资源链末端的 profile),实现了 `require_profile/workflow/node/image/task` 五个方法,`_can_access` 比对 `ctx.actor_id == owner_user_id`。profile 路由和 round 路由都接上了,**这五条链路漏改了** —— service 方法签名里根本没有 `ctx`。
**真实代码**
```python
# backend/routes/workflow_routes.py:50-61 —— 只校验"已登录"
def get_workflow(ctx, workflow_id, service=None) -> dict:
workflow_service = service or _create_workflow_service()
def action() -> dict[str, Any]:
require_authenticated(ctx)
return workflow_service.get_workflow(workflow_id).to_dict() # 无 ctx
return handle_request(ctx, action)
# backend/services/workflow_service.py:146-150
def list_workflows(self, profile_id: str) -> list[ProfileWorkflow]: # 无 ctx
self._ensure_profile_exists(profile_id) # 只判存在,不判归属
return self.workflow_repository.list_workflows(profile_id)
def get_workflow(self, workflow_id: str) -> WorkflowDetail: # 无 ctx
# backend/services/workflow_service.py:650
def get_node(self, node_id: str) -> WorkflowNode: # 无 ctx
```
**影响** 任意登录用户可枚举/读取/修改他人资源:`GET profiles/{他人id}/workflows`、`GET|PUT workflows/{id}`、`POST workflows/{id}/start|cancel|archive|execute-character`(直接花对方模型额度出图)、`POST profiles/{他人id}/workflows`、`GET|PUT nodes/{id}`、`POST nodes/{id}/generate`。`GET jobs` 无任何 owner 维度,且 `GenerationTask.to_dict()` 含完整 `request`(他人提示词、参考图 URI、模型路由)。行为还自相矛盾:`GET nodes/{id}` 能读到他人节点,而 `GET nodes/{id}/rounds` 会正确 404 —— 这正是"漏改"而非"设计如此"的铁证。
**修复**
1. `WorkflowService.list_workflows/get_workflow/get_node/list_nodes` 增加 `ctx` 参数,内部走已有的 `require_workflow` / `require_node`。
2. `QueueService.list_jobs` 与 `ImageService.list_images` 增加 `owner_user_id` 过滤参数,路由层传 `ctx.actor_id`(持 `can_manage_all_profiles` 时传 None)。
3. `HistoryService` 相关方法前置 `require_workflow`。
4. 补越权矩阵测试:用户 A 建资源,用户 B 对全部路由逐条请求,断言 404/403。这类测试一次写好可长期防回归。
### P1-3 · 客户端自带 `content_permissions` / `entrypoint`,可绕过成人内容路由闸门
**位置** `backend/services/generation_service.py:2352`(`_entrypoint`)与 `:2366`(`_permission_context`);触发点 `:1461`、`:1503`(`_govern_prompt`)与 `:1578`、`:1581`(`_content_safety_fallback`);入口 `backend/routes/node_routes.py:132-146`
**问题** `POST nodes/{node_id}/generate` 的 payload 原样透传给 `GenerationService.generate_node`,而"用户是否被允许成人内容"这个裁决输入**直接从请求体里取**,全程不引用 `ctx`。
**真实代码**
```python
# generation_service.py:2366
def _permission_context(payload: dict[str, Any]) -> dict[str, Any]:
configured = payload.get("content_permissions") if isinstance(payload.get("content_permissions"), dict) else {}
result = {
**configured,
"adult_user_allowed": bool(configured.get("adult_user_allowed", payload.get("adult_user_allowed", False))),
"quota_allowed": bool(configured.get("quota_allowed", payload.get("quota_allowed", True))),
}
# generation_service.py:2352
def _entrypoint(payload): value = _optional_text(payload.get("entrypoint") or payload.get("platform") or payload.get("source")) or "web"
# 消费点 prompt_governance_service.py:262-267
entry_allowed = bool((self.config.get("entrypoints") or {}).get(entrypoint, False))
user_allowed = bool(permissions.get("adult_user_allowed", False))
quota_allowed = bool(permissions.get("quota_allowed", True))
```
`node_routes.py:132` 起的 `generate_node` 中,`action()` 只有一行 `require_write(ctx)`,随后直接把 payload 交给 service。
**影响** 服务端 `prompt_governance.routing.adult_auto_route_enabled` 为 true 时,任意登录用户 POST `{"content_permissions": {"adult_user_allowed": true, "adult_group_allowed": true, "quota_allowed": true}, "entrypoint": "<配置放行的入口>"}` 即可让 adult_allowed 级提示词自动路由到 `nsfw_route`,同时绕过配额判定。**聊天侧是对的** —— `chat_workflow_service` 由服务端 `_content_permissions(config, chat)` 生成,唯独 Web 路由缺这一步。
**修复** 在路由层剥离客户端提供的 `content_permissions` / `adult_*` / `quota_allowed` / `entrypoint` / `platform` / `source` 字段,由服务端按 `ctx.actor_id` 查配置白名单重建(直接复用 `chat_workflow_service._content_permissions` 的逻辑),`entrypoint` 在 Web 路径硬编码为 `"web"`。这是一处"删输入"的改动,不引入新逻辑。
### P1-4 · 聊天媒体导入把任意字符串当本地文件路径读取
**位置** `backend/services/chat_media_import_service.py:33-36`
**问题** `import_image` 的兜底分支:既不是 `storage://`、也不是 `data:image/`、也不是 `http(s)://` 时,直接把字符串当本地路径读取,无根目录约束、无白名单、无图片魔数校验。
**真实代码**
```python
# backend/services/chat_media_import_service.py:30-36
elif text.startswith(("http://", "https://")):
body = read_http_response_limited(text, timeout_seconds=30, max_bytes=MAX_CHAT_IMAGE_BYTES)
extension = Path(urlsplit(text).path).suffix.lstrip(".").lower() or "jpg"
else:
source = Path(text).expanduser().resolve()
body = source.read_bytes() # <- 无任何根目录约束
extension = source.suffix.lstrip(".").lower() or "jpg"
```
调用链完全可达且无守卫:`adapters/astrbot_media_adapter.py:15-19` 逐个取消息 Image 组件的 `("url","file","path","image_url")` 属性,首个非空即返回,零格式校验 → `main.py:1161 references = image_references_from_event(event)` → `main.py:1167 asyncio.to_thread(self.chat_workflow_service.import_material, reference, ...)` → `chat_workflow_service.py:948 self.media_importer.import_image(image_reference)`,字符串原样透传。
**加重情节**:`main.py:1160` 的 `imagestudio_import_material` 处理函数**完全没有** `command_allowed(config, action, context)` 权限门,而同文件其他命令入口都有。
**影响** 消息组件的路径字段一旦可被影响(`file:///`、相对路径、`~/.astrbot/...`),任意宿主文件被读入并作为素材落盘到 `storage://materials/chat/...`,随后可通过素材列表接口读回 —— 等价于任意文件读取 + 外带。非图片内容也会被当图片存储(扩展名只是被强制改写成 jpg)。超大 data URI 会先完整解码进内存再判超限。
**修复**
1. 删除本地路径兜底分支;确需保留则对显式配置的缓存根做 `Path.resolve()` 前缀约束(`backend/services/web_hosting_service.py:58-67` 的 `_resolve` 已写对同类逻辑,直接照抄)。
2. 落盘前统一走 `core.image_formats.detect_image_format(body)`,返回 None 则拒绝,并用检出的 `image_format.extension` 而非用户给的后缀。
3. `data:` 分支先按 `len(encoded) > ((MAX_CHAT_IMAGE_BYTES + 2) // 3) * 4` 预检再解码(`engines/single_flow.py:398-404` 已有正确写法)。
4. 给 `main.py:1160` 补上 `command_allowed` 权限门,与其他聊天命令对齐。
### P1-5 · `_conf_schema.json` 缺失 prompt_governance 与成人内容白名单,内容安全开关在生产不可用
**位置** `_conf_schema.json`(整体缺口);映射表 `main.py:110-175` 的 `_CONFIG_KEY_MAP`
> 本条未进入对抗式复核批次(复核覆盖 56 条 P0/P1,此条未被抽中),沿用原判 P1。
**问题** `_CONFIG_KEY_MAP` 逐条把 `config.yaml` 路径映射到 schema 键;schema 里没有的键在 AstrBot 面板中就不存在、也无法持久化。实测缺口:整个 `prompt_governance` 段(translation 6 项、`moderation.llm_review_enabled` / `failure_policy`、`routing.safe_route` / `nsfw_route` / `adult_auto_route_enabled` / `entrypoints`、`image_moderation`、`retention` 4 项含 `redact_sensitive_logs`)全无 schema 键;`chat_access.adult_group_allowlist` 与 `adult_user_allowlist` 缺失(普通 `group_allowlist` / `user_allowlist` 有);`security.integration_token_set` / `allowed_integration_plugins` 缺失;`features` 只有 `private_companion_integration`;`storage` 只有 `advanced_materials_path`。
**真实代码**(这些键在业务代码里是真的被读的)
```python
# backend/services/chat_workflow_service.py:1175
adult_users = _id_set(access.get("adult_user_allowlist"))
adult_groups = _id_set(access.get("adult_group_allowlist"))
# backend/services/advanced_material_service.py:1309
adult_users = {str(value).strip() for value in access.get("adult_user_allowlist", []) if str(value).strip()}
# backend/services/settings_service.py:184-185 —— 插件自己的设置页渲染了它们
_field("adult_group_allowlist", "list", label="成人内容群聊白名单"),
_field("adult_user_allowlist", "list", label="成人内容用户白名单"),
# 但 main.py:156 附近的映射表里只有:
"chat_access.group_allowlist": "chat_group_allowlist",
"chat_access.user_allowlist": "chat_user_allowlist",
# 没有任何 prompt_governance.* 或 adult_*_allowlist 条目
```
**影响** 真实 AstrBot 部署下,管理员只能手改插件目录里的 `config.yaml` 来打开 NSFW 分流、内容审核、成人白名单和日志脱敏;而**插件更新会覆盖 config.yaml**,配置静默回退到默认值(`adult_auto_route_enabled: false`、`llm_review_enabled: false`、`adult_*_allowlist: []`)。即:内容安全开关在生产实际不可配置,且升级即丢失。
**修复**
1. 补齐 `_conf_schema.json` 的 `prompt_governance.moderation.*` / `prompt_governance.routing.*` / `chat_access.adult_*_allowlist` / `prompt_governance.retention.redact_sensitive_logs`,并在 `_CONFIG_KEY_MAP` 加对应映射。
2. 加防漂移测试:断言 `_CONFIG_KEY_MAP.values()` 与 `_conf_schema.json` 键集双向相等;再断言 `config.yaml` 中所有安全相关叶子路径都出现在映射表 key 里。
3. `postgresql_password` 在 schema 里是 `type:string`,面板会明文回显 —— 若 AstrBot 支持 password/secret 类型应改用,否则在 description 里引导填 dsn 并把密码放环境变量。
### P1-6 · 队列实际是 LIFO:`ORDER BY created_at DESC` + 固定 batch 导致老任务永久饿死
**位置** `database/repositories/job_repository.py:145-154`(排序)+ `backend/services/worker_service.py:207-221`(消费路径)
**问题** worker 认领任务复用了给前端做"最新在前"的通用列表接口。
```python
# job_repository.py:145-154
rows = conn.execute(f"""
SELECT {TASK_COLUMNS}
FROM generation_tasks
{where_clause}
ORDER BY created_at DESC # ← 队列消费用了倒序
LIMIT {placeholder} OFFSET {placeholder}
""", tuple(params + [normalized_page_size, offset])).fetchall()
# worker_service.py:207-212
def _claim_next(self, ctx):
queued = self.queue_service.list_jobs(status="queued", page=1, page_size=self.claim_batch_size).items
for candidate in queued:
if _retry_deferred(candidate):
continue
```
`claim_batch_size` 默认 25(`worker_service.py:394`),clamp 到 [1,50](`:92`)。`queue_service.list_jobs`(`:91-114`)只做状态白名单与分页归一,不替换排序。
**这是遗漏而非设计**:全仓唯一的 FIFO 查询是 `job_repository.py:197` 的 `ORDER BY updated_at ASC, created_at ASC, task_id ASC`(`list_stale`),但它只在 `WorkflowRoundWorkerRuntime.start()` 里经 `recover_stale_tasks` 调一次做启动恢复 —— 作者会写有序查询,claim 路径就是忘了。
**影响** 待处理队列稳定 > 25 时,最早入队的候选永远排不到(新任务不断插到窗口顶端)。用户表现为某个轮次一直卡在 queued,而后创建的轮次先出图。`_retry_deferred` 被延迟的任务还白占这 25 个名额。SQLite 的 `created_at` 是秒级 `CURRENT_TIMESTAMP`,同一秒创建的 4~8 个候选顺序完全不确定。
**修复** 给 `JobRepository` 增加专用认领查询 `list_claimable(...)`,`ORDER BY created_at ASC, task_id ASC`(FIFO + 稳定次序),`_claim_next` 改调它;同时把 `created_at` 精度提升到毫秒或增加自增 `seq` 列消除同秒歧义。工作量 S,收益立竿见影。
### P1-7 · 同步生成占满 asyncio 默认线程池,全插件无并发上限与背压
**位置** `backend/services/generation_service.py:119`(同步入口)+ `:760`/`:831-836`/`:882`(同栈内 create_task→CAS running→provider 调用);`main.py:333`(共享默认 executor);`backend/services/chat_workflow_service.py:216`(每用户 4 线程)
**问题** `nodes/generate`(Web 与聊天共用)走完全同步的 `_generate_node_locked`:任务刚 `create_task(status="queued")` 就立刻 CAS 成 running 并在同一调用栈里发起 provider 请求,整个过程持有进程内 per-node RLock。所有 Web/桥接请求又都通过 `asyncio.to_thread` 派发到 **asyncio 默认线程池**(`min(32, cpu+4)`)。没有任何信号量或专用 executor。
```python
# generation_service.py:119-123
def generate_node(self, node_id, payload, ctx) -> dict[str, Any]:
lock_entry = _retain_node_generation_lock(node_id)
lock_entry.lock.acquire()
try:
return self._generate_node_locked(node_id, payload, ctx) # ← 内含 provider 阻塞调用
# main.py:333
response = await asyncio.to_thread( # ← 默认 executor,全插件共用
dispatch_web_request, ctx, dispatch_method, dispatch_endpoint, ...)
# chat_workflow_service.py:216
with ThreadPoolExecutor(max_workers=4, thread_name_prefix="imagestudio-chat-fast") as executor:
futures = {executor.submit(self.generate_node, str(node["node_id"]), chat): node for node in nodes}
```
**影响** 单次 provider 调用默认 180 秒、最高允许 3600 秒(`engines/image_provider.py:308-313` 的 `min(max(timeout,10),3600)`)。十几个并发 `nodes/generate` 就能把默认 executor 占满,此后**所有** ImageStudio Web API(列表、状态轮询、取消)一起挂起 —— 包括用来取消这些生成的接口。快速角色命令还会为每个聊天用户额外派生 4 个线程,`with` 退出时 `shutdown(wait=True)` 不可中断,N 个用户 = 4N 路并发 provider 请求,成本无上限。
**修复**
1. 为生成建立独立、容量可配的 `ThreadPoolExecutor`(4~8),`dispatch_web_request` 继续用默认池,二者隔离 —— 这一条单独就能防住"取消接口也卡死"。
2. `GenerationService` 入口加进程级 `threading.BoundedSemaphore(max_concurrent_generations)`,取不到时快速返回 429 / `QUEUE_BUSY` 而非排队阻塞。
3. `chat_workflow_service` 的 4 图并发改为复用全局生成池,不再每次新建。
### P1-8 · `profile_repository` 的 SQL 含字面量 `%`,PostgreSQL 后端下角色列表/详情 100% 报错
**位置** `database/repositories/profile_repository.py:46` / `:73` / `:99`(三份逐字重复);触发点 `get()` `:186-194`、`list()` `:218-232`
**问题**
```sql
-- profile_repository.py:46(:73 / :99 完全相同)
AND COALESCE(legacy_card_workflow.metadata_json, '') LIKE '%"final_archive_history_id"%'
```
三处分别位于 `PROFILE_GENERATION_KIND_COLUMN`(32-57)、`PROFILE_CATEGORY_COLUMN`(59-84)、`DETAILED_WORKFLOW_STATE_COLUMN`(86-117),被拼进带参 SQL:
```python
# profile_repository.py:186-194
row = conn.execute(
f"""
SELECT {PROFILE_COLUMNS}, {PROFILE_GENERATION_KIND_COLUMN},
{PROFILE_CATEGORY_COLUMN}, {DETAILED_WORKFLOW_STATE_COLUMN}
FROM character_profiles
WHERE profile_id = {placeholder}
""",
(profile_id,),
).fetchone()
```
`db_helper.py:288-290` 的 `_placeholder` 在 `backend == "postgresql"` 时返回 `%s`,psycopg 会把整条 query 当 %-format 模板展开;`%"` 是非法格式符。`_Psycopg2ConnectionAdapter.execute`(`db_helper.py:265-268`)写的是 `cursor.execute(query, tuple(params or ()))` —— 永远传元组,"无参跳过展开"这条退路也不存在。全仓 `grep "LIKE '%"` 只有这三处(其余命中都在 `.tmp/` 历史发布包里),是孤例。
**影响** `config.yaml:153-167` 明确把 `backend: auto|sqlite|postgresql` 作为受支持配置对外暴露。一旦切到 PG,`ProfileRepository.get()` 和 `.list()` 立刻抛 `ValueError: unsupported format character '"'`(psycopg2)或 IndexError(psycopg3),角色详情与角色列表完全不可用,且错误来自驱动层格式化,**完全指向不了根因**。
**修复**
1. 立刻改成参数绑定:定义 `LEGACY_ARCHIVE_MARKER = '%"final_archive_history_id"%'`,SQL 里写 `LIKE {placeholder}`,调用处按 CASE 列出现次数补齐参数。
2. 更彻底:把 `final_archive_history_id` 提升为 `profile_workflows` 的真实列(新增 0019 迁移 + 回填),同时解决转义和前缀通配符全表扫描(与 P2 表里 `profile_repository.py:32` 的 10 个相关子查询一起修)。
3. 加静态断言测试:正则扫描 `database/repositories/*.py` 中未转义的裸 `%`(模式 `%(?!s)`)。
### P1-9 · `size` 请求字段全链路无人消费,聊天尺寸参数与高清修复静默失效
**位置** `engines/single_flow.py:61`(缺失 size→尺寸映射);写入侧 `backend/services/chat_workflow_service.py:63` 与 `:929`
**真实代码**
```python
# engines/single_flow.py:56-61
def generate(self, node: WorkflowNode, task: GenerationTask, request: dict[str, Any]) -> list[MockGeneratedAsset]:
count = _bounded_count(request.get("count", 1))
...
width, height = _dimensions(str(request.get("aspect_ratio") or "1:1")) # ← 只读 aspect_ratio
# engines/single_flow.py:248-255
def _dimensions(aspect_ratio: str) -> tuple[int, int]:
if aspect_ratio == "3:4": return 768, 1024
if aspect_ratio == "4:3": return 1024, 768
if aspect_ratio == "16:9": return 1280, 720
return 1024, 1024
# engines/single_flow.py:154-159 —— 全仓生产代码唯一构造 ImageGenerationRequest 的地方
result = provider.generate_image(ImageGenerationRequest(..., size=f"{width}x{height}", ...))
```
而写入侧写的是 `size`:
```python
# chat_workflow_service.py:59-64(/yp 单图)
payload={"prompt": ..., "negative_prompt": ..., "model_route": ..., "size": command.size, "count": ...}
# chat_workflow_service.py:925-930(高清修复)同样写 size
```
`generation_service.py:733` 的 `runtime_generation_request = {**payload, ...}` 原样透传 `size` 进 `task.request`,但全仓(排除 `.tmp/`、`tests/`)没有任何一处把 `size` 映射成 `aspect_ratio`。
**影响** `/yp 单图 ... --尺寸 4K` 与 `/yp 高清 <image_id> 4K` 都实际发出 `size="1024x1024"`。**高清修复的唯一价值(提升分辨率)完全失效**,用户只得到一张同尺寸重绘图。`astrbot_command_parser.py:49-52` 精心校验的 1K/2K/4K 参数是纯装饰,数据库记录的 width/height 也全是 1024。
**修复** 让 `size` 成为一等输入:
```python
width, height = _resolve_dimensions(request.get("size"), request.get("aspect_ratio"))
# _resolve_dimensions 先 re.fullmatch(r"(\d{2,5})\s*[x×]\s*(\d{2,5})", text) 解析 size 并 clamp 到 64..4096,
# 解析失败再回退 _dimensions(aspect_ratio)
```
补一条端到端断言测试,覆盖 `/yp 高清 <id> 4K` 产出的 `ImageGenerationRequest.size`。
### P1-10 · `displayMediaUrl()` 在 computed 与模板 render 中产生副作用
**位置** `frontend/standalone-web/src/App.vue:11146`(`displayMediaUrl`)+ `:11203-11225`(`resolveSignedMediaUrl`)+ `:997-1011`(`galleryImages` computed)+ `:4041`(唯一 revoke 点)
**问题** 看起来是格式化函数,实际同时做三件带副作用的事:读 `resolvedMediaUrls.value`(建立响应式依赖)、未命中时发起 HTTP 请求、请求返回后**整体替换** ref。它被 `galleryImages` computed(`:997`)、`selectedWorkflowRoundImageUrlByCandidateId`(`:2341`)、`workflowGenerationReviewImageUrlByCandidateId`(`:2352`)、`materialLibraryCardFromBackend`(`:5450`) 调用,也被模板经 `imageUrl()` 在 `:11668`/`:11693`/`:12826`/`:12865`/`:13961` 五处直接调用。这是 Vue 明令禁止的在计算属性/渲染中做副作用。
**真实代码**
```js
// App.vue:11146
function displayMediaUrl(rawUrl?: string | null): string {
const value = String(rawUrl || "").trim()
if (!value) return ""
if (/^storage:\/\//i.test(value)) {
const resolved = resolvedMediaUrls.value[value] // ← 建立响应式依赖
if (resolved) return resolved
if (!resolvingMediaUrls.has(value)) {
const resolution = resolveStorageMediaUrl(value) // ← computed 里发请求
.finally(() => { resolvingMediaUrls.delete(value) })
resolvingMediaUrls.set(value, resolution)
}
return ""
}
...
}
// App.vue:11215 —— 每张图 resolve 完成后整体替换 ref
const objectUrl = URL.createObjectURL(new Blob([bytes], { type: payload.content_type || "application/octet-stream" }))
ownedMediaObjectUrls.add(objectUrl)
resolvedMediaUrls.value = { ...resolvedMediaUrls.value, [rawUrl]: objectUrl, [sourceKey]: objectUrl }
// App.vue:997 —— 图库 computed 对全部图片逐张调用
const galleryImages = computed<GalleryImage[]>(() => {
const backendImages = uniqueImages([...]).filter(isAuthenticGenerationImage)
return [...backendImages].sort(...).map((image) => ({
...image,
image_url: displayMediaUrl(image.image_url),
thumbnail_url: displayMediaUrl(image.thumbnail_url),
}))
})
```
**无法靠"后端返回普通 http URL"绕开**:`backend/routes/image_routes.py:213-232` 的 `_serialize_image` 显式把每条记录改写成签名 URL(`payload["image_url"] = _signed_url(media_service, image.image_uri)`),所以必然走副作用分支。
**影响**
1. **O(N²) 重算**:`galleryImages` 依赖 `resolvedMediaUrls`,而它自己让 N 张图各触发一次 ref 整体替换 → 每张图解析完成都让整个 `galleryImages`(含排序 + N 次 `displayMediaUrl`)重跑。`loadGalleryImages`(`:4511`) 会拉全库所有页,1000 张图 ≈ 100 万次调用,`watch(galleryImages)`(`:4184`) 跟着抖 1000 次。
2. **Blob 内存无界增长**:`ownedMediaObjectUrls` 只在 `onBeforeUnmount`(`:4041`) 统一 revoke,SPA 会话中浏览过的每张图完整二进制常驻内存直到关标签页。
3. render 期间发请求:切主题、点通知等任何无关响应式变更重渲染时都可能补发媒体请求。
**修复** 把媒体解析从"渲染时惰性触发"改成"数据加载时显式预取":
1. 新建 `composables/useMediaUrls.ts`,导出纯读表的 `mediaUrl(raw)` 和显式的 `prefetchMediaUrls(rawUrls[])`。
2. 在 `loadGalleryImages` / `loadWorkflowRoundDetail` / `hydrateGenerationImages` 拿到数据后批量预取,一次 `resolvedMediaUrls.value = {...}` 写入全部结果(N 次 ref 替换压成 1 次)。
3. 给 `resolvedMediaUrls` 加 LRU 上限(如 300 条),淘汰时 `URL.revokeObjectURL` 并从 `ownedMediaObjectUrls` 移除。
4. `galleryImages` 改用纯查表的 `mediaUrl()`。
---
## 5. P2 汇总表(64 条)
> 标注「经复核降级」的条目,原判为 P1,复核确认机制属实但影响被夸大,按复核给出的严重度收录。
| 严重度 | 标题 | 位置 | 修复要点 |
| --- | --- | --- | --- |
| P2-中等(经复核降级) | reconcile_round 无条件回写状态与节点指针,迟到候选回调会"复活" superseded 父轮次 | `backend/services/workflow_round_service.py:806-861` | `_reconcile_round_locked` 先读 `round_record.status`,confirmed/superseded/cancelled 只更新 `metadata.execution_summary`;把 superseded 加入 `_ensure_writable_round_row` 不可写集合 |
| P2-中等(经复核降级) | 轮次候选任务无任何重试路径:worker 侧 `max_attempts=1`,Web 侧 task_type 被硬拒 | `backend/services/workflow_round_worker_runtime.py:45` + `backend/routes/job_routes.py:195-220` | round pool 改 `RetryPolicy(max_attempts=3, ...)`;`_retry_task` 补 `source == "workflow_round"` 分派分支 |
| P2-中等(经复核降级) | 存储根可配为任意绝对路径,VfsStorage 沙箱边界由可写配置决定 | `core/runtime_paths.py:43-45` + `core/storage.py:105-108` + `backend/services/settings_service.py:240-370` | `validate()` 增加 storage 段校验;或 `_root_paths()` 强制收敛到 `get_runtime_data_root()` 之下。见 §2 链路 A |
| P2-中等(经复核降级) | `storage/migrate` 非 dry-run 可在可配置根之间任意复制/覆盖,且无审计 | `core/storage.py:45-63` + `:182-200`;入口 `backend/routes/storage_routes.py:36-47` | `will_overwrite and not payload.get("confirm_overwrite")` 时抛 ApiError;补审计日志;非 dry-run 提升为独立权限 |
| P2-中等(经复核降级) | 配置快照把未脱敏的明文密钥写进数据库 `config_snapshots` | `backend/services/settings_service.py:614`(调用方 `:444`/`:556`) | 写入前脱敏为哨兵值(如 `***PRESERVED***`),rollback 时从 `before_file` 取回原值(`_merge_masked` 已有同类逻辑);加保留期清理 |
| P2-中等(经复核降级) | 所有已登录 WebUI 用户被无差别授予 `can_manage_config` | `main.py:2337` | 与 P1-1 同源。最小动作:把 `can_manage_config` 从默认集合移除,改为 `security.config_admin_users` 白名单 |
| P2-中等(经复核降级) | `dispatch_extension_request` 从不检查 `RouteMatch.permission` | `adapters/astrbot_adapter.py:171-187` + `backend/route_registry.py:365-377` + `main.py:1753` | 分发器内做集中式强制:取 `permission_requirement(match.permission)`,auth/permission 逐项校验;handler 内 `require_*` 保留为纵深防御;补 AST 元测试 |
| P2-中等(经复核降级) | styleValidationReviewTrust 返回编码损坏的问号串,且已渲染到界面 | `frontend/.../AdvancedMaterialImportPage.vue:1304-1317`(渲染点 `:1656`) | 恢复三条中文文案;加测试:`features/` 下 `.vue` 不得出现连续 3 个以上 `?` 的字符串字面量 |
| P2-中等(经复核降级) | 文本角色卡导入把「待整理」占位提示当真实设定写入档案,污染 base_prompt | `frontend/.../quick-profile/profile-import.ts:149-172` + `:336` + `App.vue:9710-9739` | 5 个 fallback 改空串,提示语移到 placeholder;或按 `draft.recognizedKeys` 过滤后再赋值 |
| P2-中等(经复核降级) | 「仅本次会话使用、不写入配置」的 API Key 被前端写进 `settings/save` 请求体 | `frontend/.../settings/SettingsPage.vue:133`(承诺文案)+ `:98`(注入点) | 二选一:改用不落盘的探测链路(`api_discovery_service.py:229` 已支持读 `api_key_plaintext`),或修正承诺文案并加二次确认。`duplicateAdapter` 一律不复制会话密钥 |
| P2-中等(经复核降级) | 快速角色问卷默认值是完整虚构示例角色,绕过 production-data-boundary 防线 | `frontend/.../quick-profile/profile-import.ts:32-59` + `App.vue:759` | `App.vue:759` 改用同文件 `:61` 已存在的 `createEmptyQuickProfileQuestionnaire()`;示例值降级为 placeholder;测试扫描目标扩到 `standalone-web/src` 全部 `.vue`/`.ts` |
| P2-中等(经复核降级) | 素材绑定 schema 校验可被 `schema_version` 绕过,导致 material_bind 节点永久毒化 | `backend/services/material_binding_schema_service.py:47` + `:329` + `workflow_service.py:729-732` | 删掉 fast-path 或降级为仍逐条 `_normalize_rule`;`_index_by_node_key` 改用 `.get(...) or []`;把归一化提到 `update_node` 写库**之前** |
| P2-中等(经复核降级) | 资产包清单可静默覆盖已有素材,并把未识别素材直接写成 `confirmed` | `backend/services/asset_import_service.py:141-152`(配合 `:340`、`:361-366`) | 导入素材 ID 一律服务端生成;覆盖需 `allow_overwrite` 且限同一 `package_uri` 来源;`recognition_status` 从清单剥离,一律落 `pending_recognition`;`_asset_uri` 校验 root 与 base_relative |
| P2-中等(经复核降级) | 事件流轮询无重入保护,且在图库页每 5 秒触发整库分页重扫 | `App.vue:4561-4609` + `:4511-4542` + `:4600` | 加 `eventPollInFlight` 守卫;`loadGalleryImages` 加 `if (loadingGalleryImages.value) return`;轮询触发改增量;循环条件改按页数而非 `loaded.length` |
| P2-中等(经复核降级) | 事件流 `slice(-1)` 在事件积压时静默丢弃最多 19 条事件 | `App.vue:4576` | 改为 `slice(previousIndex >= 0 ? previousIndex + 1 : 0)` —— 游标丢失时视全窗口为新事件;同时提高 `limit` |
| P2-中等(经复核降级) | `handle_request` 吞掉全部非 ApiError 异常且不记日志,166 条路由内部错误彻底静默 | `backend/routes/common.py:12-16` + `backend/dto/common.py:75-83` | 分层捕获:ApiError 记 info,其余 `logger.exception("api internal error request_id=%s actor=%s", ...)`;`response_from_exception` 的 details 补 `request_id` 便于反查 |
| P2-中等 | LLM 返回扁平结构时,候选偏好被静默丢弃(不报错、不回退确定性解析) | `backend/services/workflow_round_feedback_service.py:178` | 四个动作字段做双层回退 `feedback.get(k, parsed.get(k))`;全空但顶层存在同名键时抛 `WorkflowFeedbackInterpretationError` 触发确定性回退 |
| P2-中等 | 确定性反馈解析器把普通数字当候选编号:静默误拒 / 合法反馈被 400 | `backend/services/workflow_feedback_interpreter.py:46` | 从 `_DISPLAY_CODE_OR_NUMBER_RE` 移除裸 `\d{1,3}`,要求前置标记(候选/第/#/No./张/号);越界数字忽略而非抛 `unknown_candidate_reference` |
| P2-中等 | `create_next_round` 缺"一父轮次只能有一子轮次"守卫,可分叉多条优化链 | `backend/services/workflow_round_service.py:620` | 把 `superseded_by_round_id` 存在性检查移进 `create_round_with_candidates` 同一事务(已有 FOR UPDATE / BEGIN IMMEDIATE),或加 `(parent_round_id, round_kind)` 部分唯一索引 |
| P2-中等 | `list_node_rounds` 的 N+1,且每次仓储调用新建一条 SQLite 连接 | `backend/services/workflow_round_service.py:982` | 加批量方法 `list_candidates_for_rounds(round_ids)` / `list_pool_for_rounds`;`ImageRepository`/`JobRepository` 加 `get_many(ids)`;中期加连接复用 |
| P2-中等 | 交叉评审幂等重放只按 `idempotency_key` 全表匹配,可命中另一节点/另一种轮次 | `database/repositories/workflow_cross_review_repository.py:969` | `_round_replay` 增加并校验 `round_kind` / `node_id` / `workflow_id` / `parent_round_id`,不匹配抛 `idempotency_key_conflict`(主轮次侧 `workflow_round_service.py:94-114` 已有正确写法) |
| P2-中等 | 跨评审 skip 由三段独立事务组成,中途失败留下"已跳过但未定稿"死锁态 | `backend/services/workflow_generation_cross_review_service.py:416` | 合并「记录 skip + 确认候选」为一个事务;或引入 `decision_state='pending_confirm'` 中间态并允许撤销;`create_review_round_atomic` 加 `decision == 'skip'` 互斥校验 |
| P2-中等 | `apply_feedback_atomic` 把旧 `_conversation` 无条件带到新快照,复用过期 prompt patch | `database/repositories/workflow_round_repository.py:710` | 结构化 updates 写入时显式 `feedback_snapshot.pop("_conversation", None)`;或在 `_conversation` 记录写入序号与 pool revision,`create_next_round` 只在最新时采用 |
| P2-中等 | `recover_stale_tasks` 只在 worker 启动时执行且只认 `source=workflow_round` | `backend/services/queue_service.py:470` | source 过滤改可选白名单,纳入 `nodes.generate`(恢复动作为标 failed + 释放节点);增加周期性巡检;恢复时同步修复 `workflow_nodes.status` |
| P2-中等 | `recover_stale_tasks` 无重试上限,会跨进程重启无限重排队 | `backend/services/queue_service.py:481` | metadata 维护 `recovery.attempts` 累加,超阈值(如 3)迁 `dead_letter` 并写明原因;返回值报告 `dead_lettered` 列表 |
| P2-中等 | 轮次候选的 `timeout_seconds` 只写进 metadata,执行时从未被读取 | `backend/services/generation_service.py:355` | `execute_claimed_generation` 构造 runtime_request 时 `setdefault("timeout_seconds", task.metadata.get("timeout_seconds"))`;`run_once` 外层加看门狗 |
| P2-中等 | worker 执行成功但回写失败时,已落库的图片记录被孤立且不清理 | `backend/services/worker_service.py:104` | 把「落库图片」与「回写任务」放进同一补偿边界:`_execute` 捕获回写失败后调 `_cleanup_generation_outputs`,或返回 image_ids 交 `_on_terminal` 清理 |
| P2-中等 | 自研 YAML 往返不等价:空列表退化为字典、注释全丢(已用仓库 config.yaml 实测) | `core/config_writer.py:50` | `dump_yaml` 对空容器显式输出 `key: []` / `key: {}`;或引入 ruamel.yaml round-trip;至少加 `dump(load(x)) == 归一化(x)` 属性测试 |
| P2-中等 | `save()` 把打包默认值固化进可写配置,插件升级后新默认值永久失效 | `backend/services/settings_service.py:423` | 写盘基线改用只读可写文件的 loader(跳过打包合并),只把用户显式提交的 diff 落盘 |
| P2-中等 | `write_text_atomic` 的 `os.replace` 重置配置文件权限,临时文件短暂全局可读 | `core/config_writer.py:32` | `os.open(path, O_WRONLY|O_CREAT|O_EXCL, 0o600)` 创建临时文件并 `os.fsync`;replace 前用 `os.chmod` 继承目标既有权限位 |
| P2-中等 | 群聊日配额统计全表扫描 + Python 侧 JSON 解析 | `backend/services/chat_command_guard_service.py:75` | 建 `chat_command_quota(day, scope_type, scope_id, count)` 计数表 + UPSERT;把配额 action 从通用 `chat_command_allowed` 拆成 `chat_generation_allowed` |
| P2-中等 | `remote_fetch` 的 SSRF 防护存在 DNS TOCTOU(rebinding)窗口 | `core/remote_fetch.py:73` | 把校验通过的 IP 固定下来再连接(自定义 HTTPConnection 覆写 connect,Host/SNI 保留原主机名);或在 `http_response` 钩子里用 `getpeername()` 复核对端 IP |
| P2-中等 | 分页之后再过滤,total 与页大小失真 | `backend/routes/job_routes.py:36`(`image_routes.py:45-49` 同) | 把可见性下推到仓储 WHERE:`JobRepository.list(..., exclude_sources=(...))`、`ImageRepository.list_images(..., include_restricted)` |
| P2-中等 | 缩略图是原图的字节级完整拷贝,存储与带宽直接翻倍 | `engines/single_flow.py:178` | 新增 `_write_thumbnail(uri, image_bytes, max_edge=512)`,用已作为可选依赖存在的 Pillow 等比缩放;不可用时写原图并打 `thumbnail_downscaled: False` |
| P2-中等 | vision provider 链路完全没有错误分类与可重试判定,`retryable` 是死代码 | `backend/services/material_service.py:863` | 把 `core/generation_errors.py` 的 `_category`/`_is_retryable`/`_safe_details`/`_safe_message` 提成与异常类型无关的公共函数,新增 `vision_failure_attribution` 共用 |
| P2-中等 | vision 请求体无上限,8 张 20MB 图可构造约 213MB 的单次 JSON 请求 | `engines/vision_provider.py:294` | 新增 `MAX_VISION_REQUEST_BYTES`(如 32 MiB),`_post_json` 内超限抛 `VisionProviderError(error_type="invalid_request")`;更好是按张数 × 单张预算约束并先降采样 |
| P2-中等 | 三处 fallback 对所有错误一视同仁地换 provider,含不该重试的鉴权/配置错误 | `engines/image_provider.py:191`(另 `model_provider_runtime.py:180-189`、`:264-271`) | 让 `_is_retryable` 成为 fallback 准入条件:`if not attribution["retryable"]: raise`,鉴权/配置/请求错误立即上抛,不消耗其余 provider |
| P2-中等 | `structured_text_callable` 用裸 `json.loads` 解析模型输出,缺 vision 侧已有的容错 | `backend/services/model_provider_runtime.py:246` | 把 `vision_provider._json_from_text`(`:398-429`,已实现剥 BOM / 截 `{...}` / 去尾逗号 4 个候选)提到 `core/llm_json.py`,三处共用 |
| P2-中等 | 单条聊天消息内的图片数量无上限,放大为 N 次下载 + N 次视觉大模型调用 | `adapters/astrbot_media_adapter.py:12` | `image_references_from_event` 内部截断(`MAX_CHAT_IMAGE_REFERENCES = 4`,与 `MAX_VISION_IMAGES` 对齐);`import_material` 也走 `guard.check_generation` / `guard.record` |
| P2-中等 | 聊天身份未按平台命名空间隔离,跨平台同 ID 可互相访问档案 | `backend/services/chat_workflow_service.py:1157` | `user_id=f"{chat.platform or 'astrbot'}:{chat.user_id}"`,WebUI 侧用 `webui:` 前缀;配套一次性迁移脚本按 source 回填 |
| P2-中等 | 聊天卡片 PNG 缓存目录无淘汰机制,用户可任意撑爆磁盘 | `adapters/astrbot_card_renderer.py:59` | `CARD_DIR` 加 LRU 上限(超 500 按 `st_mtime` 删最旧);或改为渲染到 `BytesIO` 直接投递不落盘;`lines` 长度与条数做截断 |
| P2-中等 | 无组合根导致每次路由调用都重读 `config.yaml` 并重建整棵对象树 | `database/db_helper.py:297`(34 处 `Database(load_database_settings())`) | `load_config_payload` 加进程级缓存(按 `(path, mtime)` 失效),`set_runtime_config_overrides` 时主动 invalidate;组合根持单例 service 图 |
| P2-中等 | 跨仓储组合写无事务边界:删图与清 node 指针分属两次提交,且 `selected_image_id` 无外键 | `backend/services/image_service.py:216` | 下沉成 `ImageRepository.delete_with_node_release(image_id)`,同连接内 DELETE + UPDATE 一次 commit(照抄 `job_repository.delete_if_status:382-431`);补 0019 迁移加外键 `ON DELETE SET NULL` |
| P2-中等 | 陈旧任务恢复的时间戳比较绑死 SQLite 的 UTC 语义,PostgreSQL 下静默失效 | `backend/services/queue_service.py:457` | 时间差在 SQL 侧算:SQLite 用 `datetime('now', ?)`,PG 用 `NOW() - (?::text)::interval`,按 `Database.backend` 分派;或统一迁 TIMESTAMPTZ + 建连 `SET TIME ZONE 'UTC'` |
| P2-中等 | `MaterialAnalyticsService.summarize` 无条件全表扫描 9 张表,含大 JSON 列 | `backend/services/material_analytics_service.py:16` | 加时间窗参数(默认 30 天)+ `idx_generation_tasks_created`;能下推的统计改 `GROUP BY` + 聚合函数;结果加秒级过期缓存 |
| P2-中等 | `profile_repository` 每行 10 个相关子查询,同一组谓词复制三份并已开始漂移 | `database/repositories/profile_repository.py:32` | 用 LEFT JOIN 派生表把三个 EXISTS 结果算一遍再在外层 CASE 复用(子查询 10→3);与 P1-8 的列提升合并做 |
| P2-中等 | `normalize_category` 用子串匹配推断类别:landscape 判成 headwear、rooftop 判成 top | `backend/services/material_normalization_service.py:314` | 别名匹配改词边界 + 按长度降序:ASCII 用 `re.search(rf"(?<![A-Za-z0-9]){re.escape(alias)}(?![A-Za-z0-9])", text)`,CJK 保持子串;`_build_profile` 不再拿整段 prompt 猜类别 |
| P2-中等 | `list_catalog` 每次分页请求都把两张素材表整表读入内存再切片 | `backend/services/advanced_material_service.py:605` | 过滤排序下推 SQL,两库用 `UNION ALL` + 统一排序在数据库层 LIMIT/OFFSET;`metadata_json` 里的过滤键用 `json_extract` 生成列 + 索引 |
| P2-中等 | 素材统计里的风格集口径完全失效:`workflow_kind` 常量对不上,导入数恒为 0 | `backend/services/material_analytics_service.py:168` | 从 `advanced_style_set_service` 导入 `STYLE_SET_KIND`(`= "advanced_style_set"`)比较,保留旧值兼容分支;根本做法是把它下沉成 `advanced_material_imports` 的真实列 |
| P2-中等 | 导入列表接口的队列对账是 N+1,且单条详情会重复对账两次 | `backend/services/advanced_material_service.py:212` | `detail()` 加 `reconcile: bool = True`,`get_import` 传 False;`QueueService` 加 `get_jobs(task_ids)` 批量查;列表接口不做对账,改后台定时或显式刷新 |
| P2-中等 | 衣柜导入把所有 `sqlite3.IntegrityError` 一律当成重复条目 | `backend/services/wardrobe_service.py:379` | 检查 `sqlite_errorcode == sqlite3.SQLITE_CONSTRAINT_UNIQUE`(Py3.11+)或 `"UNIQUE constraint failed" in str(exc)`;非唯一约束一律 raise;仓库路由改用服务端赋值的 `metadata["library_kind"]` |
| P2-中等 | `update_material` 中的结构校验会把 `MaterialNormalizationError` 泄漏成 500 | `backend/services/material_service.py:246` | 第二处 `validate_material_structures(metadata)` 也包 try 转 `ApiError(VALIDATION_FAILED)`;并把"提取结构键→合并→校验"与 `validate_material_payload` 合并成一个函数 |
| P2-中等 | Pillow 缺失时风格集共识会把多张原图以 base64 全量载入单个请求 | `backend/services/material_service.py:786` | 为送模型的图设独立硬上限(如 `VISION_INPUT_MAX_BYTES = 3 MB`):Pillow 可用则缩放后仍超限继续降质,不可用且超限直接抛 `UPLOAD_TOO_LARGE` 并提示安装;共识阶段改流式逐张编码 |
| P2-中等 | 模板中残留字面量 `\n` 字符串,在「创建角色档案问卷」弹窗标题栏渲染出可见 `\n` | `frontend/standalone-web/src/App.vue:13091` | 替换成真正的换行;CI 加 lint:模板段内出现 `\\n` / `\\t` 字面量即失败 |
| P2-中等 | `loadCharacterWorkflowForProfile` 的缓存命中分支无条件重拉分支列表 | `frontend/standalone-web/src/App.vue:7273` | 抽出 `ensureWorkflowBranches(workflowId)`,`watch(:4111)` 与 `:7273` 共用同一守卫 |
| P2-中等 | `VisionProviderConfig.endpoint_url` 缺 `/v1` 去重,base_url 以 `/v1` 结尾时视觉请求 404 | `engines/vision_provider.py:40` | 把 `endpoint_url` 提到 `engines/_provider_base.py` 的 `join_endpoint(base_url, endpoint)`,image / vision / `model_provider_runtime.py:210-216`、`:297-303` 三处共用 |
| P2-中等 | `_signed_url` 复制 7 份,异常范围不一致且其中一份每张图新建一次 MediaService | `backend/routes/advanced_material_routes.py:428`(另 6 处见下) | 在 `MediaService` 上加实例方法 `signed_url(self, uri) -> str | None`,7 处(`image_routes:226`、`material_routes:317`、`profile_card_routes:90`、`round_routes:192`、`workflow_round_worker_runtime:257`、`dashboard_service:89`)全部改调它 |
| P2-中等 | `tests/test_material_vision_input.py` 无条件 import Pillow,而 Pillow 是可选依赖 | `tests/test_material_vision_input.py:6` | 改 `pytest.importorskip("PIL")`;新建 `requirements-dev.txt` 钉版本,`requirements.txt` 保持零依赖 |
| P2-中等 | SQLite 未开启 WAL,却跑 13 个并发写线程,全靠 30 秒 busy_timeout 硬扛 | `database/db_helper.py:159` | `connect()` 补 `PRAGMA journal_mode = WAL` 与 `PRAGMA synchronous = NORMAL`;`initialize()` 配 `wal_autocheckpoint`。(注:复核已否定"必然阻塞全库读"的机理,这里按吞吐调优而非缺陷修复对待) |
| P2-中等 | 每次队列 claim 开 2 个新连接;13 个 worker 空转时约 43 次 connect + COUNT(*) / 秒 | `backend/services/worker_service.py:207` | `JobRepository` 加 `list_items_only(...)` 跳过 COUNT(*);`claim_queued_task` 的 get+update 合成单条 `UPDATE ... WHERE status='queued'`(PG RETURNING / SQLite changes());加线程本地连接复用;idle 指数退避 |
| P2-中等 | 前端 direct-fetch 路径完全没有超时,与 plugin-bridge 路径行为不一致 | `frontend/shared/api/client.ts:81` | direct-fetch 分支复用同一套超时常量,用 `AbortController` + `signal`,`AbortError` 映射成 `ApiClientError("bridge_timeout", ...)` |
| P2-中等 | `cost_service` 对 `generation_images` 做无 LIMIT 全表扫描,days 过滤在 Python 侧 | `backend/services/cost_service.py:186` | 时间窗下推 SQL(`created_at >= ?`)并加 `LIMIT`(如 20000,超出标 `truncated=True`);长期把 token 数拆成数值列或建汇总表 |
| P2-中等 | 高级素材详情 N+1:按 attempt 循环查子表,每次新开数据库连接 | `backend/services/advanced_material_service.py:228` | 加 `list_style_validation_cases_by_attempts(attempt_ids)` 用 `WHERE attempt_id IN (...)` 一次查完;`:258-263` 的 `get_material` 双调改局部变量(顺带消除 TOCTOU) |
| P2-中等 | `ChatSessionStore` 构造期无保护地做 naive/aware datetime 比较,脏文件让插件启动崩 | `backend/services/chat_session_service.py:76` | 解析处强制归一化时区:`parsed if parsed.tzinfo else parsed.replace(tzinfo=timezone.utc)`。仓库内 `cost_service._parse_datetime` / `worker_service._retry_deferred` / `integration_token_service._parse_time` 三处已写对,应抽成 `core/` 公共函数 |
---
## 6. P3 汇总表(30 行 = 收录的 19 条 + 11 条复核推翻后的残留技术债)
> 本表 19 条计入清单总数(P3 = 19)。另有 11 行标注「经复核降级」且**不计入总数** —— 它们是被复核推翻的发现,原缺陷不成立,此处只保留复核明确认可的残留技术债,供后续重构参考。
> `QueueService.update_task() 无 CAS` 一条例外:它未被推翻(复核维持成立),只是从 P1 下调到 P3,**计入总数**。
| 严重度 | 标题 | 位置 | 修复要点 |
| --- | --- | --- | --- |
| P3-轻微(经复核降级) | `update_round` 无终态白名单,依赖调用方前置守卫兜底 | `backend/services/workflow_round_service.py:81` / `:928-940` | 复核确认 `create_round:81` 的 `_ensure_round_creation_allowed` 已拦死 confirmed 节点,攻击链不可达。残留问题是"守卫与写入分离、易被后续重构打破":给 `update_round` 加终态白名单校验 |
| P3-轻微(经复核降级) | `QueueService.update_task()` 无 CAS | `backend/services/queue_service.py:406-411` | 复核确认 `worker_service.py:106-115` 的 cancelled 早退 + `core/fsm.py:38` 的 FSM 校验已把窗口压到两条相邻语句之间。收尾动作:worker 三处写入改用已有的 `update_task_if_status` |
| P3-轻微(经复核降级) | 插件重载后旧 worker 线程仍存活 | `backend/services/worker_service.py:191-206` + `queue_service.py:439+` | 复核确认旧线程停止后不再认领新任务、不累积。残留:`stop()` 返回 `running=True` 时记日志/告警;`recovery` 跳过本进程仍存活的 worker_id |
| P3-轻微(经复核降级) | 所有 service 在 `require_*` 之前构造 | `backend/routes/node_routes.py:140`;残留问题在 `adapters/astrbot_adapter.py:171-187` 与 `main.py:315-344` | 复核确认生产两个 ingress 都在构造前完成准入判定,"未授权即触发重型初始化"不可达。残留:给分发器加兜底 try;只读 GET 不应跑 `sync_generation_provider_from_config`(`model_provider_bootstrap.py:68,79` 会 upsert 写库) |
| P3-轻微(经复核降级) | `POST profiles/{id}/archive` 实际执行删除 | `backend/routes/profile_routes.py:109-114` | 复核确认前端唯一调用方是红色"删除"按钮(`ProfileDetailPane.vue:190-198`),用户意图与后端行为一致,无数据事故。残留:REST 路径命名误导且与契约文档不符。**不要改成写 `status="archived"`** —— 那会让删除按钮不删除,引入真实回归 |
| P3-轻微(经复核降级) | 内容安全审核 provider 解析缺 `provider_type` 校验 | `backend/services/model_provider_runtime.py:285` | 复核指出"安全审核静默绕过"方向写反了:现状是 fail-closed(异常降级为 quarantine)。**修复时必须同时处理 `reviewer is None 即放行` 的语义**,否则会引入比原问题更严重的缺陷 |
| P3-轻微(经复核降级) | `metadata_json` 整列覆盖 + 跨连接读改写 | `backend/services/generation_service.py:1869-1886` | 复核确认服务层 `_normalize_workflow_metadata`(`workflow_service.py:1027-1031`、`:1058-1068`)已从新鲜快照强制回填 `branch_state` / `character_execution`,仓储整列覆盖被消解。残留:失败回写的 check-then-act 改用已有的 `update_node_if_status` |
| P3-轻微(经复核降级) | `_string_list` 多份实现语义不一 | `backend/services/workflow_round_service.py:1544` / `core/astrbot_provider_bridge.py:344` / `advanced_style_set_service.py:4288` | 复核确认真实是 17 处(多算的在 `.tmp/` 构建快照里)、无跨模块导入、无数据流交汇,三条影响均不可达。唯一实证不一致是 `VisionRecognitionResult.tags` 的三个构造点排序不同,下游只当集合用。按可维护性收敛即可 |
| P3-轻微(经复核降级) | 模型路由解析链前端重实现 | `frontend/.../workflow/workflow-model-route.ts:36-88` | 复核确认 round 层是对 `workflow_round_service.py:596-597` 的正确镜像,缺 `image_low` 是刻意 fail-safe(返回空串触发 `App.vue:8492-8495` 的硬闸门),quick_* 节点永不进入该标签链。残留:前端复刻映射表的配置键耦合,理想做法是后端下发 `effective_model_route + source` |
| P3-轻微(经复核降级) | retry 类操作前端权限门禁漏判 `can_write` | `frontend/standalone-web/src/App.vue:3073-3077` / `:3136-3140` | 复核确认"有 can_retry_tasks 无 can_write"的组合在本仓库造不出来,且 `backendWriteBlockMessage`(`:4376-4387`)会在本地拦下。残留:文案 tone 不精确。彻底做法是按 contract 的 `required_permissions` 构造统一 `canCall(method, endpoint)` |
| P3-轻微(经复核降级) | `events/stream` 无游标 | `App.vue:4575-4582` + `backend/services/event_stream_service.py:22-32` | 复核确认全仓事件只有 `generation.` / `workflow.` 两个前缀,OR 归约不可能因丢事件翻假;轮次面板另有 4 秒自续轮询(`App.vue:6999-7008`)。残留:接口无游标、`body`/`content_type` 白费序列化、`slice(..., -1)` 魔数写法 |
| P3-轻微(经复核降级) | `ApiError` 是继承 Exception 的 dataclass,`str(exc)` 返回元组 repr | `backend/services/chat_workflow_service.py:903` | 复核确认 `main.py` 内 `grep -c ApiError` = 0,且 `handle_request` 用 `self.message` 而非 `str(exc)`、`_data`(`:1166-1170`)整体丢弃 details。残留仅 1 处绕过 dispatcher 的直调(对应 `main.py:1134` `/yp 审核`),且 details 只含内部 ID。给 `ApiError` 加显式 `__str__` 即可 |
| P3-轻微 | 反馈幂等日志按字典序而非时间序裁剪,会淘汰较新的 key | `database/repositories/workflow_round_repository.py:726` | 按记录里已有的 `updated_at` 排序后再 `[-20:]` |
| P3-轻微 | `_ensure_round_enqueued` 的元数据回写在 `_reconcile_lock` 之外 | `backend/services/workflow_round_service.py:928` | 把末尾读-改-写包进 `with self._reconcile_lock:`,或改用仓储条件更新(只更 `task_ids`/`planned_only` 两个键) |
| P3-轻微 | 未加引号的配置标量会被 `os.path.expandvars` 展开 | `database/db_helper.py:445` | 只对显式引用语法(`env:NAME` / `${NAME}`)展开,其余原样返回;`core/secret_service.resolve_env_value` 已有这套语义可复用 |
| P3-轻微 | 媒体令牌置于 URL 查询串且 payload 内不含签发者标识 | `core/media_proxy.py:51` | payload 增加 `actor_id` 并在 `_resolve_token` 与当前 ctx 比对;响应加 `Referrer-Policy: no-referrer` |
| P3-轻微 | `public_token` 权限档与实际暴露面不符,`media/fetch` 绕过分发器不留审计 | `main.py:329` | 把 `public_token` 描述改为"签名 token + 宿主鉴权"以与实际一致;提前返回前记一条 LogService 媒体访问日志(含 request_id、actor、uri) |
| P3-轻微 | 装配分散导致 `WorkflowService` 实例行为不一致,素材绑定事件被静默丢弃 | `backend/routes/node_material_routes.py:69`(另 `branch_routes.py:64`、`history_routes.py:72`、`review_routes.py:90`) | 4 处工厂补 `event_bus=get_default_event_bus()`;让 `WorkflowService.event_bus` 默认取全局总线;禁止 `self.<other_service>.event_bus` 穿透写法;加装配断言测试 |
| P3-轻微 | `generation_service` 内部 `event_bus` 取用方式自相矛盾 | `backend/services/generation_service.py:1416` | `:1416-1427` 改用 `self._publish(...)`,删除 `self.workflow_service.event_bus` 引用 |
| P3-轻微 | 关键词过滤未转义 LIKE 通配符 | `database/repositories/profile_repository.py:305`(`advanced_material_repository.py:493-498` 同) | 转义 `\` `%` `_` 后再拼接,SQL 侧加 `ESCAPE '\'` |
| P3-轻微 | `list_stale` 与图库列表的排序键与现有索引不匹配 | `database/repositories/job_repository.py:191` | 补 0019 迁移:`idx_generation_tasks_status_updated(status, updated_at)`、`idx_images_profile_archived(profile_id, is_archived, created_at DESC)` |
| P3-轻微 | GalleryPage 批量操作串行执行且完全吞掉错误 | `frontend/.../gallery/GalleryPage.vue:121` | 收集 `failures`,用 `Promise.allSettled` + 并发上限(5)替代串行;失败 id 保留在 `checkedIds` 并展示前几条原因 |
| P3-轻微 | 归档素材在标准库与进阶库产生两种不同的错误语义 | `backend/services/material_catalog_resolver.py:75` | `_normal_material` 前补 `if material.recognition_status == "archived": return None`;`_resolve_material_references` 的 404 加 `"reason": "material_missing_or_archived"` |
| P3-轻微 | `deleteSelectedProfile` 遗漏清理 6 个 per-profile 缓存 Map | `frontend/standalone-web/src/App.vue:6316` | 合并成 `purgeProfileCaches(profileId)` 辅助函数,与 `invalidateProfileDetailsRequests` / `invalidateProfileWardrobeRequests` 共用 |
| P3-轻微 | `EventStreamService._event_to_webhook` 造两次对象再丢弃一次 | `backend/services/event_stream_service.py:42` | 直接构造 `WebhookEvent(event_type=..., data=..., event_id=event.event_id, created_at=event.created_at)`;`core/webhook.py:48-49` 的 `event_from_bus` 随之成死代码,一并删 |
| P3-轻微 | 节点写锁规则前后端不一致,前端判据含后端从不产出的 `sealed_at` | `frontend/.../workflow/workflow-lock-state.ts:12,21-27` | 复核确认 `sealed_at` 是 OR 链里的恒 undefined 项,只会多加锁不会漏加锁;`adopt-image` 路径两边一致(`history_service.py:55` 同时写 status+selected_image_id)。彻底做法:`WorkflowNode.to_dict()` 下发 `writable` + `lock_reason`(`workflow.ts:108-123` 已有同形状结构可复用) |
| P3-轻微 | `_Psycopg2ConnectionAdapter.execute` 每次新建 cursor 且从不关闭 | `database/db_helper.py:305` | 返回包装对象在 fetch 后自动 close;至少加 try/except 在抛错时 `cursor.close()` 后 re-raise |
| P3-轻微 | 每个请求重排 166 条路由 + 逐条编译正则 + `inspect.signature`,全程无缓存 | `adapters/astrbot_adapter.py:47` | 模块加载时预编译 `dict[method] -> [(pattern, RouteSpec)]` 并预排序;`_load_handler` 加 `lru_cache`;handler 参数绑定方案导入时算一次缓存到 RouteSpec |
| P3-轻微 | `log_service` / `cost_service` 的 `_json_loads` 无异常保护 | `backend/services/log_service.py:297` | 改 `try: json.loads(v) except (ValueError, TypeError): return {"_parse_error": True, "raw_preview": str(v)[:200]}` |
| P3-轻微 | `EventBus.publish` 不隔离订阅者异常 | `core/event_bus.py:48` | `handler(event)` 包 try/except + `logger.exception`;顺带修 `unsubscribe`(`:41-43`)对未订阅类型凭空建键的问题 |
---
## 6.1 终审补录:跨维度被漏收的条目(**不计入上表 94 条**)
> 本清单原按 `category ∈ {bug, security, perf}` 收录。终审逐条回扫 `_raw.json` 全部 214 条发现后,确认下列 10 条虽被归类为 `hygiene`/`coupling`,但**内容属于正确性、安全或性能范畴**,前四份主报告均未收录。补录于此,严重度沿用原判(这些条目未进入 P0/P1 复核批次,除非另行注明)。
| 严重度 | 维度 | 标题 | 位置 | 修复要点 |
| --- | --- | --- | --- | --- |
| P2-中等 | A5 核心与安全 | `ProfileService._require_owner` 不认管理员权限,与 `ResourceAccessService._can_access` 语义相反 —— 同一套归属校验在两处给出相反答案,**做 §4 P1-2 的 IDOR 改造时必须先统一,否则会把矛盾扩散到五条链路** | `backend/services/profile_service.py:160` | 让 `_require_owner` 复用 `ResourceAccessService._can_access`(含 `can_manage_all_profiles` 分支),删除本地实现 |
| P2-中等 | A1 生成与队列 | `_BoundedWorkerHandler` 的并发限流在生产配置下**完全是空操作**,且限流点位于「认领之后」——任务已被 CAS 认领才去抢信号量,抢不到只能阻塞持锁等待 | `backend/services/worker_service.py:400` | 限流点前移到 `_claim_next` **之前**;上限从生产配置真实读取而非落到默认无界值。与 §5 的 `generation_service.py:119` 背压项(阶段 2 的 2-8)同一个 PR 做 |
| P2-中等 | C4 横切 | 主动通知全链路静默失败:签名失败返回 `None`、发送失败返回 `False`、terminal 回调静默 `return`,**一行日志都没有** —— 用户不会收到轮次完成通知,运维也无从得知 | `backend/services/workflow_round_worker_runtime.py:262` | 三个失败出口各补 `logger.warning`(含 round_id / task_id / 失败阶段);随阶段 2 的日志基座一起做 |
| P2-中等 | C4 横切 | AstrBot 桥接与配置覆盖是**进程级模块全局变量**,热重载与测试隔离困难(插件 reload 后旧桥接对象可能残留) | `core/astrbot_provider_bridge.py:22` | 收进一个显式的 runtime 持有者对象,由组合根(03 报告 §1.4.4)注入;`set_*` 提供对应的 `reset_*` 供测试用 |
| P3-轻微 | A4 数据层 | PostgreSQL 迁移执行器**按分号裸切分** SQL —— 迁移脚本里只要出现函数体、`DO $$ ... $$` 或字符串内的分号就会被切错,静默执行半条语句 | `database/db_helper.py:280` | 改用驱动自身的多语句执行,或在迁移文件里显式声明语句边界。与 §4 P1-8 的 PG 兼容性一并验证 |
| P3-轻微 | A6 引擎与适配器 | `_match_endpoint` 未对路由字面量做 `re.escape` —— 端点模板里一旦出现正则元字符(`.`、`+`、`(`)就会产生非预期匹配 | `adapters/astrbot_adapter.py:226` | 对非 `{param}` 段一律 `re.escape`;与 §6 的路由表预编译缓存(`astrbot_adapter.py:47`)同一处改 |
| P3-轻微 | A3 素材 | 衣柜分类无白名单校验;`delete_item` 用 `assert` 做并发保护 —— **`python -O` 下 assert 被整体剥除,保护直接消失** | `backend/services/wardrobe_service.py:128` | `assert` 换成显式 `if ...: raise ApiError(...)`;分类值加白名单(复用 `material-labels` 的分类集合) |
| P3-轻微 | A5 核心与安全 | 敏感键匹配把 `"key"` 当子串 —— `sort_key`、`route_key`、`node_key` 等普通配置项被误当密钥脱敏,配置页显示 `***` 却无法编辑 | `backend/services/settings_service.py:26` | 改为按完整路径白名单或后缀匹配(`_api_key` / `_token` / `_password` / `_secret`) |
| P3-轻微 | A1 生成与队列 | `cancel_job` 的重读循环**无次数上限与退避** —— 与 worker 高频写入竞争时可能长时间空转 | `backend/services/queue_service.py:135` | 加最大重试次数(如 5)与指数退避,超限抛 `ApiError(CONFLICT)` 让调用方重试 |
| P3-轻微 | A2 工作流与轮次 | approve 响应里对同一个 `next_node_id` 重复查询节点 | `backend/services/workflow_generation_cross_review_service.py:262` | 查一次存局部变量复用 |
**前端侧另有 3 条被漏收**(归 `coupling`/`hygiene`,已在 03/04 的收敛方案中间接覆盖,此处仅登记):`ProfilesPage.vue:10` 三层 prop drilling(24 props / 13 emits,其中 16 个纯透传)、`ProfileWardrobePane.vue:249` 状态归属分裂(衣橱条目走 props/emits 而套装模板自己调 API)、`App.vue:10504` `queueBatchActionMessage` 内的局部 `errorMessage` 遮蔽同名全局工具函数。
---
## 7. 按子系统的缺陷密度
| 子系统 | 缺陷数 | P0 | P1 | P2 | P3 | 规模参照 | 判断 |
| --- | --- | --- | --- | --- | --- | --- | --- |
| `backend/services/` | **42** | 0 | 3 | 33 | 6 | 70 个文件,`advanced_style_set_service.py` 单文件 4491 行 | **最需要重构。** 缺陷占全部 45%,且高度集中在轮次/队列/素材三条链上。根因不是单点 bug,是没有组合根(34 处各自 `Database(load_database_settings())`)、状态机守卫与写入分离、N+1 与整表加载成为默认写法 |
| `database/`(仓储 + db_helper) | **12** | 0 | 2 | 5 | 5 | 131 处重复的 connect/execute/close 样板 | 次要重灾区。PG 兼容性(字面量 `%`、时间戳语义)在两处已实证会崩;连接管理缺失是 `backend/services/` 一半性能问题的下游放大器 |
| `core/` | **7** | 0 | 0 | 5 | 2 | — | 安全边界几乎全在这里(runtime_paths / storage / config_writer / remote_fetch / media_proxy),且**每一条都是"约束缺失"而非"逻辑写错"**。§2 两条攻击链的 3 个断链点全在此目录 |
| 前端 `App.vue` | **6** | 0 | 1 | 4 | 1 | 22563 行(script 11356 / template 2784 / CSS 8395) | 密度不高,但 P1-10 的 `displayMediaUrl` 是典型的巨型单文件症状:格式化函数里塞了网络 I/O 和响应式写入,在 11356 行的 script 里没人看得出来 |
| 前端 `features/` | **6** | 0 | 0 | 4 | 2 | — | 问题集中在"占位数据/示例数据混进生产路径"(2 条)与"前端复刻后端规则"(1 条) |
| `engines/` | **5** | 0 | 1 | 4 | 0 | — | `single_flow.py` 是全仓唯一构造 `ImageGenerationRequest` 的地方,尺寸链路断在这里;fallback 无错误分类是 image/vision 共性 |
| `backend/routes/` | **5** | 0 | 1 | 3 | 1 | 32 个文件 / 166 条路由 | 缺陷少但杠杆高:`common.py:12` 一处吞异常影响全部 166 条路由;IDOR 是五条链路的共性漏改 |
| `adapters/` | **4** | 0 | 0 | 3 | 1 | — | 分发器不强制权限矩阵 + 每请求重算路由表,都是"入口处该做一次的事没做" |
| `main.py` | **3** | 0 | 1 | 1 | 1 | 2580 行 | 全部围绕同一行:`:2337` 的权限赋值 |
| 仓库根 / 配置 / 打包 | **2** | **1** | 1 | 0 | 0 | — | 条数最少、危害最大。P0 与 `_conf_schema.json` 缺口都不在代码里,而在"代码之外的交付面" |
| `tests/` + 前端 `shared/` | **2** | 0 | 0 | 2 | 0 | 后端 45 个测试文件 / 前端 8 个 | — |
**结论**:重构优先级 `backend/services/` > `core/`(按危害而非条数)> `database/`。`core/` 条数只有 7 但含全部安全边界,且每条修复都是十几行的约束补充 —— 投入产出比最高,应当先做。
---
## 8. 复核说明
本清单的每一条 P0/P1 发现都经过**对抗式复核**:为每条发现派一名独立复核者,立场设为「默认这是误报」,要求实际 Read 源码后才可判定成立。复核覆盖 56 条 P0/P1,**推翻 16 条**,维持 40 条 —— 其中 **33 条被下调严重度**、仅 7 条维持原判。
维持的 40 条复核后分布为 P0×1 / P1×9 / P2×20 / P3×10;被推翻的 16 条一律给出 P3 的残留定级。换算成"原判 → 现判":原判 P0 的 6 条只剩 1 条仍是 P0(凭据泄露),3 条降 P1、1 条降 P2、1 条被推翻;原判 P1 的 50 条中仅 6 条维持 P1,19 条降 P2、10 条降 P3、15 条被推翻。**误报率 29%,下调率 59%** —— 这个比例本身就是一条结论:动手修之前先写一个能复现的测试。
被推翻的 16 条中,有 12 条属于本清单的 bug/security/perf 类别,**已全部从"成立的缺陷"中剔除**(另 4 条属 coupling/hygiene 类别,不在本清单范围)。这 12 条中,11 条的残留技术债按复核给出的降级严重度收录在 §6 P3 表并标注「经复核降级」、不计入总数;剩下 1 条(SQLite 未启用 WAL)的残留内容与另一条独立成立的 P2 性能发现(`database/db_helper.py:159`)指向同一处代码,已合并到 §5 P2 表对应行,并在该行注明复核否定了原机理。
复核也修正了原报告的事实错误,例如:`.env` 泄露的 `api_key_plaintext` 实际在第 **25** 行(原报告写 :26,差一行);`_string_list` 真实是 **17** 处而非 18 处(多算的在 `.tmp/` 构建快照里)。
### 被推翻的典型案例
**案例一:`update_round` 无状态机守卫(原判 P0-致命 → 推翻)**
原发现称"已 confirmed 的轮次可被幂等重放静默回退"。复核确认引用的代码片段全部真实存在(`:115-117` 的重放分支、`:928-940` 无条件写 `status="queued"`、`update_round` 确是裸 UPDATE),但**发现者漏读了 `create_round` 的第一行守卫**:`_ensure_round_creation_allowed(node, workflow)` 在第 81 行执行,早于第 90 行读取 `idempotency_key`;该守卫对 `node.status == "selected"` 或 `selected_image_id` 非空的节点直接抛 `VALIDATION_FAILED`。复核进一步证明"轮次 confirmed"与"节点 selected"是同一原子事务写入(`workflow_round_repository.py:993-1017`、`workflow_cross_review_repository.py:580-635`),不存在可利用的中间态,也不存在解锁节点但保留轮次 confirmed 的回退路径。整条攻击链对 confirmed 轮次不可达。降级为 P3 防御性编码瑕疵。
**案例二:`_conf_schema.json`(原判 P1 → 保留)与 SQLite WAL(原判 P1 → 推翻)的对照**
WAL 那条的复核最能说明标准。原发现称"写事务持有 RESERVED/EXCLUSIVE 锁会阻塞全库所有读,provider 调用稍慢就 30s 超时"。复核指出:(a) SQLite 语义被说错 —— rollback journal 模式下 RESERVED 不阻塞读者;(b) 通读 `confirm_candidate_atomic` 全文(`workflow_round_repository.py:801-1131`),事务内只有本地 SELECT/UPDATE/INSERT,**没有任何网络或文件 I/O**,事务寿命毫秒级,与 30s busy_timeout 差 4 个数量级;(c) 声称的并发场景是虚构的 —— `confirm_candidate_atomic` 唯一调用方是用户确认候选的交互式 API,聊天侧的 4 线程走的是完全不同的 `nodes/{id}/generate` 链路。开启 WAL 仍是合理调优,但"生成静默失败"级缺陷不成立,已按 P2 性能调优收录(§5 表末)。
**案例三:`POST profiles/{id}/archive` 实际执行删除(原判 P1 → 推翻)**
原发现称"用户点击标注为'归档'的按钮,档案却被删除,两种意图被合并成破坏性操作"。复核把 `profileArchive` 的全部引用查了一遍:全仓唯一调用点在 `App.vue:6300` 的 `deleteSelectedProfile()`,失败文案是"删除角色失败",状态变量叫 `profileDeletingId`,模板绑定是 `@delete`;用户实际看到的控件(`ProfileDetailPane.vue:190-198`)文案是"删除"、hover 提示"删除角色档案"、样式是 `danger-button`。**用户意图 = 删除,后端行为 = soft_delete,两者完全一致**,不存在所称的意图错配。更关键的是,复核指出如果照原修复建议改成写 `status="archived"`,会让这个删除按钮变成不删除、档案继续留在列表里 —— **修复本身会引入真实的功能回归**。仅保留 P3 级的 REST 路径命名整洁度问题。
---
*本清单只收录有 `文件:行号` 支撑的内容。所有严重度均为复核后的最终判定,未经复核的条目已在正文中标注。*