@qingflow-tech/qingflow-app-builder-mcp 1.0.40 → 1.0.41

package/src/qingflow_mcp/tools/record_tools.py

@@ -4037,7 +4037,11 @@ class RecordTools(ToolBase):
             "field_id": field_id,
             "error_code": error_code,
             "message": self._record_write_semantic_error_message(error_code, error.get("message")),
-            "next_action": self._record_write_next_action_for_error(error_code),
+            "next_action": self._record_write_next_action_for_error(
+                error_code,
+                expected_format=expected_format,
+                field_payload=field_payload,
+            ),
         }
         if expected_format is not None:
             payload["expected_format"] = expected_format
@@ -4148,8 +4152,30 @@ class RecordTools(ToolBase):
             return _normalize_optional_text(fallback) or "字段值格式不正确。"
         return _normalize_optional_text(fallback) or "字段写入失败。"
 
-    def _record_write_next_action_for_error(self, error_code: str) -> str:
+    def _record_write_next_action_for_error(
+        self,
+        error_code: str,
+        *,
+        expected_format: JSONObject | None = None,
+        field_payload: JSONObject | None = None,
+    ) -> str:
         """执行内部辅助逻辑。"""
+        kind = _normalize_optional_text((expected_format or {}).get("kind"))
+        field_title = (
+            _normalize_optional_text((field_payload or {}).get("que_title"))
+            or _normalize_optional_text((field_payload or {}).get("title"))
+            or "该字段"
+        )
+        if kind == "member_list":
+            return f"{field_title} 需要有效成员；用唯一姓名/邮箱/id，歧义时先调用 record_member_candidates 后只重试本行。"
+        if kind == "department_list":
+            return f"{field_title} 需要有效部门；用候选范围内的部门名/id/object，歧义或不确定时先调用 record_department_candidates 后只重试本行。"
+        if kind == "relation_record":
+            return f"{field_title} 需要关联记录；优先改用目标记录 record_id/apply_id，或使用可唯一命中的显示文本后只重试本行。"
+        if kind == "attachment_list":
+            return f"{field_title} 需要附件值；先用 file_upload_local 上传文件，再写返回的 value/url 后只重试本行。"
+        if kind in {"single_select", "multi_select"}:
+            return f"{field_title} 需要选项值；使用 schema options 中的标签或 option id，修正后只重试本行。"
         if error_code == "MISSING_REQUIRED_FIELD":
             return "补充该字段后只重试本行。"
         if error_code in {"FIELD_NOT_FOUND", "AMBIGUOUS_FIELD"}: