@social-data/social-neuron-subscription 1.0.0-beta.5 → 1.0.0-beta.6

package/manifest.json

@@ -184,15 +184,39 @@
             "type": "array"
           },
           "published": {
-            "description": "发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天到昨天)",
-            "enum": [
-              "T-0",
-              "T-1",
-              "T-7"
-            ],
+            "description": "**发布时间**口径(必填,主口径 —— 它同时决定查哪个月的索引、怎么拆分片,所以不能缺省)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。",
+            "pattern": "^T-\\d+~T-\\d+$",
             "title": "Published",
             "type": "string"
           },
+          "idate": {
+            "anyOf": [
+              {
+                "pattern": "^T-\\d+~T-\\d+$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "**入库时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 AND 一层:入库时间落在本区间的数据。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。",
+            "title": "Idate"
+          },
+          "udate": {
+            "anyOf": [
+              {
+                "pattern": "^T-\\d+~T-\\d+$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "**更新时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 AND 一层:更新时间落在本区间的数据。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。",
+            "title": "Udate"
+          },
           "frequency": {
             "description": "自然语言同步频率,系统转 cron(东八区)。可指定具体时间、并**支持一天多次**:如「每天9点」「每天9点和15点」(一天跑两次)「每周一9点」「每小时」「每30分钟」。无法解析为 cron 会被拒绝。",
             "maxLength": 64,
@@ -237,7 +261,7 @@
               }
             ],
             "default": null,
-            "description": "投递目标;省略默认 octo(excel)。本期仅接受 octo",
+            "description": "投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。",
             "title": "Target"
           }
         },
@@ -282,10 +306,34 @@
             "type": "array"
           },
           "published": {
-            "description": "发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天)",
+            "description": "发布时间口径(相对,规范形态 T-M~T-N,如 T-1~T-1 / T-7~T-3);触发时按 task_time 折算成绝对日期区间",
             "title": "Published",
             "type": "string"
           },
+          "idate": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "入库时间口径(相对,T-M~T-N);null=该维度不过滤",
+            "title": "Idate"
+          },
+          "udate": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "更新时间口径(相对,T-M~T-N);null=该维度不过滤",
+            "title": "Udate"
+          },
           "fields": {
             "description": "拉取/导出字段(空=全量)",
             "items": {
@@ -305,7 +353,7 @@
             "type": "string"
           },
           "target_type": {
-            "description": "投递类型:octo(本期)/sftp/kafka",
+            "description": "投递类型:octo、sftp、kafka(暂不支持)",
             "title": "Target Type",
             "type": "string"
           },
@@ -337,6 +385,8 @@
           "rule_ids",
           "source",
           "published",
+          "idate",
+          "udate",
           "fields",
           "frequency",
           "cron",
@@ -374,9 +424,23 @@
         {
           "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**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。"
+        },
+        {
+          "flag": "--idate",
+          "field": "idate",
+          "type": "string",
+          "required": false,
+          "desc": "**入库时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 AND 一层:入库时间落在本区间的数据。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。"
+        },
+        {
+          "flag": "--udate",
+          "field": "udate",
+          "type": "string",
+          "required": false,
+          "desc": "**更新时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 AND 一层:更新时间落在本区间的数据。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。"
         },
         {
           "flag": "--frequency",
@@ -397,7 +461,7 @@
           "field": "target",
           "type": "object(json)",
           "required": false,
-          "desc": "投递目标;省略默认 octo(excel)。本期仅接受 octo"
+          "desc": "投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。"
         }
       ],
       "transport": {
@@ -540,10 +604,34 @@
                 "type": "array"
               },
               "published": {
-                "description": "发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天)",
+                "description": "发布时间口径(相对,规范形态 T-M~T-N,如 T-1~T-1 / T-7~T-3);触发时按 task_time 折算成绝对日期区间",
                 "title": "Published",
                 "type": "string"
               },
