87 KiB
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 |
清理命令
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 视角,并加硬断言:
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。
真实代码(逐字核对,含原有注释)
# 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() 的 "*" 分支仍有效,不是整段死代码)。
修复
- 短期、当天可做:在
config.yaml增加显式白名单(如security.config_admin_users),main.py:2337改为按 username 命中白名单才追加can_manage_config/can_manage_materials,未命中只给can_write+can_retry_tasks。这不需要上游改PluginRequest。 - 中期:从 AstrBot 请求上下文尝试解析角色(
g上的 role/claims),解析失败时降级到最小集而非最大集。 - 配套:把这条边界写进启动自检 —— 若白名单为空且检测到多个不同 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。
真实代码
# 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 —— 这正是"漏改"而非"设计如此"的铁证。
修复
WorkflowService.list_workflows/get_workflow/get_node/list_nodes增加ctx参数,内部走已有的require_workflow/require_node。QueueService.list_jobs与ImageService.list_images增加owner_user_id过滤参数,路由层传ctx.actor_id(持can_manage_all_profiles时传 None)。HistoryService相关方法前置require_workflow。- 补越权矩阵测试:用户 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。
真实代码
# 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):// 时,直接把字符串当本地路径读取,无根目录约束、无白名单、无图片魔数校验。
真实代码
# 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 会先完整解码进内存再判超限。
修复
- 删除本地路径兜底分支;确需保留则对显式配置的缓存根做
Path.resolve()前缀约束(backend/services/web_hosting_service.py:58-67的_resolve已写对同类逻辑,直接照抄)。 - 落盘前统一走
core.image_formats.detect_image_format(body),返回 None 则拒绝,并用检出的image_format.extension而非用户给的后缀。 data:分支先按len(encoded) > ((MAX_CHAT_IMAGE_BYTES + 2) // 3) * 4预检再解码(engines/single_flow.py:398-404已有正确写法)。- 给
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。
真实代码(这些键在业务代码里是真的被读的)
# 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: [])。即:内容安全开关在生产实际不可配置,且升级即丢失。
修复
- 补齐
_conf_schema.json的prompt_governance.moderation.*/prompt_governance.routing.*/chat_access.adult_*_allowlist/prompt_governance.retention.redact_sensitive_logs,并在_CONFIG_KEY_MAP加对应映射。 - 加防漂移测试:断言
_CONFIG_KEY_MAP.values()与_conf_schema.json键集双向相等;再断言config.yaml中所有安全相关叶子路径都出现在映射表 key 里。 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 认领任务复用了给前端做"最新在前"的通用列表接口。
# 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。
# 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 请求,成本无上限。
修复
- 为生成建立独立、容量可配的
ThreadPoolExecutor(4~8),dispatch_web_request继续用默认池,二者隔离 —— 这一条单独就能防住"取消接口也卡死"。 GenerationService入口加进程级threading.BoundedSemaphore(max_concurrent_generations),取不到时快速返回 429 /QUEUE_BUSY而非排队阻塞。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
问题
-- 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:
# 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),角色详情与角色列表完全不可用,且错误来自驱动层格式化,完全指向不了根因。
修复
- 立刻改成参数绑定:定义
LEGACY_ARCHIVE_MARKER = '%"final_archive_history_id"%',SQL 里写LIKE {placeholder},调用处按 CASE 列出现次数补齐参数。 - 更彻底:把
final_archive_history_id提升为profile_workflows的真实列(新增 0019 迁移 + 回填),同时解决转义和前缀通配符全表扫描(与 P2 表里profile_repository.py:32的 10 个相关子查询一起修)。 - 加静态断言测试:正则扫描
database/repositories/*.py中未转义的裸%(模式%(?!s))。
P1-9 · size 请求字段全链路无人消费,聊天尺寸参数与高清修复静默失效
位置 engines/single_flow.py:61(缺失 size→尺寸映射);写入侧 backend/services/chat_workflow_service.py:63 与 :929
真实代码
# 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:
# 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 成为一等输入:
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 明令禁止的在计算属性/渲染中做副作用。
真实代码
// 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)),所以必然走副作用分支。
影响
- O(N²) 重算:
galleryImages依赖resolvedMediaUrls,而它自己让 N 张图各触发一次 ref 整体替换 → 每张图解析完成都让整个galleryImages(含排序 + N 次displayMediaUrl)重跑。loadGalleryImages(:4511) 会拉全库所有页,1000 张图 ≈ 100 万次调用,watch(galleryImages)(:4184) 跟着抖 1000 次。 - Blob 内存无界增长:
ownedMediaObjectUrls只在onBeforeUnmount(:4041) 统一 revoke,SPA 会话中浏览过的每张图完整二进制常驻内存直到关标签页。 - render 期间发请求:切主题、点通知等任何无关响应式变更重渲染时都可能补发媒体请求。
修复 把媒体解析从"渲染时惰性触发"改成"数据加载时显式预取":
- 新建
composables/useMediaUrls.ts,导出纯读表的mediaUrl(raw)和显式的prefetchMediaUrls(rawUrls[])。 - 在
loadGalleryImages/loadWorkflowRoundDetail/hydrateGenerationImages拿到数据后批量预取,一次resolvedMediaUrls.value = {...}写入全部结果(N 次 ref 替换压成 1 次)。 - 给
resolvedMediaUrls加 LRU 上限(如 300 条),淘汰时URL.revokeObjectURL并从ownedMediaObjectUrls移除。 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 |
| 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 |
| 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 路径命名整洁度问题。
本清单只收录有 文件:行号 支撑的内容。所有严重度均为复核后的最终判定,未经复核的条目已在正文中标注。