vault backup: 2025-12-09 10:58:24

app_prd/知识增强服务KES.md

@@ -63,13 +63,16 @@
 4.  **调用 API**: 发送 HTTP POST 请求给 `summary_api`。
 5.  **结果处理**:
     *   **成功**:
-        *   将返回的 JSON 填入 `knowledges`, `methods`, `problem_summary` 字段。
-        *   同时将这些值 **Copy** 一份给 `updated_knowledges`, `updated_methods` (作为人工审核的默认值)。
-        *   更新状态 `enrich_status = 'done'`。
+	    - **第一步：更新 AI 原始字段**。将 API 返回的 JSON 数据填入 knowledges, methods, problem_summary 字段。这些字段始终反映 AI 的最新判断。
+        
+	    - **第二步：更新人工审核字段 (写保护逻辑)**。
+	        - **检查该题目的 is_reviewed 字段状态**。
+	        - **场景 A (未审核, is_reviewed = False)**：将 AI 提取的结果 **复制 (Copy)** 一份给 updated_knowledges 和 updated_methods。此时认为 AI 结果即为当前最佳结果。
+	        - **场景 B (已审核, is_reviewed = True)**：**跳过** 对 updated_knowledges 和 updated_methods 的更新。**绝对禁止** 覆盖人工已经校对过的数据，仅更新 AI 原始字段供参考。
+	    - **第三步：更新状态**。将 enrich_status 更新为 'done'，清空 enrich_error。
     *   **失败 (5xx/Timeout)**:
         *   触发重试（指数退避，最多 3 次）。
         *   若最终失败，更新状态 `enrich_status = 'failed'`，并记录 `error_msg`。
-
 ### 3.2 人工审核 (Human-in-the-Loop)
 *   **审核逻辑**: AI 的提取结果并不总是 100% 准确。系统信任链为：**人工数据 > AI 数据**。
 *   **数据流**: