astrbot_plugin_imagestudio/审计/findings/A2-工作流与轮次.md

30 KiB

A2 · 工作流 / 轮次 / 分支 / 交叉评审 状态机

审计范围(实际逐行通读的源文件):

  • backend/services/workflow_round_service.py
  • backend/services/workflow_service.py
  • backend/services/workflow_generation_cross_review_service.py
  • backend/services/generation_cross_review_service.py
  • backend/services/workflow_feedback_interpreter.py
  • backend/services/workflow_round_feedback_service.py
  • backend/services/branch_lineage_service.py
  • backend/services/workflow_round_worker_runtime.py
  • backend/services/generation_job_retry_service.py(前 120 行)
  • backend/routes/round_routes.py
  • database/repositories/workflow_round_repository.py
  • database/repositories/workflow_cross_review_repository.py
  • database/models.py、database/migrations/0014_workflow_generation_rounds.sql、database/db_helper.py(connect 部分)
  • frontend/standalone-web/src/App.vue(轮次相关片段:2336-2340、7030-7075)

另:已用 python -c 实际执行 WorkflowFeedbackInterpreter / WorkflowRoundFeedbackService 验证 F4、F5 两条发现。

摘要

轮次状态机的写入口分散且没有统一的状态守卫:WorkflowRoundRepository.update_round() 是一个裸 UPDATE,_ensure_writable_round_row() 的只读保护只在 apply_feedback_atomic / confirm_candidate_atomic 等少数事务里生效,而 _ensure_round_enqueued() 和 reconcile_round() 绕过它无条件改写 status。结果是 confirmed / superseded 这两个终态可以被普通的幂等重放或迟到的 worker 回调回退成 queued / completed,从而击穿"已定稿轮次只读"和"跨评审必须复用已确认候选"两条核心不变量。

分支层面,create_next_round 把父轮次标记 superseded 之后没有任何机制阻止父轮次继续被 reconcile 回写,也没有 next_round_id 唯一性守卫(交叉评审侧有 next_review_round_id,主轮次侧没有),同一父轮次可以分叉出多个"下一轮"并互相覆盖节点的 active_round_id。

反馈解释器方面,LLM 路径对扁平结构的模型输出会静默丢弃全部候选偏好(只保留 patch),确定性回退路径会把用户文本里的普通数字("不要 3 个人"、"分辨率 512")当作候选编号,导致误拒候选或直接 400。

性能上 list_node_rounds → _persisted_detail 是典型 N+1,且本仓库每次仓储调用都 sqlite3.connect() 新建连接,一次轮次列表加载可产生数十条独立连接,而前端还在轮询该接口。


发现

