573 行
66 KiB
Markdown
573 行
66 KiB
Markdown
|
|
# 复核结论(对抗式验证)
|
|||
|
|
> 对全部 P0/P1 发现各派一名独立复核者,立场设为「默认这是误报」,要求 Read 真实代码后才可判定成立。
|
|||
|
|
> 复核 56 条,**推翻 16 条**,维持 40 条。
|
|||
|
|
|
|||
|
|
## 被推翻的发现(不得进入最终报告,或须按复核意见降级)
|
|||
|
|
|
|||
|
|
### 推翻 #1
|
|||
|
|
- **定位**:`backend/services/workflow_round_service.py:81 (_ensure_round_creation_allowed,定义在 :1129-1156)`
|
|||
|
|
- **复核意见**:结论:误报。发现者引用的代码片段本身真实存在(workflow_round_service.py:115-117 的幂等重放分支、:928-940 无条件写 status="queued"、database/repositories/workflow_round_repository.py:1355-1375 的 _ensure_writable_round_row confirmed 只读保护、:416-431 的裸 UPDATE update_round),但它漏读了 create_round 的第一行守卫,导致整条攻击链对 confirmed 轮次不可达。
|
|||
|
|
|
|||
|
|
1) create_round 在读取 idempotency_key 之前就先跑了节点级锁:
|
|||
|
|
```python
|
|||
|
|
node, workflow = self._node_and_workflow(node_id, ctx)
|
|||
|
|
self._ensure_round_creation_allowed(node, workflow) # line 81
|
|||
|
|
...
|
|||
|
|
idempotency_key = _optional_text(payload.get("idempotency_key")) # line 90
|
|||
|
|
if idempotency_key:
|
|||
|
|
existing = self.round_repository.get_round_by_idempotency_key(idempotency_key) # line 92
|
|||
|
|
```
|
|||
|
|
而 _ensure_round_creation_allowed(:1145-1156)明确拒绝已定稿节点:
|
|||
|
|
```python
|
|||
|
|
if node.status == "selected" or node.selected_image_id or (
|
|||
|
|
progression is not None and node.node_id in progression.completed_node_ids
|
|||
|
|
):
|
|||
|
|
raise ApiError(
|
|||
|
|
ErrorCode.VALIDATION_FAILED,
|
|||
|
|
"confirmed workflow node is locked; create a branch before adding another round",
|
|||
|
|
{"node_id": node.node_id, "branch_name": node.branch_name, "required_action": "create_branch"},
|
|||
|
|
)
|
|||
|
|
```
|
|||
|
|
即:目标节点一旦定稿,请求在第 81 行就抛 VALIDATION_FAILED,根本走不到第 92 行的 idempotency 查表,更走不到 :116 的 _ensure_round_enqueued。
|
|||
|
|
|
|||
|
|
2) 「轮次 status=confirmed」与「节点 status=selected / selected_image_id 非空」是同一原子事务里一起写的,不存在“轮次已 confirmed 但节点仍可创建轮次”的中间态。全仓只有两处把轮次写成 confirmed,两处都同时锁死节点:
|
|||
|
|
- workflow_round_repository.py:993-1000(confirm_candidate_atomic)先执行
|
|||
|
|
```sql
|
|||
|
|
UPDATE workflow_nodes SET status = 'selected', selected_image_id = ?, updated_at = CURRENT_TIMESTAMP WHERE node_id = ?
|
|||
|
|
```
|
|||
|
|
:1010-1017 才写 `UPDATE workflow_generation_rounds SET status = 'confirmed' ...`,同一 conn 同一事务(sqlite BEGIN IMMEDIATE,pg FOR UPDATE 行锁)。
|
|||
|
|
- workflow_cross_review_repository.py:580-583 同样先 `UPDATE workflow_nodes SET status = 'selected', selected_image_id = ?`,:599-635 才把评审轮次与 root 轮次写成 confirmed。
|
|||
|
|
|
|||
|
|
3) 不存在“解锁节点但保留轮次 confirmed”的回退路径。唯一清 selected_image_id 的地方是 image_service.py:179/205/225(unselect/archive/delete_image),三处入口都先调 _ensure_image_node_is_editable(:236-255),对 LOCKED_NODE_STATUSES 内节点直接 raise locked_node_edit_error;即便 selected_image_id 被清空,node.status 仍是 'selected',第 1145 行照样拦得住。
|
|||
|
|
|
|||
|
|
4) 因此发现列举的三项后果全部不成立:apply_feedback_atomic 的 _ensure_writable_round_row 拦截、workflow_cross_review_repository.py:1066-1076 的 confirmed_candidate_mismatch、:1108-1122 的 _ensure_review_after_confirmation_is_safe、:795 的 record_skip_restoration_handoff_atomic,都不会因为“status 被回退成 completed”而失效——status 压根回退不了。另外跨评审轮次也不走 create_round:backend/routes/generation_cross_review_routes.py 走 workflow_cross_review_repository 的原子路径(:165-169 有独立 _round_replay),与这条 idempotency 分支无关。
|
|||
|
|
|
|||
|
|
5) 触发条件描述尤其站不住:“网络超时后的正常重试”发生在轮次刚创建、节点尚未定稿时,此时 status 是 draft/queued/running,_ensure_round_enqueued 写成 queued 再 reconcile 成实际聚合态,正是幂等补偿的预期语义,不是缺陷。
|
|||
|
|
|
|||
|
|
残留的真实问题仅是防御性编码瑕疵:_ensure_round_enqueued 末尾的 status 写入确实没有终态白名单,依赖调用方(create_round:81)的前置守卫兜底,属于“守卫与写入分离、易被后续重构打破”的健壮性问题,最多 P3,需先破坏第 81 行节点锁才可能演变为真实缺陷。
|
|||
|
|
|
|||
|
|
### 推翻 #2
|
|||
|
|
- **定位**:`backend/services/worker_service.py:191-206 (_run_loop) 与 backend/services/queue_service.py:439+ (recover_stale_tasks)`
|
|||
|
|
- **复核意见**:代码引用属实,但核心机理与影响链被证伪,标题所述的"并发抢占同一队列 / worker 线性膨胀"不成立。
|
|||
|
|
|
|||
|
|
1) 引用的代码确实存在、行号对得上:
|
|||
|
|
- worker_service.py:180-185 的 stop() 逐字一致(set() 后 join(timeout),返回 running=self.is_running());
|
|||
|
|
- main.py:437-439 逐字一致:`self.round_worker_result = self.round_worker_runtime.stop()` / `self.round_worker_runtime = None`,确实不看 running;
|
|||
|
|
- engines/image_provider.py:308-313 的 `_generation_request_timeout_seconds` 返回 `min(max(timeout, 10), 3600)` 也属实。
|
|||
|
|
|
|||
|
|
2) 决定性反证——旧线程停止后不会再认领任何任务。worker_service.py:191-206:
|
|||
|
|
```
|
|||
|
|
def _run_loop(self, ctx):
|
|||
|
|
while not self._stop_event.is_set():
|
|||
|
|
result = self.run_once(ctx)
|
|||
|
|
...
|
|||
|
|
```
|
|||
|
|
认领动作只发生在 run_once → _claim_next 内,而 run_once 每次只认领一条任务(_claim_next 返回单个 task,见 207-221 行)。stop_event 被 set 后,阻塞中的 run_once 一旦返回,while 条件立即为假,线程退出。也就是说 join 超时后残留的旧线程**最多把手上那一条已认领任务跑完就自然死亡,绝不会与新 pool 竞争认领新任务**。因此"新旧 worker 池并发抢占同一队列""worker 数量随每次重载线性膨胀"两条结论都不成立——每次重载最多留下 5 个短命线程,各自跑完一条即退出,不累积。
|
|||
|
|
|
|||
|
|
3) 残余风险存在但被默认配置基本关闭。唯一真实的窄窗口是:旧线程手上那条任务若在新 runtime 启动时已 running 超过 stale_after_seconds,会被 recover_stale_tasks(workflow_round_worker_runtime.py:55-59,默认 stale_after_seconds=300)标 failed 再重新入队,造成同一候选被生成两次。但要触发必须让单条任务的 running 时长超过 300 秒,而 config.yaml:25 / config.yaml:42 的默认 `timeout_seconds: 180`,加上 terminate() 里 5 个 worker 顺序 join(最多 25 秒)才轮到 initialize() 做 recovery,默认配置下窗口实际关闭;只有把 provider 超时手动配到 >300 秒(上限 3600)才可能命中。这属于配置相关的边缘竞态,而非 P0/P1 级的必现重复计费。
|
|||
|
|
|
|||
|
|
4) 另外 update_task 并非"无条件写回":queue_service.py:405-408 的 update_task 会先走 `_validate_task_status_transition`(673-686 行,依赖 core/fsm.py 的 TASK_TRANSITIONS);run_once 116 行之前还会先 get_job 复查 cancelled(106-115 行)。真正的 CAS 保护(update_task_if_status / claim_queued_task,184-228、280-312 行)确实保证了同一条任务不会被两个线程同时认领。
|
|||
|
|
|
|||
|
|
结论:机理描述有真实成分(stop() 返回值被忽略、join 可能超时),但被断言的影响链(队列抢占、线程线性膨胀、必然重复计费)经代码验证不成立,严重度严重夸大。按误报处理,若要保留最多记为 P3 的健壮性改进(stop() 返回 running=True 时记日志/告警,或让 recovery 跳过本进程仍存活的 worker_id)。
|
|||
|
|
|
|||
|
|
### 推翻 #3
|
|||
|
|
- **定位**:`backend/routes/profile_routes.py:109-114(仅命名问题);frontend/shared/api/endpoints.ts:10-11(profileDelete 定义后未使用)`
|
|||
|
|
- **复核意见**:代码本身存在,但这条发现的"影响"是编造的,P1-严重定级完全站不住脚。
|
|||
|
|
|
|||
|
|
一、代码事实核对(这部分属实)
|
|||
|
|
`backend/routes/profile_routes.py:109-114` 确实是:
|
|||
|
|
```python
|
|||
|
|
def archive_profile(
|
|||
|
|
ctx: RequestContext,
|
|||
|
|
profile_id: str,
|
|||
|
|
service: ProfileService | None = None,
|
|||
|
|
) -> dict:
|
|||
|
|
return delete_profile(ctx, profile_id, service)
|
|||
|
|
```
|
|||
|
|
`backend/route_registry.py:69` 也确实注册了 `RouteSpec("POST", "profiles/{profile_id}/archive", "backend.routes.profile_routes.archive_profile", "write")`。行号无误,非幻觉。
|
|||
|
|
|
|||
|
|
二、致命反驳:前端根本没有"归档"按钮,唯一调用方是一个红色"删除"按钮
|
|||
|
|
发现声称"前端 profileArchive 按钮标注为'归档',用户点击后档案被删除……归档与删除两种不同用户意图被合并成一种破坏性操作"。我把 profileArchive 的全部引用查了一遍,全仓库只有一处调用(`frontend/standalone-web/src/App.vue:6300`),而它所在的函数是:
|
|||
|
|
```js
|
|||
|
|
async function deleteSelectedProfile() {
|
|||
|
|
const profile = selectedProfilePage.value
|
|||
|
|
if (!profile || profileDeletingId.value) return
|
|||
|
|
const blocked = backendWriteBlockMessage("删除角色档案")
|
|||
|
|
...
|
|||
|
|
profileDeletingId.value = profile.profile_id
|
|||
|
|
try {
|
|||
|
|
await postJson<CharacterProfile>(endpoints.profileArchive(profile.profile_id))
|
|||
|
|
```
|
|||
|
|
失败文案是 `` `删除角色失败:${errorMessage(err)}` ``(App.vue:6334),状态变量叫 `profileDeletingId`,模板绑定是 `@delete="deleteSelectedProfile"`(App.vue:13369)。
|
|||
|
|
|
|||
|
|
再看用户实际看到的控件(`frontend/standalone-web/src/features/profiles/ProfileDetailPane.vue:190-198`):
|
|||
|
|
```html
|
|||
|
|
<button
|
|||
|
|
type="button"
|
|||
|
|
class="danger-button"
|
|||
|
|
:disabled="!canWrite || !backendConnected || deleting || Boolean(generationBusy)"
|
|||
|
|
title="删除角色档案"
|
|||
|
|
@click="emit('delete')"
|
|||
|
|
>
|
|||
|
|
{{ deleting ? "删除中" : "删除" }}
|
|||
|
|
</button>
|
|||
|
|
```
|
|||
|
|
按钮文案是"删除"、hover 提示是"删除角色档案"、样式是 `danger-button`。用户意图 = 删除,后端行为 = `repository.soft_delete()` 置 `status="deleted"`,两者**完全一致**。不存在任何"用户以为在归档、结果被删除"的场景,也就不存在所声称的"两种不同用户意图被合并"和"破坏性操作"。发现里"该档案及其下所有工作流从 UI 彻底消失"这一后果是删除按钮的**预期行为**,不是缺陷。
|
|||
|
|
|
|||
|
|
三、被引用的"证据"反而说明这是有意为之
|
|||
|
|
发现自己引用的 `delete_profile_via_post`(profile_routes.py:101-107)同样转发 `delete_profile`,对应 `route_registry.py:68` 的 `POST profiles/{profile_id}/delete`。也就是说仓库为软删除提供了 DELETE、POST /delete、POST /archive 三条等价入口(`endpoints.ts:10` 的 `profileDelete` 已定义但全仓库无人调用),前端只是挑了 `/archive` 这条当删除用。这是路径命名/冗余入口的整洁性问题,不是语义错误导致的数据事故。
|
|||
|
|
|
|||
|
|
四、与 workflow 侧的对照不成立
|
|||
|
|
`workflow_routes.py:106-111` 的 `archive_workflow` 走 `_set_workflow_status(ctx, workflow_id, "archived", service)`,确实是真归档,但 workflow 有 `core/fsm.py:9-15` 定义的 `archived` 终态,而 profile 侧的状态机里压根没有 `archived` 这个态——`ProfileService.get_profile`(profile_service.py:70-77)只对 `status == "deleted"` 做 404,`list_profiles` 默认 `status="active"`。profile 从未设计过归档态,拿 workflow 的 FSM 去要求 profile 属于类比失当。
|
|||
|
|
|
|||
|
|
五、结论
|
|||
|
|
唯一站得住的残留问题是:REST 路径叫 `/archive` 却执行删除,命名有误导性,且与 `imagestudio_full_plugin_dev_doc_v3_ui_adjusted.md:657` 的契约文档字面不符,未来若真要加归档功能会撞名。这是 P3 命名/契约整洁度问题。发现给出的"修复建议"(把 archive 改成写入 `status="archived"`)如果照做,反而会让当前这个"删除"按钮变成不删除、档案继续留在列表里——即引入真实的功能回归。故判定为误报。
|
|||
|
|
|
|||
|
|
### 推翻 #4
|
|||
|
|
- **定位**:`backend/routes/node_routes.py:140(构造顺序);真正残留问题在 adapters/astrbot_adapter.py:171-187 与 main.py:315-344 缺少兜底 try`
|
|||
|
|
- **复核意见**:代码本身没有幻觉,但这条发现的**核心指控("未授权即触发重型初始化")在本仓库不存在可达路径**,属于误报级别的过度定级。
|
|||
|
|
|
|||
|
|
一、代码确实如描述(这部分成立)
|
|||
|
|
`backend/routes/node_routes.py:132-146` 逐字对得上:
|
|||
|
|
```python
|
|||
|
|
def generate_node(ctx, node_id, payload=None, service=None, generation_service=None) -> dict:
|
|||
|
|
workflow_service = service or _create_workflow_service()
|
|||
|
|
resolved_generation_service = generation_service or (None if service else _create_generation_service())
|
|||
|
|
def action() -> dict[str, Any]:
|
|||
|
|
require_write(ctx)
|
|||
|
|
```
|
|||
|
|
`_create_generation_service()`(node_routes.py:315-390)确实调 `load_config_payload()`、`Database(...)`、`sync_generation_provider_from_config(...)`;后者在 `backend/services/model_provider_bootstrap.py:68,79` 里确实执行 `service.upsert_provider(...)` 与 `service.upsert_route(...)` 写库。`round_routes.py:137-138` 的只读 `list_node_rounds` 也确实经 `_create_round_service()` → `create_generation_service()` 走同一条重型链路。`backend/routes/common.py:12-16` 的 try 也确实只包住 callback。
|
|||
|
|
|
|||
|
|
二、致命反驳:不存在"有权限差、但能打到 handler"的调用者
|
|||
|
|
生产环境只有两个 ingress,两个都在 service 构造**之前**就完成了准入判定:
|
|||
|
|
|
|||
|
|
1. Web 桥接(前端唯一通路):`main.py:2324-2344`
|
|||
|
|
```python
|
|||
|
|
# AstrBot authenticates extension routes before invoking the plugin, but
|
|||
|
|
# PluginRequest currently exposes only the authenticated username.
|
|||
|
|
permissions = BRIDGE_PERMISSIONS if username or user_id else frozenset()
|
|||
|
|
```
|
|||
|
|
`BRIDGE_PERMISSIONS`(main.py:104-106)= `{"can_write","can_manage_config","can_manage_materials","can_retry_tasks"}` 全给。也就是说:**凡是能走到 handler 的请求,`require_write` / `require_task_retry` 必然通过**;而未登录请求根本进不来——`docs/project-migration-handoff-2026-07-18.md:263` 是实测证据:"插件 Web 路径直接无认证访问会返回 `Missing API key`,这是正常鉴权行为"。攻击者拿不到 401 之后的执行权,谈不上"未授权用户狂刷 GET nodes/x/rounds"。
|
|||
|
|
|
|||
|
|
2. 聊天命令通路:`backend/services/chat_workflow_service.py:1149-1164`,白名单校验 `chat_action_allowed(...)` 在**构造 ctx 和 dispatch 之前**,不通过直接 `raise ValueError("当前群聊或用户不满足聊天白名单规则")`;通过者被显式授予 `{"can_write","can_retry_tasks","can_manage_materials"}`。同样不存在"权限不足但已进入 handler"的状态。
|
|||
|
|
|
|||
|
|
结论:把 `require_*` 提到构造前,唯一能省下的是一个**在生产中永远不会发生**的分支的开销。原文声称的影响 1(未授权资源消耗 / SQLite 写锁被未授权流量拖垮)与影响 3 的"未授权"定性,均不可达。
|
|||
|
|
|
|||
|
|
三、影响 2(500 泄漏)被夸大
|
|||
|
|
`adapters/astrbot_adapter.py:171-187` 的 `dispatch_extension_request` 与 `main.py:315-344` 的 `dispatch_bridge_request` 确实都没有 try,构造期异常会逃逸到 Quart —— 这一条**技术上成立**。但:(a) 只影响响应体格式(丢失 `{"ok": false, ...}` 信封),不是安全问题;(b) "带 traceback 的 500"是臆测,Quart 非 debug 模式只返回通用 Internal Server Error,仓库中没有任何证据显示 AstrBot 以 debug 模式运行;(c) 即便包进 try,`response_from_exception` 也只是把同一个错误换个外壳返回,实际收益是格式一致性而非防泄漏。
|
|||
|
|
|
|||
|
|
四、残留的真问题与原文定性不同
|
|||
|
|
真正值得修的是"**只读 GET 也跑一遍 config bootstrap 并 upsert provider/route**"(node_routes.py:328 + model_provider_bootstrap.py:68,79),这是**已授权用户**的每请求性能/副作用问题,与鉴权顺序无关——把 `require_write` 前移一行也解决不了它。注意默认 `config.yaml`(generation.provider 的 base_url/model_id/route_name 均为空)会在 bootstrap.py:49-51 因 `missing` 直接 continue,只剩 `list_routes()` 读操作,写副作用仅在真实配置好的部署里出现。
|
|||
|
|
|
|||
|
|
综上:标题与 P0/P1 级的"未授权"框架站不住脚,判定为误报;剩下的"构造放进 try / 只读接口不该跑 provider 同步"属于 P3 级健壮性与设计清洁度整改,且后者应作为独立的性能发现单独提出。
|
|||
|
|
|
|||
|
|
### 推翻 #5
|
|||
|
|
- **定位**:`backend/services/model_provider_runtime.py:285(代码定位属实,但影响判定错误)`
|
|||
|
|
- **复核意见**:一、代码事实核对(部分属实):`backend/services/model_provider_runtime.py:285` 确实是 `resolved = self.model_provider_service.resolve_route(route_name)`,其后 `provider = resolved.get("provider") or {}` 直接进入 `resolve_secret_value(...)`,没有 provider_type 判断;对照的 `:131-136` 与 `:200` 也确如描述。行号与代码文本对得上,不是幻觉。但"与同文件其他两处不一致"被夸大了:`_structured_text_callable_for_single_route(:196)` 同样是 `resolve_route(route_name)` 不带 modality,且全库 model_routes 表只存在 `image_generation` / `vision_recognition` 两种 modality(`model_provider_bootstrap.py:75,245`),"结构化 callable 不传 modality"是这一族函数的既有写法,真正唯一缺失的只有 provider_type 一道门。
|
|||
|
|
|
|||
|
|
二、"安全审核静默绕过"这一条是彻底错误的,方向恰好相反。`backend/services/prompt_governance_service.py:356-366`:
|
|||
|
|
```
|
|||
|
|
if self.reviewer is None or not bool(self.config.get("enabled", False)):
|
|||
|
|
return {"status": "not_configured", "action": "allow", ...}
|
|||
|
|
try:
|
|||
|
|
result = dict(self.reviewer({...}))
|
|||
|
|
except Exception:
|
|||
|
|
return {"status": "review_failed", "action": "quarantine", ...}
|
|||
|
|
```
|
|||
|
|
也就是说,`review_with_fallback(:271)` 抛出的 RuntimeError 会被上游捕获并**降级为 quarantine(fail-closed)**,`generation_service.py:966-971` 随后把该图标记 `quarantined=True` / `gallery_visibility="restricted"` 并放进 `restricted_images`,绝不会当作放行。发现里"上层若把审核不可用当放行即静默绕过"的假设在本仓库不成立。
|
|||
|
|
|
|||
|
|
更关键的是,如果按发现建议补上 modality 与 provider_type 前置校验,`_structured_vision_callable_for_single_route` 会返回 None → `structured_vision_callable` 返回 None → `node_routes.py:345-348` 得到 `image_moderation_callable = None` → `ImageModerationService.reviewer is None` → 走 `{"status": "not_configured", "action": "allow"}`,**全部图片直接放行**。即:现状的宽松解析是 fail-closed,而所谓的"修复"才会制造真正的审核静默绕过。安全论证被写反了。
|
|||
|
|
|
|||
|
|
三、可达性也被高估。`config.yaml:120-122` 中 `prompt_governance.image_moderation.enabled: false`、`model_route: ""`,`node_routes.py:344-348` 对空路由直接不构造 callable,功能默认关闭。要触发 modality 串号,还必须管理员在 `image_generation` 和 `vision_recognition` 两个 modality 下配置**同名**路由(bootstrap 的 `_config_route_id` 以 modality 为前缀,同名跨模态是被设计允许的),此时 `model_provider_repository.py:266` 的 `ORDER BY route.priority ASC, route.route_id ASC` 在优先级相同时会让 `route_config_image_generation_*` 胜出。要触发 provider_type 问题,还需管理员在设置页把适配器类型选成"自定义 HTTP"(SettingsPage.vue 的 select 仅 openai_compatible / custom),而 custom 适配器在 `_image_provider_from_resolved(:79-80)` 里本来就返回 None、连生图都不可用。两个前提都是明确的管理员误配。
|
|||
|
|
|
|||
|
|
四、真实残余影响只有一条:上述误配下每张图会被误判为 quarantine(可用性问题),且图片 metadata 里会留下 `image_moderation.status = "review_failed"`,可诊断、可回溯,既不泄密也不绕过安全。综上:定位属实、影响与严重度判定错误,按"安全审核绕过"定级不成立,最多算 P3 级的一致性/健壮性小瑕疵,且修复时必须同时处理"reviewer 为 None 即放行"的语义,否则会引入比原问题更严重的缺陷。
|
|||
|
|
|
|||
|
|
### 推翻 #6
|
|||
|
|
- **定位**:`database/db_helper.py:159-171`
|
|||
|
|
- **复核意见**:代码事实属实但影响链条不成立,按描述的缺陷判为误报。\n\n1) 事实核对通过:database/db_helper.py:159-171 与证据片段逐字一致,`conn = sqlite3.connect(db_path, timeout=30.0)` 后只有 `PRAGMA foreign_keys = ON` 和 `PRAGMA busy_timeout = 30000`;全仓库 backend/core/database/tests 内 grep `journal_mode` 零命中,确实未启用 WAL。BEGIN IMMEDIATE 的两处行号(workflow_round_repository.py:313、:815)也对得上。\n\n2) SQLite 锁语义被说错。rollback journal 模式下 BEGIN IMMEDIATE 只拿 RESERVED 锁,RESERVED 不阻塞读者(读者继续持 SHARED 读原始 db 文件,写者脏页在 page cache/journal 中),只有 commit 瞬间升级 PENDING/EXCLUSIVE 才短暂挡读。"写事务持有 RESERVED/EXCLUSIVE 锁会阻塞全库所有读"不成立。\n\n3) 所谓"长事务"里没有任何慢 I/O。通读 confirm_candidate_atomic(database/repositories/workflow_round_repository.py:801-1131)全文,事务内只有本地 SELECT/UPDATE/INSERT(如 `UPDATE workflow_round_candidate_pool SET is_final = 0 ... WHERE round_id = ?`、`INSERT INTO workflow_history (...)`),配合 `datetime.now(timezone.utc)`、`uuid4()`、json 序列化,没有 provider 调用/网络/文件 I/O;get_consistent_round_snapshot(:300-354)是 3 条 SELECT 后立即 `conn.commit()`。事务寿命毫秒级,与 30s busy_timeout 相差约 4 个数量级,"provider 调用稍慢就 30s 超时"无代码依据。\n\n4) 声称的并发场景是虚构的。grep 全仓库,confirm_candidate_atomic 唯一调用方是 backend/services/workflow_round_service.py:694(用户确认候选的 API),get_consistent_round_snapshot 唯一调用方是 :473 create_next_round,二者均为交互式单用户动作;而 chat_workflow_service.py:216 的 4 线程提交的是 `executor.submit(self.generate_node, str(node["node_id"]), chat)` → `nodes/{id}/generate` 链路,根本不会进入 confirm_candidate_atomic。"任一线程进入 confirm_candidate_atomic 阻塞其余 3 线程"不可能发生。\n\n5) except 引用不准且不相关。真实位置是 generation_service.py:1865-1866 与 1887-1888(:1890 是 `"generation.node_failed"` 事件名,不是 except),且两处都在 `_record_generation_failure` 内,仅在生成已失败后的失败记录路径执行,不覆盖正常写入路径。\n\n6) 另佐证:image_repository.create 等均为 connect→execute→commit→close 的短连接模式(database/repositories/image_repository.py:44-48),generation_service 自身不持有 connection 跨越 provider 调用;仓库内无任何 `database is locked`/OperationalError 处理或文档记录,无该问题实际发生的痕迹。\n\n结论:开启 WAL 仍是合理的低优先级调优(提升并发读写吞吐、减少 fsync),但不构成所描述的"生成静默失败"级缺陷,故降级为 P3 并判定该发现站不住脚。
|
|||
|
|
|
|||
|
|
### 推翻 #7
|
|||
|
|
- **定位**:`backend/services/generation_service.py:1869-1886(残留的弱化问题:check-then-act 未用 update_node_if_status)`
|
|||
|
|
- **复核意见**:代码片段本身不是幻觉,但这条发现的**因果链和影响是编造的**,且完全漏掉了服务层已有的合并守卫。
|
|||
|
|
|
|||
|
|
**1. 代码确实存在(唯一成立的部分)**
|
|||
|
|
`database/repositories/workflow_repository.py:298-318` 的 `update_node` 和 `:154-178` 的 `update_workflow` 确实是整列覆盖 `metadata_json = ?`,无 merge/版本号。行号对得上。
|
|||
|
|
|
|||
|
|
**2. 声称的影响路径在类型上不可达 —— 这是决定性的反驳**
|
|||
|
|
发现称"`generation_service._prepare_quick_character` 用旧快照 `update_workflow`,把 `confirm_candidate_atomic` 写的 `stage_inputs` 抹掉"。但这两条路径永远不会碰同一行工作流:
|
|||
|
|
|
|||
|
|
`backend/services/generation_service.py:612` 只有 `is_quick_character_node(workflow, node)` 为真才进入 `_prepare_quick_character_context`,而 `backend/services/quick_character_consistency.py:49-53`:
|
|||
|
|
```python
|
|||
|
|
def is_quick_character_node(workflow: Any, node: Any) -> bool:
|
|||
|
|
return (
|
|||
|
|
str(getattr(workflow, "workflow_type", "") or "").strip() == "character_fast"
|
|||
|
|
and str(getattr(node, "node_key", "") or "").strip() in QUICK_CHARACTER_TARGETS
|
|||
|
|
)
|
|||
|
|
```
|
|||
|
|
即该路径**只作用于 `character_fast`**。而回合/候选确认体系(`stage_inputs`/`branch_state`/`character_execution` 的写入者)在 `backend/services/workflow_round_service.py:1130` 与 `:147` 被硬性拒绝非渐进类型:
|
|||
|
|
```python
|
|||
|
|
if workflow.workflow_type != "character_gradual":
|
|||
|
|
raise ApiError(..., {"workflow_id": workflow.workflow_id, "workflow_type": workflow.workflow_type})
|
|||
|
|
```
|
|||
|
|
`character_fast` 工作流根本不存在 `stage_inputs`,"确认了候选图但下一节点拿不到上游图"的症状无法由此产生。
|
|||
|
|
|
|||
|
|
**3. "用更早读到的快照"这句是事实错误**
|
|||
|
|
`generation_service.py:1145-1149` 恰恰是在锁内**重新读取**,紧接着 :1246 写回,中间没有跨请求的陈旧快照:
|
|||
|
|
```python
|
|||
|
|
lock_entry.lock.acquire()
|
|||
|
|
try:
|
|||
|
|
current_workflow = self.workflow_service.get_workflow(workflow.workflow_id).workflow
|
|||
|
|
metadata = dict(current_workflow.metadata or {})
|
|||
|
|
```
|
|||
|
|
而且 :1246 的 `update_workflow` 只在 `else`(尚未 managed,即批次首次初始化)分支执行,二次进入走 `managed` 分支根本不写。
|
|||
|
|
|
|||
|
|
**4. 服务层存在被完全忽略的合并守卫**
|
|||
|
|
`backend/services/workflow_service.py:234` 先 `before = self.get_workflow(workflow_id).workflow`,随后 `:268-275` 强制走 `_normalize_workflow_metadata`。该函数 `:1027-1031` 与 `:1058-1068`:
|
|||
|
|
```python
|
|||
|
|
if workflow.workflow_type == "character_gradual" and not allow_character_execution_update:
|
|||
|
|
if "character_execution" in current_metadata:
|
|||
|
|
normalized["character_execution"] = current_metadata["character_execution"]
|
|||
|
|
...
|
|||
|
|
if workflow.workflow_type == "character_gradual":
|
|||
|
|
if isinstance(current_metadata.get("branch_state"), dict):
|
|||
|
|
# Clients edit only the active projection. Sibling branch
|
|||
|
|
# snapshots are server-owned and must survive stale PUTs.
|
|||
|
|
normalized["branch_state"] = current_metadata["branch_state"]
|
|||
|
|
```
|
|||
|
|
也就是说,发现点名的 `branch_state / character_execution / completed_node_ids` 恰恰是**从新鲜读取的 `before` 强制回填**的,调用方传入的整包 metadata 覆盖不掉它们。仓储层的"整列覆盖"在这几个键上已被服务层消解。
|
|||
|
|
|
|||
|
|
**5. 写入方本身是原子的,且仓储已提供 CAS 变体**
|
|||
|
|
`workflow_round_repository.py:812-818` 的 `confirm_candidate_atomic` 用 `BEGIN IMMEDIATE`(sqlite)/ `FOR UPDATE`(postgresql)在同一事务内读 + 写 `:1112-1120`,本身无丢更新。仓储也已经有 CAS 版本 `update_workflow_if_status`(`workflow_repository.py:180-231`,`cursor.rowcount` 判定)和 `update_node_if_status`(`:324` 起),并非"只靠进程内锁"。
|
|||
|
|
|
|||
|
|
**残留的、被大幅夸大后剩下的真实点**
|
|||
|
|
`generation_service.py:1869-1886` 的失败回写确实是 check-then-act 却用了普通 `update_node` 而非同文件仓储已有的 `update_node_if_status`,理论上存在窗口。但:它包在 `try/except Exception: pass` 内(:1868/:1887),守卫条件为 `last_task_id == task.task_id and node.status in {"queued","running"}`,最坏后果只是某个节点的 `generation_failure` 诊断字段被覆盖,不会破坏工作流状态机。这最多是 P3 的一致性收尾建议,与原发现"工作流状态机真身被抹掉 / 下一节点拿不到上游图"的 P0/P1 级描述完全不是一回事。
|
|||
|
|
|
|||
|
|
结论:标题所述的"丢更新导致确认后拿不到上游图"站不住脚,判定误报。
|
|||
|
|
|
|||
|
|
### 推翻 #8
|
|||
|
|
- **定位**:`frontend/standalone-web/src/App.vue:6126`
|
|||
|
|
- **复核意见**:代码确实存在(App.vue:6126 的 `const instructions` 表、character_workflow_service.py:280 的 `fast = {`,行号完全对得上,非幻觉)。但该发现的**核心影响与一半前提都不成立**,判为误报,仅残留一个 P3 级 DRY 小问题。
|
|||
|
|
|
|||
|
|
**1)「前端把 _FIELD_ALIASES 重抄一遍」——事实错误。**
|
|||
|
|
前端 `quickCharacterIdentityFields()`(App.vue:6100)产出的是**原始字段值**,键名恰好是后端别名表能识别的别名,并作为 `identity_fields` 随 payload/metadata 上传。这正是后端**明文定义的输入契约**,`build_identity_lock()`(quick_character_consistency.py:56-68)把它们列为显式数据源:
|
|||
|
|
```python
|
|||
|
|
sources = [
|
|||
|
|
_record(profile_metadata.get("questionnaire")),
|
|||
|
|
_record(profile_metadata.get("identity_fields")),
|
|||
|
|
profile_metadata,
|
|||
|
|
_record(request_metadata.get("identity_fields")),
|
|||
|
|
_record(payload.get("identity_fields")),
|
|||
|
|
_lock_fields(payload.get("identity_lock")),
|
|||
|
|
]
|
|||
|
|
```
|
|||
|
|
别名归一、`_normalize_gender`/`_normalize_age_group`、缺省推断、canonical 字段集、锁文案与 `identity_lock_hash` **全部仍在后端**。前端没有复制任何一张别名表。
|
|||
|
|
|
|||
|
|
**2)「身份锁在前端拼、四联图一致性不可复现」——直接被推翻。**
|
|||
|
|
generation_service.py:691 对**每个** quick-character 节点无条件套用服务端身份锁,代码注释明写此意图:
|
|||
|
|
```python
|
|||
|
|
# Direct mode intentionally bypasses LLM rewriting, but it must
|
|||
|
|
# never bypass the immutable server-owned character identity lock.
|
|||
|
|
prompt_expansion = _locked_quick_character_prompt_expansion(...)
|
|||
|
|
```
|
|||
|
|
其内部 `append_identity_lock(base_prompt, quick_context["identity_lock"])`,而锁文案(`_identity_prompt`,:180-190)是:
|
|||
|
|
```
|
|||
|
|
MANDATORY CHARACTER IDENTITY LOCK; depict the same individual in every image in this quick-character batch; do not change gender presentation, apparent age, species, ancestry, skin tone, facial identity, hair, eyes, body build, distinctive features, or core outfit
|
|||
|
|
```
|
|||
|
|
前端 quick_avatar 少写的「keep identity consistent」这几个词,被这条强度高出一个数量级的强制锁**完全覆盖**。且 `identity_lock_hash()` 对 canonical JSON 做 sha256,一致性是**确定性可复现**的——恰恰与「不可复现」的断言相反。
|
|||
|
|
|
|||
|
|
**3)「prompt 治理会被前端拼串绕过」——错误。**
|
|||
|
|
`_govern_prompt()`(:1456)显式读取前端串:`original = _optional_text(payload.get("user_prompt") or payload.get("prompt") or payload.get("prompt_patch")) or ...`,随后审核(moderation)、路由裁决、`route.allowed` 为假时抛 `VALIDATION_FAILED` 阻断,**全部照常作用于前端串**。`prompt_processing_mode:"direct"` 只跳过 LLM 翻译/改写,而这是任何调用方都能传的显式开关,与本条「指令表重抄」无因果关系。
|
|||
|
|
|
|||
|
|
**4)「前端触发 vs 后端自身触发产生不同提示词」——缺乏第二条路径。**
|
|||
|
|
`_step_instruction()` 只被 `_node_prompt()` 调用,而 `_node_prompt()` 仅在 `_execute_sequenced`/`_execute_unsequenced`(:123、:201)中用于**准备 node.prompt**,并不存在一条为 quick 四联图独立出图的后端路径。且在非 direct 模式下,`prompt_expansion_service.merge_prompt_sections` 同时并入 `{"parts": [node.prompt]}` 与 `_payload_parts(payload)`(含 prompt_patch),后端指令是**叠加而非被替换**。
|
|||
|
|
|
|||
|
|
**结论**:真实残留问题仅为「4 条短指令字符串在前后端各写一份、措辞已漂移」的可维护性瑕疵,属 P3-轻微。所声称的身份一致性失效、治理被绕过、行为不可复现均不成立。
|
|||
|
|
|
|||
|
|
### 推翻 #9
|
|||
|
|
- **定位**:`backend/services/workflow_round_service.py:1544 (调用点 163);core/astrbot_provider_bridge.py:344 (调用点 278);backend/services/advanced_style_set_service.py:4288 (调用点 1537)`
|
|||
|
|
- **复核意见**:代码片段本身抄写无误、行号对得上,但"18 次"和三条声称的影响全部站不住脚。
|
|||
|
|
|
|||
|
|
(1)计数错误:真实源码树 `grep -rn "def _string_list" --include=*.py backend core engines` 只有 17 处;多出来的是 `.tmp/deploy-1.0.35/`、`.tmp/deploy-clean-1.0.36/` 等构建产物快照里的重复文件,不是源码。
|
|||
|
|
|
|||
|
|
(2)"把逗号分隔的 tags 传给 workflow_round_service 版本会得到空列表"——该调用路径不存在。workflow_round_service.py 全文只有一处调用:
|
|||
|
|
source_candidate_ids = _string_list(payload.get("source_candidate_ids"))[:3] # 第 163 行
|
|||
|
|
处理的是内部 payload 里的候选 ID JSON 数组,用于 optimization_source_candidate_ids / source_candidate_id,tags 永不经过此处。同理 prompt_expansion_service.py:257 全文只用于第 109 行的 selected_draft_image_ids;generation_service.py:2417 只用于 1462 行 locked_terms 和 2250 行 reference_image_uris——均无逗号字符串来源。
|
|||
|
|
|
|||
|
|
(3)"prompt 片段顺序在 advanced_style_set_service 与 astrbot_provider_bridge 之间不可预测"——两者不处理同一个值。bridge 唯一调用是 `tags=_string_list(payload.get("tags"))`(第 278 行,视觉 provider 的 JSON);advanced_style_set 的调用全部是 representative_source_ids / comparison_source_ids / 反馈计划的 increase|decrease|remove|preserve / 自己那份 tags。prompt_parts 这个字段根本不经过任何一个 _string_list。
|
|||
|
|
|
|||
|
|
(4)不存在"跨 service 流转":`grep "import _string_list|from ... import ..._string_list"` 零结果,17 个实现全部是下划线私有、无一被跨模块导入。每个调用点都是在本模块自己的信任边界上对刚解析的 dict 做一次本地归一化,而非接力传递已归一化列表,因此不同实现之间不会互相污染。
|
|||
|
|
|
|||
|
|
(5)唯一真实的不一致:VisionRecognitionResult.tags 有三个构造点——engines/vision_provider.py:357(sorted)、core/astrbot_provider_bridge.py:278(sorted)、advanced_style_set_service.py:1537(dict.fromkeys 保序)。三者中两者一致,第三者顺序不同。但下游消费(material_service.py:472 generated_tags、advanced_style_set_service.py:1765 "tags": recognition.tags 等)只把 tags 当元数据集合存储/展示,无任何依赖顺序的逻辑,影响是装饰性的。
|
|||
|
|
|
|||
|
|
综上:DRY 违规客观存在、值得统一收敛,但数据损坏 / 静默空列表 / 顺序不可预测三条影响均无可达路径,P1 定级被严重夸大,实际为 P3 可维护性异味。
|
|||
|
|
|
|||
|
|
### 推翻 #10
|
|||
|
|
- **定位**:`tests/(测试目录整体),非 backend/route_registry.py:1`
|
|||
|
|
- **复核意见**:【结论:误报 / 不成立】原始统计数字能复现,但定位、证据与影响描述三处均不成立。
|
|||
|
|
|
|||
|
|
一、定位是伪造的。`backend/route_registry.py:1` 是文件 docstring `"""Route registry manifest for AstrBot Web API mounting."""`。整个文件(377 行)是一张纯声明式的 RouteSpec 清单加 `route_manifest()` / `assert_unique_routes()` / `assert_known_permissions()` 三个工具函数,代码本身没有任何缺陷。所谓"缺陷"是 `tests/` 目录的属性,不是这个文件的属性。把测试债挂到一个正确无误的清单文件第 1 行,不构成一条代码缺陷。
|
|||
|
|
|
|||
|
|
二、最有杀伤力的那条证据是事实错误。发现称 storage_routes 是"签名 URL / 文件下发,直接决定前端不能看到本地绝对路径这条安全约束"。实读 `backend/routes/storage_routes.py`,全文只有两个 handler:`get_storage_status` 和 `migrate_storage`;registry 里也只挂了两条(route_registry.py:167-168):
|
|||
|
|
```
|
|||
|
|
RouteSpec("GET", "storage/status", "...storage_routes.get_storage_status", "read"),
|
|||
|
|
RouteSpec("POST", "storage/migrate", "...storage_routes.migrate_storage", "config"),
|
|||
|
|
```
|
|||
|
|
它既不下发文件也不签 URL。签名与取流在 media_routes(route_registry.py:169-173,`media/sign`、`media/fetch`),是另一个模块。旗舰级安全论据属于臆造。
|
|||
|
|
|
|||
|
|
三、"路由层的参数校验与权限装饰完全裸奔"是假的。所有被点名的"高危未测模块"每个 handler 首行都显式调了 `core.security` 的守卫:
|
|||
|
|
- round_routes.py:33/55/71/88/108/128 → `require_authenticated(ctx)` / `require_write(ctx)`
|
|||
|
|
- data_backup_routes.py:11/15/23/27 → 四个 handler 全部 `require_config_manager(ctx)`
|
|||
|
|
- settings_routes.py:23/36 `require_authenticated`,50/64/78/91/104/118/133/147/161 共 9 处 `require_config_manager`
|
|||
|
|
- integration_routes.py:32/47 `require_authenticated`,63/77 `require_config_manager`
|
|||
|
|
- media_routes.py:26/68/86/107 `require_authenticated`
|
|||
|
|
core/security.py:17-24 的 `require_permission` 会先 `require_authenticated` 再校验 `ctx.has_permission(permission)`,不通过直接抛 `ApiError(FORBIDDEN)`。守卫齐整存在,谈不上"裸奔"。storage_routes 自身同样有 `require_authenticated` / `require_config_manager`。
|
|||
|
|
|
|||
|
|
四、度量方法系统性低估。用 endpoint 字面量全文 grep 会漏掉直接 import handler 的测试。我实测:endpoint 字面量命中 33,而 handler 函数名命中 50,模块名命中 8(非 7)。实证例子:tests/test_character_workflow_progression.py:6 `from backend.routes.node_routes import generate_node, retry_node`;tests/test_generation_node_completion_guard.py:6 导入 `mark_node_completed`;tests/test_profile_delete_route.py:12 走 adapter 的 `resolve_route` 断言 `handler_path == "backend.routes.profile_routes.delete_profile_via_post"`;tests/test_profile_card_finalize.py:290 与 test_workflow_generation_cross_review.py:9 直接对 ROUTES 做清单断言。19.9% 是下界而非真实覆盖率,要给结论必须跑 coverage.py。
|
|||
|
|
|
|||
|
|
五、严重度严重夸大。这是一条测试债观察,不是缺陷:没有指出任何真实 bug、不可达守卫或权限漏洞,当前行为没有任何一处是错的。它描述的是"未来重构可能没人拦"的假设性风险。真要保留,合理形态是一条 P3 改进建议(例如补一个遍历 ROUTES、断言每个 handler 源码内出现 require_* 的元测试),而非现在这条带伪造定位和伪造安全论据的发现。
|
|||
|
|
|
|||
|
|
### 推翻 #11
|
|||
|
|
- **定位**:`INSTALL.md(发布包白名单/最小运行时清单)+ frontend/standalone-web/vite.config.ts:12`
|
|||
|
|
- **复核意见**:代码引用属实但结论站不住脚,判定为误报(最多是 P3 流程 nit)。
|
|||
|
|
|
|||
|
|
一、引用的代码确实存在,行号完全对得上:
|
|||
|
|
- `frontend/standalone-web/vite.config.ts:11-15`:`base: "/api/v1/plugins/extensions/astrbot_plugin_imagestudio/web/"` / `outDir: resolve(rootDir, "../../web")` / `emptyOutDir: true`
|
|||
|
|
- `frontend/plugin-page/vite.config.ts:11-15`:`base: "./"` / `outDir: resolve(rootDir, "../../pages/imagestudio")`
|
|||
|
|
- `backend/services/web_hosting_service.py:14-15`、`manifest()` 只判断 `(dir/"index.html").exists()`
|
|||
|
|
- `.gitignore:16` 只有 `frontend/**/dist/`
|
|||
|
|
- `git ls-files web/ pages/` = 38 个文件,`git log -- web/assets` = 80 次提交
|
|||
|
|
以上事实核对无误,不是幻觉。
|
|||
|
|
|
|||
|
|
二、致命反驳:这两个目录不是"误提交的编译产物",而是**被文档明确定义的发布负载**,必须入库。
|
|||
|
|
`INSTALL.md` 的"最小运行时清单"把 `pages/imagestudio/` 和 `web/` 与 `main.py`、`metadata.yaml` 并列列为安装后必需内容;"发布包白名单"章节要求正式 ZIP 归档 `pages/` 和 `web/`。ImageStudio 是 AstrBot 插件(`metadata.yaml: astrbot_version: ">=4.25.0,<5"`),装机路径是把仓库/ZIP 铺到 `data/plugins/astrbot_plugin_imagestudio/`,**安装期没有任何 npm/vite 步骤**。若按发现的建议把 `web/` `pages/` 加进 .gitignore,`WebHostingService._resolve` 会直接抛 `ErrorCode.RESOURCE_NOT_FOUND, "web asset not built"`,插件页面全线不可用。.gitignore 忽略 `frontend/**/dist/`(中间产物)而保留这两个目录,恰恰是正确的区分,不是遗漏。
|
|||
|
|
|
|||
|
|
三、"两份重复 dist"这一核心指控不成立。两份构建的 `base` 不同且必须不同:`web/index.html` 里是绝对路径 `src="/api/v1/plugins/extensions/astrbot_plugin_imagestudio/web/assets/index-CvjPX4dT.js"`,`pages/imagestudio/index.html` 里是相对路径 `src="./assets/index-Dp4kkpJ0.js"`。两者挂载于不同 URL 根(`PLUGIN_PAGE_URL = "/plugin/imagestudio"` vs `STANDALONE_WEB_URL = "/api/v1/..."`),一份产物物理上无法同时服务两个挂载点。`plugin-page/src/App.vue` 复用 `standalone-web/src/App.vue` 正是为避免真正的重复。`DEVELOPMENT.md:57` 与 `INSTALL.md` 都说明了两者定位(`pages/imagestudio/` 是正式插件页,`web/` 是兼容产物)。
|
|||
|
|
|
|||
|
|
四、"必须构建两次、漏一次"的风险已有机制消解:`frontend/package.json` 提供 `"build": "npm run build:plugin && npm run build:web"`,`INSTALL.md:223-224` 与 `DEVELOPMENT.md:72-73` 的验证清单都要求两条一起跑。
|
|||
|
|
|
|||
|
|
五、影响被显著夸大,实测数据不支持"2MB 噪音淹没 diff":
|
|||
|
|
最近 5 次 dist 提交的实际 stat 为 `24 files changed, 59 insertions(+), 69 deletions(-)`(878f1f6)、`24 files changed, 37 insertions(+), 27 deletions(-)`(2dbf90b)。git 的重命名检测把内容哈希改名识别成 `web/assets/{index-CumvEEtc.js => index-CvjPX4dT.js}`,压缩产物是单行文件,因此每次只有几十行 diff,不是 2MB。
|
|||
|
|
"git 累积大量永不复用的 blob"归因也错了:`git count-objects -vH` 显示 size-pack 44.03 MiB,而 `git ls-files release/` 有 20 个 ZIP、仅当前树就占 37.0 MiB——仓库体积的主因是被跟踪的 release 包,不是 web/assets。
|
|||
|
|
|
|||
|
|
六、残余的真实问题很小:确实没有 CI 校验产物新鲜度(仓库根本没有 `.github/workflows`),历史上有 24 次只更新 `web/assets`、3 次只更新 `pages/imagestudio/assets` 的提交。但 `manifest()` 从未声称做版本一致性校验,它只是"是否已构建"的状态位;`_resolve` 另有 `candidate != root and root not in candidate.parents` 的路径逃逸防护,功能上没有可达缺陷。把 `fix: recover material library after stale asset token`(3edec9a)当作双 dist 错位的症状也属牵强——该提交同时改了 `frontend/standalone-web/src/App.vue`、`AdvancedMaterialImportPage.vue` 与两个 assets 目录,是源码修复带构建,不是漏构建导致的错位。
|
|||
|
|
|
|||
|
|
综上:代码引用真实,但"不该提交产物"的前提与文档化的发布模型直接冲突,"两份重复"是必需的双挂载,量化影响与实测相差一个数量级。判定 refuted=true;若保留,只能降为 P3(建议增加构建新鲜度校验脚本),且位置应落在 INSTALL.md/发布流程而非 vite.config.ts:12。
|
|||
|
|
|
|||
|
|
### 推翻 #12
|
|||
|
|
- **定位**:`frontend/standalone-web/src/App.vue:4575-4582;backend/services/event_stream_service.py:22-32`
|
|||
|
|
- **复核意见**:代码事实部分属实(行号对得上),但**因果链在关键一步断裂,声称的影响不成立**,判定为误报。
|
|||
|
|
|
|||
|
|
一、代码确实存在,无幻觉
|
|||
|
|
`backend/services/event_stream_service.py:22-32` 确实只有 `event_type`/`limit`,没有 `after_event_id`:
|
|||
|
|
```python
|
|||
|
|
def recent_events(self, *, event_type: str | None = None, limit: int = 50) -> dict[str, Any]:
|
|||
|
|
events = self.event_bus.history(event_type)
|
|||
|
|
normalized_limit = _limit(limit)
|
|||
|
|
selected = events[-normalized_limit:]
|
|||
|
|
```
|
|||
|
|
`App.vue:4575-4577` 也确实是那段 `slice(previousIndex >= 0 ? previousIndex + 1 : -1)`。
|
|||
|
|
|
|||
|
|
二、决定性反驳:全仓库事件类型只有 `generation.` / `workflow.` 两个前缀,OR 判定不可能因丢事件而翻假
|
|||
|
|
我把 `backend/services/` 下所有 `_publish(` / `event_bus.publish(` 的首参字面量全量抽取,共 17 个,**无一例外**:
|
|||
|
|
`generation.node_cancelled / node_completed / node_failed / node_queued / node_running / task_created / task_deleted / task_status_changed / task_updated`、`workflow.branch_created / created / node_created / node_material_bindings_updated / node_status_changed / status_changed / updated / node_updated`(含 `workflow_node_material_service.py:209`、`generation_job_retry_service.py:269,278`、`generation_service.py:1417,1426` 这些间接发布点)。
|
|||
|
|
|
|||
|
|
而判定逻辑是 `.some()` 的 OR 归约:
|
|||
|
|
```js
|
|||
|
|
const generationChanged = eventTypes.some((t) => t.startsWith("generation."))
|
|||
|
|
const workflowChanged = eventTypes.some((t) => t.startsWith("workflow."))
|
|||
|
|
```
|
|||
|
|
既然总线上**每一条**事件都满足这两个谓词之一,那么退化到 `slice(-1)` 只留 1 条时,`generationChanged || workflowChanged` **恒为 true**。发现里"eventTypes 只有一个元素 → 基于 1/20 样本判定 → 该刷的不刷"是错的:把 20 条样本砍到 1 条,无法把一个所有候选都为真的 OR 归约翻成假。生成爆发期最后一条几乎必然是 `generation.task_updated`/`task_status_changed`,`generationChanged` 为真,`loadJobs()`/`loadDashboard()` 照常触发。
|
|||
|
|
|
|||
|
|
三、刷新是全量重取而非增量应用,丢中间事件不产生状态失配
|
|||
|
|
`loadJobs()` / `loadDashboard()` / `loadWorkflowRoundDetail()` 都是重新 GET 全量状态,事件只当"触发器"用。因此丢掉 19 条冗余触发器不会让 UI 停在旧状态——只要有 1 条触发,取回的就是最新完整状态。
|
|||
|
|
|
|||
|
|
四、workflow 轮次面板另有一条与事件流完全无关的 4 秒自续轮询,直接推翻"生成完了界面不动的结构性来源"
|
|||
|
|
`App.vue:6999-7008`:
|
|||
|
|
```js
|
|||
|
|
function scheduleWorkflowRoundPolling(detail = selectedWorkflowRound.value) {
|
|||
|
|
stopWorkflowRoundPolling()
|
|||
|
|
if (!detail || !workflowRoundIsActive(detail.round.status) || document.hidden) return
|
|||
|
|
workflowRoundPollTimer = window.setTimeout(() => { ... void loadWorkflowRoundDetail(roundId, true) }, 4000)
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
它在轮次入队时就被武装(`App.vue:8538`,紧跟 `已加入生成队列` 分支),并在每次 `loadWorkflowRoundDetail` 成功后自续(`App.vue:7017`),轮次一旦不再 active 才停。另有 `reconnectBackendWhenVisible()`(`App.vue:4471-4477`)在页面重新可见时强制刷新活动轮次。即使事件流一条都不处理,轮次面板也是 4 秒一刷。
|
|||
|
|
|
|||
|
|
五、爆发结束后必然自愈
|
|||
|
|
`lastEventStreamId` 每轮都推进到 `newest`;爆发一停,下一次 5 秒轮询窗口内新增 <20 条,`findIndex` 就能命中锚点,恢复精确增量。不存在"直到用户手动刷新"的持久卡死。
|
|||
|
|
|
|||
|
|
六、"窗口太小"也不是接口设计缺陷
|
|||
|
|
`_limit` 上限是 200(`min(max(limit,1),200)`),总线 `EventBus(history_limit=500)`。前端自己传的 `{ limit: 20 }`,要扩窗口改一个数字即可,不需要引入游标。
|
|||
|
|
|
|||
|
|
七、真正站得住的只有边角问题
|
|||
|
|
(1) 接口确实无游标;(2) `body`/`content_type` 预渲染的 SSE 文本被前端丢弃,属白费序列化——但每 5 秒 20 条小 payload,量级可忽略;(3) `slice(..., -1)` 这个魔数兜底写法确实不优雅,应改成 `previousIndex >= 0 ? slice(previousIndex+1) : slice()`(退化时取全窗口而非 1 条)。这些合计至多 P3 代码质量,与原发现声称的"事件静默丢失 → UI 停滞的结构性来源"不是一回事。
|
|||
|
|
|
|||
|
|
### 推翻 #13
|
|||
|
|
- **定位**:`frontend/standalone-web/src/App.vue:3073-3077 / 3136-3140(仅为文案/tone 层面的一致性问题)`
|
|||
|
|
- **复核意见**:代码本身不是幻觉,但"声称的影响"链条站不住脚,判为误报。
|
|||
|
|
|
|||
|
|
一、引用的代码确实存在,行号对得上:
|
|||
|
|
- backend/route_registry.py:22-27 确为 `"retry": {... "required_permission": "can_retry_tasks", "required_permissions": ["can_write", "can_retry_tasks"] ...}`;
|
|||
|
|
- core/security.py:31-33 确为 `def require_task_retry(ctx): require_write(ctx); require_permission(ctx, "can_retry_tasks")`;
|
|||
|
|
- App.vue:2786 `const canRetry = Boolean(permissions?.can_retry_tasks)`,3076 与 3139 两处 retry 卡片确实只判 `canRetry && !selectedNodeWriteLocked && !workflowNodeActionExecuting`;3372-3373 队列面板确实是 `canManageQueue = canWrite && canRetry`。
|
|||
|
|
|
|||
|
|
二、但前提条件在本仓库中不可产生(不可达)。全仓 RequestContext 的构造只有三处非测试路径,没有任何一处能产出"有 can_retry_tasks 而无 can_write"的组合:
|
|||
|
|
- main.py:104-106 与 2337:`BRIDGE_PERMISSIONS = frozenset({"can_write", "can_manage_config", "can_manage_materials", "can_retry_tasks"})`,`permissions = BRIDGE_PERMISSIONS if username or user_id else frozenset()` —— 要么四个全给,要么一个不给。全不给时 `canRetry` 为 false,卡片就显示"无权限"且 disabled,正是期望行为;
|
|||
|
|
- backend/services/chat_workflow_service.py:1160 `permissions={"can_write", "can_retry_tasks", "can_manage_materials"}` —— 同样含 can_write;
|
|||
|
|
- backend/services/chat_command_guard_service.py:42 `permissions=set()` —— 空集。
|
|||
|
|
bootstrap 的权限来源 backend/services/ui_service.py:24-29 只是逐项透传 `ctx.has_permission(...)`,不会额外派生。也就是说"持有 can_retry_tasks 但无 can_write 的账号"在当前代码里根本造不出来。
|
|||
|
|
|
|||
|
|
三、即便假设该组合存在,点击路径也有上游守卫,"一律被 require_write 拒为 FORBIDDEN"的描述是错的。App.vue:8092-8094 的 workflowNodeRetry 走 `runSelectedWorkflowNodeGeneration({ retry: true })`,而该函数 8560 行第一件事就是:
|
|||
|
|
const blocked = backendWriteBlockMessage(options.retry ? "节点重跑" : "节点生成")
|
|||
|
|
if (blocked) { workflowNodeActionError.value = blocked; return false }
|
|||
|
|
而 backendWriteBlockMessage(4376-4387)里明确含 `if (!bootstrap.value?.permissions.can_write) return \`${action}需要后端写入权限。\``。所以无 can_write 时前端本地就拦下,根本不会发出 nodes/{id}/retry 或 nodes/{id}/generate 请求,也就没有所谓的 FORBIDDEN 回包。发现描述的核心危害链在此断裂。
|
|||
|
|
(唯一未被该守卫覆盖的是 8559 行 `if (isSelectedWorkflowRoundNode.value) return submitSelectedWorkflowRound(options)` 的提前分支,submitSelectedWorkflowRound(8462-)只判 workflowLockedNodeWriteMessage 而不判 can_write;但它打的是 rounds 接口,route_registry.py:92/95 标注为 "write" 而非 "retry",与本条发现主张的 retry 复合权限无关,且同样受前述"权限不可分离"约束。)
|
|||
|
|
|
|||
|
|
四、严重度被夸大。真正剩下的只是 UI 文案层面的不一致:3073-3074 用 `canRetry ? "可重试" : "无权限"` 作 state/tone,理论上会在一个当前造不出的权限组合下显示乐观文案,按钮点下去也只会得到一句本地提示。另外 App.vue:3818-3821 也是同样的 canRetry-only 写法,说明这是节点级卡片的一贯写法(节点级操作的写权限统一由 backendWriteBlockMessage 兜底),而 3373 队列面板加 canWrite 是因为队列卡片直接调接口、没有同样的兜底函数——这是两类不同上下文,不能据此推断"遗漏"。无安全影响,无越权,无功能故障,最多是 P3 的文案精确性问题。
|
|||
|
|
|
|||
|
|
### 推翻 #14
|
|||
|
|
- **定位**:`frontend/standalone-web/src/features/workflow/workflow-model-route.ts:36-88(代码属实,但所述影响不可达)`
|
|||
|
|
- **复核意见**:代码位置属实(前端 36-48 的候选链、59-88 的 assignment 映射,后端 generation_service.py:169-176 / 617-624 / 2022-2045 全部对得上,不是幻觉),但三条"不一致"的结论逐条站不住脚,核心影响不可达。
|
|||
|
|
|
|||
|
|
【1. "前端多了 round 层" —— 错误,backend 确实有这一层】
|
|||
|
|
指控者只看了 generation_service.py,漏了续轮真正的服务。backend/services/workflow_round_service.py:596-597:
|
|||
|
|
"model_route": _optional_text(payload.get("model_route"))
|
|||
|
|
or _optional_text(parent.prompt_snapshot.get("model_route")),
|
|||
|
|
即"本次覆盖 → 父轮次冻结路由",与前端 ["override", …] → ["round", …] 的顺序完全一致。前端 selectedWorkflowRoundFrozenRoute(App.vue:2202-2210)读的正是 detail.round.prompt_snapshot 的 model_route,就是后端这个 parent.prompt_snapshot。round 层是如实镜像,不是前端发明的。
|
|||
|
|
|
|||
|
|
【2. "少了 image_low 兜底" —— 是刻意设计,且 fail-safe,不会说谎】
|
|||
|
|
workflow-model-route.ts:28-31 的注释明写 "Mirrors the server-owned route chain without inventing a frontend default.",第 48 行返回 { route: "", source: "backend" }。这个空值不是被静默吞掉,而是被上游当作硬闸门:
|
|||
|
|
- App.vue:8492-8495:if (!persistentParent && !selectedWorkflowModelResolution.value.route) { workflowRoundError.value = "当前节点和后端默认均未提供生图路由…"; return false }
|
|||
|
|
- 模板 12929 / 12935-12936::model-status-message 与 :submit-disabled 都绑定 !selectedWorkflowModelResolution.route
|
|||
|
|
所以缺 image_low 的后果是"标签显示后端自动 + 禁止提交",而不是显示错误路由。硬编码 image_low 反而会让 UI 声称一个后端可能拒绝的路由(require_resolved_model_route 会抛 MODEL_CAPABILITY_UNCONFIRMED)。
|
|||
|
|
|
|||
|
|
【3. "快速角色标签说谎 / quick_avatar 查不到分配" —— 不可达,这是本条发现的致命硬伤】
|
|||
|
|
该标签链的输入全部来自 selectedWorkflowBackendNode ← activeWorkflowBackendNodes ← selectedQuickProfileLibraryItem.value?.workflowId(App.vue:1768-1775)。而 workflowId 字段只可能是 character_gradual,四处赋值全查过:
|
|||
|
|
- App.vue:4943-4954:const detailedWorkflow = availableWorkflows.find(w => w.workflow_type === CHARACTER_WORKFLOW_TYPE),然后 workflowId: detailedWorkflow?.workflow_id;快速工作流被单独放进 quickCharacterWorkflowId 字段。
|
|||
|
|
- App.vue:7410-7419:只有 if (workflowType === CHARACTER_WORKFLOW_TYPE) 才调 updateQuickProfileWorkflowLink(7524 写 workflowId);else 分支只写 quickCharacterWorkflowId。
|
|||
|
|
- App.vue:9455:workflowId: saved.workflow && isCharacterWorkflow(saved.workflow) ? … : undefined —— 该 saved.workflow 由 quick_profile_service.py:140 创建,workflow_type 为 "quick_profile",isCharacterWorkflow(7533-7535 只认 character_gradual / character_fast)返回 false,故为 undefined。
|
|||
|
|
- App.vue:9489:唯一调用点 4873 传入 characterWorkflow = undefined。
|
|||
|
|
CHARACTER_WORKFLOW_TYPE = "character_gradual"(App.vue:925)。结论:quick_avatar/quick_bust/quick_stand/quick_sheet 永远不会成为 selectedWorkflowBackendNode,这个 Composer 标签根本不为快速角色流渲染,"UI 显示本次覆盖而后端按 assigned_route 出图"的场景无法构造。
|
|||
|
|
|
|||
|
|
而且快速角色流有自己独立且正确的解析器 App.vue:6086-6098:
|
|||
|
|
return recordString(assignments, "quick_generation") || recordString(generation, "default_model") || selectedImageModelRoute()
|
|||
|
|
与后端 _assignment_key 把 quick_* 映射到 quick_generation 完全对齐;且 5813-5815 在其为空时直接 throw "未配置 quick_generation 统一生图路由…",连提交都进不去。
|
|||
|
|
|
|||
|
|
【4. 实际可达路径下前后端结论完全一致】
|
|||
|
|
gradual 工作流的生图节点键(engines/character_flow.py:51-105)只有 headshot / upper_body / lower_body / full_body / turnaround / design_sheet / style_lock,这七个在前端 76-84 与后端 2026-2033 的映射表里逐条相同(都→portrait_generation / halfbody_generation / fullbody_generation ×2 / sheet_generation ×2 / hires_fix)。非生图节点(profile_brief/prompt_plan/material_bind/profile_card)前端返回 ""、后端返回原 node_key 查不到分配,两边同样落到 profile→system,结果一致。后端多出的 questionnaire/preview/virtual_single_image/profile_draft/profile_preview 分支对应的节点类型在 gradual 工作流中不存在。
|
|||
|
|
|
|||
|
|
【5. 配置键耦合被夸大】
|
|||
|
|
App.vue:2234 读 generation.default_model,与后端 backend/routes/node_routes.py:377 的 default_model_route=str(generation_config.get("default_model") …) 是同一个键,当前并无失准。这属于"前端复刻了一份映射表、改键名需两边同改"的可维护性耦合,值得收敛(理想做法是后端在节点/轮次响应里下发 effective_model_route + source),但不是运行期缺陷。
|
|||
|
|
|
|||
|
|
综上:位置真实,但"优先级相反导致标签说谎"的场景被数据流隔离得不可达,缺 image_low 是刻意的 fail-safe,round 层是对 workflow_round_service.py:596-597 的正确镜像。P0/P1 严重度不成立,仅保留 P3 的重复实现/配置键耦合技术债。
|
|||
|
|
|
|||
|
|
### 推翻 #15
|
|||
|
|
- **定位**:`backend/services/integration_token_service.py:1(若保留,应收窄为“9 个模块零执行”,且必须删除 branch_lineage / workflow_progression 两项)`
|
|||
|
|
- **复核意见**:## 判定:误报(方法论无效,核心量化结论与最耸动的子论断均被实测推翻)
|
|||
|
|
|
|||
|
|
### 1. 该发现的取证方法是「在 tests/ 里 grep 模块文件名字符串」,这不是覆盖率
|
|||
|
|
我先复现了它的脚本,结果确实一致(68 个 service,23 个模块名在 tests/ 全文中零出现),类名同样为 0:
|
|||
|
|
`IntegrationTokenService 0 / ChatCommandGuardService 0 / DeletionSafetyService 0 / BranchLineageService 0 / WorkflowProgressionService 0 ...`
|
|||
|
|
|
|||
|
|
但这只证明「测试没有直接 import 这个文件名」,不能证明「零测试」。我随即安装 coverage 7.15.2,对全量套件做了真实行覆盖测量:
|
|||
|
|
`python -m coverage run --source=backend/services -m pytest tests/ -q` → **263 passed in 177.79s**。
|
|||
|
|
|
|||
|
|
### 2. 实测结果:23 个模块中有 8 个被实质性执行,其中 5 个覆盖率 74%~94%
|
|||
|
|
```
|
|||
|
|
branch_lineage_service stmts=172 covered=160 pct=93%
|
|||
|
|
workflow_progression_service stmts= 90 covered= 85 pct=94%
|
|||
|
|
prompt_plan_schema_service stmts=147 covered=123 pct=84%
|
|||
|
|
material_binding_schema_service stmts=140 covered=104 pct=74%
|
|||
|
|
node_injection_template_service stmts= 27 covered= 25 pct=93%
|
|||
|
|
model_provider_bootstrap stmts=126 covered= 41 pct=33%
|
|||
|
|
reference_binding_mapper stmts= 40 covered= 22 pct=55%
|
|||
|
|
chat_session_service stmts= 66 covered= 34 pct=52%
|
|||
|
|
```
|
|||
|
|
我进一步用 AST 剔除 import/def/class 头部行,只统计**函数体内真实执行的语句**,排除「仅 import 噪音」的可能:
|
|||
|
|
```
|
|||
|
|
branch_lineage_service body_executed=133
|
|||
|
|
prompt_plan_schema_service body_executed= 97
|
|||
|
|
material_binding_schema_service body_executed= 84
|
|||
|
|
workflow_progression_service body_executed= 67
|
|||
|
|
```
|
|||
|
|
这是货真价实的行为覆盖,不是导入副作用。
|
|||
|
|
|
|||
|
|
### 3. 最耸动的那句「同名测试不测同名 service,制造假象」——事实完全相反
|
|||
|
|
发现称 `test_workflow_branch_lineage.py`、`test_character_workflow_progression.py` 是「假象」。实测这两个模块恰恰是覆盖率最高的两个(93% / 94%)。原因是它们是**被再导出的 helper 模块**,测试通过前门 service 调用:
|
|||
|
|
```python
|
|||
|
|
# backend/services/workflow_service.py:10
|
|||
|
|
from backend.services.branch_lineage_service import (
|
|||
|
|
# backend/services/workflow_node_material_service.py:17
|
|||
|
|
from backend.services.branch_lineage_service import workflow_metadata_for_branch
|
|||
|
|
# backend/services/character_workflow_service.py:11
|
|||
|
|
from backend.services.workflow_progression_service import (
|
|||
|
|
# backend/services/image_service.py:11
|
|||
|
|
from backend.services.workflow_progression_service import ensure_character_gradual_node_access
|
|||
|
|
```
|
|||
|
|
而 `test_workflow_branch_lineage.py` 第 6-8 行正是 `from backend.services.character_workflow_service import CharacterWorkflowService` / `workflow_service import WorkflowService`。同名测试**正在**测同名 service,只是走的是调用方入口。把这称为「比明摆着没测试更危险的假象」是对代码的误读,且是本条发现中最不成立的部分。
|
|||
|
|
|
|||
|
|
### 4. 行数被夸大约一倍
|
|||
|
|
被声称的 4579 行中,实质有覆盖的 8 个模块合计约 **2279 行**(356+240+379+408+366+375+69+86),即约一半。真正零执行的只有 9 个模块(api_discovery 351、asset_import 406、contract 30、dashboard 117、deletion_safety 75、history 314、integration 171、integration_token 202、log 300 ≈ **1966 行**),不是 23 个 / 4579 行。
|
|||
|
|
|
|||
|
|
### 5. 残余的真实内核(但不足以支撑原发现,且非代码缺陷)
|
|||
|
|
公允地说,实测确认了三点中的两点:
|
|||
|
|
- `integration_token_service` executed=0(129 statements 全未执行)——属实;
|
|||
|
|
- `deletion_safety_service` executed=0——属实;
|
|||
|
|
- `chat_command_guard_service` 实际是 30%,但 body_executed 仅 4 行,`check_generation` 主体(21-39 行)与 `_daily_count`/`_daily_group_count` 全在 missing 中,行为层面确实未测——这一条方向上成立,但发现写的「零测试」与实测的 30% 不符。
|
|||
|
|
|
|||
|
|
不过这属于**测试覆盖缺口(过程问题)**,而非可触发的代码缺陷。我通读了 `integration_token_service.py` 全文,鉴权逻辑本身是正确的、无可指摘的:`verify()` 先做插件白名单校验(91-96 行 `if allowed_plugins and normalized_source not in allowed_plugins: raise ApiError(...INTEGRATION_TOKEN_INVALID)`),`_matches_hash` 用 `hmac.compare_digest(_hash_token(token, salt), digest)` 做常量时间比较(175 行),legacy 分支同样是 `hmac.compare_digest`(115 行),salt 用 `secrets.token_hex(16)`,`_previous_token_set` 带过期窗口校验(139-140 行),`_grace_seconds` 有 `min(max(seconds,0), MAX_GRACE_SECONDS)` 上下界钳制。没有任何硬编码比较、时序泄漏或绕过路径。路由层 `backend/routes/integration_routes.py:100/105-107` 也是正常注入。
|
|||
|
|
|
|||
|
|
### 结论
|
|||
|
|
发现的标题(23 个模块 / 4579 行零测试)在实测下**模块数虚高 2.5 倍、行数虚高约 1 倍**,且其重点强调的「同名测试假象」被证明是彻底反向的错误结论。取证手段(grep 模块名)对本仓库这种 helper-被再导出的架构系统性失效。按「不确定即误报」以及「一条发现里过半内容不成立即不成立」的标准,判 refuted=true。若要保留,必须重写为「9 个 service 零执行覆盖,其中 integration_token_service / deletion_safety_service 为安全相关」,严重度 P3(测试债,无已证实缺陷),并删除关于 branch_lineage_service 与 workflow_progression_service 的全部指控。
|
|||
|
|
|
|||
|
|
### 推翻 #16
|
|||
|
|
- **定位**:`backend/services/chat_workflow_service.py:903(唯一绕过 dispatcher 的直连调用,对应 main.py:1134 `/yp 审核`)`
|
|||
|
|
- **复核意见**:判定:误报(核心影响链不成立)。
|
|||
|
|
|
|||
|
|
一、机制本身属实,但只是"潜在"而非"已触发"
|
|||
|
|
backend/dto/common.py:29-33 的代码确实存在,行号完全对得上。我本机实测(Python 3.11.15)确认位置参数构造时 `BaseException.__new__` 会填充 args:
|
|||
|
|
POS str = "(<ErrorCode.VALIDATION_FAILED: 'VALIDATION_FAILED'>, '内容审核未通过', {'body_preview': 'secret'})"
|
|||
|
|
所以"str(exc) 返回元组 repr"这一点我不否认。但这只在 ApiError **作为异常对象本身**流到 f-string 时才有害。
|
|||
|
|
|
|||
|
|
二、决定性反证:main.py 里根本没有 ApiError
|
|||
|
|
`git ls-files "*.py" | xargs grep -ln ApiError` 的结果里**没有 main.py**;`grep -c ApiError main.py` = 0。main.py 那 40 处 `{exc}`(我逐条核对,515/669/1591 等行号确实存在)捕获到的不是 ApiError。
|
|||
|
|
|
|||
|
|
三、框架层已经消解了它——两道闸门
|
|||
|
|
闸门1,backend/routes/common.py:12-16:
|
|||
|
|
def handle_request(ctx, callback):
|
|||
|
|
try: return success_response(callback(), request_id=ctx.request_id)
|
|||
|
|
except Exception as exc: return response_from_exception(exc, request_id=ctx.request_id)
|
|||
|
|
`response_from_exception` 走 `exc.to_response()`,用的是 **self.message 字段**而非 str(exc),details 被装进 dict 的 "details" 键。
|
|||
|
|
我用脚本遍历了 `backend.route_registry.ROUTES` 全部 166 条路由 / 163 个 distinct handler:**0 个未被包裹**。初筛出的 8 个(start_workflow、archive_profile、get_error_logs 等)经查全部委托给 `_set_workflow_status` / `delete_profile` / `_read_logs`,这些内部都以 `return handle_request(ctx, action)` 收尾。
|
|||
|
|
|
|||
|
|
闸门2,backend/services/chat_workflow_service.py:1166-1170:
|
|||
|
|
@staticmethod
|
|||
|
|
def _data(response):
|
|||
|
|
if not response.get("ok"):
|
|||
|
|
raise ValueError(str(response.get("message") or response.get("error_code") or "ImageStudio 请求失败"))
|
|||
|
|
return response.get("data")
|
|||
|
|
即 details 在这里被**整体丢弃**,只取 message,且 ValueError 是单个位置参数 → str() 干净。
|
|||
|
|
|
|||
|
|
端到端实测(模拟含 provider_id/model_id/body_preview 的 ApiError):
|
|||
|
|
route response dict: {'ok': False, ..., 'details': {'provider_id':..., 'body_preview': '{"error":{"message":"sk-leak..."}}'}}
|
|||
|
|
type reaching main.py: ValueError
|
|||
|
|
main.py renders: 错误:生成失败:上游返回错误
|
|||
|
|
聊天用户拿到的是干净中文 message,无元组语法、无 details。所谓"中文提示被 Python 元组语法淹没"与"details 推送到群聊"两条影响均不成立。
|
|||
|
|
|
|||
|
|
四、证据片段有事实错误
|
|||
|
|
发现称 engines/image_provider.py:253,289,324 会把 body_preview 塞进 ApiError。实际读该文件:`grep -c ApiError engines/image_provider.py` = **0**。那三处抛的是 ImageProviderError,且 engines/image_provider.py:96-110 定义为:
|
|||
|
|
class ImageProviderError(RuntimeError):
|
|||
|
|
def __init__(self, message, *, provider_id, status_code=None, error_type="provider_error", details=None):
|
|||
|
|
super().__init__(message) # 单参数 → str(exc) 就是 message
|
|||
|
|
self.details = details or {}
|
|||
|
|
details 是普通属性,永远不进 str()。body_preview 泄漏链完全不存在。
|
|||
|
|
|
|||
|
|
五、异步推送路径也已加固
|
|||
|
|
worker_service.py:230 已经是 `message = _safe_error_message(exc)`,514-534 的实现只保留 message + code + reason/finish_reason/provider/model 白名单提示并截断 500 字。发现说"作者知道坑但聊天路径没复用"——实际是聊天路径用了另一套等效防护(_data 直接丢 details),不需要复用。
|
|||
|
|
|
|||
|
|
六、唯一残留(远低于所称严重度)
|
|||
|
|
chat_workflow_service.py:903 是全仓唯一绕过 dispatcher 的进程内直调:
|
|||
|
|
model_reviews = {node_id: self.cross_reviewer_factory().review_node(node_id) for node_id in node_ids}
|
|||
|
|
CrossReviewService.review_node 内部经 workflow_progression_service.py:168-172 可抛 ApiError,此时会以元组 repr 落到 main.py:1134 `❌ 审核失败:{exc}`。但:(1) 仅此 1 处,不是 40 处;(2) 该 details 内容为 workflow_id/node_id/node_key/branch_name/required_action/progression_version(见 workflow_progression_service.py:138-167),全是内部 ID,无 provider_id、无 model_id、无 body_preview、无凭据;(3) 同一命令的成功分支 main.py:1132 本来就 `json.dumps(result, ...)[:3000]` 把含 provider_id/model 的完整审核结果打给聊天,该命令设计上就是 verbose 的;(4) 该 ApiError 的 message 是英文 "character workflow node is locked by sequential progression",不存在"中文被淹没"。
|
|||
|
|
|
|||
|
|
综上:所称 P0/P1 级信息泄漏 + 40 处可用性崩坏为误报;实际残留是 1 处仅显示内部 ID 的观感问题,P3。
|