@qingflow-tech/qingflow-cli 1.1.60 → 1.1.61-beta.2

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/subtable.json

@@ -111,7 +111,7 @@
           ]
         },
         "fileSize": {
-          "minimum": 1,
+          "minimum": 0,
           "type": [
             "integer",
             "null"
@@ -131,7 +131,7 @@
           ]
         },
         "maxFileLimit": {
-          "minimum": 1,
+          "minimum": 0,
           "type": [
             "integer",
             "null"
@@ -229,7 +229,7 @@
     },
     "DataRelationCondition": {
       "additionalProperties": false,
-      "description": "一条数据关联过滤条件;sourceField 必须属于数据来源,operator 必须适用于该字段类型。固定值请使用 literal operand,不要直接声明后端 matchRules。",
+      "description": "一条数据关联过滤条件;sourceField 必须属于数据来源,operator 必须适用于该字段类型。固定值请使用 literal operand,不要直接声明后端 matchRules。sourceField 省略为存量读回形态(历史脏公式的源字段缺失,如 #queId_0$,写回时以 queId=0 透传),新建条件应提供 sourceField。",
       "properties": {
         "operand": {
           "$ref": "#/$defs/DataRelationOperand",
@@ -265,11 +265,10 @@
         },
         "sourceField": {
           "$ref": "#/$defs/FieldSelector",
-          "description": "被过滤的数据源字段。"
+          "description": "被过滤的数据源字段;存量读回形态可能缺失(后端反解析出的条件源字段 queId=0 且无名称)。"
         }
       },
       "required": [
-        "sourceField",
         "operator",
         "operand"
       ],
@@ -277,7 +276,7 @@
     },
     "DataRelationConfig": {
       "additionalProperties": false,
-      "description": "数据关联字段配置;从应用、Q-Linker 或代码块输出中读取数据。",
+      "description": "数据关联字段配置;从应用、Q-Linker 或代码块输出中读取数据。source 省略表示该字段当前无关联来源配置(存量表单读回形态:后端 GET 对 displayed 目标缺失的 relation 行不回传,FormSvcImpl#getQuestionRelationsBeans continue 分支;新建数据关联字段应提供 source)。",
       "properties": {
         "aggregation": {
           "description": "可选聚合方式;null 表示不聚合。",
@@ -312,12 +311,10 @@
         },
         "source": {
           "$ref": "#/$defs/DataRelationSource",
-          "description": "数据来源;按 kind 选择一种来源结构。"
+          "description": "数据来源;按 kind 选择一种来源结构。存量读回形态可能无 source(后端读面不回传关联配置),此时写回不重建该字段的关联。"
         }
       },
-      "required": [
-        "source"
-      ],
+      "required": [],
       "type": "object"
     },
     "DataRelationCustomButton": {
@@ -989,7 +986,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },
@@ -1010,13 +1007,9 @@
           "type": "string"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
-          "enum": [
-            25,
-            50,
-            75,
-            100
-          ],
+          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
+          "maximum": 100,
+          "minimum": 1,
           "type": "integer"
         }
       },
@@ -1036,10 +1029,10 @@
           ]
         }
       ],
-      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
       "properties": {
         "name": {
-          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
           "minLength": 1,
           "type": "string"
         },
@@ -1401,7 +1394,7 @@
     },
     "RelationConfig": {
       "additionalProperties": false,
-      "description": "引用字段配置;引用其他应用中的数据。",
+      "description": "引用字段配置;引用其他应用中的数据。展示字段与权限以 displayFields 为准(后端 referQuestions 全量有序回写,queAuth 1=可编辑/2=隐藏/3=仅可见);displayField/visibleFields 为已废弃旧形态,apply 兼容接收一个版本窗口(displayField 同时视为双向绑定目标)。",
       "properties": {
         "beingDefaultFormulaAutoFillEnabled": {
           "description": "是否启用引用字段的默认值公式自动填充。",
@@ -1439,7 +1432,32 @@
         },
         "displayField": {
           "$ref": "#/$defs/FieldSelector",
-          "description": "引用值的主展示字段。"
+          "description": "已废弃:主展示字段;apply 兼容翻译为 twoWayBoundField + displayFields 首项,后续版本移除。"
+        },
+        "displayFields": {
+          "description": "有序展示字段全量列表(含隐藏字段),按 ordinal 保序回写为后端 referQuestions。可为空列表:空 = 双向绑定未配展示字段的合法存量形态(后端写链路对空 referQuestions 跳过插入、读面容忍空),round-trip 空↔空稳定;与已废弃 displayField/visibleFields 不可混用,条目 queId 不可重复。",
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "auth": {
+                "default": "visible",
+                "description": "展示字段权限;editable=可编辑(1), hidden=隐藏(2), visible=仅可见(3);缺失按 visible。",
+                "enum": [
+                  "editable",
+                  "hidden",
+                  "visible"
+                ]
+              },
+              "field": {
+                "$ref": "#/$defs/FieldSelector"
+              }
+            },
+            "required": [
+              "field"
+            ],
+            "type": "object"
+          },
+          "type": "array"
         },
         "relationMode": {
           "default": "single",
@@ -1454,8 +1472,19 @@
           "minLength": 1,
           "type": "string"
         },
+        "twoWayBoundField": {
+          "description": "双向引用绑定的目标字段(后端 referQueId);null/省略 = 单向引用。get 读面在 referQueId 非空时必产出。",
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/FieldSelector"
+            }
+          ]
+        },
         "visibleFields": {
-          "description": "引用选择界面额外展示的字段。",
+          "description": "已废弃:额外展示字段;apply 兼容翻译为 displayFields 后续项,后续版本移除。",
           "items": {
             "$ref": "#/$defs/FieldSelector"
           },
@@ -1464,8 +1493,7 @@
         }
       },
       "required": [
-        "targetAppKey",
-        "displayField"
+        "targetAppKey"
       ],
       "type": "object"
     },
@@ -1584,7 +1612,10 @@
                   "$ref": "#/$defs/NumberConfig"
                 },
                 "questionType": {
-                  "const": "number"
+                  "enum": [
+                    "number",
+                    "amount"
+                  ]
                 }
               },
               "required": [
@@ -1597,7 +1628,10 @@
                   "$ref": "#/$defs/EmptyConfig"
                 },
                 "questionType": {
-                  "const": "date"
+                  "enum": [
+                    "date",
+                    "datetime"
+                  ]
                 }
               },
               "required": [

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/text.json

@@ -78,7 +78,7 @@
           "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
         },
         "name": {
-          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同父级允许同名(后端以 queId 为字段身份),配置引用建议携带 queId。",
           "minLength": 1,
           "type": "string"
         },
@@ -99,13 +99,9 @@
           "type": "string"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
-          "enum": [
-            25,
-            50,
-            75,
-            100
-          ],
+          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
+          "maximum": 100,
+          "minimum": 1,
           "type": "integer"
         }
       },

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/formula.json

@@ -236,6 +236,28 @@
         "DATEDELTA(date, number, unit)"
       ]
     },
+    "DATEDIF": {
+      "category": "date",
+      "example": "DATEDIF(#queId_102$, #queId_101$)",
+      "meaning": "历史日期差函数名，仅存在于存量公式中（当前公式引擎未注册，日期差请使用 DAYS(end, start)）。为使存量声明的 validate/round-trip 通过而保留声明，不建议新公式使用。",
+      "parameters": [
+        {
+          "description": "结束日期或列表",
+          "name": "end"
+        },
+        {
+          "description": "开始日期或列表",
+          "name": "start"
+        }
+      ],
+      "returns": {
+        "description": "天数差文本列表",
+        "type": "list"
+      },
+      "signatures": [
+        "DATEDIF(end, start)"
+      ]
+    },
     "DATETOTIMESTAMP": {
       "category": "date",
       "example": "DATETOTIMESTAMP(#queId_101$)",
@@ -363,6 +385,19 @@
         "GETUSEREMAIL()"
       ]
     },
+    "GETUSERENAME": {
+      "category": "context",
+      "example": "GETUSERENAME()",
+      "meaning": "历史拼写（GETUSERNAME 的讹写），仅存在于存量公式中（当前公式引擎未注册，请使用 GETUSERNAME()）。为使存量声明的 validate/round-trip 通过而保留声明，不建议新公式使用。",
+      "parameters": [],
+      "returns": {
+        "description": "当前用户显示名称；无法取得时为空字符串",
+        "type": "string"
+      },
+      "signatures": [
+        "GETUSERENAME()"
+      ]
+    },
     "GETUSERNAME": {
       "category": "context",
       "example": "GETUSERNAME()",
@@ -1590,5 +1625,13 @@
       "需要拼接字段当前值时，将该字段的实际 queId 写成未加引号的 #queId_<字段ID>$；字段 name、字段标题和字段默认值都不能替代字段引用。",
       "新建应用的同一次 create 声明中尚未获得 queId 时，不得虚构 queId 或以字段 name 代替：先创建字段，app_form_get 回读实际 queId 后，再提交公式默认值更新。"
     ]
