@social-data/social-neuron-subscription 1.0.0-beta.26 → 1.0.0-beta.28

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "revision": 10,
+  "revision": 12,
   "capability": "subscription",
   "command": "social-neuron-subscription",
   "default_action": null,
@@ -201,6 +201,33 @@
             "title": "OctoTarget",
             "type": "object"
           },
+          "PlatformSite": {
+            "additionalProperties": false,
+            "properties": {
+              "platform": {
+                "description": "平台编码，取 list_platforms 的 name_en",
+                "minLength": 1,
+                "title": "Platform",
+                "type": "string"
+              },
+              "sites": {
+                "description": "站点编码数组，取 list_sites 的 value；[\"*\"] 表示该平台全部站点，不可混用",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "title": "Sites",
+                "type": "array"
+              }
+            },
+            "required": [
+              "platform",
+              "sites"
+            ],
+            "title": "PlatformSite",
+            "type": "object"
+          },
           "SftpTarget": {
             "additionalProperties": false,
             "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
@@ -306,6 +333,33 @@
         },
         "additionalProperties": false,
         "properties": {
+          "source": {
+            "description": "历史热门站点中文名数组，取 list_source；与 platform_site 必须二选一",
+            "items": {
+              "minLength": 1,
+              "type": "string"
+            },
+            "minItems": 1,
+            "title": "Source",
+            "type": "array"
+          },
+          "platform_site": {
+            "anyOf": [
+              {
+                "items": {
+                  "$ref": "#/$defs/PlatformSite"
+                },
+                "minItems": 1,
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "元数据平台站点组合；platform 取 list_platforms.name_en，sites 取 list_sites.value；与 source 二选一",
+            "title": "Platform Site"
+          },
           "confirmed": {
             "default": false,
             "description": "是否已确认继续并同意系统超限处理规则；超量时默认拒绝，true 允许保存但仍按上限截断；不跳过其他校验，不保存到 job，TopN 不适用",
@@ -329,16 +383,6 @@
             "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)$",
@@ -455,7 +499,6 @@
         "required": [
           "name",
           "rule_ids",
-          "source",
           "published",
           "frequency"
         ],
@@ -464,6 +507,33 @@
       },
       "output_schema": {
         "$defs": {
+          "PlatformSite": {
+            "additionalProperties": false,
+            "properties": {
+              "platform": {
+                "description": "平台编码，取 list_platforms 的 name_en",
+                "minLength": 1,
+                "title": "Platform",
+                "type": "string"
+              },
+              "sites": {
+                "description": "站点编码数组，取 list_sites 的 value；[\"*\"] 表示该平台全部站点，不可混用",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "title": "Sites",
+                "type": "array"
+              }
+            },
+            "required": [
+              "platform",
+              "sites"
+            ],
+            "title": "PlatformSite",
+            "type": "object"
+          },
           "PrecheckResult": {
             "additionalProperties": false,
             "properties": {
@@ -591,13 +661,29 @@
             "type": "array"
           },
           "source": {
-            "description": "站点数组",
+            "description": "历史热门站点中文名数组；元数据模式为空数组",
             "items": {
               "type": "string"
             },
             "title": "Source",
             "type": "array"
           },
+          "platform_site": {
+            "anyOf": [
+              {
+                "items": {
+                  "$ref": "#/$defs/PlatformSite"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "元数据平台站点组合；历史热门站点模式为 null",
+            "title": "Platform Site"
+          },
           "published": {
             "description": "发布时间口径(相对,支持按天或按分钟);触发时按 task_time 折算成绝对时间区间",
             "title": "Published",
@@ -716,6 +802,20 @@
         "type": "object"
       },
       "flags": [
+        {
+          "flag": "--source",
+          "field": "source",
+          "type": "list[str](json)",
+          "required": false,
+          "desc": "历史热门站点中文名数组，取 list_source；与 platform_site 必须二选一"
+        },
+        {
+          "flag": "--platform-site",
+          "field": "platform_site",
+          "type": "list[object](json)",
+          "required": false,
+          "desc": "元数据平台站点组合；platform 取 list_platforms.name_en，sites 取 list_sites.value；与 source 二选一"
+        },
         {
           "flag": "--confirmed",
           "field": "confirmed",
@@ -737,13 +837,6 @@
           "required": true,
           "desc": "魔方规则ID数组,至少 1 个"
         },
-        {
-          "flag": "--source",
-          "field": "source",
-          "type": "list[str](json)",
-          "required": true,
-          "desc": "站点数组,至少 1 个;只能取已配置站点"
-        },
         {
           "flag": "--published",
           "field": "published",
@@ -910,6 +1003,33 @@
       },
       "output_schema": {
         "$defs": {
+          "PlatformSite": {
+            "additionalProperties": false,
+            "properties": {
+              "platform": {
+                "description": "平台编码，取 list_platforms 的 name_en",
+                "minLength": 1,
+                "title": "Platform",
+                "type": "string"
+              },
+              "sites": {
+                "description": "站点编码数组，取 list_sites 的 value；[\"*\"] 表示该平台全部站点，不可混用",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "title": "Sites",
+                "type": "array"
+              }
+            },
+            "required": [
+              "platform",
+              "sites"
+            ],
+            "title": "PlatformSite",
+            "type": "object"
+          },
           "PrecheckResult": {
             "additionalProperties": false,
             "properties": {
@@ -1037,13 +1157,29 @@
                 "type": "array"
               },
               "source": {
-                "description": "站点数组",
+                "description": "历史热门站点中文名数组；元数据模式为空数组",
                 "items": {
                   "type": "string"
                 },
                 "title": "Source",
                 "type": "array"
               },
+              "platform_site": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "$ref": "#/$defs/PlatformSite"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "元数据平台站点组合；历史热门站点模式为 null",
+                "title": "Platform Site"
+              },
               "published": {
                 "description": "发布时间口径(相对,支持按天或按分钟);触发时按 task_time 折算成绝对时间区间",
                 "title": "Published",
@@ -1683,6 +1819,33 @@
             "title": "OctoTarget",
             "type": "object"
           },
+          "PlatformSite": {
+            "additionalProperties": false,
+            "properties": {
+              "platform": {
+                "description": "平台编码，取 list_platforms 的 name_en",
+                "minLength": 1,
+                "title": "Platform",
+                "type": "string"
+              },
+              "sites": {
+                "description": "站点编码数组，取 list_sites 的 value；[\"*\"] 表示该平台全部站点，不可混用",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "title": "Sites",
+                "type": "array"
+              }
+            },
+            "required": [
+              "platform",
+              "sites"
+            ],
+            "title": "PlatformSite",
+            "type": "object"
+          },
           "SftpTarget": {
             "additionalProperties": false,
             "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
@@ -1847,9 +2010,26 @@
               }
             ],
             "default": null,
-            "description": "整组全量覆盖",
+            "description": "历史热门站点中文名数组，取 list_source；整体替换范围，与 platform_site 互斥",
             "title": "Source"
           },
+          "platform_site": {
+            "anyOf": [
+              {
+                "items": {
+                  "$ref": "#/$defs/PlatformSite"
+                },
+                "minItems": 1,
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "元数据平台站点组合；整体替换范围，与 source 互斥；不传保持原范围",
+            "title": "Platform Site"
+          },
           "published": {
             "anyOf": [
               {
@@ -2012,6 +2192,33 @@
       },
       "output_schema": {
         "$defs": {
+          "PlatformSite": {
+            "additionalProperties": false,
+            "properties": {
+              "platform": {
+                "description": "平台编码，取 list_platforms 的 name_en",
+                "minLength": 1,
+                "title": "Platform",
+                "type": "string"
+              },
+              "sites": {
+                "description": "站点编码数组，取 list_sites 的 value；[\"*\"] 表示该平台全部站点，不可混用",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "title": "Sites",
+                "type": "array"
+              }
+            },
+            "required": [
+              "platform",
+              "sites"
+            ],
+            "title": "PlatformSite",
+            "type": "object"
+          },
           "PrecheckResult": {
             "additionalProperties": false,
             "properties": {
@@ -2139,13 +2346,29 @@
             "type": "array"
           },
           "source": {
-            "description": "站点数组",
+            "description": "历史热门站点中文名数组；元数据模式为空数组",
             "items": {
               "type": "string"
             },
             "title": "Source",
             "type": "array"
           },
+          "platform_site": {
+            "anyOf": [
+              {
+                "items": {
+                  "$ref": "#/$defs/PlatformSite"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "元数据平台站点组合；历史热门站点模式为 null",
+            "title": "Platform Site"
+          },
           "published": {
             "description": "发布时间口径(相对,支持按天或按分钟);触发时按 task_time 折算成绝对时间区间",
             "title": "Published",
@@ -2297,7 +2520,14 @@
           "field": "source",
           "type": "list[str](json)",
           "required": false,
-          "desc": "整组全量覆盖"
+          "desc": "历史热门站点中文名数组，取 list_source；整体替换范围，与 platform_site 互斥"
+        },
+        {
+          "flag": "--platform-site",
+          "field": "platform_site",
+          "type": "list[object](json)",
+          "required": false,
+          "desc": "元数据平台站点组合；整体替换范围，与 source 互斥；不传保持原范围"
         },
         {
           "flag": "--published",
@@ -2383,10 +2613,39 @@
       "summary": "列出所选站点下可导出的字段:name_en(填 fields 用)、中文名、类型、是否枚举 / code。",
       "description": "列出所选站点下可导出的字段:name_en(填 fields 用)、中文名、类型、是否枚举 / code。\n\n``is_enum`` / ``is_code`` 为真的字段,导出文件里存的是枚举码 / 编码值;\n**若**调用方要把它们换成中文,再调 ``get_field_values`` 取字典自行替换(按需,非必经步骤)。",
       "input_schema": {
+        "$defs": {
+          "PlatformSite": {
+            "additionalProperties": false,
+            "properties": {
+              "platform": {
+                "description": "平台编码，取 list_platforms 的 name_en",
+                "minLength": 1,
+                "title": "Platform",
+                "type": "string"
+              },
+              "sites": {
+                "description": "站点编码数组，取 list_sites 的 value；[\"*\"] 表示该平台全部站点，不可混用",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "title": "Sites",
+                "type": "array"
+              }
+            },
+            "required": [
+              "platform",
+              "sites"
+            ],
+            "title": "PlatformSite",
+            "type": "object"
+          }
+        },
         "additionalProperties": false,
         "properties": {
           "source": {
-            "description": "站点数组(中文站点名,取自 list_sites),至少 1 个;返回这些站点下字段的并集",
+            "description": "历史热门站点中文名数组，取 list_source；与 platform_site 必须二选一",
             "items": {
               "minLength": 1,
               "type": "string"
@@ -2395,6 +2654,23 @@
             "title": "Source",
             "type": "array"
           },
+          "platform_site": {
+            "anyOf": [
+              {
+                "items": {
+                  "$ref": "#/$defs/PlatformSite"
+                },
+                "minItems": 1,
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "元数据平台站点组合；platform 取 list_platforms.name_en，sites 取 list_sites.value；与 source 二选一",
+            "title": "Platform Site"
+          },
           "keyword": {
             "anyOf": [
               {
@@ -2410,9 +2686,6 @@
             "title": "Keyword"
           }
         },
-        "required": [
-          "source"
-        ],
         "title": "SubListFieldsInput",
         "type": "object"
       },
@@ -2505,8 +2778,15 @@
           "flag": "--source",
           "field": "source",
           "type": "list[str](json)",
-          "required": true,
-          "desc": "站点数组(中文站点名,取自 list_sites),至少 1 个;返回这些站点下字段的并集"
+          "required": false,
+          "desc": "历史热门站点中文名数组，取 list_source；与 platform_site 必须二选一"
+        },
+        {
+          "flag": "--platform-site",
+          "field": "platform_site",
+          "type": "list[object](json)",
+          "required": false,
+          "desc": "元数据平台站点组合；platform 取 list_platforms.name_en，sites 取 list_sites.value；与 source 二选一"
         },
         {
           "flag": "--keyword",
@@ -2529,10 +2809,202 @@
         "internal"
       ]
     },
+    {
+      "action": "list-platforms",
+      "op": "list_platforms",
+      "name": "subscription/list_platforms",
+      "summary": "列出舆情元数据平台，name_en 填入 platform_site[].platform。",
+      "description": "列出舆情元数据平台，name_en 填入 platform_site[].platform。",
+      "input_schema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+      },
+      "output_schema": {
+        "$defs": {
+          "Platform": {
+            "additionalProperties": false,
+            "properties": {
+              "name_en": {
+                "description": "平台标识(= kw_platform 值)",
+                "title": "Name En",
+                "type": "string"
+              },
+              "name": {
+                "description": "平台中文名",
+                "title": "Name",
+                "type": "string"
+              },
+              "description": {
+                "default": "",
+                "description": "平台描述",
+                "title": "Description",
+                "type": "string"
+              },
+              "index_prefix": {
+                "default": "",
+                "description": "索引前缀(索引名解析用)",
+                "title": "Index Prefix",
+                "type": "string"
+              },
+              "time_pattern": {
+                "default": "",
+                "description": "索引时间分片模式(如 yyyyMM)",
+                "title": "Time Pattern",
+                "type": "string"
+              }
+            },
+            "required": [
+              "name_en",
+              "name"
+            ],
+            "title": "Platform",
+            "type": "object"
+          }
+        },
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "description": "元数据平台列表，name_en 填 platform_site.platform",
+            "items": {
+              "$ref": "#/$defs/Platform"
+            },
+            "title": "Items",
+            "type": "array"
+          },
+          "total": {
+            "description": "平台总数",
+            "title": "Total",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "items",
+          "total"
+        ],
+        "title": "SubPlatformList",
+        "type": "object"
+      },
+      "flags": [],
+      "transport": {
+        "method": "POST",
+        "path": "/subscription/list_platforms",
+        "send": "args"
+      },
+      "errors": [
+        "auth_error",
+        "validation",
+        "api_error",
+        "network",
+        "internal"
+      ]
+    },
     {
       "action": "list-sites",
       "op": "list_sites",
       "name": "subscription/list_sites",
+      "summary": "搜索元数据站点，value 填 platform_site[].sites；原热门站点列表已改名 list_source。",
+      "description": "搜索元数据站点，value 填 platform_site[].sites；原热门站点列表已改名 list_source。",
+      "input_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "keyword": {
+            "anyOf": [
+              {
+                "maxLength": 64,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "按站点中文名或编码搜索，建议传关键词收窄结果",
+            "title": "Keyword"
+          }
+        },
+        "title": "SubListSitesInput",
+        "type": "object"
+      },
+      "output_schema": {
+        "$defs": {
+          "Site": {
+            "additionalProperties": false,
+            "properties": {
+              "name": {
+                "description": "站点中文名",
+                "title": "Name",
+                "type": "string"
+              },
+              "value": {
+                "description": "ES 来源字段值(如 douyin.com);站点目录即字典,value_source=none",
+                "title": "Value",
+                "type": "string"
+              },
+              "is_key_site": {
+                "default": false,
+                "description": "是否重点站点",
+                "title": "Is Key Site",
+                "type": "boolean"
+              }
+            },
+            "required": [
+              "name",
+              "value"
+            ],
+            "title": "Site",
+            "type": "object"
+          }
+        },
+        "additionalProperties": false,
+        "properties": {
+          "items": {
+            "description": "元数据全局站点列表，value 填 platform_site.sites；不包含平台归属，保存时校验对应关系",
+            "items": {
+              "$ref": "#/$defs/Site"
+            },
+            "title": "Items",
+            "type": "array"
+          },
+          "total": {
+            "description": "命中站点总数",
+            "title": "Total",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "items",
+          "total"
+        ],
+        "title": "SubSiteList",
+        "type": "object"
+      },
+      "flags": [
+        {
+          "flag": "--keyword",
+          "field": "keyword",
+          "type": "string",
+          "required": false,
+          "desc": "按站点中文名或编码搜索，建议传关键词收窄结果"
+        }
+      ],
+      "transport": {
+        "method": "POST",
+        "path": "/subscription/list_sites",
+        "send": "args"
+      },
+      "errors": [
+        "auth_error",
+        "validation",
+        "api_error",
+        "network",
+        "internal"
+      ]
+    },
+    {
+      "action": "list-source",
+      "op": "list_source",
+      "name": "subscription/list_source",
       "summary": "列出可订阅站点(中文站点名)—— job_create / job_update 的 source 只能取这里的值。",
       "description": "列出可订阅站点(中文站点名)—— job_create / job_update 的 source 只能取这里的值。",
       "input_schema": {
@@ -2562,13 +3034,13 @@
           "items",
           "total"
         ],
-        "title": "SubSiteList",
+        "title": "SubSourceList",
         "type": "object"
       },
       "flags": [],
       "transport": {
         "method": "POST",
-        "path": "/subscription/list_sites",
+        "path": "/subscription/list_source",
         "send": "args"
       },
       "errors": [
@@ -2657,6 +3129,33 @@
             "title": "OctoTarget",
             "type": "object"
           },
+          "PlatformSite": {
+            "additionalProperties": false,
+            "properties": {
+              "platform": {
+                "description": "平台编码，取 list_platforms 的 name_en",
+                "minLength": 1,
+                "title": "Platform",
+                "type": "string"
+              },
+              "sites": {
+                "description": "站点编码数组，取 list_sites 的 value；[\"*\"] 表示该平台全部站点，不可混用",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "title": "Sites",
+                "type": "array"
+              }
+            },
+            "required": [
+              "platform",
+              "sites"
+            ],
+            "title": "PlatformSite",
+            "type": "object"
+          },
           "SftpTarget": {
             "additionalProperties": false,
             "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
@@ -2736,6 +3235,33 @@
           "SubJobCreateInput": {
             "additionalProperties": false,
             "properties": {
+              "source": {
+                "description": "历史热门站点中文名数组，取 list_source；与 platform_site 必须二选一",
+                "items": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "minItems": 1,
+                "title": "Source",
+                "type": "array"
+              },
+              "platform_site": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "$ref": "#/$defs/PlatformSite"
+                    },
+                    "minItems": 1,
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "元数据平台站点组合；platform 取 list_platforms.name_en，sites 取 list_sites.value；与 source 二选一",
+                "title": "Platform Site"
+              },
               "confirmed": {
                 "default": false,
                 "description": "是否已确认继续并同意系统超限处理规则；超量时默认拒绝，true 允许保存但仍按上限截断；不跳过其他校验，不保存到 job，TopN 不适用",
@@ -2759,16 +3285,6 @@
                 "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)$",
@@ -2885,7 +3401,6 @@
             "required": [
               "name",
               "rule_ids",
-              "source",
               "published",
               "frequency"
             ],
@@ -2954,9 +3469,26 @@
                   }
                 ],
                 "default": null,
-                "description": "整组全量覆盖",
+                "description": "历史热门站点中文名数组，取 list_source；整体替换范围，与 platform_site 互斥",
                 "title": "Source"
               },
+              "platform_site": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "$ref": "#/$defs/PlatformSite"
+                    },
+                    "minItems": 1,
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "元数据平台站点组合；整体替换范围，与 source 互斥；不传保持原范围",
+                "title": "Platform Site"
+              },
               "published": {
                 "anyOf": [
                   {
@@ -3601,7 +4133,7 @@
   ],
   "skill": {
     "slug": "social-neuron-subscription",
-    "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信息",
+    "description": "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task;普通批量创建/取数配置修改有数据量预检，可选 precheck 只读预览；超量先提示调整参数或征求用户确认，明确同意系统超限规则后才以 confirmed=true 重提，导出仍按上限截断；订阅范围二选一：热门站点用 source（list_source 返回的中文名，按已有配置确定范围）；指定平台站点用 platform_site（platform 取 list_platforms.name_en，sites 取 list_sites.value），适用于指定平台下站点、不同平台各自站点或整个平台，sites=[\"*\"] 表示该平台全部站点；范围选择与是否 TopN 独立，两种范围均支持普通批量或 TopN。发现接口:list_source / list_platforms / list_sites 对齐范围，list_fields 对齐字段；原 list_sites 的热门站点列表已改名 list_source，新 list_sites 返回元数据站点对象；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",
@@ -3610,7 +4142,9 @@
       "job-trigger",
       "job-update",
       "list-fields",
+      "list-platforms",
       "list-sites",
+      "list-source",
       "precheck",
       "task-list"
     ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@social-data/social-neuron-subscription",
-  "version": "1.0.0-beta.26",
+  "version": "1.0.0-beta.28",
   "description": "Social Neuron subscription 能力 CLI —— 一能力一命令(social-neuron-subscription),薄客户端直达 /subscription/{op}。",
   "bin": {
     "social-neuron-subscription": "bin/cli.js"

package/skills/social-neuron-subscription/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: social-neuron-subscription
-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信息"
+description: "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task;普通批量创建/取数配置修改有数据量预检，可选 precheck 只读预览；超量先提示调整参数或征求用户确认，明确同意系统超限规则后才以 confirmed=true 重提，导出仍按上限截断；订阅范围二选一：热门站点用 source（list_source 返回的中文名，按已有配置确定范围）；指定平台站点用 platform_site（platform 取 list_platforms.name_en，sites 取 list_sites.value），适用于指定平台下站点、不同平台各自站点或整个平台，sites=["*"] 表示该平台全部站点；范围选择与是否 TopN 独立，两种范围均支持普通批量或 TopN。发现接口:list_source / list_platforms / list_sites 对齐范围，list_fields 对齐字段；原 list_sites 的热门站点列表已改名 list_source，新 list_sites 返回元数据站点对象；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信息"
 metadata:
   openclaw:
     requires: { bins: ['social-neuron-subscription'], skills: [] }
@@ -62,7 +62,7 @@ metadata:
 两条路径的保存条件和导出上限相同。跳过独立预检不会跳过服务端内部检查，也不表示同意超限处理。
 
 ```
-准备普通批量创建参数 / 局部修改参数，必要时用 list-sites / list-fields 对齐合法取值
+准备普通批量创建参数 / 局部修改参数，必要时用 list-source / list-fields 对齐合法取值
   ↓
 创建或修改前说明可选预检及上述区别，按用户选择走：
   ├─ 先预检 → precheck(create/update)
@@ -122,17 +122,45 @@ TopN 维持原样，不进入本次数据量预检确认流程。
 `count_relation=gte` 表示“至少”命中，不是精确总量。三个时间维度见 windows。
 预检只反映当前窗口，不代表未来每次执行量。
 
-### 四、建 job 前先对齐取值(站点 / 字段)
+### 四、选择订阅范围：热门站点 / 指定平台站点
 
-`--source` 和 `--fields` 不能凭感觉写,两个发现接口给的就是合法取值:
+先按用户需要的订阅范围选择参数，再查询对应的合法取值：
 
-| 命令 | 给什么 | 怎么用 |
+| 使用场景 | 选择参数 | 行为 |
 |---|---|---|
-| `list-sites` | 可订阅站点(**中文站点名**,如「抖音」「微博」) | 原样填 `--source` |
-| `list-fields --source '["抖音"]'` | 该站点下可导出的字段 | `name_en` 填 `--fields`;`name` 是中文名,用来把用户说法对齐到 `name_en` |
+| 热门站点：用户要订阅已配置的常用站点，如抖音、微博，不需要指定平台归属 | `source` | 按中文热门站点名选择，平台与实际站点范围由已有配置确定 |
+| 指定平台站点：用户明确指定某个平台下的站点、不同平台各自的站点，或整个平台；需要选择热门站点列表以外的站点 | `platform_site` | 每组明确绑定平台编码与站点编码，可分别指定多个平台的站点范围 |
 
-`--source` 填的是**中文站点名**,不是域名 —— `douyin.com` 这类是大库内部的过滤值,填进去会被拒。
-字段近千,按需用 `list-fields --keyword 情感` 收窄。
+例如“订阅抖音和微博”可先查 list-source，使用 source；“订阅新闻平台中的腾讯站点”使用
+platform_site；“订阅新闻整个平台”也使用 platform_site，并显式填写 sites=["*"]。
+热门站点模式仅限 list-source 中已有配置的站点；指定平台站点模式从元数据查询平台和站点。
+不要仅凭中文站点名猜测平台编码，也不要把不同平台的站点合并成没有对应关系的平铺数组。
+
+**范围选择与 TopN 是两个独立选择**：source / platform_site 决定从哪里取；top 决定命中后
+是否只取排序前 N 条。两种范围均可用于普通批量或 TopN。“热门站点”指已配置的常用站点，
+不表示热门内容、热搜榜或按互动量排序；用户未要求排序前 N 条时，不自动添加 top。
+
+创建时 `source` 与 `platform_site` 必须且只能提供一种。旧调用和历史 job 的 source 含义不变。
+
+| 模式 | 发现命令 | 参数取值 |
+|---|---|---|
+| 热门站点 | `list-source` | 中文站点名原样填顶层 `--source` |
+| 指定平台站点 | `list-platforms`，`list-sites --keyword 腾讯` | 平台 name_en 填 platform_site[].platform；站点 value 填 platform_site[].sites |
+| 导出字段 | `list-fields`，传与 job 相同的 source 或 platform_site | name_en 填 fields；仅 selectable=true 的业务字段可选 |
+
+**历史接口变化**：原 `list-sites`（返回中文热门站点数组）已改名 `list-source`；
+新的 `list-sites` 返回元数据站点对象 name/value/is_key_site，value 是站点编码，不是中文名。
+旧调用方获取热门站点时必须改调 list-source；已有 source 创建请求不需要改动。
+
+平台站点示例：`--platform-site '[{"platform":"news","sites":["toutiao.com","qq.com"]}]'`。
+每组平台与站点绑定，多组 OR 合并；平台和站点的实际归属由服务端校验。
+整个平台显式传 `"sites":["*"]`，不能混入具体站点；不接受空数组或省略 sites。
+list-sites 是全局站点目录，不带平台归属，不能把站点搜索命中当成属于任意平台的证明。
+站点目录可能有数万条，优先传 keyword 搜索，不拉全量作为输入枚举。
+
+顶层 source 只接受 list-source 的中文热门站点名，不能填写 list-sites.value。
+更新不传范围则保持原模式；传 source 或 platform_site 即整体替换范围并切换模式，不能同时传。
+字段近千，按需用 list-fields --keyword 情感 收窄，并传与创建/修改相同的范围。
 
 ### 五、三个时间口径别搞混
 
@@ -255,7 +283,7 @@ json 格式下就是 JSON 数组;csv / excel 下这一列落成紧凑 JSON 字
 - **拉不到数据就不会有文件**,`file_info` 里也就没有 url —— 这不是失败,是没命中。
 - 普通批量 `--size` 默认/最大 **50 万行**，超限按服务端提示处理；传了 `--top` 则默认 **1000**、最大 **10000**,超出报错。
 - 每个 token 生效的 job 默认 **≤10 个**,满了要先 `job-delete` 或停用。
-- `--source` 只能填**已配置站点的中文名**(用 `list-sites` 查);写 `douyin.com` 这类域名会被拒。
+- `--source` 只能填**已配置站点的中文名**(用 `list-source` 查);写 `douyin.com` 这类域名会被拒。
 - 投递目标本期只支持 **octo / sftp**(kafka 规划中);省略 `--target` 默认 octo。
 - 传了 `--top` 时同时命中多条规则的数据只出现一份(`kw_ruleId` 里列出全部命中的规则);
   不传时每条规则各出一份。按规则分组统计前先想清楚要哪种。
@@ -263,11 +291,33 @@ json 格式下就是 JSON 数组;csv / excel 下这一列落成紧凑 JSON 字
 
 ## 示例
 
+### 热门站点：订阅已配置的抖音和微博
+
+```bash
+# 查询中文热门站点名，确认用户选择的站点在返回列表中
+social-neuron-subscription list-source
+social-neuron-subscription job-create --name 热门站点每日订阅 --rule-ids '["12345"]' --source '["抖音","微博"]' --published 'T-1~T-1' --frequency '每天9点' -y
+```
+
+> 使用 source，由已有站点配置确定平台及站点范围；不同时传 platform_site。这是普通批量订阅，不表示只取热门内容；超量按预检与用户确认流程处理。
+
+### 指定平台站点：订阅新闻平台中的腾讯站点
+
+```bash
+# 平台 name_en 填 platform，站点 value 填 sites；实际归属由服务端校验
+social-neuron-subscription list-platforms
+social-neuron-subscription list-sites --keyword 腾讯
+social-neuron-subscription list-fields --platform-site '[{"platform":"news","sites":["qq.com"]}]' --keyword 标题
+social-neuron-subscription job-create --name 指定平台站点每日订阅 --rule-ids '["12345"]' --platform-site '[{"platform":"news","sites":["qq.com"]}]' --published 'T-1~T-1' --frequency '每天9点' -y
+```
+
+> 使用 platform_site，不同时传 source；整个平台改为 sites=["*"]。多个平台分别写一组，保留各自的站点对应关系。同样支持普通批量或 TopN；只有用户要求排序前 N 条时才加 top，普通批量超量按确认流程处理。
+
 ### 选择不单独预检：直接创建，成功后手动跑一次
 
 ```bash
 # 1) 先看有哪些站点可订阅(--source 填的是中文站点名)
-social-neuron-subscription list-sites
+social-neuron-subscription list-source
 
 # 2) 再看该站点有哪些字段可导出(name_en 填 --fields)
 social-neuron-subscription list-fields --source '["抖音"]' --keyword 情感
@@ -419,10 +469,11 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 
 | flag | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|---|
+| --source | source | list[string] | 否 | minItems=1, minLen=1 | 历史热门站点中文名数组，取 list_source；与 platform_site 必须二选一 |
+| --platform-site | platform_site | list[PlatformSite] | 否 | minItems=1 | 元数据平台站点组合；platform 取 list_platforms.name_en，sites 取 list_sites.value；与 source 二选一 |
 | --confirmed | confirmed | boolean | 否 | - | 是否已确认继续并同意系统超限处理规则；超量时默认拒绝，true 允许保存但仍按上限截断；不跳过其他校验，不保存到 job，TopN 不适用 |
 | --name | name | string | 是 | minLen=1, maxLen=128 | job 名称,同一凭证(token)下唯一 |
 | --rule-ids | rule_ids | list[string] | 是 | minItems=1, minLen=1 | 魔方规则ID数组,至少 1 个 |
-| --source | source | list[string] | 是 | minItems=1, minLen=1 | 站点数组,至少 1 个;只能取已配置站点 |
 | --published | published | string | 是 | - | **发布时间**口径(必填,主口径 —— 它同时决定查哪个月的索引、怎么拆分片,所以不能缺省)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。 |
 | --idate | idate | string | 否 | - | **入库时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 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个月),超限直接报错(不会静默回落)。 |
 | --udate | udate | string | 否 | - | **更新时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 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个月),超限直接报错(不会静默回落)。 |
@@ -448,6 +499,13 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | type | string | 是 | - | 固定 octo |
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 
+**对象 `PlatformSite`**
+
+| 键 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|
+| platform | string | 是 | minLen=1 | 平台编码，取 list_platforms 的 name_en |
+| sites | list[string] | 是 | minItems=1, minLen=1 | 站点编码数组，取 list_sites 的 value；["*"] 表示该平台全部站点，不可混用 |
+
 **对象 `SftpTarget`** —— sftp(本期):把导出文件上传到 SFTP 远端目录。
 目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task
 重跑多少次,远端路径与文件名都不变。
@@ -479,7 +537,8 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | job_id | integer | 是 | - | job ID |
 | name | string | 是 | - | job 名称,同一凭证(token)下唯一 |
 | rule_ids | list[string] | 是 | - | 魔方规则ID数组 |
-| source | list[string] | 是 | - | 站点数组 |
+| source | list[string] | 是 | - | 历史热门站点中文名数组；元数据模式为空数组 |
+| platform_site | list[PlatformSite] | 否 | - | 元数据平台站点组合；历史热门站点模式为 null |
 | published | string | 是 | - | 发布时间口径(相对,支持按天或按分钟);触发时按 task_time 折算成绝对时间区间 |
 | idate | string | 是 | - | 入库时间口径(相对,按天或按分钟);null=该维度不过滤 |
 | udate | string | 是 | - | 更新时间口径(相对,按天或按分钟);null=该维度不过滤 |
@@ -494,6 +553,13 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | created_at | string | 是 | - | 创建时间(ISO8601,UTC+8) |
 | updated_at | string | 是 | - | 更新时间(ISO8601,UTC+8) |
 
+**对象 `PlatformSite`**
+
+| 键 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|
+| platform | string | 是 | minLen=1 | 平台编码，取 list_platforms 的 name_en |
+| sites | list[string] | 是 | minItems=1, minLen=1 | 站点编码数组，取 list_sites 的 value；["*"] 表示该平台全部站点，不可混用 |
+
 **对象 `PrecheckResult`**
 
 | 键 | 类型 | 必填 | 约束 | 说明 |
@@ -508,7 +574,7 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | checked | boolean | 否 | - | 是否执行数据量统计；TopN 为 false |
 | message | string | 是 | - | 数量提示及调整参数或确认继续的说明 |
 
-示例:social-neuron-subscription job-create --name <v> --rule-ids '["a","b"]' --source '["a","b"]' --published <v> --frequency <v>
+示例:social-neuron-subscription job-create --name <v> --rule-ids '["a","b"]' --published <v> --frequency <v>
 
 ### social-neuron-subscription job-delete
 软删除本人 job:置 active=0(记录保留,可 job_update 恢复)。
@@ -553,7 +619,8 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | job_id | integer | 是 | - | job ID |
 | name | string | 是 | - | job 名称,同一凭证(token)下唯一 |
 | rule_ids | list[string] | 是 | - | 魔方规则ID数组 |
-| source | list[string] | 是 | - | 站点数组 |
+| source | list[string] | 是 | - | 历史热门站点中文名数组；元数据模式为空数组 |
+| platform_site | list[PlatformSite] | 否 | - | 元数据平台站点组合；历史热门站点模式为 null |
 | published | string | 是 | - | 发布时间口径(相对,支持按天或按分钟);触发时按 task_time 折算成绝对时间区间 |
 | idate | string | 是 | - | 入库时间口径(相对,按天或按分钟);null=该维度不过滤 |
 | udate | string | 是 | - | 更新时间口径(相对,按天或按分钟);null=该维度不过滤 |
@@ -643,7 +710,8 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | --job-id | job_id | integer | 是 | - | 目标 job |
 | --name | name | string | 否 | minLen=1, maxLen=128 | 新名称(同一凭证下唯一) |
 | --rule-ids | rule_ids | list[string] | 否 | minItems=1, minLen=1 | 整组全量覆盖 |
-| --source | source | list[string] | 否 | minItems=1, minLen=1 | 整组全量覆盖 |
+| --source | source | list[string] | 否 | minItems=1, minLen=1 | 历史热门站点中文名数组，取 list_source；整体替换范围，与 platform_site 互斥 |
+| --platform-site | platform_site | list[PlatformSite] | 否 | minItems=1 | 元数据平台站点组合；整体替换范围，与 source 互斥；不传保持原范围 |
 | --published | published | string | 否 | - | **发布时间**口径(必填字段,只能改不能清)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。 |
 | --idate | idate | string | 否 | - | **入库时间**口径。不传=不改;传空串 ""=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。 |
 | --udate | udate | string | 否 | - | **更新时间**口径。不传=不改;传空串 ""=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。 |
@@ -670,6 +738,13 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | type | string | 是 | - | 固定 octo |
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 
+**对象 `PlatformSite`**
+
+| 键 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|
+| platform | string | 是 | minLen=1 | 平台编码，取 list_platforms 的 name_en |
+| sites | list[string] | 是 | minItems=1, minLen=1 | 站点编码数组，取 list_sites 的 value；["*"] 表示该平台全部站点，不可混用 |
+
 **对象 `SftpTarget`** —— sftp(本期):把导出文件上传到 SFTP 远端目录。
 目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task
 重跑多少次,远端路径与文件名都不变。
@@ -701,7 +776,8 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | job_id | integer | 是 | - | job ID |
 | name | string | 是 | - | job 名称,同一凭证(token)下唯一 |
 | rule_ids | list[string] | 是 | - | 魔方规则ID数组 |
-| source | list[string] | 是 | - | 站点数组 |
+| source | list[string] | 是 | - | 历史热门站点中文名数组；元数据模式为空数组 |
+| platform_site | list[PlatformSite] | 否 | - | 元数据平台站点组合；历史热门站点模式为 null |
 | published | string | 是 | - | 发布时间口径(相对,支持按天或按分钟);触发时按 task_time 折算成绝对时间区间 |
 | idate | string | 是 | - | 入库时间口径(相对,按天或按分钟);null=该维度不过滤 |
 | udate | string | 是 | - | 更新时间口径(相对,按天或按分钟);null=该维度不过滤 |
@@ -716,6 +792,13 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | created_at | string | 是 | - | 创建时间(ISO8601,UTC+8) |
 | updated_at | string | 是 | - | 更新时间(ISO8601,UTC+8) |
 
+**对象 `PlatformSite`**
+
+| 键 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|
+| platform | string | 是 | minLen=1 | 平台编码，取 list_platforms 的 name_en |
+| sites | list[string] | 是 | minItems=1, minLen=1 | 站点编码数组，取 list_sites 的 value；["*"] 表示该平台全部站点，不可混用 |
+
 **对象 `PrecheckResult`**
 
 | 键 | 类型 | 必填 | 约束 | 说明 |
@@ -742,9 +825,17 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 
 | flag | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|---|
-| --source | source | list[string] | 是 | minItems=1, minLen=1 | 站点数组(中文站点名,取自 list_sites),至少 1 个;返回这些站点下字段的并集 |
+| --source | source | list[string] | 否 | minItems=1, minLen=1 | 历史热门站点中文名数组，取 list_source；与 platform_site 必须二选一 |
+| --platform-site | platform_site | list[PlatformSite] | 否 | minItems=1 | 元数据平台站点组合；platform 取 list_platforms.name_en，sites 取 list_sites.value；与 source 二选一 |
 | --keyword | keyword | string | 否 | maxLen=64 | 按字段中文名 / name_en 模糊过滤(如「情感」「互动」);不传=该站点全部字段 |
 
+**对象 `PlatformSite`**
+
+| 键 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|
+| platform | string | 是 | minLen=1 | 平台编码，取 list_platforms 的 name_en |
+| sites | list[string] | 是 | minItems=1, minLen=1 | 站点编码数组，取 list_sites 的 value；["*"] 表示该平台全部站点，不可混用 |
+
 **出参 `SubFieldList`**
 
 | 字段 | 类型 | 必填 | 约束 | 说明 |
@@ -765,24 +856,77 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | is_enum | boolean | 是 | - | 值来自内置枚举(如数据类型、情感):导出列存的是枚举码;如需换成中文,再按需调 get_field_values 取字典自行替换 |
 | is_code | boolean | 是 | - | 值是编码值(如品牌标签、品类标签):导出列存的是 code 而非中文;如需换成中文,再按需调 get_field_values 取字典自行替换 |
 
-示例:social-neuron-subscription list-fields --source '["a","b"]'
+示例:social-neuron-subscription list-fields
+
+### social-neuron-subscription list-platforms
+列出舆情元数据平台，name_en 填入 platform_site[].platform。
+
+**入参**
+
+| flag | 字段 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|---|
+
+**出参 `SubPlatformList`**
+
+| 字段 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|
+| items | list[Platform] | 是 | - | 元数据平台列表，name_en 填 platform_site.platform |
+| total | integer | 是 | - | 平台总数 |
+
+**对象 `Platform`**
+
+| 键 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|
+| name_en | string | 是 | - | 平台标识(= kw_platform 值) |
+| name | string | 是 | - | 平台中文名 |
+| description | string | 否 | - | 平台描述 |
+| index_prefix | string | 否 | - | 索引前缀(索引名解析用) |
+| time_pattern | string | 否 | - | 索引时间分片模式(如 yyyyMM) |
+
+示例:social-neuron-subscription list-platforms
 
 ### social-neuron-subscription list-sites
-列出可订阅站点(中文站点名)—— job_create / job_update 的 source 只能取这里的值。
+搜索元数据站点，value 填 platform_site[].sites；原热门站点列表已改名 list_source。
 
 **入参**
 
 | flag | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|---|
+| --keyword | keyword | string | 否 | maxLen=64 | 按站点中文名或编码搜索，建议传关键词收窄结果 |
 
 **出参 `SubSiteList`**
 
+| 字段 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|
+| items | list[Site] | 是 | - | 元数据全局站点列表，value 填 platform_site.sites；不包含平台归属，保存时校验对应关系 |
+| total | integer | 是 | - | 命中站点总数 |
+
+**对象 `Site`**
+
+| 键 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|
+| name | string | 是 | - | 站点中文名 |
+| value | string | 是 | - | ES 来源字段值(如 douyin.com);站点目录即字典,value_source=none |
+| is_key_site | boolean | 否 | - | 是否重点站点 |
+
+示例:social-neuron-subscription list-sites
+
+### social-neuron-subscription list-source
+列出可订阅站点(中文站点名)—— job_create / job_update 的 source 只能取这里的值。
+
+**入参**
+
+| flag | 字段 | 类型 | 必填 | 约束 | 说明 |
+|---|---|---|---|---|---|
+
+**出参 `SubSourceList`**
+
 | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
 | items | list[string] | 是 | - | 中文站点名列表,即 job_create / job_update 的 source 该填的值(按配置顺序) |
 | total | integer | 是 | - | 站点总数 |
 
-示例:social-neuron-subscription list-sites
+示例:social-neuron-subscription list-source
 
 ### social-neuron-subscription precheck
 可选预览订阅创建/修改的数据量；正式保存会重新检查，TopN 保持原样。
@@ -799,10 +943,11 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 
 | 键 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
+| source | list[string] | 否 | minItems=1, minLen=1 | 历史热门站点中文名数组，取 list_source；与 platform_site 必须二选一 |
+| platform_site | list[PlatformSite] | 否 | minItems=1 | 元数据平台站点组合；platform 取 list_platforms.name_en，sites 取 list_sites.value；与 source 二选一 |
 | confirmed | boolean | 否 | - | 是否已确认继续并同意系统超限处理规则；超量时默认拒绝，true 允许保存但仍按上限截断；不跳过其他校验，不保存到 job，TopN 不适用 |
 | name | string | 是 | minLen=1, maxLen=128 | job 名称,同一凭证(token)下唯一 |
 | rule_ids | list[string] | 是 | minItems=1, minLen=1 | 魔方规则ID数组,至少 1 个 |
-| source | list[string] | 是 | minItems=1, minLen=1 | 站点数组,至少 1 个;只能取已配置站点 |
 | published | string | 是 | - | **发布时间**口径(必填,主口径 —— 它同时决定查哪个月的索引、怎么拆分片,所以不能缺省)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。 |
 | idate | string | 否 | - | **入库时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 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个月),超限直接报错(不会静默回落)。 |
 | udate | string | 否 | - | **更新时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 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个月),超限直接报错(不会静默回落)。 |
@@ -820,7 +965,8 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | job_id | integer | 是 | - | 目标 job |
 | name | string | 否 | minLen=1, maxLen=128 | 新名称(同一凭证下唯一) |
 | rule_ids | list[string] | 否 | minItems=1, minLen=1 | 整组全量覆盖 |
-| source | list[string] | 否 | minItems=1, minLen=1 | 整组全量覆盖 |
+| source | list[string] | 否 | minItems=1, minLen=1 | 历史热门站点中文名数组，取 list_source；整体替换范围，与 platform_site 互斥 |
+| platform_site | list[PlatformSite] | 否 | minItems=1 | 元数据平台站点组合；整体替换范围，与 source 互斥；不传保持原范围 |
 | published | string | 否 | - | **发布时间**口径(必填字段,只能改不能清)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。 |
 | idate | string | 否 | - | **入库时间**口径。不传=不改;传空串 ""=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。 |
 | udate | string | 否 | - | **更新时间**口径。不传=不改;传空串 ""=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 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个月),超限直接报错(不会静默回落)。 |