@social-data/social-neuron-subscription 1.0.12 → 1.0.13

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "revision": 9,
+  "revision": 10,
   "capability": "subscription",
   "command": "social-neuron-subscription",
   "default_action": null,
@@ -212,23 +212,28 @@
                 "type": "string"
               },
               "host": {
-                "description": "SFTP 主机",
+                "description": "SFTP 主机,不能为空白",
+                "minLength": 1,
                 "title": "Host",
                 "type": "string"
               },
               "port": {
                 "default": 22,
-                "description": "端口,默认 22",
+                "description": "端口,1–65535,默认 22",
+                "maximum": 65535,
+                "minimum": 1,
                 "title": "Port",
                 "type": "integer"
               },
               "username": {
-                "description": "登录用户名",
+                "description": "登录用户名,不能为空白",
+                "minLength": 1,
                 "title": "Username",
                 "type": "string"
               },
               "password": {
-                "description": "登录密码",
+                "description": "登录密码,不能为空白,保留首尾空格",
+                "minLength": 1,
                 "title": "Password",
                 "type": "string"
               },
@@ -301,6 +306,12 @@
         },
         "additionalProperties": false,
         "properties": {
+          "confirmed": {
+            "default": false,
+            "description": "是否已确认继续并同意系统超限处理规则；超量时默认拒绝，true 允许保存但仍按上限截断；不跳过其他校验，不保存到 job，TopN 不适用",
+            "title": "Confirmed",
+            "type": "boolean"
+          },
           "name": {
             "description": "job 名称,同一凭证(token)下唯一",
             "maxLength": 128,
@@ -370,7 +381,7 @@
             "type": "string"
           },
           "fields": {
-            "description": "拉取/导出字段;不填拉全量",
+            "description": "_id 自动输出，禁止在 fields 中填写；拉取/导出字段;不填拉全量",
             "items": {
               "minLength": 1,
               "type": "string"
@@ -381,7 +392,7 @@
           "size": {
             "anyOf": [
               {
-                "maximum": 500000,
+                "maximum": 2147483647,
                 "minimum": 1,
                 "type": "integer"
               },
@@ -390,7 +401,7 @@
               }
             ],
             "default": null,
-            "description": "每次执行最多导出的记录行数。省略则按模式取默认:取全部命中 500,000(同时是上限);传了 top(只取前 N 条)则默认 1,000、上限 10,000",
+            "description": "每次执行最多导出的记录行数。省略则按模式取默认:普通批量默认最多 500000 条，实际以服务端当前约束为准;传了 top(只取前 N 条)则默认 1,000、上限 10,000",
             "title": "Size"
           },
           "target": {
@@ -452,9 +463,115 @@
         "type": "object"
       },
       "output_schema": {
+        "$defs": {
+          "PrecheckResult": {
+            "additionalProperties": false,
+            "properties": {
+              "checked_at": {
+                "description": "检查时间，东八区 ISO 时间",
+                "title": "Checked At",
+                "type": "string"
+              },
+              "windows": {
+                "additionalProperties": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "description": "发布时间、入库时间、更新时间三个维度的绝对闭区间；空表示不过滤",
+                "title": "Windows",
+                "type": "object"
+              },
+              "matched_rows": {
+                "description": "命中行数；count_relation=gte 时为下界，非精确总量",
+                "title": "Matched Rows",
+                "type": "integer"
+              },
+              "count_relation": {
+                "description": "eq=精确计数；gte=至少命中该数量",
+                "enum": [
+                  "eq",
+                  "gte"
+                ],
+                "title": "Count Relation",
+                "type": "string"
+              },
+              "system_limit": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "普通批量的系统导出上限；TopN 未执行预检时为空",
+                "title": "System Limit"
+              },
+              "effective_limit": {
+                "description": "本次生效的单次最大导出行数",
+                "title": "Effective Limit",
+                "type": "integer"
+              },
+              "would_truncate": {
+                "description": "当前统计是否超出有效导出数量；TopN 不新增预检",
+                "title": "Would Truncate",
+                "type": "boolean"
+              },
+              "checked": {
+                "default": true,
+                "description": "是否执行数据量统计；TopN 为 false",
+                "title": "Checked",
+                "type": "boolean"
+              },
+              "message": {
+                "description": "数量提示及调整参数或确认继续的说明",
+                "title": "Message",
+                "type": "string"
+              }
+            },
+            "required": [
+              "checked_at",
+              "windows",
+              "matched_rows",
+              "count_relation",
+              "system_limit",
+              "effective_limit",
+              "would_truncate",
+              "message"
+            ],
+            "title": "PrecheckResult",
+            "type": "object"
+          }
+        },
         "additionalProperties": false,
         "description": "订阅 job 出参对象。",
         "properties": {
+          "precheck": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/PrecheckResult"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "本次保存的数据量预检摘要；非预检场景为空，不保存到 job"
+          },
+          "warnings": {
+            "description": "本次保存的超量截断提醒；未超量为空，不保存到 job",
+            "items": {
+              "type": "string"
+            },
+            "title": "Warnings",
+            "type": "array"
+          },
           "job_id": {
             "description": "job ID",
             "title": "Job Id",
@@ -511,7 +628,7 @@
             "title": "Udate"
           },
           "fields": {
-            "description": "拉取/导出字段(空=全量)",
+            "description": "_id 自动输出，禁止在 fields 中填写；拉取/导出字段(空=全量)",
             "items": {
               "type": "string"
             },
@@ -519,7 +636,7 @@
             "type": "array"
           },
           "size": {
-            "description": "每次执行最多导出的记录行数;取全部命中时上限 500000,只取前 N 条时上限 10000",
+            "description": "每次执行最多导出的记录行数；普通批量保存时按系统配置校验，只取前 N 条时上限 10000",
             "title": "Size",
             "type": "integer"
           },
@@ -599,6 +716,13 @@
         "type": "object"
       },
       "flags": [
+        {
+          "flag": "--confirmed",
+          "field": "confirmed",
+          "type": "boolean",
+          "required": false,
+          "desc": "是否已确认继续并同意系统超限处理规则；超量时默认拒绝，true 允许保存但仍按上限截断；不跳过其他校验，不保存到 job，TopN 不适用"
+        },
         {
           "flag": "--name",
           "field": "name",
@@ -653,14 +777,14 @@
           "field": "fields",
           "type": "list[str](json)",
           "required": false,
-          "desc": "拉取/导出字段;不填拉全量"
+          "desc": "_id 自动输出，禁止在 fields 中填写；拉取/导出字段;不填拉全量"
         },
         {
           "flag": "--size",
           "field": "size",
           "type": "integer",
           "required": false,
-          "desc": "每次执行最多导出的记录行数。省略则按模式取默认:取全部命中 500,000(同时是上限);传了 top(只取前 N 条)则默认 1,000、上限 10,000"
+          "desc": "每次执行最多导出的记录行数。省略则按模式取默认:普通批量默认最多 500000 条，实际以服务端当前约束为准;传了 top(只取前 N 条)则默认 1,000、上限 10,000"
         },
         {
           "flag": "--target",
@@ -786,10 +910,114 @@
       },
       "output_schema": {
         "$defs": {
+          "PrecheckResult": {
+            "additionalProperties": false,
+            "properties": {
+              "checked_at": {
+                "description": "检查时间，东八区 ISO 时间",
+                "title": "Checked At",
+                "type": "string"
+              },
+              "windows": {
+                "additionalProperties": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "description": "发布时间、入库时间、更新时间三个维度的绝对闭区间；空表示不过滤",
+                "title": "Windows",
+                "type": "object"
+              },
+              "matched_rows": {
+                "description": "命中行数；count_relation=gte 时为下界，非精确总量",
+                "title": "Matched Rows",
+                "type": "integer"
+              },
+              "count_relation": {
+                "description": "eq=精确计数；gte=至少命中该数量",
+                "enum": [
+                  "eq",
+                  "gte"
+                ],
+                "title": "Count Relation",
+                "type": "string"
+              },
+              "system_limit": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "普通批量的系统导出上限；TopN 未执行预检时为空",
+                "title": "System Limit"
+              },
+              "effective_limit": {
+                "description": "本次生效的单次最大导出行数",
+                "title": "Effective Limit",
+                "type": "integer"
+              },
+              "would_truncate": {
+                "description": "当前统计是否超出有效导出数量；TopN 不新增预检",
+                "title": "Would Truncate",
+                "type": "boolean"
+              },
+              "checked": {
+                "default": true,
+                "description": "是否执行数据量统计；TopN 为 false",
+                "title": "Checked",
+                "type": "boolean"
+              },
+              "message": {
+                "description": "数量提示及调整参数或确认继续的说明",
+                "title": "Message",
+                "type": "string"
+              }
+            },
+            "required": [
+              "checked_at",
+              "windows",
+              "matched_rows",
+              "count_relation",
+              "system_limit",
+              "effective_limit",
+              "would_truncate",
+              "message"
+            ],
+            "title": "PrecheckResult",
+            "type": "object"
+          },
           "SubJob": {
             "additionalProperties": false,
             "description": "订阅 job 出参对象。",
             "properties": {
+              "precheck": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/PrecheckResult"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "本次保存的数据量预检摘要；非预检场景为空，不保存到 job"
+              },
+              "warnings": {
+                "description": "本次保存的超量截断提醒；未超量为空，不保存到 job",
+                "items": {
+                  "type": "string"
+                },
+                "title": "Warnings",
+                "type": "array"
+              },
               "job_id": {
                 "description": "job ID",
                 "title": "Job Id",
@@ -846,7 +1074,7 @@
                 "title": "Udate"
               },
               "fields": {
-                "description": "拉取/导出字段(空=全量)",
+                "description": "_id 自动输出，禁止在 fields 中填写；拉取/导出字段(空=全量)",
                 "items": {
                   "type": "string"
                 },
@@ -854,7 +1082,7 @@
                 "type": "array"
               },
               "size": {
-                "description": "每次执行最多导出的记录行数;取全部命中时上限 500000,只取前 N 条时上限 10000",
+                "description": "每次执行最多导出的记录行数；普通批量保存时按系统配置校验，只取前 N 条时上限 10000",
                 "title": "Size",
                 "type": "integer"
               },
@@ -1068,23 +1296,28 @@
                 "type": "string"
               },
               "host": {
-                "description": "SFTP 主机",
+                "description": "SFTP 主机,不能为空白",
+                "minLength": 1,
                 "title": "Host",
                 "type": "string"
               },
               "port": {
                 "default": 22,
-                "description": "端口,默认 22",
+                "description": "端口,1–65535,默认 22",
+                "maximum": 65535,
+                "minimum": 1,
                 "title": "Port",
                 "type": "integer"
               },
               "username": {
-                "description": "登录用户名",
+                "description": "登录用户名,不能为空白",
+                "minLength": 1,
                 "title": "Username",
                 "type": "string"
               },
               "password": {
-                "description": "登录密码",
+                "description": "登录密码,不能为空白,保留首尾空格",
+                "minLength": 1,
                 "title": "Password",
                 "type": "string"
               },
@@ -1254,7 +1487,7 @@
           "size": {
             "anyOf": [
               {
-                "maximum": 500000,
+                "maximum": 2147483647,
                 "minimum": 1,
                 "type": "integer"
               },
@@ -1263,7 +1496,7 @@
               }
             ],
             "default": null,
-            "description": "覆盖本次导出行数;不传则继承 job 的 size,最大 500000",
+            "description": "覆盖本次导出行数；不传继承 job.size 并按系统当前上限收紧，显式超限拒绝",
             "title": "Size"
           }
         },
@@ -1356,7 +1589,7 @@
           "field": "size",
           "type": "integer",
           "required": false,
-          "desc": "覆盖本次导出行数;不传则继承 job 的 size,最大 500000"
+          "desc": "覆盖本次导出行数；不传继承 job.size 并按系统当前上限收紧，显式超限拒绝"
         }
       ],
       "transport": {
@@ -1461,23 +1694,28 @@
                 "type": "string"
               },
               "host": {
-                "description": "SFTP 主机",
+                "description": "SFTP 主机,不能为空白",
+                "minLength": 1,
                 "title": "Host",
                 "type": "string"
               },
               "port": {
                 "default": 22,
-                "description": "端口,默认 22",
+                "description": "端口,1–65535,默认 22",
+                "maximum": 65535,
+                "minimum": 1,
                 "title": "Port",
                 "type": "integer"
               },
               "username": {
-                "description": "登录用户名",
+                "description": "登录用户名,不能为空白",
+                "minLength": 1,
                 "title": "Username",
                 "type": "string"
               },
               "password": {
-                "description": "登录密码",
+                "description": "登录密码,不能为空白,保留首尾空格",
+                "minLength": 1,
                 "title": "Password",
                 "type": "string"
               },