[P0-致命] update_round 无状态机守卫:已确认(confirmed)轮次可被幂等重放静默回退,击穿只读锁与跨评审校验

  • 位置:backend/services/workflow_round_service.py:115、backend/services/workflow_round_service.py:928、database/repositories/workflow_round_repository.py:416
  • 问题: create_round 命中 idempotency_key 重放分支时,会无条件调用 _ensure_round_enqueued(existing, ctx);该方法末尾又无条件把轮次 status 写成 "queued",随后 reconcile_round 依据候选聚合把它改成 completed。整条链路上没有任何一处检查 existing.status 是否已经是 confirmed / superseded 这类终态,而 update_round 本身只是一条裸 UPDATE,_ensure_writable_round_row() 的只读保护完全没有参与。
  • 代码:
    # workflow_round_service.py:115-117  —— 幂等重放路径
                    if self.generation_service is not None:
                        self._ensure_round_enqueued(existing, ctx)
                    return {**self.get_round(existing.round_id).to_dict(), "created": False, "idempotent_replay": True}
    
    # workflow_round_service.py:928-940  —— 无条件覆写 status
            latest = self.round_repository.get_round(round_record.round_id) or round_record
            self.round_repository.update_round(
                round_record.round_id,
                {
                    "status": "queued",
                    "metadata": {
                        **latest.metadata,
                        "planned_only": False,
                        "task_ids": task_ids,
                    },
                },
            )
            self.reconcile_round(round_record.round_id, ctx)
    
    # workflow_round_repository.py:416-431  —— 裸 UPDATE,不校验当前 status
        def update_round(self, round_id: str, payload: dict[str, Any]) -> WorkflowGenerationRound | None:
            assignments, params = _round_update_assignments(payload, self.placeholder)
            ...
                conn.execute(
                    f"UPDATE workflow_generation_rounds SET {', '.join(assignments)} WHERE round_id = {self.placeholder}",
                    tuple(params),
                )
    
    对照被绕过的守卫:
    # workflow_round_repository.py:1364-1369
        if status == "confirmed":
            raise WorkflowRoundWriteError(
                "round_already_confirmed",
                "confirmed workflow round is read-only",
                {"round_id": round_id},
            )
    
  • 影响: 客户端(或 AstrBot 聊天侧)用同一个 idempotency_key 重试 POST nodes/{id}/rounds(网络超时后的正常重试即可触发,不需要并发),一个已经 confirmed 的轮次会退回 completed。后果链:
    1. _ensure_writable_round_row 不再拦截 → apply_feedback_atomic 可以继续改写已定稿轮次的候选偏好/_conversation;
    2. WorkflowCrossReviewRepository._load_source_owner(workflow_cross_review_repository.py:1066-1076)只在 status == "confirmed" 时校验 confirmed_candidate_mismatch,状态被回退后该校验被跳过 → 用户可以对与已定稿候选不同的候选发起跨评审;同理 _ensure_review_after_confirmation_is_safe(:1108-1111)在非 confirmed 时直接 return,下游节点已完成的保护也一并失效;
    3. record_skip_restoration_handoff_atomic(:795)要求 status == 'confirmed',回退后跳过流程的 XF 交接会永久失败。 节点侧 selected_image_id 仍指向旧图,轮次侧却重新变成可写,两边彻底不一致。
  • 修复建议:
    1. 在 WorkflowRoundRepository 增加 update_round_if_status(round_id, expected_statuses, payload)(仓库里已有同模式的 update_workflow_if_status / update_node_if_status 可参照),或在 update_round 内部对 status 赋值做终态白名单校验:confirmed / superseded / cancelled 一律拒绝降级。
    2. create_round 的幂等重放分支加前置判断:
      if existing.status in {"confirmed", "superseded", "cancelled"}:
          return {**self.get_round(existing.round_id).to_dict(), "created": False, "idempotent_replay": True}
      
    3. _ensure_round_enqueued 末尾改为 "status": "queued" if task_ids else latest.status,并同样跳过终态轮次。