+              "idate": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "入库时间口径(相对,T-M~T-N);null=该维度不过滤",
+                "title": "Idate"
+              },
+              "udate": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "更新时间口径(相对,T-M~T-N);null=该维度不过滤",
+                "title": "Udate"
+              },
               "fields": {
                 "description": "拉取/导出字段(空=全量)",
                 "items": {
@@ -563,7 +651,7 @@
                 "type": "string"
               },
               "target_type": {
-                "description": "投递类型:octo(本期)/sftp/kafka",
+                "description": "投递类型:octo、sftp、kafka(暂不支持)",
                 "title": "Target Type",
                 "type": "string"
               },
@@ -595,6 +683,8 @@
               "rule_ids",
               "source",
               "published",
+              "idate",
+              "udate",
               "fields",
               "frequency",
               "cron",
@@ -820,7 +910,7 @@
               }
             ],
             "default": null,
-            "description": "回溯起始;与 end_time 同传同不传",
+            "description": "本次**发布时间**下界(绝对时间,ISO8601 UTC+8,如 2026-08-14T00:00:00+08:00);与 end_time 同传同不传;不传则按 job 上的 published 相对口径折算",
             "title": "Start Time"
           },
           "end_time": {
@@ -833,9 +923,61 @@
               }
             ],
             "default": null,
-            "description": "回溯结束",
+            "description": "本次**发布时间**上界(绝对时间,ISO8601 UTC+8,如 2026-08-20T23:59:59+08:00)",
             "title": "End Time"
           },