@@ -1550,6 +1788,12 @@
         },
         "additionalProperties": false,
         "properties": {
+          "confirmed": {
+            "default": false,
+            "description": "是否已确认继续并同意系统超限处理规则；修改取数配置超量时默认拒绝，true 允许保存但仍按上限截断；仅本次有效，TopN 不适用",
+            "title": "Confirmed",
+            "type": "boolean"
+          },
           "job_id": {
             "description": "目标 job",
             "title": "Job Id",
@@ -1662,13 +1906,13 @@
               }
             ],
             "default": null,
-            "description": "整组全量覆盖",
+            "description": "业务字段整组全量覆盖；_id 自动输出，禁止在 fields 中填写",
             "title": "Fields"
           },
           "size": {
             "anyOf": [
               {
-                "maximum": 500000,
+                "maximum": 2147483647,
                 "minimum": 1,
                 "type": "integer"
               },
@@ -1677,7 +1921,7 @@
               }
             ],
             "default": null,
-            "description": "每次执行最多导出的记录行数;不传则不修改,最大 500000",
+            "description": "每次执行最多导出的记录行数；不传则不修改，普通批量默认上限 500000，TopN 默认上限 10000，实际以上游返回约束为准",
             "title": "Size"
           },
           "frequency": {
@@ -1767,9 +2011,115 @@
         "type": "object"
       },
       "output_schema": {
+        "$defs": {
+          "PrecheckResult": {
+            "additionalProperties": false,
+            "properties": {
+              "checked_at": {
+                "description": "检查时间，东八区 ISO 时间",
+                "title": "Checked At",
+                "type": "string"
+              },
+              "windows": {
+                "additionalProperties": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "description": "发布时间、入库时间、更新时间三个维度的绝对闭区间；空表示不过滤",
+                "title": "Windows",
+                "type": "object"
+              },
+              "matched_rows": {
+                "description": "命中行数；count_relation=gte 时为下界，非精确总量",
+                "title": "Matched Rows",
+                "type": "integer"
+              },
+              "count_relation": {
+                "description": "eq=精确计数；gte=至少命中该数量",
+                "enum": [
+                  "eq",
+                  "gte"
+                ],
+                "title": "Count Relation",
+                "type": "string"
+              },
+              "system_limit": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "普通批量的系统导出上限；TopN 未执行预检时为空",
+                "title": "System Limit"
+              },
+              "effective_limit": {
+                "description": "本次生效的单次最大导出行数",
+                "title": "Effective Limit",
+                "type": "integer"
+              },
+              "would_truncate": {
+                "description": "当前统计是否超出有效导出数量；TopN 不新增预检",
+                "title": "Would Truncate",
+                "type": "boolean"
+              },
+              "checked": {
+                "default": true,
+                "description": "是否执行数据量统计；TopN 为 false",
+                "title": "Checked",
+                "type": "boolean"
+              },
+              "message": {
+                "description": "数量提示及调整参数或确认继续的说明",
+                "title": "Message",
+                "type": "string"
+              }
+            },
+            "required": [
+              "checked_at",
+              "windows",
+              "matched_rows",
+              "count_relation",
+              "system_limit",
+              "effective_limit",
+              "would_truncate",
+              "message"
+            ],
+            "title": "PrecheckResult",
+            "type": "object"
+          }
+        },
         "additionalProperties": false,
         "description": "订阅 job 出参对象。",
         "properties": {
+          "precheck": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/PrecheckResult"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "本次保存的数据量预检摘要；非预检场景为空，不保存到 job"
+          },
+          "warnings": {
+            "description": "本次保存的超量截断提醒；未超量为空，不保存到 job",
+            "items": {
+              "type": "string"
+            },
+            "title": "Warnings",
+            "type": "array"
+          },
           "job_id": {
             "description": "job ID",
             "title": "Job Id",
@@ -1826,7 +2176,7 @@
             "title": "Udate"
           },
           "fields": {
-            "description": "拉取/导出字段(空=全量)",
+            "description": "_id 自动输出，禁止在 fields 中填写；拉取/导出字段(空=全量)",
             "items": {
               "type": "string"
             },
@@ -1834,7 +2184,7 @@
             "type": "array"
           },
           "size": {
-            "description": "每次执行最多导出的记录行数;取全部命中时上限 500000,只取前 N 条时上限 10000",
+            "description": "每次执行最多导出的记录行数；普通批量保存时按系统配置校验，只取前 N 条时上限 10000",
             "title": "Size",
             "type": "integer"
           },