+  },
+  "x-qingflow-validation": {
+    "functionCallPolicy": "validate 会识别公式文本中引号外的 函数名( 调用；函数名必须在 x-qingflow-functions 中声明。未知函数会被拒绝，字符串字面量中的 NAME() 不视为函数调用。",
+    "scope": [
+      "defaultType=3 的 defaultValue",
+      "config.defaultValueFormula",
+      "data_relation config.filters.mode=advanced 的 config.filters.formula"
+    ]
   }
 }

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/summary.json

@@ -136,10 +136,10 @@
           ]
         }
       ],
-      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "description": "字段选择器;用于定位应用的数据标题、数据封面、自定义编号取值来源或其他配置引用的字段。至少提供 queId 或 name,两者同时提供时必须指向同一字段。后端允许同父级同名字段,queId 是稳定身份;name 仅在唯一时可解析,命中多个同名时报 AMBIGUOUS_FIELD_SELECTOR,此时必须改用 queId。",
       "properties": {
         "name": {
-          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析,同名命中多个字段时报 AMBIGUOUS_FIELD_SELECTOR,应改用 queId。",
           "minLength": 1,
           "type": "string"
         },
@@ -258,13 +258,9 @@
           "type": "array"
         },
         "width": {
-          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
-          "enum": [
-            25,
-            50,
-            75,
-            100
-          ],
+          "description": "字段在所在行的宽度百分比(1-100 整数);后端不校验总和与取值,存量数据存在 33/34 等三等分布值。",
+          "maximum": 100,
+          "minimum": 1,
           "type": "integer"
         }
       },
@@ -334,11 +330,10 @@
           "description": "段落判别值。"
         },
         "rows": {
-          "description": "段落内的非空有序字段行。",
+          "description": "段落内的有序字段行;可为空数组(空 = 存量空段落形态,后端容忍,round-trip 空↔空稳定)。",
           "items": {
             "$ref": "#/$defs/FieldRow"
           },
-          "minItems": 1,
           "type": "array"
         },
         "sectionId": {
@@ -383,7 +378,6 @@
             ],
             "type": "object"
           },