+          "idate_start": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "本次**入库时间**下界(绝对时间,ISO8601 UTC+8);与 idate_end 同传同不传;不传则按 job 上的 idate 相对口径折算,job 也没配=该维度不过滤",
+            "title": "Idate Start"
+          },
+          "idate_end": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "本次**入库时间**上界(绝对时间,ISO8601 UTC+8)",
+            "title": "Idate End"
+          },
+          "udate_start": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "本次**更新时间**下界(绝对时间,ISO8601 UTC+8);与 udate_end 同传同不传;不传则按 job 上的 udate 相对口径折算,job 也没配=该维度不过滤",
+            "title": "Udate Start"
+          },
+          "udate_end": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "本次**更新时间**上界(绝对时间,ISO8601 UTC+8)",
+            "title": "Udate End"
+          },
           "target": {
             "anyOf": [
               {
@@ -908,14 +1050,42 @@
           "field": "start_time",
           "type": "string",
           "required": false,
-          "desc": "回溯起始;与 end_time 同传同不传"
+          "desc": "本次**发布时间**下界(绝对时间,ISO8601 UTC+8,如 2026-08-14T00:00:00+08:00);与 end_time 同传同不传;不传则按 job 上的 published 相对口径折算"
         },
         {
           "flag": "--end-time",
           "field": "end_time",
           "type": "string",
           "required": false,
-          "desc": "回溯结束"
+          "desc": "本次**发布时间**上界(绝对时间,ISO8601 UTC+8,如 2026-08-20T23:59:59+08:00)"
+        },
+        {
+          "flag": "--idate-start",
+          "field": "idate_start",
+          "type": "string",
+          "required": false,
+          "desc": "本次**入库时间**下界(绝对时间,ISO8601 UTC+8);与 idate_end 同传同不传;不传则按 job 上的 idate 相对口径折算,job 也没配=该维度不过滤"
+        },
+        {
+          "flag": "--idate-end",
+          "field": "idate_end",
+          "type": "string",
+          "required": false,
+          "desc": "本次**入库时间**上界(绝对时间,ISO8601 UTC+8)"
+        },
+        {
+          "flag": "--udate-start",
+          "field": "udate_start",
+          "type": "string",
+          "required": false,
+          "desc": "本次**更新时间**下界(绝对时间,ISO8601 UTC+8);与 udate_end 同传同不传;不传则按 job 上的 udate 相对口径折算,job 也没配=该维度不过滤"
+        },
+        {
+          "flag": "--udate-end",
+          "field": "udate_end",
+          "type": "string",
+          "required": false,
+          "desc": "本次**更新时间**上界(绝对时间,ISO8601 UTC+8)"
         },
         {
           "flag": "--target",
@@ -1149,11 +1319,7 @@
           "published": {
             "anyOf": [
               {
-                "enum": [
-                  "T-0",
-                  "T-1",
-                  "T-7"
-                ],
+                "pattern": "^T-\\d+~T-\\d+$",
                 "type": "string"
               },
               {
@@ -1161,9 +1327,37 @@
               }
             ],
             "default": null,
-            "description": "发布时间口径:T-0 / T-1 / T-7",
+            "description": "**发布时间**口径(必填字段,只能改不能清)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。",
             "title": "Published"
           },
+          "idate": {
+            "anyOf": [
+              {
+                "pattern": "^(?:T-\\d+~T-\\d+)?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "**入库时间**口径。不传=不改;传空串 \"\"=**清除**该维度(恢复成不过滤)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。",
+            "title": "Idate"
+          },
+          "udate": {
+            "anyOf": [
+              {
+                "pattern": "^(?:T-\\d+~T-\\d+)?$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "**更新时间**口径。不传=不改;传空串 \"\"=**清除**该维度(恢复成不过滤)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。",
+            "title": "Udate"
+          },
           "fields": {
             "anyOf": [
               {
@@ -1282,10 +1476,34 @@
             "type": "array"
           },
           "published": {
-            "description": "发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天)",
+            "description": "发布时间口径(相对,规范形态 T-M~T-N,如 T-1~T-1 / T-7~T-3);触发时按 task_time 折算成绝对日期区间",
             "title": "Published",
             "type": "string"
           },
+          "idate": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "入库时间口径(相对,T-M~T-N);null=该维度不过滤",
+            "title": "Idate"
+          },
+          "udate": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "更新时间口径(相对,T-M~T-N);null=该维度不过滤",
+            "title": "Udate"
+          },
           "fields": {
             "description": "拉取/导出字段(空=全量)",
             "items": {
@@ -1305,7 +1523,7 @@
             "type": "string"
           },
           "target_type": {
-            "description": "投递类型:octo(本期)/sftp/kafka",
+            "description": "投递类型:octo、sftp、kafka(暂不支持)",
             "title": "Target Type",
             "type": "string"
           },
@@ -1337,6 +1555,8 @@
           "rule_ids",
           "source",
           "published",
+          "idate",
+          "udate",
           "fields",
           "frequency",
           "cron",
@@ -1381,9 +1601,23 @@
         {
           "flag": "--published",
           "field": "published",
-          "type": "enum(T-0、T-1、T-7)",
+          "type": "string",
+          "required": false,
+          "desc": "**发布时间**口径(必填字段,只能改不能清)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。"
+        },
+        {
+          "flag": "--idate",
+          "field": "idate",
+          "type": "string",
+          "required": false,
+          "desc": "**入库时间**口径。不传=不改;传空串 \"\"=**清除**该维度(恢复成不过滤)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。"
+        },
+        {
+          "flag": "--udate",
+          "field": "udate",
+          "type": "string",
           "required": false,
-          "desc": "发布时间口径:T-0 / T-1 / T-7"
+          "desc": "**更新时间**口径。不传=不改;传空串 \"\"=**清除**该维度(恢复成不过滤)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。"
         },
         {
           "flag": "--fields",

package/package.json

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

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

@@ -24,10 +24,12 @@ metadata:
 | --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 | enum(T-0、T-1、T-7) | 是 | - | 发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天到昨天) |
+| --published | published | string | 是 | - | **发布时间**口径(必填,主口径 —— 它同时决定查哪个月的索引、怎么拆分片,所以不能缺省)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。 |
+| --idate | idate | string | 否 | - | **入库时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 AND 一层:入库时间落在本区间的数据。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。 |
+| --udate | udate | string | 否 | - | **更新时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 AND 一层:更新时间落在本区间的数据。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。 |
 | --frequency | frequency | string | 是 | minLen=1, maxLen=64 | 自然语言同步频率,系统转 cron(东八区)。可指定具体时间、并**支持一天多次**:如「每天9点」「每天9点和15点」(一天跑两次)「每周一9点」「每小时」「每30分钟」。无法解析为 cron 会被拒绝。 |
 | --fields | fields | list[string] | 否 | minLen=1 | 拉取/导出字段;不填拉全量 |
-| --target | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 投递目标;省略默认 octo(excel)。本期仅接受 octo |
+| --target | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。 |
 
 **对象 `KafkaTarget`** —— kafka(规划):把记录流投送到 topic(无文件)。
 
@@ -67,11 +69,13 @@ metadata:
 | name | string | 是 | - | job 名称,同一凭证(token)下唯一 |
 | rule_ids | list[string] | 是 | - | 魔方规则ID数组 |
 | source | list[string] | 是 | - | 站点数组 |
-| published | string | 是 | - | 发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天) |
+| published | string | 是 | - | 发布时间口径(相对,规范形态 T-M~T-N,如 T-1~T-1 / T-7~T-3);触发时按 task_time 折算成绝对日期区间 |
+| idate | string | 是 | - | 入库时间口径(相对,T-M~T-N);null=该维度不过滤 |
+| udate | string | 是 | - | 更新时间口径(相对,T-M~T-N);null=该维度不过滤 |
 | fields | list[string] | 是 | - | 拉取/导出字段(空=全量) |
 | frequency | string | 是 | - | 自然语言频率 |
 | cron | string | 是 | - | 系统由 frequency 转换的 cron |
-| target_type | string | 是 | - | 投递类型:octo(本期)/sftp/kafka |
+| target_type | string | 是 | - | 投递类型:octo、sftp、kafka(暂不支持) |
 | target_info | object | 是 | - | 投递配置 |
 | active | integer | 是 | - | 1 生效 / 0 停用 |
 | created_at | string | 是 | - | 创建时间(ISO8601,UTC+8) |
@@ -121,11 +125,13 @@ metadata:
 | name | string | 是 | - | job 名称,同一凭证(token)下唯一 |
 | rule_ids | list[string] | 是 | - | 魔方规则ID数组 |
 | source | list[string] | 是 | - | 站点数组 |
-| published | string | 是 | - | 发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天) |
+| published | string | 是 | - | 发布时间口径(相对,规范形态 T-M~T-N,如 T-1~T-1 / T-7~T-3);触发时按 task_time 折算成绝对日期区间 |
+| idate | string | 是 | - | 入库时间口径(相对,T-M~T-N);null=该维度不过滤 |
+| udate | string | 是 | - | 更新时间口径(相对,T-M~T-N);null=该维度不过滤 |
 | fields | list[string] | 是 | - | 拉取/导出字段(空=全量) |
 | frequency | string | 是 | - | 自然语言频率 |
 | cron | string | 是 | - | 系统由 frequency 转换的 cron |
-| target_type | string | 是 | - | 投递类型:octo(本期)/sftp/kafka |
+| target_type | string | 是 | - | 投递类型:octo、sftp、kafka(暂不支持) |
 | target_info | object | 是 | - | 投递配置 |
 | active | integer | 是 | - | 1 生效 / 0 停用 |
 | created_at | string | 是 | - | 创建时间(ISO8601,UTC+8) |
@@ -145,8 +151,12 @@ metadata:
 | flag | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|---|
 | --job-id | job_id | integer | 是 | - | 目标 job |
-| --start-time | start_time | string | 否 | - | 回溯起始;与 end_time 同传同不传 |
-| --end-time | end_time | string | 否 | - | 回溯结束 |
+| --start-time | start_time | string | 否 | - | 本次**发布时间**下界(绝对时间,ISO8601 UTC+8,如 2026-08-14T00:00:00+08:00);与 end_time 同传同不传;不传则按 job 上的 published 相对口径折算 |
+| --end-time | end_time | string | 否 | - | 本次**发布时间**上界(绝对时间,ISO8601 UTC+8,如 2026-08-20T23:59:59+08:00) |
+| --idate-start | idate_start | string | 否 | - | 本次**入库时间**下界(绝对时间,ISO8601 UTC+8);与 idate_end 同传同不传;不传则按 job 上的 idate 相对口径折算,job 也没配=该维度不过滤 |
+| --idate-end | idate_end | string | 否 | - | 本次**入库时间**上界(绝对时间,ISO8601 UTC+8) |
+| --udate-start | udate_start | string | 否 | - | 本次**更新时间**下界(绝对时间,ISO8601 UTC+8);与 udate_end 同传同不传;不传则按 job 上的 udate 相对口径折算,job 也没配=该维度不过滤 |
+| --udate-end | udate_end | string | 否 | - | 本次**更新时间**上界(绝对时间,ISO8601 UTC+8) |
 | --target | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 覆盖本次投递目标 |
 
 **对象 `KafkaTarget`** —— kafka(规划):把记录流投送到 topic(无文件)。
@@ -199,7 +209,9 @@ metadata:
 | --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 | 整组全量覆盖 |
-| --published | published | enum(T-0、T-1、T-7) | 否 | - | 发布时间口径:T-0 / T-1 / T-7 |
+| --published | published | string | 否 | - | **发布时间**口径(必填字段,只能改不能清)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。 |
+| --idate | idate | string | 否 | - | **入库时间**口径。不传=不改;传空串 ""=**清除**该维度(恢复成不过滤)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。 |
+| --udate | udate | string | 否 | - | **更新时间**口径。不传=不改;传空串 ""=**清除**该维度(恢复成不过滤)。记法 **T-M~T-N**:从 M 天前到 N 天前的闭区间(要求 M>=N),端点按天计,基准日是本次触发的 task_time(东八区;定时=cron 槽位日,手动=触发当日)。**两个端点都必须写全,不接受单值简写** —— 「昨天」写 T-1~T-1,写 T-1 会被拒绝。举例:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-2=前天;T-1~T-0=昨天到今天(2天);T-2~T-1=前天到昨天(2天,口语的「前两天」);T-3~T-1=前三天(3天);T-7~T-3=7天前到3天前(5天);T-7~T-1=近7天到昨天(7天)。跨度最多 120 天、偏移最多 720 天(近两年),M<N 或超限直接报错(不会静默回落)。 |
 | --fields | fields | list[string] | 否 | minLen=1 | 整组全量覆盖 |
 | --frequency | frequency | string | 否 | minLen=1, maxLen=64 | 传入则按新频率重算 cron(用法同创建;支持一天多次,如「每天9点和15点」);无法解析为 cron 会被拒绝 |
 | --target | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 整体替换投递目标 |
@@ -243,11 +255,13 @@ metadata:
 | name | string | 是 | - | job 名称,同一凭证(token)下唯一 |
 | rule_ids | list[string] | 是 | - | 魔方规则ID数组 |
 | source | list[string] | 是 | - | 站点数组 |
-| published | string | 是 | - | 发布时间口径:T-0(当天)/ T-1(昨天)/ T-7(近7天) |
+| published | string | 是 | - | 发布时间口径(相对,规范形态 T-M~T-N,如 T-1~T-1 / T-7~T-3);触发时按 task_time 折算成绝对日期区间 |
+| idate | string | 是 | - | 入库时间口径(相对,T-M~T-N);null=该维度不过滤 |
+| udate | string | 是 | - | 更新时间口径(相对,T-M~T-N);null=该维度不过滤 |
 | fields | list[string] | 是 | - | 拉取/导出字段(空=全量) |
 | frequency | string | 是 | - | 自然语言频率 |
 | cron | string | 是 | - | 系统由 frequency 转换的 cron |
-| target_type | string | 是 | - | 投递类型:octo(本期)/sftp/kafka |
+| target_type | string | 是 | - | 投递类型:octo、sftp、kafka(暂不支持) |
 | target_info | object | 是 | - | 投递配置 |
 | active | integer | 是 | - | 1 生效 / 0 停用 |
 | created_at | string | 是 | - | 创建时间(ISO8601,UTC+8) |