@social-data/social-neuron-subscription 1.0.0-beta.2 → 1.0.0-beta.21

package/manifest.json

@@ -1,9 +1,128 @@
 {
-  "revision": 6,
+  "revision": 9,
   "capability": "subscription",
   "command": "social-neuron-subscription",
+  "default_action": null,
   "mcp_path": "/subscription/mcp",
   "tools": [
+    {
+      "action": "get-field-values",
+      "op": "get_field_values",
+      "name": "subscription/get_field_values",
+      "summary": "取字段值字典 [{code, value}];**仅在需要把导出的码值换成中文时按需取用**。",
+      "description": "取字段值字典 [{code, value}];**仅在需要把导出的码值换成中文时按需取用**。\n\n枚举字段与编码字段统一走这里(值从哪来是元数据内部的事,对外只有\"有没有字典\"之分)。\n\n换值**不是订阅的标准步骤**:导出文件默认按大库原值交付,只有调用方(或其用户)明确要求\n中文时才用这份字典自行替换 —— 系统不做出参自动回显,也不读产出的文件。\n\n**空列表原样返回**:不在出参里猜原因 —— \"该字段真是明文(本就无字典)\"与\"元数据侧没配值来源\"\n在出参上无法区分,猜错反而误导(说成\"直接当原值用\"会让调用方把一列 code 当中文发出去)。",
+      "input_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "field": {
+            "description": "字段 name_en(取自 list_fields);仅 is_enum / is_code 为真的字段有值字典(按需取用:只有要把导出的码值换成中文时才需要)",
+            "title": "Field",
+            "type": "string"
+          },
+          "keyword": {
+            "anyOf": [
+              {
+                "maxLength": 64,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "按中文值 / code 模糊过滤(如品牌搜「兰」);不传=全量,编码类字段(品牌/品类标签)可上千条,建议带",
+            "title": "Keyword"
+          }
+        },
+        "required": [
+          "field"
+        ],
+        "title": "SubFieldValuesInput",
+        "type": "object"
+      },
+      "output_schema": {
+        "$defs": {
+          "SubFieldValue": {
+            "additionalProperties": false,
+            "description": "值字典的一项。\n\n刻意**不复用** ``commons.metadata.schemas.values.FieldValue``:那是元数据面的内部契约,\n字段说明里带着上游系统的字段名(``tagCode`` / ``tagName`` 之类),对外没有意义也不该暴露。\n这里只说调用方需要知道的两件事:导出列里存的是什么、对应的中文是什么。",
+            "properties": {
+              "code": {
+                "description": "编码值 —— 导出列里实际存的那个值(如 1、V200500020023)",
+                "title": "Code",
+                "type": "string"
+              },
+              "value": {
+                "description": "该编码值对应的中文",
+                "title": "Value",
+                "type": "string"
+              }
+            },
+            "required": [
+              "code",
+              "value"
+            ],
+            "title": "SubFieldValue",
+            "type": "object"
+          }
+        },
+        "additionalProperties": false,
+        "properties": {
+          "field": {
+            "description": "字段 name_en(回显入参)",
+            "title": "Field",
+            "type": "string"
+          },
+          "items": {
+            "description": "值字典 [{code, value}]:code 是导出列里存的值,value 是对应中文;明文字段无字典,返回空列表",
+            "items": {
+              "$ref": "#/$defs/SubFieldValue"
+            },
+            "title": "Items",
+            "type": "array"
+          },
+          "total": {
+            "description": "值总数",
+            "title": "Total",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "field",
+          "items",
+          "total"
+        ],
+        "title": "SubFieldValueList",
+        "type": "object"
+      },
+      "flags": [
+        {
+          "flag": "--field",
+          "field": "field",
+          "type": "string",
+          "required": true,
+          "desc": "字段 name_en(取自 list_fields);仅 is_enum / is_code 为真的字段有值字典(按需取用:只有要把导出的码值换成中文时才需要)"
+        },
+        {
+          "flag": "--keyword",
+          "field": "keyword",
+          "type": "string",
+          "required": false,
+          "desc": "按中文值 / code 模糊过滤(如品牌搜「兰」);不传=全量,编码类字段(品牌/品类标签)可上千条,建议带"
+        }
+      ],
+      "transport": {
+        "method": "POST",
+        "path": "/subscription/get_field_values",
+        "send": "args"
+      },
+      "errors": [
+        "auth_error",
+        "validation",
+        "api_error",
+        "network",
+        "internal"
+      ]
+    },
     {
       "action": "job-create",
       "op": "job_create",
@@ -84,7 +203,7 @@
           },
           "SftpTarget": {
             "additionalProperties": false,
-            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。",
+            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
             "properties": {
               "type": {
                 "const": "sftp",
@@ -114,10 +233,23 @@
                 "type": "string"
               },
               "remote_path": {
-                "description": "远端目录/路径",
+                "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)",
@@ -139,12 +271,38 @@
             ],
             "title": "SftpTarget",
             "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": {
           "name": {
-            "description": "job 名称,全局唯一",
+            "description": "job 名称,同一凭证(token)下唯一",
             "maxLength": 128,
             "minLength": 1,
             "title": "Name",
@@ -171,15 +329,39 @@
             "type": "array"
           },
           "published": {
-            "description": "发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天到昨天)",
-            "enum": [
-              "T-0",
-              "T-1",
-              "T-7"
-            ],
+            "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,
@@ -196,6 +378,21 @@
             "title": "Fields",
             "type": "array"
           },
+          "size": {
+            "anyOf": [
+              {
+                "maximum": 500000,
+                "minimum": 1,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "每次执行最多导出的记录行数。省略则按模式取默认:取全部命中 500,000(同时是上限);传了 top(只取前 N 条)则默认 1,000、上限 10,000",
+            "title": "Size"
+          },
           "target": {
             "anyOf": [
               {
@@ -224,8 +421,24 @@
               }
             ],
             "default": null,
-            "description": "投递目标;省略默认 octo(excel)。本期仅接受 octo",
+            "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": [
@@ -240,15 +453,15 @@
       },
       "output_schema": {
         "additionalProperties": false,
-        "description": "订阅 job 出参对象(= sub_job 全字段,id 暴露为 job_id)。",
+        "description": "订阅 job 出参对象。",
         "properties": {
           "job_id": {
-            "description": "job ID(sub_job.id)",
+            "description": "job ID",
             "title": "Job Id",
             "type": "integer"
           },
           "name": {
-            "description": "job 名称,全局唯一",
+            "description": "job 名称,同一凭证(token)下唯一",
             "title": "Name",
             "type": "string"
           },
@@ -269,10 +482,34 @@
             "type": "array"
           },
           "published": {
-            "description": "发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天)",
+            "description": "发布时间口径(相对,支持按天或按分钟);触发时按 task_time 折算成绝对时间区间",
             "title": "Published",
             "type": "string"
           },
+          "idate": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "入库时间口径(相对,按天或按分钟);null=该维度不过滤",
+            "title": "Idate"
+          },
+          "udate": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "更新时间口径(相对,按天或按分钟);null=该维度不过滤",
+            "title": "Udate"
+          },
           "fields": {
             "description": "拉取/导出字段(空=全量)",
             "items": {
@@ -281,6 +518,28 @@
             "title": "Fields",
             "type": "array"
           },
+          "size": {
+            "description": "每次执行最多导出的记录行数;取全部命中时上限 500000,只取前 N 条时上限 10000",
+            "title": "Size",
+            "type": "integer"
+          },
+          "top": {
+            "anyOf": [
+              {
+                "items": {
+                  "additionalProperties": true,
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "只取前 N 条的排序定义 [{field, order}];null = 给命中条件的全部数据。非 null 时每次执行只取按该排序排在前 size 条的数据",
+            "title": "Top"
+          },
           "frequency": {
             "description": "自然语言频率",
             "title": "Frequency",
@@ -292,7 +551,7 @@
             "type": "string"
           },
           "target_type": {
-            "description": "投递类型:octo(本期)/sftp/kafka",
+            "description": "投递类型:octo、sftp、kafka(暂不支持)",
             "title": "Target Type",
             "type": "string"
           },
@@ -324,7 +583,10 @@
           "rule_ids",
           "source",
           "published",
+          "idate",
+          "udate",
           "fields",
+          "size",
           "frequency",
           "cron",
           "target_type",
@@ -342,28 +604,42 @@
           "field": "name",
           "type": "string",
           "required": true,
-          "desc": "job 名称,全局唯一"
+          "desc": "job 名称,同一凭证(token)下唯一"
         },
         {
           "flag": "--rule-ids",
           "field": "rule_ids",
-          "type": "list[str]",
+          "type": "list[str](json)",
           "required": true,
           "desc": "魔方规则ID数组,至少 1 个"
         },
         {
           "flag": "--source",
           "field": "source",
-          "type": "list[str]",
+          "type": "list[str](json)",
           "required": true,
           "desc": "站点数组,至少 1 个;只能取已配置站点"
         },
         {
           "flag": "--published",
           "field": "published",
-          "type": "enum(T-0、T-1、T-7)",
+          "type": "string",
           "required": true,
-          "desc": "发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天到昨天)"
+          "desc": "**发布时间**口径(必填,主口径 —— 它同时决定查哪个月的索引、怎么拆分片,所以不能缺省)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。"
+        },
+        {
+          "flag": "--idate",
+          "field": "idate",
+          "type": "string",
+          "required": false,
+          "desc": "**入库时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 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个月),超限直接报错(不会静默回落)。"
+        },
+        {
+          "flag": "--udate",
+          "field": "udate",
+          "type": "string",
+          "required": false,
+          "desc": "**更新时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 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个月),超限直接报错(不会静默回落)。"
         },
         {
           "flag": "--frequency",
@@ -375,16 +651,30 @@
         {
           "flag": "--fields",
           "field": "fields",
-          "type": "list[str]",
+          "type": "list[str](json)",
           "required": false,
           "desc": "拉取/导出字段;不填拉全量"
         },
+        {
+          "flag": "--size",
+          "field": "size",
+          "type": "integer",
+          "required": false,
+          "desc": "每次执行最多导出的记录行数。省略则按模式取默认:取全部命中 500,000(同时是上限);传了 top(只取前 N 条)则默认 1,000、上限 10,000"
+        },
         {
           "flag": "--target",
           "field": "target",
           "type": "object(json)",
           "required": false,
-          "desc": "投递目标;省略默认 octo(excel)。本期仅接受 octo"
+          "desc": "投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。"
+        },
+        {
+          "flag": "--top",
+          "field": "top",
+          "type": "list[object](json)",
+          "required": false,
+          "desc": "只取前 N 条(可选)。**不改变筛选条件** —— 省略时给命中条件的全部数据,传了则在同一批命中结果里按指定字段排序、只取前 size 条。排序跨发布窗内所有日期 / 站点 / 规则**全局生效**(不是每天各取 N)。多字段按顺序作排序优先级(前者相同时比后者)。字段必须是可排序类型(keyword / long / double / date)。该模式下 size 默认 1,000、最大 10,000;且多条规则改为 OR 合并并去重,导出的 kw_ruleId 恒为 topN、无法区分来源规则"
         }
       ],
       "transport": {
@@ -498,15 +788,15 @@
         "$defs": {
           "SubJob": {
             "additionalProperties": false,
-            "description": "订阅 job 出参对象(= sub_job 全字段,id 暴露为 job_id)。",
+            "description": "订阅 job 出参对象。",
             "properties": {
               "job_id": {
-                "description": "job ID(sub_job.id)",
+                "description": "job ID",
                 "title": "Job Id",
                 "type": "integer"
               },
               "name": {
-                "description": "job 名称,全局唯一",
+                "description": "job 名称,同一凭证(token)下唯一",
                 "title": "Name",
                 "type": "string"
               },
@@ -527,10 +817,34 @@
                 "type": "array"
               },
               "published": {
-                "description": "发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天)",
+                "description": "发布时间口径(相对,支持按天或按分钟);触发时按 task_time 折算成绝对时间区间",
                 "title": "Published",
                 "type": "string"
               },
+              "idate": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "入库时间口径(相对,按天或按分钟);null=该维度不过滤",
+                "title": "Idate"
+              },
+              "udate": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "更新时间口径(相对,按天或按分钟);null=该维度不过滤",
+                "title": "Udate"
+              },
               "fields": {
                 "description": "拉取/导出字段(空=全量)",
                 "items": {
@@ -539,6 +853,28 @@
                 "title": "Fields",
                 "type": "array"
               },
+              "size": {
+                "description": "每次执行最多导出的记录行数;取全部命中时上限 500000,只取前 N 条时上限 10000",
+                "title": "Size",
+                "type": "integer"
+              },
+              "top": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "只取前 N 条的排序定义 [{field, order}];null = 给命中条件的全部数据。非 null 时每次执行只取按该排序排在前 size 条的数据",
+                "title": "Top"
+              },
               "frequency": {
                 "description": "自然语言频率",
                 "title": "Frequency",
@@ -550,7 +886,7 @@
                 "type": "string"
               },
               "target_type": {
-                "description": "投递类型:octo(本期)/sftp/kafka",
+                "description": "投递类型:octo、sftp、kafka(暂不支持)",
                 "title": "Target Type",
                 "type": "string"
               },
@@ -582,7 +918,10 @@
               "rule_ids",
               "source",
               "published",
+              "idate",
+              "udate",
               "fields",
+              "size",
               "frequency",
               "cron",
               "target_type",
@@ -644,8 +983,8 @@
       "action": "job-trigger",
       "op": "job_trigger",
       "name": "subscription/job_trigger",
-      "summary": "临时触发一次本人 job,落一条 sub_task(manual);默认用 job 存的 target,可覆盖。",
-      "description": "临时触发一次本人 job,落一条 sub_task(manual);默认用 job 存的 target,可覆盖。\n\n落 pending task 后触发 Airflow DAG(``social_neuron_subscription``)跑取数→组装→投递(上传取 url);\n未配 airflow_base_url 时(本地/测试)触发被跳过,仅留 pending task。**无通知**:结果落\n``file_info.url``,调用方轮询 ``task-list`` 拉取。",
+      "summary": "临时触发一次本人 job,落一条 ik_subscription_task(manual);默认用 job 存的 target,可覆盖。",
+      "description": "临时触发一次本人 job,落一条 ik_subscription_task(manual);默认用 job 存的 target,可覆盖。\n\n落 pending task 后触发 Airflow DAG(``social_capability_subscription``)\n跑取数→组装→投递(上传取 url);\n未配 airflow_base_url 时(本地/测试)触发被跳过,仅留 pending task。**无通知**:结果落\n``file_info.url``,调用方轮询 ``task-list`` 拉取。",
       "input_schema": {
         "$defs": {
           "KafkaTarget": {
@@ -720,7 +1059,7 @@
           },
           "SftpTarget": {
             "additionalProperties": false,
-            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。",
+            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
             "properties": {
               "type": {
                 "const": "sftp",
@@ -750,10 +1089,23 @@
                 "type": "string"
               },
               "remote_path": {
-                "description": "远端目录/路径",
+                "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)",
@@ -787,6 +1139,7 @@
           "start_time": {
             "anyOf": [
               {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T(?:[01]\\d|2[0-3]):[0-5]\\d)?$",
                 "type": "string"
               },
               {
@@ -794,12 +1147,13 @@
               }
             ],
             "default": null,
-            "description": "回溯起始;与 end_time 同传同不传",
+            "description": "**发布时间**闭区间下界(东八区)。支持 yyyy-MM-dd(整日)、yyyy-MM-ddTHH:mm(整分钟);与 end_time 同传同不传;不传则按 job 上的 published 相对口径折算",
             "title": "Start Time"
           },
           "end_time": {
             "anyOf": [
               {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T(?:[01]\\d|2[0-3]):[0-5]\\d)?$",
                 "type": "string"
               },
               {
@@ -807,39 +1161,110 @@
               }
             ],
             "default": null,
-            "description": "回溯结束",
+            "description": "**发布时间**闭区间上界(东八区,精度须与下界一致);日期包含整日,分钟包含整分钟",
             "title": "End Time"
           },
-          "target": {
+          "idate_start": {
             "anyOf": [
               {
-                "discriminator": {
-                  "mapping": {
-                    "kafka": "#/$defs/KafkaTarget",
-                    "octo": "#/$defs/OctoTarget",
-                    "sftp": "#/$defs/SftpTarget"
-                  },
-                  "propertyName": "type"
-                },
-                "oneOf": [
-                  {
-                    "$ref": "#/$defs/OctoTarget"
-                  },
-                  {
-                    "$ref": "#/$defs/SftpTarget"
-                  },
-                  {
-                    "$ref": "#/$defs/KafkaTarget"
-                  }
-                ]
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T(?:[01]\\d|2[0-3]):[0-5]\\d)?$",
+                "type": "string"
               },
               {
                 "type": "null"
               }
             ],
             "default": null,
-            "description": "覆盖本次投递目标",
-            "title": "Target"
+            "description": "**入库时间**闭区间下界(东八区,支持日期/分钟);与 idate_end 同传同不传;不传则按 job 上的 idate 相对口径折算,job 也没配=该维度不过滤",
+            "title": "Idate Start"
+          },
+          "idate_end": {
+            "anyOf": [
+              {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T(?:[01]\\d|2[0-3]):[0-5]\\d)?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "本次**入库时间**闭区间上界(东八区,精度须与下界一致)",
+            "title": "Idate End"
+          },
+          "udate_start": {
+            "anyOf": [
+              {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T(?:[01]\\d|2[0-3]):[0-5]\\d)?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "**更新时间**闭区间下界(东八区,支持日期/分钟);与 udate_end 同传同不传;不传则按 job 上的 udate 相对口径折算,job 也没配=该维度不过滤",
+            "title": "Udate Start"
+          },
+          "udate_end": {
+            "anyOf": [
+              {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T(?:[01]\\d|2[0-3]):[0-5]\\d)?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "**更新时间**闭区间上界(东八区,精度须与下界一致)",
+            "title": "Udate End"
+          },
+          "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"
+          },
+          "size": {
+            "anyOf": [
+              {
+                "maximum": 500000,
+                "minimum": 1,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "覆盖本次导出行数;不传则继承 job 的 size,最大 500000",
+            "title": "Size"
           }
         },
         "required": [
@@ -882,14 +1307,42 @@
           "field": "start_time",
           "type": "string",
           "required": false,
-          "desc": "回溯起始;与 end_time 同传同不传"
+          "desc": "**发布时间**闭区间下界(东八区)。支持 yyyy-MM-dd(整日)、yyyy-MM-ddTHH:mm(整分钟);与 end_time 同传同不传;不传则按 job 上的 published 相对口径折算"
         },
         {
           "flag": "--end-time",
           "field": "end_time",
           "type": "string",
           "required": false,
-          "desc": "回溯结束"
+          "desc": "**发布时间**闭区间上界(东八区,精度须与下界一致);日期包含整日,分钟包含整分钟"
+        },
+        {
+          "flag": "--idate-start",
+          "field": "idate_start",
+          "type": "string",
+          "required": false,
+          "desc": "**入库时间**闭区间下界(东八区,支持日期/分钟);与 idate_end 同传同不传;不传则按 job 上的 idate 相对口径折算,job 也没配=该维度不过滤"
+        },
+        {
+          "flag": "--idate-end",
+          "field": "idate_end",
+          "type": "string",
+          "required": false,
+          "desc": "本次**入库时间**闭区间上界(东八区,精度须与下界一致)"
+        },
+        {
+          "flag": "--udate-start",
+          "field": "udate_start",
+          "type": "string",
+          "required": false,
+          "desc": "**更新时间**闭区间下界(东八区,支持日期/分钟);与 udate_end 同传同不传;不传则按 job 上的 udate 相对口径折算,job 也没配=该维度不过滤"
+        },
+        {
+          "flag": "--udate-end",
+          "field": "udate_end",
+          "type": "string",
+          "required": false,
+          "desc": "**更新时间**闭区间上界(东八区,精度须与下界一致)"
         },
         {
           "flag": "--target",
@@ -897,6 +1350,13 @@
           "type": "object(json)",
           "required": false,
           "desc": "覆盖本次投递目标"
+        },
+        {
+          "flag": "--size",
+          "field": "size",
+          "type": "integer",
+          "required": false,
+          "desc": "覆盖本次导出行数;不传则继承 job 的 size,最大 500000"
         }
       ],
       "transport": {
@@ -992,7 +1452,7 @@
           },
           "SftpTarget": {
             "additionalProperties": false,
-            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。",
+            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
             "properties": {
               "type": {
                 "const": "sftp",
@@ -1022,10 +1482,23 @@
                 "type": "string"
               },
               "remote_path": {
-                "description": "远端目录/路径",
+                "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)",
@@ -1047,6 +1520,32 @@
             ],
             "title": "SftpTarget",
             "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,
@@ -1068,7 +1567,7 @@
               }
             ],
             "default": null,
-            "description": "新名称(全局唯一)",
+            "description": "新名称(同一凭证下唯一)",
             "title": "Name"
           },
           "rule_ids": {
@@ -1110,11 +1609,7 @@
           "published": {
             "anyOf": [
               {
-                "enum": [
-                  "T-0",
-                  "T-1",
-                  "T-7"
-                ],
+                "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"
               },
               {
@@ -1122,9 +1617,37 @@
               }
             ],
             "default": null,
-            "description": "发布时间口径:T-0 / T-1 / T-7",
+            "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": [
               {
@@ -1142,6 +1665,21 @@
             "description": "整组全量覆盖",
             "title": "Fields"
           },
+          "size": {
+            "anyOf": [
+              {
+                "maximum": 500000,
+                "minimum": 1,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "每次执行最多导出的记录行数;不传则不修改,最大 500000",
+            "title": "Size"
+          },
           "frequency": {
             "anyOf": [
               {
@@ -1188,6 +1726,22 @@
             "description": "整体替换投递目标",
             "title": "Target"
           },
+          "top": {
+            "anyOf": [
+              {
+                "items": {
+                  "$ref": "#/$defs/TopSpec"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "只取前 N 条的排序规格:传入则整组替换,不传则不修改。切到该模式后 size 最大 10,000;传空数组 [] 表示改回「给全部命中数据」",
+            "title": "Top"
+          },
           "active": {
             "anyOf": [
               {
@@ -1214,15 +1768,15 @@
       },
       "output_schema": {
         "additionalProperties": false,
-        "description": "订阅 job 出参对象(= sub_job 全字段,id 暴露为 job_id)。",
+        "description": "订阅 job 出参对象。",
         "properties": {
           "job_id": {
-            "description": "job ID(sub_job.id)",
+            "description": "job ID",
             "title": "Job Id",
             "type": "integer"
           },
           "name": {
-            "description": "job 名称,全局唯一",
+            "description": "job 名称,同一凭证(token)下唯一",
             "title": "Name",
             "type": "string"
           },
@@ -1243,10 +1797,34 @@
             "type": "array"
           },
           "published": {
-            "description": "发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天)",
+            "description": "发布时间口径(相对,支持按天或按分钟);触发时按 task_time 折算成绝对时间区间",
             "title": "Published",
             "type": "string"
           },
+          "idate": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "入库时间口径(相对,按天或按分钟);null=该维度不过滤",
+            "title": "Idate"
+          },
+          "udate": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "更新时间口径(相对,按天或按分钟);null=该维度不过滤",
+            "title": "Udate"
+          },
           "fields": {
             "description": "拉取/导出字段(空=全量)",
             "items": {
@@ -1255,6 +1833,28 @@
             "title": "Fields",
             "type": "array"
           },
+          "size": {
+            "description": "每次执行最多导出的记录行数;取全部命中时上限 500000,只取前 N 条时上限 10000",
+            "title": "Size",
+            "type": "integer"
+          },
+          "top": {
+            "anyOf": [
+              {
+                "items": {
+                  "additionalProperties": true,
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "只取前 N 条的排序定义 [{field, order}];null = 给命中条件的全部数据。非 null 时每次执行只取按该排序排在前 size 条的数据",
+            "title": "Top"
+          },
           "frequency": {
             "description": "自然语言频率",
             "title": "Frequency",
@@ -1266,7 +1866,7 @@
             "type": "string"
           },
           "target_type": {
-            "description": "投递类型:octo(本期)/sftp/kafka",
+            "description": "投递类型:octo、sftp、kafka(暂不支持)",
             "title": "Target Type",
             "type": "string"
           },
@@ -1298,7 +1898,10 @@
           "rule_ids",
           "source",
           "published",
+          "idate",
+          "udate",
           "fields",
+          "size",
           "frequency",
           "cron",
           "target_type",
@@ -1323,36 +1926,57 @@
           "field": "name",
           "type": "string",
           "required": false,
-          "desc": "新名称(全局唯一)"
+          "desc": "新名称(同一凭证下唯一)"
         },
         {
           "flag": "--rule-ids",
           "field": "rule_ids",
-          "type": "list[str]",
+          "type": "list[str](json)",
           "required": false,
           "desc": "整组全量覆盖"
         },
         {
           "flag": "--source",
           "field": "source",
-          "type": "list[str]",
+          "type": "list[str](json)",
           "required": false,
           "desc": "整组全量覆盖"
         },
         {
           "flag": "--published",
           "field": "published",
-          "type": "enum(T-0、T-1、T-7)",
+          "type": "string",
+          "required": false,
+          "desc": "**发布时间**口径(必填字段,只能改不能清)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。"
+        },
+        {
+          "flag": "--idate",
+          "field": "idate",
+          "type": "string",
+          "required": false,
+          "desc": "**入库时间**口径。不传=不改;传空串 \"\"=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。"
+        },
+        {
+          "flag": "--udate",
+          "field": "udate",
+          "type": "string",
           "required": false,
-          "desc": "发布时间口径:T-0 / T-1 / T-7"
+          "desc": "**更新时间**口径。不传=不改;传空串 \"\"=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。"
         },
         {
           "flag": "--fields",
           "field": "fields",
-          "type": "list[str]",
+          "type": "list[str](json)",
           "required": false,
           "desc": "整组全量覆盖"
         },
+        {
+          "flag": "--size",
+          "field": "size",
+          "type": "integer",
+          "required": false,
+          "desc": "每次执行最多导出的记录行数;不传则不修改,最大 500000"
+        },
         {
           "flag": "--frequency",
           "field": "frequency",
@@ -1367,6 +1991,13 @@
           "required": false,
           "desc": "整体替换投递目标"
         },
+        {
+          "flag": "--top",
+          "field": "top",
+          "type": "list[object](json)",
+          "required": false,
+          "desc": "只取前 N 条的排序规格:传入则整组替换,不传则不修改。切到该模式后 size 最大 10,000;传空数组 [] 表示改回「给全部命中数据」"
+        },
         {
           "flag": "--active",
           "field": "active",
@@ -1388,6 +2019,197 @@
         "internal"
       ]
     },
+    {
+      "action": "list-fields",
+      "op": "list_fields",
+      "name": "subscription/list_fields",
+      "summary": "列出所选站点下可导出的字段:name_en(填 fields 用)、中文名、类型、是否枚举 / code。",
+      "description": "列出所选站点下可导出的字段:name_en(填 fields 用)、中文名、类型、是否枚举 / code。\n\n``is_enum`` / ``is_code`` 为真的字段,导出文件里存的是枚举码 / 编码值;\n**若**调用方要把它们换成中文,再调 ``get_field_values`` 取字典自行替换(按需,非必经步骤)。",
+      "input_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "source": {
+            "description": "站点数组(中文站点名,取自 list_sites),至少 1 个;返回这些站点下字段的并集",
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "title": "Source",
+            "type": "array"
+          },
+          "keyword": {
+            "anyOf": [
+              {
+                "maxLength": 64,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "按字段中文名 / name_en 模糊过滤(如「情感」「互动」);不传=该站点全部字段",
+            "title": "Keyword"
+          }
+        },
+        "required": [
+          "source"
+        ],
+        "title": "SubListFieldsInput",
+        "type": "object"
+      },
+      "output_schema": {
+        "$defs": {
+          "SubField": {
+            "additionalProperties": false,
+            "description": "一个可导出字段(**订阅口径**:只给填 ``fields`` 与翻译列值要用的信息)。",
+            "properties": {
+              "name_en": {
+                "description": "字段标识(ES 字段名),即 job_create / job_update 的 fields 该填的值",
+                "title": "Name En",
+                "type": "string"
+              },
+              "name": {
+                "description": "字段中文名 —— 把用户说法对齐到 name_en 用",
+                "title": "Name",
+                "type": "string"
+              },
+              "data_type": {
+                "description": "语义类型:keyword / text / long / double / date / boolean / object / nested",
+                "title": "Data Type",
+                "type": "string"
+              },
+              "description": {
+                "default": "",
+                "description": "字段描述;元数据未登记描述时为空串",
+                "title": "Description",
+                "type": "string"
+              },
+              "is_enum": {
+                "description": "值来自内置枚举(如数据类型、情感):导出列存的是枚举码;如需换成中文,再按需调 get_field_values 取字典自行替换",
+                "title": "Is Enum",
+                "type": "boolean"
+              },
+              "is_code": {
+                "description": "值是编码值(如品牌标签、品类标签):导出列存的是 code 而非中文;如需换成中文,再按需调 get_field_values 取字典自行替换",
+                "title": "Is Code",
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "name_en",
+              "name",
+              "data_type",
+              "is_enum",
+              "is_code"
+            ],
+            "title": "SubField",
+            "type": "object"
+          }
+        },
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "description": "字段列表(所选站点的并集,按 name_en 排序)",
+            "items": {
+              "$ref": "#/$defs/SubField"
+            },
+            "title": "Items",
+            "type": "array"
+          },
+          "total": {
+            "description": "字段总数",
+            "title": "Total",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "items",
+          "total"
+        ],
+        "title": "SubFieldList",
+        "type": "object"
+      },
+      "flags": [
+        {
+          "flag": "--source",
+          "field": "source",
+          "type": "list[str](json)",
+          "required": true,
+          "desc": "站点数组(中文站点名,取自 list_sites),至少 1 个;返回这些站点下字段的并集"
+        },
+        {
+          "flag": "--keyword",
+          "field": "keyword",
+          "type": "string",
+          "required": false,
+          "desc": "按字段中文名 / name_en 模糊过滤(如「情感」「互动」);不传=该站点全部字段"
+        }
+      ],
+      "transport": {
+        "method": "POST",
+        "path": "/subscription/list_fields",
+        "send": "args"
+      },
+      "errors": [
+        "auth_error",
+        "validation",
+        "api_error",
+        "network",
+        "internal"
+      ]
+    },
+    {
+      "action": "list-sites",
+      "op": "list_sites",
+      "name": "subscription/list_sites",
+      "summary": "列出可订阅站点(中文站点名)—— job_create / job_update 的 source 只能取这里的值。",
+      "description": "列出可订阅站点(中文站点名)—— job_create / job_update 的 source 只能取这里的值。",
+      "input_schema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      },
+      "output_schema": {
+        "additionalProperties": false,
+        "description": "可订阅站点名单(全量,无需翻页:站点由运维在表里配,量级有界)。",
+        "properties": {
+          "items": {
+            "description": "中文站点名列表,即 job_create / job_update 的 source 该填的值(按配置顺序)",
+            "items": {
+              "type": "string"
+            },
+            "title": "Items",
+            "type": "array"
+          },
+          "total": {
+            "description": "站点总数",
+            "title": "Total",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "items",
+          "total"
+        ],
+        "title": "SubSiteList",
+        "type": "object"
+      },
+      "flags": [],
+      "transport": {
+        "method": "POST",
+        "path": "/subscription/list_sites",
+        "send": "args"
+      },
+      "errors": [
+        "auth_error",
+        "validation",
+        "api_error",
+        "network",
+        "internal"
+      ]
+    },
     {
       "action": "task-list",
       "op": "task_list",
@@ -1497,10 +2319,10 @@
         "$defs": {
           "SubTask": {
             "additionalProperties": false,
-            "description": "订阅 task 出参对象(**对外精简**:只给调用方轮询/下载所需;其余字段仅存 sub_task 表供排查)。",
+            "description": "订阅 task 出参对象(**对外精简**:只给调用方轮询/下载所需)。",
             "properties": {
               "task_id": {
-                "description": "task ID(sub_task.id)",
+                "description": "task ID",
                 "title": "Task Id",
                 "type": "integer"
               },
@@ -1509,6 +2331,28 @@
                 "title": "Job Id",
                 "type": "integer"
               },
+              "size": {
+                "description": "本次执行最多导出的记录行数;取全部命中时上限 500000,只取前 N 条时上限 10000",
+                "title": "Size",
+                "type": "integer"
+              },
+              "top": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "additionalProperties": true,
+                      "type": "object"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "本次生效的排序快照 [{field, order}];null = 取了命中条件的全部数据。非 null 时本次只取按该排序排在前 size 条的数据",
+                "title": "Top"
+              },
               "status": {
                 "description": "pending/running/success/failed/terminated",
                 "title": "Status",
@@ -1555,6 +2399,7 @@
             "required": [
               "task_id",
               "job_id",
+              "size",
               "status",
               "created_at",
               "updated_at"
@@ -1660,13 +2505,16 @@
   ],
   "skill": {
     "slug": "social-neuron-subscription",
-    "description": "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②单次拉数≤10 万行,超出截断;③投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。",
+    "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信息",
     "actions": [
+      "get-field-values",
       "job-create",
       "job-delete",
       "job-list",
       "job-trigger",
       "job-update",
+      "list-fields",
+      "list-sites",
       "task-list"
     ]
   }