-          "minItems": 1,
           "type": "array"
         },
         "sectionId": {
@@ -695,6 +689,7 @@
   "x-qingflow-supported-field-types": [
     "text",
     "long_text",
+    "rich_text",
     "number",
     "amount",
     "link",

package/src/qingflow_mcp/builder_facade/service.py

@@ -163,9 +163,14 @@ FIELD_TYPE_TO_QUESTION_TYPE: dict[str, int] = {
     FieldType.relation.value: 25,
 }
 
+# code_block / q_linker 输出目标字段类型。后端写链无类型白名单(FormSvcImpl 原样
+# 落库),运行时 DataSvcImpl.getAnswerValueByString:attachment 按拆分 URL 写入、
+# subtable 整表组装(均有专门分支),rich_text/data_relation 走 Question.canImport
+# 兜底按字符串写入(不报错)——四者为存量合法配置,与 validator 侧白名单同口径。
 INTEGRATION_OUTPUT_TARGET_FIELD_TYPES: tuple[str, ...] = (
     FieldType.text.value,
     FieldType.long_text.value,
+    "rich_text",
     FieldType.number.value,
     FieldType.amount.value,
     FieldType.date.value,
@@ -173,6 +178,9 @@ INTEGRATION_OUTPUT_TARGET_FIELD_TYPES: tuple[str, ...] = (
     FieldType.single_select.value,
     FieldType.multi_select.value,
     FieldType.boolean.value,
+    FieldType.attachment.value,
+    "data_relation",
+    FieldType.subtable.value,
 )
 
 MATCH_TYPE_ACCURACY = 1
@@ -23237,6 +23245,23 @@ def _apply_field_mutation(field: dict[str, Any], mutation: Any) -> None:
         field.pop("_question_rebuild_required", None)
 
 
+class AmbiguousFieldSelector(ValueError):
+    """name-only selector 命中多个同名字段。
+
+    方案 A(duplicate-field-name):后端以 queId 为字段身份、允许同父级同名;
+    name 命中多个字段时禁止静默取第一个,必须显式失败并给出候选 queId。
+    compiler 包装层(app_form)把它转写为 AMBIGUOUS_FIELD_SELECTOR 错误码。
+    """
+
+    def __init__(self, location: str, candidates: list[int]) -> None:
+        self.location = location
+        self.candidates = candidates
+        super().__init__(
+            f"{location} matches multiple fields with the same name; "
+            f"use queId to disambiguate (candidate queIds: {sorted(candidates)})"
+        )
+
+
 def _resolve_field_selector_with_uniqueness(
     *,
     fields: list[dict[str, Any]],
@@ -23252,7 +23277,12 @@ def _resolve_field_selector_with_uniqueness(
         name = str(selector.name or "").strip()
         matched = [field for field in fields if str(field.get("name") or "").strip() == name]
         if len(matched) > 1:
-            raise ValueError(f"{location} matched multiple fields with the same name; use field_id or que_id")
+            candidate_ids = [
+                ref
+                for candidate in matched
+                if (ref := _coerce_any_int(candidate.get("que_id"))) is not None
+            ]
+            raise AmbiguousFieldSelector(location, candidate_ids)
     else:
         matched = []
     if len(matched) != 1:
@@ -29932,6 +29962,14 @@ def _build_view_update_payload(
         payload["viewgraphType"] = "calendarView"
         payload["beingShowTitleQue"] = True
         payload.pop("groupQueId", None)
+    elif normalized_type == "hierarchy":
+        payload["viewgraphType"] = "hierarchyView"
+        payload["beingShowTitleQue"] = True
+        payload.pop("groupQueId", None)
+    elif normalized_type == "calendar":
+        payload["viewgraphType"] = "calendarView"
+        payload["beingShowTitleQue"] = True
+        payload.pop("groupQueId", None)
     return _hydrate_view_backend_payload(
         payload=payload,
         view_type=normalized_type,

package/src/qingflow_mcp/cli/commands/data.py

@@ -20,6 +20,8 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
               items.json    [{"fields": {"101": "A"}}]
               fields.json   {"101": "B"}
             query/get/insert/update 默认返回 field_capabilities；可用 --no-schema 关闭。
+            下载附件：data get --app-key APP_KEY --record-id RECORD_ID --download-attachments，
+            从 file_assets.items[].local_path 获取本地文件。
         """).strip(),
     )
     commands = parser.add_subparsers(dest="data_command", required=True, metavar="{query,get,insert,update,delete}")
@@ -27,7 +29,9 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     query = commands.add_parser(
         "query", help="分页查询应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog='最小示例：qingflow data query --app-key APP_1 --where-file where.json\n'
-               'where.json: [{"field_id": 101, "op": "eq", "value": "A"}]',
+               'where.json: [{"field_id": 101, "op": "eq", "value": "A"}]\n'
+               '查询不下载附件；对目标记录执行 data get --app-key APP_KEY --record-id RECORD_ID\n'
+               '--download-attachments，使用 file_assets.items[].local_path。',
     )
     query.add_argument("--app-key", required=True)
     query.add_argument("--columns-file", help='JSON 数组，例如 [101, 102]')
@@ -44,10 +48,15 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     query.add_argument("--output", choices=("json", "csv"), default="json")
     query.set_defaults(handler=_handle_query, format_hint="data_query")
 
-    get = commands.add_parser("get", help="读取单条应用数据")
+    get = commands.add_parser(
+        "get", help="读取单条应用数据", formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog='默认只读取字段；下载附件或图片时加 --download-attachments，并保留 schema。\n'
+               '使用 file_assets.items[].local_path；部分下载失败时读取 file_assets.warnings。',
+    )
     get.add_argument("--app-key", required=True)
     get.add_argument("--record-id", required=True)
     get.add_argument("--no-schema", action="store_false", dest="include_schema", default=True)
+    get.add_argument("--download-attachments", action="store_true", help="下载当前记录可见附件到本地（需要 schema）")
     get.set_defaults(handler=_handle_get, format_hint="data_get")
 
     insert = commands.add_parser(
@@ -102,7 +111,8 @@ def _handle_query(args: argparse.Namespace, context: CliContext) -> dict:
 
 def _handle_get(args: argparse.Namespace, context: CliContext) -> dict:
     return context.data.data_get(
-        profile=args.profile, app_key=args.app_key, record_id=args.record_id, include_schema=args.include_schema
+        profile=args.profile, app_key=args.app_key, record_id=args.record_id, include_schema=args.include_schema,
+        download_attachments=args.download_attachments,
     )
 
 

package/src/qingflow_mcp/cli/formatters.py

@@ -137,6 +137,13 @@ def _format_data_result(result: dict[str, Any]) -> str:
     record = result.get("record") if isinstance(result.get("record"), dict) else {}
     if record:
         lines.append(f"Record ID: {record.get('record_id') or '-'}")
+    file_assets = result.get("file_assets")
+    if isinstance(file_assets, dict):
+        lines.append(f"Attachments: {file_assets.get('status') or '-'}")
+        for asset in file_assets.get("items", []):
+            if isinstance(asset, dict):
+                lines.append(f"- {asset.get('file_name')}: {asset.get('access_status')} / {asset.get('local_path') or '-'}")
+        _append_warnings(lines, file_assets.get("warnings"))
     items = result.get("items") if isinstance(result.get("items"), list) else []
     if items:
         lines.append(f"Items: {len(items)}")

package/src/qingflow_mcp/cli/main.py

@@ -7,11 +7,22 @@ import sys
 from typing import Any, Callable, TextIO
 
 from ..errors import QingflowApiError, backend_code_value_int, message_looks_like_invalid_token
-from ..public_surface import cli_public_tool_spec_from_namespace
+from ..public_surface import (
+    NON_TOOL_CLI_HANDLER_ROUTES,
+    cli_public_tool_spec_from_namespace,
+    cli_route_from_namespace,
+    cli_trim_key_from_namespace,
+)
 from ..resource_uri import cli_resource_base_url
 from ..response_trim import resolve_cli_tool_name, trim_error_response, trim_public_response
 from ..tools.ai_builder_tools import _attach_builder_apply_envelope
 from ..version import get_cli_version, get_cli_version_info
+from ..tool_policy import (
+    TOOL_POLICY_ENV,
+    TOOL_POLICY_INVALID,
+    ToolPolicyViolation,
+    parse_tool_policy,
+)
 from .context import CliContext, build_cli_context
 from .formatters import emit_json_result, emit_text_result
 from .commands import register_all_commands
@@ -90,6 +101,14 @@ def run(
     if handler is None:
         parser.print_help(out)
         return 2
+    violation = _cli_tool_policy_violation(args)
+    if violation is not None:
+        return _emit_error(
+            violation.payload(),
+            json_mode=bool(args.json),
+            stdout=out,
+            stderr=err,
+        )
     try:
         if _should_force_json_output(args):
             setattr(args, "json", True)
@@ -122,6 +141,20 @@ def run(
     return exit_code
 
 
+def _cli_tool_policy_violation(args: argparse.Namespace) -> ToolPolicyViolation | None:
+    stable_id = cli_trim_key_from_namespace(args)
+    if stable_id is None:
+        # 仅显式登记的非业务分发器可跳过闸门；无子命令的新增 handler 也必须默认拒绝。
+        if cli_route_from_namespace(args) in NON_TOOL_CLI_HANDLER_ROUTES:
+            return None
+        return ToolPolicyViolation(
+            TOOL_POLICY_INVALID,
+            "user:unregistered",
+            "CLI 业务命令未登记稳定工具 ID",
+        )
+    return parse_tool_policy(os.getenv(TOOL_POLICY_ENV)).violation_for(stable_id)
+
+
 def _handle_version(_args: argparse.Namespace, _context: CliContext) -> dict[str, Any]:
     info = get_cli_version_info()
     return {

package/src/qingflow_mcp/cloud_context.py

@@ -2,11 +2,14 @@ from __future__ import annotations
 
 from contextvars import ContextVar
 from dataclasses import dataclass, field
-from typing import Callable
+from typing import TYPE_CHECKING, Callable
 
 from .backend_client import BackendRequestContext
 from .session_store import BackendSession, SessionProfile
 
+if TYPE_CHECKING:
+    from .tool_policy import ToolPolicySnapshot
+
 
 CLOUD_PROFILE_NAME = "__cloud_mcp__"
 
@@ -73,3 +76,15 @@ current_call_platform: ContextVar[str] = ContextVar(
     "qingflow_mcp_current_call_platform",
     default="",
 )
+
+# 远端 MCP 每个 HTTP 请求独立绑定策略原文；缺头用 None 表示，不回退进程环境变量。
+current_tool_policy_header: ContextVar[str | None] = ContextVar(
+    "qingflow_mcp_current_tool_policy_header",
+    default=None,
+)
+
+# 在 HTTP 入口合成一次快照，列表与调用共用，避免将 URL 选择保存到会话或共享环境。
+current_http_tool_policy: ContextVar[ToolPolicySnapshot | None] = ContextVar(
+    "qingflow_mcp_current_http_tool_policy",
+    default=None,
+)