[P1-严重] reconcile_round 无条件回写状态与节点指针:迟到的候选回调会把 superseded 父轮次"复活"并把节点 active_round_id 指回旧轮次

  • 位置:backend/services/workflow_round_service.py:806、backend/services/workflow_round_service.py:621
  • 问题: create_next_round 只要求父轮次里有 1~3 个 succeeded 的 liked 候选,并不要求父轮次已经终态(get_consistent_round_snapshot 没有任何 status 校验)。因此完全可以在父轮次还有候选处于 queued/running 时创建子轮次,父轮次被打上 superseded。当那些残留候选随后完成时,worker 的 handle_task_terminal → reconcile_round(parent) 会用聚合状态覆盖 superseded,同时把节点 metadata 的 active_round_id 重新指向父轮次。
  • 代码:
    # workflow_round_service.py:818-847
            updated_round = self.round_repository.update_round(
                round_id,
                {
                    "status": round_status,           # 直接覆盖 superseded / confirmed
                    ...
                },
            ) or round_record
            if self.generation_service is not None:
                ...
                if node.status not in {"selected", "discarded"}:
                    update_payload = {
                        "status": node_status,
                        "metadata": {
                            **metadata,
                            "active_round_id": round_id,   # 指回被 reconcile 的那个轮次
                            "last_round_status": round_status,
                            ...
    
    # workflow_round_service.py:621-633 —— 父轮次被标 superseded,但没有任何后续保护
            superseded_parent = self.round_repository.update_round(
                parent_round_id,
                {"status": "superseded", "metadata": {..., "superseded_by_round_id": created.get("round_id"), ...}},
            )
    
    且 _ensure_writable_round_row(workflow_round_repository.py:1355-1375)的不可写列表里没有 superseded:
        if status in {"cancelled", "all_failed"}:
            raise WorkflowRoundWriteError("round_not_writable", ...)
    
  • 影响:
    1. 父轮次状态从 superseded 变回 completed/partial_success,UI 上同一节点出现两个"可确认"的轮次,用户可能在旧轮次上定稿,绕过刚创建的优化子轮次;
    2. 节点 metadata.active_round_id 被改回父轮次,前端 App.vue:2336 的 selectedWorkflowActiveRoundId 直接采信该值(不做"是否在已加载轮次列表中"的校验,和 App.vue:7048 的加载逻辑不一致),面板会跳回旧轮次;
    3. 节点 status 由父轮次聚合结果决定,子轮次还在跑时节点就被标 completed;
    4. superseded 轮次仍可写反馈 → 用户能对已被取代的轮次继续 like/reject,且可以再次 create_next_round 生成第二个子轮次(主轮次侧缺少交叉评审那样的 next_review_round_id 唯一性守卫,见下一条)。
  • 修复建议:
    1. _reconcile_round_locked 读取 round_record.status,若已是 confirmed / superseded / cancelled,只更新 metadata.execution_summary,不写 status,也不改节点的 active_round_id;
    2. 更新节点前先确认 round_id == node.metadata.get("active_round_id") 或该轮次仍是该节点最新的非终态轮次,避免旧轮次抢占节点指针;
    3. 把 superseded 加入 _ensure_writable_round_row 的不可写状态集合。

[P2-中等] create_next_round 缺少"一个父轮次只能有一个子轮次"的守卫,可分叉出多条优化链

  • 位置:backend/services/workflow_round_service.py:465(create_next_round 全流程)
  • 问题:交叉评审侧有明确守卫:
    # workflow_cross_review_repository.py:171-182
                existing_child = _optional_text(parent_metadata.get("next_review_round_id"))
                if existing_child:
                    raise WorkflowRoundWriteError(
                        "cross_review_followup_exists",
                        "this review round already has a follow-up",
                        {..., "required_action": "open_latest_cross_review"},
                    )
    
    而主轮次的 create_next_round 只写 superseded_by_round_id,创建前不检查它是否已存在:
    # workflow_round_service.py:620-633
            created = self.create_round(parent.node_id, next_payload, ctx)
            superseded_parent = self.round_repository.update_round(
                parent_round_id,
                {"status": "superseded",
                 "metadata": {**parent.metadata, "superseded_by_round_id": created.get("round_id"), ...}},
            )
    
    唯一的并发保护是 parent_feedback_revision 乐观校验(workflow_round_repository.py:162-174),但它只在父轮次 feedback 发生变化时才拒绝;两次内容相同的 create_next_round 请求(不带 idempotency_key,或带不同 key)revision 一致,两次都会成功。
  • 影响:同一父轮次产生两个平级子轮次,superseded_by_round_id 被后者覆盖,前者成为无人引用的孤儿优化链;节点的 active_round_id 在两条链之间来回跳;_feedback_summary / feedback_context.parent_round_id 追溯信息失真。
  • 修复建议:把 superseded_by_round_id 的存在性检查移进 create_round_with_candidates 的同一事务(该事务已经对 parent 行加了 FOR UPDATE / BEGIN IMMEDIATE),存在即抛 next_round_exists;或在 workflow_generation_rounds(parent_round_id, round_kind) 上加部分唯一索引。

[P2-中等] LLM 返回扁平结构时,候选偏好被静默丢弃(不报错、不回退到确定性解析)

  • 位置:backend/services/workflow_round_feedback_service.py:166(_normalize_model_payload)
  • 问题:_model_request 下发的 response_schema 把 liked/rejected/... 嵌在 feedback 下,_normalize_model_payload 也只从 parsed["feedback"] 取这些键;模型若按常见习惯返回扁平结构(顶层直接给 liked),feedback 为空 dict,候选偏好全部丢失,但 positive_patch 因为单独从顶层取而被保留,于是校验通过、source="llm_validated"、fallback_used=False——没有任何错误、也不会回退到确定性解析器。
  • 代码:
    # workflow_round_feedback_service.py:178-189
        feedback = parsed.get("feedback")
        feedback = dict(feedback) if isinstance(feedback, Mapping) else {}
        merged = {
            **feedback,                       # 顶层的 liked/rejected/final 在这里被丢掉
            "positive_patch": parsed.get("positive_patch", feedback.get("positive_patch", parsed.get("next_round_prompt_patch"))),
            "negative_patch": parsed.get("negative_patch", feedback.get("negative_patch")),
            "material_intent": parsed.get("material_intent", feedback.get("material_intent")),
        }
        return merged
    
    实测(本机执行):
    flat   payload {'liked': ['TX-01-02'], 'positive_patch': 'more light'}
        -> source=llm_validated  liked=[]            patch='more light'  fallback_used=False
    nested payload {'feedback': {'liked': ['TX-01-02']}, 'positive_patch': 'more light'}
        -> source=llm_validated  liked=['TX-01-02']
    
  • 影响:用户说"保留第 2 张并加点光",系统只记下 patch、丢掉"保留第 2 张"。随后 create_next_round 因为 liked 为空直接 400(workflow_round_service.py:504-514 "select one to three liked candidates"),用户看不到任何"模型没理解"的提示,只会认为功能坏了;更糟的情况是同一请求里还有 rejected,则用户的拒绝意图被无声吞掉。
  • 修复建议:_normalize_model_payload 对四个动作字段做 feedback.get(k, parsed.get(k)) 的双层回退;并在 merged 中所有动作字段都为空且 parsed 顶层存在同名键时,抛 WorkflowFeedbackInterpretationError("invalid_llm_result", ...),让 interpret() 的 except Exception 走确定性回退,而不是"半成功"。

[P2-中等] 确定性反馈解析器把普通数字当候选编号:静默误拒候选 / 合法反馈被 400

  • 位置:backend/services/workflow_feedback_interpreter.py:46(_DISPLAY_CODE_OR_NUMBER_RE)、:172-208(interpret 主循环)
  • 问题:候选 token 正则里包含裸 \d{1,3},任何 1~3 位数字都会被当成候选序号;interpret 又会把"没有动作词但有数字"的后续片段挂到上一个动作(active_prefix_action)。这是LLM 不可用时的默认路径(round_routes.py:143-150:未配置 prompt_planning 路由时 feedback_callable=None)。
  • 代码:
    # workflow_feedback_interpreter.py:46-54
    _DISPLAY_CODE_OR_NUMBER_RE = re.compile(
        r"(?<![A-Za-z0-9])"
        r"(?:"
        r"(?=[A-Za-z0-9-]*\d)[A-Za-z][A-Za-z0-9]*(?:-[A-Za-z0-9]+)+"
        r"|\d{1,3}"                      # ← 任意 1~3 位数字
        r")"
        r"(?![A-Za-z0-9])",
        re.IGNORECASE,
    )
    
    实测(白名单 TX-01-01..TX-01-04):
    "喜欢 TX-01-01,不要 3 个人"   -> liked=['TX-01-01']  rejected=['TX-01-03']   # 静默误拒
    "拒绝 02,分辨率 512"          -> WorkflowFeedbackInterpretationError:
                                      reason=unknown_candidate_reference, reference='512'
    
  • 影响:
    • 误拒路径:update_feedback 会把 TX-01-03 写成 rejected 并落 pool_state='rejected' + history,用户完全不知情,且该候选此后无法 confirm(confirm_candidate_atomic 拒绝 rejected 候选);
    • 400 路径:只要用户反馈里出现 3 位以内数字(尺寸、人数、年龄、角度…),整个反馈请求被 ApiError(VALIDATION_FAILED, "candidate reference '512' is not in the current whitelist") 拒绝,错误信息对用户毫无意义。
  • 修复建议:
    1. 裸数字只在紧邻候选语境时才视为候选引用——要求前置量词/标记(候选、第、#、No.、张、号);把无标记的 \d{1,3} 从 _DISPLAY_CODE_OR_NUMBER_RE 移除,交给 _CHINESE_ORDINAL_RE 这类带标记的规则;
    2. 解析出的数字若不在白名单的终端序号集合内,应当忽略而不是抛 unknown_candidate_reference(仅当该 token 带显式候选标记时才报错);
    3. active_prefix_action 跨片段续接时同样只接受带标记的 token。

[P2-中等] list_node_rounds 的 N+1,且每次仓储调用都新建一条 SQLite 连接

  • 位置:backend/services/workflow_round_service.py:982(_persisted_detail)、backend/services/workflow_round_service.py:942(list_node_rounds)、database/db_helper.py:159(connect)
  • 问题:list_node_rounds 对该节点的每一个轮次调用 _persisted_detail,后者对每一个候选再各查一次 image 和 task;而所有仓储方法都是 conn = self.database.connect() … conn.close(),即每次查询都新建一条 sqlite3.connect()(还要跑两条 PRAGMA)。
  • 代码:
    # workflow_round_service.py:982-998
        def _persisted_detail(self, round_record: WorkflowGenerationRound) -> WorkflowGenerationRoundDetail:
            candidates = {item.candidate_id: item for item in self.round_repository.list_candidates(round_record.round_id)}
            views: list[WorkflowRoundCandidateView] = []
            for pool in self.round_repository.list_pool(round_record.round_id):
                candidate = candidates.get(pool.candidate_id) or self.round_repository.get_candidate(pool.candidate_id)
                if candidate is None:
                    continue
                image = self.image_repository.get(candidate.image_id) if candidate.image_id else None
                task = self.job_repository.get(candidate.current_task_id) if candidate.current_task_id else None
    
    # db_helper.py:159-170
        def connect(self):
            if self.backend == "sqlite":
                ...
                conn = sqlite3.connect(db_path, timeout=30.0)
                conn.row_factory = sqlite3.Row
                conn.execute("PRAGMA foreign_keys = ON")
                conn.execute("PRAGMA busy_timeout = 30000")
                return conn
    
  • 影响:一个有 6 轮 × 4 候选的节点,单次 GET nodes/{id}/rounds 约产生 3 + 6×(2 + 4×2) ≈ 63 条独立连接/查询;而前端 App.vue 的 scheduleWorkflowRoundPolling 在轮次运行期间会周期性重拉该接口。SQLite 单写锁下,这会与 worker 的候选写入争抢 busy_timeout,放大 database is locked 风险。
  • 修复建议:
    1. 给 WorkflowRoundRepository 增加批量方法 list_candidates_for_rounds(round_ids) / list_pool_for_rounds(round_ids)(WHERE origin_round_id IN (...)),一次取回全部轮次的候选与池;
    2. ImageRepository / JobRepository 增加 get_many(ids);_persisted_detail 改为接收预取好的字典;
    3. 中期考虑给 Database 加连接复用(线程本地连接或连接池),当前"每查询一连接"在轮询场景下代价过高。

[P2-中等] 交叉评审的幂等重放只按 idempotency_key 全表匹配,可命中另一个节点/另一种轮次并对其改状态

  • 位置:database/repositories/workflow_cross_review_repository.py:969(_round_replay)、被 :57 与 :166 调用
  • 问题:idempotency_key 在 workflow_generation_rounds 上是全表唯一(0014_workflow_generation_rounds.sql: idx_workflow_rounds_idempotency),主轮次、交叉评审轮次、XF 交接轮次共用同一个键空间。但 _round_replay 只按 key 查,不校验命中的轮次是否属于本次请求的 source round / node / round_kind:
  • 代码:
    # workflow_cross_review_repository.py:969-978
        def _round_replay(self, conn: Any, idempotency_key: str | None) -> dict[str, Any] | None:
            if not idempotency_key:
                return None
            row = conn.execute(
                f"SELECT round_id, display_code FROM workflow_generation_rounds WHERE idempotency_key = {self.placeholder}",
                (idempotency_key,),
            ).fetchone()
            if row is None:
                return None
            return {"round_id": row["round_id"], "display_code": row["display_code"]}
    
    对照主轮次侧有这层校验(workflow_round_service.py:94-114:existing.node_id != node.node_id / existing.parent_round_id 均会报错)。 且返回后调用方立刻对这个"重放命中"的轮次做写操作:
    # workflow_generation_cross_review_service.py:389-391
            self._ensure_enqueued(str(created["round_id"]), ctx)
            result = {**self.round_service.get_round(str(created["round_id"]), ctx).to_dict(), "review_operation": created}
    
    而 _ensure_enqueued(:668-676)末尾会 update_round(status=..., metadata={... "task_ids": ..., "planned_only": False}) 并 reconcile_round。
  • 影响:客户端在不同操作上复用同一个 idempotency_key(UI 用同一个"操作 id"、或聊天侧用消息 id 做 key 都会踩到),交叉评审请求会"成功"返回一个完全无关的轮次,并把它的 status/metadata.task_ids 覆盖掉、触发一次针对该轮次的 reconcile(进而改写其节点的 active_round_id)。跨用户场景下 round_service.get_round(..., ctx) 的 require_node 会在最后一步拦住读取,但写入已经发生。
  • 修复建议:_round_replay 增加参数并校验:命中行的 round_kind 必须匹配、node_id/workflow_id 必须等于 round_payload 中的值、parent_round_id 必须等于本次的 source/parent;不匹配时抛 WorkflowRoundWriteError("idempotency_key_conflict", ...) 而不是当作重放。

[P2-中等] 跨评审 skip 由三段独立事务组成,中途失败会留下"已跳过但未定稿"的不一致状态

  • 位置:backend/services/workflow_generation_cross_review_service.py:407(_skip)
  • 问题:跳过流程依次执行三个各自独立提交的事务:① record_skip_atomic(写 generation_cross_review.decision='skip' + history)→ ② round_service.confirm_candidate(另一个连接里的 confirm_candidate_atomic)→ ③ record_skip_restoration_handoff_atomic(要求 status == 'confirmed')。
  • 代码:
    # workflow_generation_cross_review_service.py:416-445
            try:
                decision = self.cross_review_repository.record_skip_atomic(...)   # ① 已提交
            except WorkflowRoundWriteError as exc:
                raise _write_error(exc) from exc
            if decision.get("already_confirmed"):
                result = self.round_service.get_round(source_round_id, ctx).to_dict()
            else:
                result = self.round_service.confirm_candidate(                     # ② 可能抛错
                    source_round_id,
                    {"candidate_id": candidate_id, "idempotency_key": f"{idempotency_key}:confirm" if idempotency_key else None},
                    ctx,
                )
            try:
                restoration_handoff = (
                    self.cross_review_repository.record_skip_restoration_handoff_atomic(...)   # ③ 要求 confirmed
                )
    
    ② 的失败原因很现实:confirm_candidate_atomic 会因 round_branch_not_active(另一个标签页切了分支)、node_already_completed、candidate_image_restricted 而抛错。
  • 影响:轮次 metadata 里已经写死 decision='skip',但轮次并未 confirmed、XF 输入库也没有条目。此时用户如果改主意想走 review,会被 record_skip_atomic 的分支挡住吗?——不会,existing.get("decision") == "skip" 分支会当成幂等重放返回 already_confirmed=False,然后又去 confirm_candidate,永远卡在同一个失败点;而走 review 分支的 create_review_round_atomic 不检查 decision=='skip',会在一个已标记跳过的轮次上再建评审轮次,两个状态并存。
  • 修复建议:
    1. 把"记录 skip + 确认候选"合并为一个事务(record_skip_atomic 内部直接完成 confirm 所需的全部写入,或让 confirm_candidate_atomic 接受一个 review_decision 参数在同一 conn 内落库);
    2. 若暂时无法合并,则在 record_skip_atomic 里区分"已记录但未确认"的中间态(如 decision_state='pending_confirm'),并允许用户显式撤销该跳过决定;
    3. create_review_round_atomic 增加 decision == 'skip' 的互斥校验。

[P2-中等] apply_feedback_atomic 会把旧的 _conversation 无条件带到新快照,导致 create_next_round 复用过期的 prompt patch

  • 位置:database/repositories/workflow_round_repository.py:703、backend/services/workflow_round_service.py:534
  • 问题:每次反馈写入都会用池里的最新偏好重建 feedback_snapshot,然后把上一版快照里所有 _ 前缀的键原样复制回来。当用户第一次用自然语言反馈(写入 _conversation),第二次改用结构化 updates(此时 conversation is None,不覆盖),旧的 _conversation 会被保留。
  • 代码:
    # workflow_round_repository.py:703-716
                feedback_snapshot = {
                    str(row["candidate_id"]): {...}
                    for row in pool_rows
                }
                for key, value in previous_snapshot.items():
                    if str(key).startswith("_"):
                        feedback_snapshot[str(key)] = value      # ← 旧 _conversation 原样带过来
                ...
                if conversation is not None:
                    feedback_snapshot["_conversation"] = conversation
    
    # workflow_round_service.py:534-559 —— create_next_round 直接吃这个残留值
            conversation = parent.feedback_snapshot.get("_conversation")
            conversation = dict(conversation) if isinstance(conversation, dict) else {}
            ...
            positive_patch = _bounded_optional_text(conversation.get("positive_patch"), field="positive_patch", maximum=4_000)
            material_intent = _bounded_optional_text(conversation.get("material_intent"), ...)
    
  • 影响:用户第一轮说"下一轮加暖光",之后改口用界面按钮重新勾选偏好(不再提暖光),生成的子轮次仍会带上"加暖光"的 prompt_patch 与 material_intent,且 feedback_context.source_text 显示的是那句早已作废的原话。用户无法通过 UI 清除该 patch。
  • 修复建议:在 _conversation 里记录写入序号/时间戳与其所依据的 pool_revision;create_next_round 只在 _conversation 对应的是最近一次反馈写入时才采用其 patch,否则只使用池偏好 + _strict_rejection_patch。或者更简单:结构化 updates 写入时显式 feedback_snapshot.pop("_conversation", None),并在 API 上暴露"清除对话补丁"的能力。

[P3-轻微] 反馈幂等日志按字典序而非时间序裁剪,会淘汰掉较新的 key

  • 位置:database/repositories/workflow_round_repository.py:719
  • 问题:request_log 是从 metadata_json 反序列化出来的 dict,而写库时用的是 json.dumps(..., sort_keys=True)(workflow_round_repository.py:1318-1321),所以重新读出来的插入顺序是字典序,不是写入时间顺序。[-20:] 因此保留的是"字典序最大的 20 个 key"。
  • 代码:
    # workflow_round_repository.py:719-726
                if idempotency_key:
                    request_log[idempotency_key] = {...}
                    request_log = dict(list(request_log.items())[-20:])
    
    # workflow_round_repository.py:1318-1321
    def _json_or_none(value: Any | None) -> str | None:
        if value is None:
            return None
        return json.dumps(value, ensure_ascii=False, sort_keys=True)
    
  • 影响:在同一轮次上做超过 20 次带 key 的反馈写入后,被淘汰的是字典序小的 key(例如以 a 开头的 UUID),而非最旧的。用户对一个刚提交过的请求做重试时,幂等记录可能已被淘汰 → 重复写入一条 round_feedback_updated history,并重复触发审计事件。
  • 修复建议:在每条记录里已有 updated_at 字段,裁剪时按它排序:
    request_log = dict(sorted(request_log.items(), key=lambda kv: str(kv[1].get("updated_at") or ""))[-20:])
    

[P3-轻微] approve 响应里对同一个 next_node_id 重复查询节点

  • 位置:backend/services/workflow_generation_cross_review_service.py:259
  • 问题:条件表达式里把 get_node 调了两次(一次判空、一次取值),既是多余的 DB 往返,也有 TOCTOU(两次之间节点被删则第二次返回 None,.to_dict() 抛 AttributeError)。
  • 代码:
    # workflow_generation_cross_review_service.py:259-267
            return {
                **self.round_service.get_round(round_id, ctx).to_dict(),
                "approval": approval,
                "next_node": (
                    self.workflow_repository.get_node(str(approval["next_node_id"])).to_dict()
                    if approval.get("next_node_id") and self.workflow_repository.get_node(str(approval["next_node_id"]))
                    else None
                ),
            }
    
  • 影响:多一次数据库连接;极端竞态下 500 而非正常响应。
  • 修复建议:
    next_node = (
        self.workflow_repository.get_node(str(approval["next_node_id"]))
        if approval.get("next_node_id")
        else None
    )
    ...
    "next_node": next_node.to_dict() if next_node else None,