astrbot_plugin_imagestudio/审计/findings/_复核结论.md

66 KiB

复核结论(对抗式验证)

对全部 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 之前就先跑了节点级锁:
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)明确拒绝已定稿节点:

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。

  1. 「轮次 status=confirmed」与「节点 status=selected / selected_image_id 非空」是同一原子事务里一起写的,不存在“轮次已 confirmed 但节点仍可创建轮次”的中间态。全仓只有两处把轮次写成 confirmed,两处都同时锁死节点:
  • workflow_round_repository.py:993-1000(confirm_candidate_atomic)先执行
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。
  1. 不存在“解锁节点但保留轮次 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 行照样拦得住。

  2. 因此发现列举的三项后果全部不成立: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 分支无关。

  3. 触发条件描述尤其站不住:“网络超时后的正常重试”发生在轮次刚创建、节点尚未定稿时,此时 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) 也属实。
  1. 决定性反证——旧线程停止后不会再认领任何任务。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 个短命线程,各自跑完一条即退出,不累积。

  1. 残余风险存在但被默认配置基本关闭。唯一真实的窄窗口是:旧线程手上那条任务若在新 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 级的必现重复计费。

  2. 另外 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 确实是:

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),而它所在的函数是:

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):

<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 逐字对得上:

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
    # 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"。

  1. 聊天命令通路: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:

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 被硬性拒绝非渐进类型:

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 写回,中间没有跨请求的陈旧快照:

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:

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)把它们列为显式数据源:

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 节点无条件套用服务端身份锁,代码注释明写此意图:

# 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:

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 归约:

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:

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 调用:

# 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。