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

426 行
30 KiB
Markdown

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

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

# 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()` 的只读保护完全没有参与。
- **代码**:
```python
# 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}
```
```python
# 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)
```
```python
# 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),
)
```
对照被绕过的守卫:
```python
# 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` 的幂等重放分支加前置判断:
```python
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` 重新指向**父轮次**。
- **代码**:
```python
# 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,
...
```
```python
# 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`:
```python
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` 全流程)
- **问题**:交叉评审侧有明确守卫:
```python
# 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`,**创建前不检查它是否已存在**:
```python
# 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`——**没有任何错误、也不会回退到确定性解析器**。
- **代码**:
```python
# 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`)。
- **代码**:
```python
# 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)。
- **代码**:
```python
# 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
```
```python
# 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**:
- **代码**:
```python
# 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` 均会报错)。
且返回后调用方立刻对这个"重放命中"的轮次做写操作:
```python
# 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'`)。
- **代码**:
```python
# 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` 会被保留。
- **代码**:
```python
# 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
```
```python
# 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"。
- **代码**:
```python
# workflow_round_repository.py:719-726
if idempotency_key:
request_log[idempotency_key] = {...}
request_log = dict(list(request_log.items())[-20:])
```
```python
# 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` 字段,裁剪时按它排序:
```python
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`)。
- **代码**:
```python
# 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 而非正常响应。
- **修复建议**:
```python
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,
```