@@ -1914,6 +2264,13 @@
         "type": "object"
       },
       "flags": [
+        {
+          "flag": "--confirmed",
+          "field": "confirmed",
+          "type": "boolean",
+          "required": false,
+          "desc": "是否已确认继续并同意系统超限处理规则；修改取数配置超量时默认拒绝，true 允许保存但仍按上限截断；仅本次有效，TopN 不适用"
+        },
         {
           "flag": "--job-id",
           "field": "job_id",
@@ -1968,14 +2325,14 @@
           "field": "fields",
           "type": "list[str](json)",
           "required": false,
-          "desc": "整组全量覆盖"
+          "desc": "业务字段整组全量覆盖；_id 自动输出，禁止在 fields 中填写"
         },
         {
           "flag": "--size",
           "field": "size",
           "type": "integer",
           "required": false,
-          "desc": "每次执行最多导出的记录行数;不传则不修改,最大 500000"
+          "desc": "每次执行最多导出的记录行数；不传则不修改，普通批量默认上限 500000，TopN 默认上限 10000，实际以上游返回约束为准"
         },
         {
           "flag": "--frequency",
@@ -2063,13 +2420,25 @@
         "$defs": {
           "SubField": {
             "additionalProperties": false,
-            "description": "一个可导出字段(**订阅口径**:只给填 ``fields`` 与翻译列值要用的信息)。",
+            "description": "一个字段的订阅口径描述；selectable 区分可选业务字段与自动输出的系统字段。",
             "properties": {
               "name_en": {
-                "description": "字段标识(ES 字段名),即 job_create / job_update 的 fields 该填的值",
+                "description": "字段标识(ES 字段名),仅 selectable=true 时可填入 job_create / job_update 的 fields",
                 "title": "Name En",
                 "type": "string"
               },
+              "field_origin": {
+                "default": "source",
+                "description": "字段来源：source 为业务字段，system 为系统字段",
+                "title": "Field Origin",
+                "type": "string"
+              },
+              "selectable": {
+                "default": true,
+                "description": "是否允许填入 fields；_id 自动输出，不可填写",
+                "title": "Selectable",
+                "type": "boolean"
+              },
               "name": {
                 "description": "字段中文名 —— 把用户说法对齐到 name_en 用",
                 "title": "Name",
@@ -2210,6 +2579,733 @@
         "internal"
       ]
     },
+    {
+      "action": "precheck",
+      "op": "precheck",
+      "name": "subscription/precheck",
+      "summary": "可选预览订阅创建/修改的数据量；正式保存会重新检查，TopN 保持原样。",
+      "description": "可选预览订阅创建/修改的数据量；正式保存会重新检查，TopN 保持原样。",
+      "input_schema": {
+        "$defs": {
+          "KafkaTarget": {
+            "additionalProperties": false,
+            "description": "kafka(规划):把记录流投送到 topic(无文件)。",
+            "properties": {
+              "type": {
+                "const": "kafka",
+                "description": "固定 kafka",
+                "title": "Type",
+                "type": "string"
+              },
+              "brokers": {
+                "description": "broker 列表(逗号分隔)",
+                "title": "Brokers",
+                "type": "string"
+              },
+              "topic": {
+                "description": "目标 topic",
+                "title": "Topic",
+                "type": "string"
+              },
+              "key_field": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "作为消息 key 的字段名",
+                "title": "Key Field"
+              }
+            },
+            "required": [
+              "type",
+              "brokers",
+              "topic"
+            ],
+            "title": "KafkaTarget",
+            "type": "object"
+          },
+          "OctoTarget": {
+            "additionalProperties": false,
+            "description": "octo(本期,默认):导出文件上传 octo 存储,产出 CDN 下载 url(写入 file_info.url)。",
+            "properties": {
+              "type": {
+                "const": "octo",
+                "description": "固定 octo",
+                "title": "Type",
+                "type": "string"
+              },
+              "format": {
+                "default": "json",
+                "description": "文件格式:csv/excel/json(默认 json)",
+                "enum": [
+                  "csv",
+                  "excel",
+                  "json"
+                ],
+                "title": "Format",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "title": "OctoTarget",
+            "type": "object"
+          },
+          "SftpTarget": {
+            "additionalProperties": false,
+            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
+            "properties": {
+              "type": {
+                "const": "sftp",
+                "description": "固定 sftp",
+                "title": "Type",
+                "type": "string"
+              },
+              "host": {
+                "description": "SFTP 主机,不能为空白",
+                "minLength": 1,
+                "title": "Host",
+                "type": "string"
+              },
+              "port": {
+                "default": 22,
+                "description": "端口,1–65535,默认 22",
+                "maximum": 65535,
+                "minimum": 1,
+                "title": "Port",
+                "type": "integer"
+              },
+              "username": {
+                "description": "登录用户名,不能为空白",
+                "minLength": 1,
+                "title": "Username",
+                "type": "string"
+              },
+              "password": {
+                "description": "登录密码,不能为空白,保留首尾空格",
+                "minLength": 1,
+                "title": "Password",
+                "type": "string"
+              },
+              "remote_path": {
+                "description": "远端目录/路径。可在**任意一层**用日期变量,但变量必须**独占一层**:`/data/sub/yyyyMM/yyyyMMdd` 合法,`/data/sub_yyyyMMdd` 非法。只认 yyyyMMdd / yyyyMM / yyyy 三种;不允许 '..'、空目录层。",
+                "title": "Remote Path",
+                "type": "string"
+              },
+              "filename_template": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "自定义文件名模板(不含扩展名)。只允许字母、数字、'_'、'-' 与日期变量,且变量前后必须是 '_' 或首尾:`daily_yyyyMMdd_export`、`yyyyMM_summary` 合法,`dailyyyyyMMdd`、`report-yyyyMMdd-x` 非法。系统统一追加 `_<task_id>` 与扩展名。不传=沿用默认 `<job_id>_<task_id>.<ext>`。",
+                "title": "Filename Template"
+              },
+              "format": {
+                "default": "json",
+                "description": "文件格式:csv/excel/json(默认 json)",
+                "enum": [
+                  "csv",
+                  "excel",
+                  "json"
+                ],
+                "title": "Format",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "host",
+              "username",
+              "password",
+              "remote_path"
+            ],
+            "title": "SftpTarget",
+            "type": "object"
+          },
+          "SubJobCreateInput": {
+            "additionalProperties": false,
+            "properties": {
+              "confirmed": {
+                "default": false,
+                "description": "是否已确认继续并同意系统超限处理规则；超量时默认拒绝，true 允许保存但仍按上限截断；不跳过其他校验，不保存到 job，TopN 不适用",
+                "title": "Confirmed",
+                "type": "boolean"
+              },
+              "name": {
+                "description": "job 名称,同一凭证(token)下唯一",
+                "maxLength": 128,
+                "minLength": 1,
+                "title": "Name",
+                "type": "string"
+              },
+              "rule_ids": {
+                "description": "魔方规则ID数组,至少 1 个",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "title": "Rule Ids",
+                "type": "array"
+              },
+              "source": {
+                "description": "站点数组,至少 1 个;只能取已配置站点",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "title": "Source",
+                "type": "array"
+              },
+              "published": {
+                "description": "**发布时间**口径(必填,主口径 —— 它同时决定查哪个月的索引、怎么拆分片,所以不能缺省)。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。",
+                "pattern": "^(?:T-\\d+~T-\\d+|T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d~T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d)$",
+                "title": "Published",
+                "type": "string"
+              },
+              "idate": {
+                "anyOf": [
+                  {
+                    "pattern": "^(?:T-\\d+~T-\\d+|T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d~T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d)$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "**入库时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 AND 一层:入库时间落在本区间的数据。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。",
+                "title": "Idate"
+              },
+              "udate": {
+                "anyOf": [
+                  {
+                    "pattern": "^(?:T-\\d+~T-\\d+|T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d~T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d)$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "**更新时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 AND 一层:更新时间落在本区间的数据。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。",
+                "title": "Udate"
+              },
+              "frequency": {
+                "description": "自然语言同步频率,系统转 cron(东八区)。可指定具体时间、并**支持一天多次**:如「每天9点」「每天9点和15点」(一天跑两次)「每周一9点」「每小时」「每30分钟」。无法解析为 cron 会被拒绝。",
+                "maxLength": 64,
+                "minLength": 1,
+                "title": "Frequency",
+                "type": "string"
+              },
+              "fields": {
+                "description": "_id 自动输出，禁止在 fields 中填写；拉取/导出字段;不填拉全量",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "title": "Fields",
+                "type": "array"
+              },
+              "size": {
+                "anyOf": [
+                  {
+                    "maximum": 2147483647,
+                    "minimum": 1,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "每次执行最多导出的记录行数。省略则按模式取默认:普通批量默认最多 500000 条，实际以服务端当前约束为准;传了 top(只取前 N 条)则默认 1,000、上限 10,000",
+                "title": "Size"
+              },
+              "target": {
+                "anyOf": [
+                  {
+                    "discriminator": {
+                      "mapping": {
+                        "kafka": "#/$defs/KafkaTarget",
+                        "octo": "#/$defs/OctoTarget",
+                        "sftp": "#/$defs/SftpTarget"
+                      },
+                      "propertyName": "type"
+                    },
+                    "oneOf": [
+                      {
+                        "$ref": "#/$defs/OctoTarget"
+                      },
+                      {
+                        "$ref": "#/$defs/SftpTarget"
+                      },
+                      {
+                        "$ref": "#/$defs/KafkaTarget"
+                      }
+                    ]
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。",
+                "title": "Target"
+              },
+              "top": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "$ref": "#/$defs/TopSpec"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "只取前 N 条(可选)。**不改变筛选条件** —— 省略时给命中条件的全部数据,传了则在同一批命中结果里按指定字段排序、只取前 size 条。排序跨发布窗内所有日期 / 站点 / 规则**全局生效**(不是每天各取 N)。多字段按顺序作排序优先级(前者相同时比后者)。字段必须是可排序类型(keyword / long / double / date)。该模式下 size 默认 1,000、最大 10,000;且多条规则改为 OR 合并并去重,导出的 kw_ruleId 恒为 topN、无法区分来源规则",
+                "title": "Top"
+              }
+            },
+            "required": [
+              "name",
+              "rule_ids",
+              "source",
+              "published",
+              "frequency"
+            ],
+            "title": "SubJobCreateInput",
+            "type": "object"
+          },
+          "SubJobUpdateInput": {
+            "additionalProperties": false,
+            "properties": {
+              "confirmed": {
+                "default": false,
+                "description": "是否已确认继续并同意系统超限处理规则；修改取数配置超量时默认拒绝，true 允许保存但仍按上限截断；仅本次有效，TopN 不适用",
+                "title": "Confirmed",
+                "type": "boolean"
+              },
+              "job_id": {
+                "description": "目标 job",
+                "title": "Job Id",
+                "type": "integer"
+              },
+              "name": {
+                "anyOf": [
+                  {
+                    "maxLength": 128,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "新名称(同一凭证下唯一)",
+                "title": "Name"
+              },
+              "rule_ids": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "minItems": 1,
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "整组全量覆盖",
+                "title": "Rule Ids"
+              },
+              "source": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "minItems": 1,
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "整组全量覆盖",
+                "title": "Source"
+              },
+              "published": {
+                "anyOf": [
+                  {
+                    "pattern": "^(?:T-\\d+~T-\\d+|T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d~T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d)$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "**发布时间**口径(必填字段,只能改不能清)。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。",
+                "title": "Published"
+              },
+              "idate": {
+                "anyOf": [
+                  {
+                    "pattern": "^(?:T-\\d+~T-\\d+|T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d~T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "**入库时间**口径。不传=不改;传空串 \"\"=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。",
+                "title": "Idate"
+              },
+              "udate": {
+                "anyOf": [
+                  {
+                    "pattern": "^(?:T-\\d+~T-\\d+|T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d~T-\\d+@(?:[01]\\d|2[0-3]):[0-5]\\d)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "**更新时间**口径。不传=不改;传空串 \"\"=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。",
+                "title": "Udate"
+              },
+              "fields": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "业务字段整组全量覆盖；_id 自动输出，禁止在 fields 中填写",
+                "title": "Fields"
+              },
+              "size": {
+                "anyOf": [
+                  {
+                    "maximum": 2147483647,
+                    "minimum": 1,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "每次执行最多导出的记录行数；不传则不修改，普通批量默认上限 500000，TopN 默认上限 10000，实际以上游返回约束为准",
+                "title": "Size"
+              },
+              "frequency": {
+                "anyOf": [
+                  {
+                    "maxLength": 64,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "传入则按新频率重算 cron(用法同创建;支持一天多次,如「每天9点和15点」);无法解析为 cron 会被拒绝",
+                "title": "Frequency"
+              },
+              "target": {
+                "anyOf": [
+                  {
+                    "discriminator": {
+                      "mapping": {
+                        "kafka": "#/$defs/KafkaTarget",
+                        "octo": "#/$defs/OctoTarget",
+                        "sftp": "#/$defs/SftpTarget"
+                      },
+                      "propertyName": "type"
+                    },
+                    "oneOf": [
+                      {
+                        "$ref": "#/$defs/OctoTarget"
+                      },
+                      {
+                        "$ref": "#/$defs/SftpTarget"
+                      },
+                      {
+                        "$ref": "#/$defs/KafkaTarget"
+                      }
+                    ]
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "整体替换投递目标",
+                "title": "Target"
+              },
+              "top": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "$ref": "#/$defs/TopSpec"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "只取前 N 条的排序规格:传入则整组替换,不传则不修改。切到该模式后 size 最大 10,000;传空数组 [] 表示改回「给全部命中数据」",
+                "title": "Top"
+              },
+              "active": {
+                "anyOf": [
+                  {
+                    "enum": [
+                      0,
+                      1
+                    ],
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "启停:1 / 0",
+                "title": "Active"
+              }
+            },
+            "required": [
+              "job_id"
+            ],
+            "title": "SubJobUpdateInput",
+            "type": "object"
+          },
+          "TopSpec": {
+            "additionalProperties": false,
+            "description": "全局TopN排序规格(subscription专用)。",
+            "properties": {
+              "field": {
+                "description": "排序字段(name_en);仅支持可排序类型(keyword/long/double/date)",
+                "title": "Field",
+                "type": "string"
+              },
+              "order": {
+                "default": "desc",
+                "description": "排序方向:desc降序(取最大的N个)/asc升序(取最小的N个)",
+                "enum": [
+                  "asc",
+                  "desc"
+                ],
+                "title": "Order",
+                "type": "string"
+              }
+            },
+            "required": [
+              "field"
+            ],
+            "title": "TopSpec",
+            "type": "object"
+          }
+        },
+        "additionalProperties": false,
+        "properties": {
+          "operation": {
+            "description": "预览操作：create 创建或 update 修改",
+            "enum": [
+              "create",
+              "update"
+            ],
+            "title": "Operation",
+            "type": "string"
+          },
+          "create": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/SubJobCreateInput"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "创建业务参数；仅 operation=create 时传入，confirmed 不影响预览"
+          },
+          "update": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/SubJobUpdateInput"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "本人 job_id 和局部修改参数；仅 operation=update 时传入，confirmed 不影响预览"
+          }
+        },
+        "required": [
+          "operation"
+        ],
+        "title": "PrecheckInput",
+        "type": "object"
+      },
+      "output_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "checked_at": {
+            "description": "检查时间，东八区 ISO 时间",
+            "title": "Checked At",
+            "type": "string"
+          },
+          "windows": {
+            "additionalProperties": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "description": "发布时间、入库时间、更新时间三个维度的绝对闭区间；空表示不过滤",
+            "title": "Windows",
+            "type": "object"
+          },
+          "matched_rows": {
+            "description": "命中行数；count_relation=gte 时为下界，非精确总量",
+            "title": "Matched Rows",
+            "type": "integer"
+          },
+          "count_relation": {
+            "description": "eq=精确计数；gte=至少命中该数量",
+            "enum": [
+              "eq",
+              "gte"
+            ],
+            "title": "Count Relation",
+            "type": "string"
+          },
+          "system_limit": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "普通批量的系统导出上限；TopN 未执行预检时为空",
+            "title": "System Limit"
+          },
+          "effective_limit": {
+            "description": "本次生效的单次最大导出行数",
+            "title": "Effective Limit",
+            "type": "integer"
+          },
+          "would_truncate": {
+            "description": "当前统计是否超出有效导出数量；TopN 不新增预检",
+            "title": "Would Truncate",
+            "type": "boolean"
+          },
+          "checked": {
+            "default": true,
+            "description": "是否执行数据量统计；TopN 为 false",
+            "title": "Checked",
+            "type": "boolean"
+          },
+          "message": {
+            "description": "数量提示及调整参数或确认继续的说明",
+            "title": "Message",
+            "type": "string"
+          }
+        },
+        "required": [
+          "checked_at",
+          "windows",
+          "matched_rows",
+          "count_relation",
+          "system_limit",
+          "effective_limit",
+          "would_truncate",
+          "message"
+        ],
+        "title": "PrecheckResult",
+        "type": "object"
+      },
+      "flags": [
+        {
+          "flag": "--operation",
+          "field": "operation",
+          "type": "enum(create、update)",
+          "required": true,
+          "desc": "预览操作：create 创建或 update 修改"
+        },
+        {
+          "flag": "--create",
+          "field": "create",
+          "type": "object(json)",
+          "required": false,
+          "desc": "创建业务参数；仅 operation=create 时传入，confirmed 不影响预览"
+        },
+        {
+          "flag": "--update",
+          "field": "update",
+          "type": "object(json)",
+          "required": false,
+          "desc": "本人 job_id 和局部修改参数；仅 operation=update 时传入，confirmed 不影响预览"
+        }
+      ],
+      "transport": {
+        "method": "POST",
+        "path": "/subscription/precheck",
+        "send": "args"
+      },
+      "errors": [
+        "auth_error",
+        "validation",
+        "api_error",
+        "network",
+        "internal"
+      ]
+    },
     {
       "action": "task-list",
       "op": "task_list",
@@ -2332,7 +3428,7 @@
                 "type": "integer"
               },
               "size": {
-                "description": "本次执行最多导出的记录行数;取全部命中时上限 500000,只取前 N 条时上限 10000",
+                "description": "本次任务记录的导出数量；实际执行受系统当前总量上限约束，TopN 默认上限 10000 条",
                 "title": "Size",
                 "type": "integer"
               },
@@ -2382,7 +3478,7 @@
                   }
                 ],
                 "default": null,
-                "description": "失败原因(status=failed 时给出;成功/进行中为空)",
+                "description": "对外可操作的失败提示;系统异常仅给通用提示,内部细节不返回",
                 "title": "Error Msg"
               },
               "created_at": {
@@ -2505,7 +3601,7 @@
   ],
   "skill": {
     "slug": "social-neuron-subscription",
-    "description": "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task;另有三个只读发现接口:list_sites / list_fields 用于建 job 前对齐站点与字段取值;get_field_values 给出枚举值 / 编码值的中文字典,仅在用户明确要求把导出的码值换成中文时按需取用(换值由调用方拿到数据后自行完成,系统不自动回显)。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②两种取数模式二选一:**默认**给命中条件的全部数据、size 默认且最大 50 万、多规则各自拉(同时命中多条规则的数据会重复出现);传 **top** 则不改筛选条件、只在同一批命中里按指定字段跨全部日期/站点/规则排序后取前 N 条、size 默认 1000 最大 10000、多规则 OR 合并(同时命中多条的只出一份),排序字段只能是 keyword/long/double/date 类型;这与平台自身的热搜/热门榜单无关;③导出数据的 kw_ruleId 字段**恒为数组**(列出本行命中的 rule_id;此前是字符串,按老格式解析的下游需改);④投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。⑤如果拉取不到数据则不会产生文件上传，也就没有文件url信息",
+    "description": "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task;普通批量创建/取数配置修改有数据量预检，可选 precheck 只读预览；超量先提示调整参数或征求用户确认，明确同意系统超限规则后才以 confirmed=true 重提，导出仍按上限截断；另有三个只读发现接口:list_sites / list_fields 用于建 job 前对齐站点与字段取值;get_field_values 给出枚举值 / 编码值的中文字典,仅在用户明确要求把导出的码值换成中文时按需取用(换值由调用方拿到数据后自行完成,系统不自动回显)。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②两种取数模式二选一:**默认**给命中条件的全部数据、size 默认/最大 50 万、多规则各自拉(同时命中多条规则的数据会重复出现);传 **top** 则不改筛选条件、只在同一批命中里按指定字段跨全部日期/站点/规则排序后取前 N 条、size 默认 1000 最大 10000、多规则 OR 合并(同时命中多条的只出一份),排序字段只能是 keyword/long/double/date 类型;这与平台自身的热搜/热门榜单无关;③导出数据的 kw_ruleId 字段**恒为数组**(列出本行命中的 rule_id;此前是字符串,按老格式解析的下游需改);④投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。⑤如果拉取不到数据则不会产生文件上传，也就没有文件url信息",
     "actions": [
       "get-field-values",
       "job-create",
@@ -2515,6 +3611,7 @@
       "job-update",
       "list-fields",
       "list-sites",
+      "precheck",
       "task-list"
     ]
   }