npm - @social-data/social-neuron-subscription - Versions diffs - 1.0.0-beta.5 → 1.0.0-beta.7 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/manifest.json +268 -28
package/package.json +1 -1
package/skills/social-neuron-subscription/SKILL.md +25 -11

package/manifest.json CHANGED Viewed

@@ -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",
@@ -813,6 +903,7 @@
           "start_time": {
             "anyOf": [
               {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                 "type": "string"
               },
               {
@@ -820,12 +911,13 @@
               }
             ],
             "default": null,
-            "description": "回溯起始;与 end_time 同传同不传",
+            "description": "**发布时间**下界(绝对日期 yyyy-MM-dd,东八区,按天闭区间,不含时分秒);与 end_time 同传同不传;不传则按 job 上的 published 相对口径折算",
             "title": "Start Time"
           },
           "end_time": {
             "anyOf": [
               {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                 "type": "string"
               },
               {
@@ -833,9 +925,65 @@
               }
             ],
             "default": null,
-            "description": "回溯结束",
+            "description": "**发布时间**上界(绝对日期 yyyy-MM-dd,东八区,该日整天含在窗内)",
             "title": "End Time"
           },
+          "idate_start": {
+            "anyOf": [
+              {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "**入库时间**下界(绝对日期 yyyy-MM-dd,东八区);与 idate_end 同传同不传;不传则按 job 上的 idate 相对口径折算,job 也没配=该维度不过滤",
+            "title": "Idate Start"
+          },
+          "idate_end": {
+            "anyOf": [
+              {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "本次**入库时间**上界(绝对日期 yyyy-MM-dd,东八区,该日整天含在窗内)",
+            "title": "Idate End"
+          },
+          "udate_start": {
+            "anyOf": [
+              {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "**更新时间**下界(绝对日期 yyyy-MM-dd,东八区);与 udate_end 同传同不传;不传则按 job 上的 udate 相对口径折算,job 也没配=该维度不过滤",
+            "title": "Udate Start"
+          },
+          "udate_end": {
+            "anyOf": [
+              {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "**更新时间**上界(绝对日期 yyyy-MM-dd,东八区,该日整天含在窗内)",
+            "title": "Udate End"
+          },
           "target": {
             "anyOf": [
               {
@@ -908,14 +1056,42 @@
           "field": "start_time",
           "type": "string",
           "required": false,
-          "desc": "回溯起始;与 end_time 同传同不传"
+          "desc": "**发布时间**下界(绝对日期 yyyy-MM-dd,东八区,按天闭区间,不含时分秒);与 end_time 同传同不传;不传则按 job 上的 published 相对口径折算"
         },
         {
           "flag": "--end-time",
           "field": "end_time",
           "type": "string",
           "required": false,
-          "desc": "回溯结束"
+          "desc": "**发布时间**上界(绝对日期 yyyy-MM-dd,东八区,该日整天含在窗内)"
+        },
+        {
+          "flag": "--idate-start",
+          "field": "idate_start",
+          "type": "string",
+          "required": false,
+          "desc": "**入库时间**下界(绝对日期 yyyy-MM-dd,东八区);与 idate_end 同传同不传;不传则按 job 上的 idate 相对口径折算,job 也没配=该维度不过滤"
+        },
+        {
+          "flag": "--idate-end",
+          "field": "idate_end",
+          "type": "string",
+          "required": false,
+          "desc": "本次**入库时间**上界(绝对日期 yyyy-MM-dd,东八区,该日整天含在窗内)"
+        },
+        {
+          "flag": "--udate-start",
+          "field": "udate_start",
+          "type": "string",
+          "required": false,
+          "desc": "**更新时间**下界(绝对日期 yyyy-MM-dd,东八区);与 udate_end 同传同不传;不传则按 job 上的 udate 相对口径折算,job 也没配=该维度不过滤"
+        },
+        {
+          "flag": "--udate-end",
+          "field": "udate_end",
+          "type": "string",
+          "required": false,
+          "desc": "**更新时间**上界(绝对日期 yyyy-MM-dd,东八区,该日整天含在窗内)"
         },
         {
           "flag": "--target",
@@ -1149,11 +1325,7 @@
           "published": {
             "anyOf": [
               {
-                "enum": [
-                  "T-0",
-                  "T-1",
-                  "T-7"
-                ],
+                "pattern": "^T-\\d+~T-\\d+$",
                 "type": "string"
               },
               {
@@ -1161,9 +1333,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 +1482,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 +1529,7 @@
             "type": "string"
           },
           "target_type": {
-            "description": "投递类型:octo(本期)/sftp/kafka",
+            "description": "投递类型:octo、sftp、kafka(暂不支持)",
             "title": "Target Type",
             "type": "string"
           },
@@ -1337,6 +1561,8 @@
           "rule_ids",
           "source",
           "published",
+          "idate",
+          "udate",
           "fields",
           "frequency",
           "cron",
@@ -1381,9 +1607,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 CHANGED Viewed

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

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

@@ -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 | 否 | - | **发布时间**下界(绝对日期 yyyy-MM-dd,东八区,按天闭区间,不含时分秒);与 end_time 同传同不传;不传则按 job 上的 published 相对口径折算 |
+| --end-time | end_time | string | 否 | - | **发布时间**上界(绝对日期 yyyy-MM-dd,东八区,该日整天含在窗内) |
+| --idate-start | idate_start | string | 否 | - | **入库时间**下界(绝对日期 yyyy-MM-dd,东八区);与 idate_end 同传同不传;不传则按 job 上的 idate 相对口径折算,job 也没配=该维度不过滤 |
+| --idate-end | idate_end | string | 否 | - | 本次**入库时间**上界(绝对日期 yyyy-MM-dd,东八区,该日整天含在窗内) |
+| --udate-start | udate_start | string | 否 | - | **更新时间**下界(绝对日期 yyyy-MM-dd,东八区);与 udate_end 同传同不传;不传则按 job 上的 udate 相对口径折算,job 也没配=该维度不过滤 |
+| --udate-end | udate_end | string | 否 | - | **更新时间**上界(绝对日期 yyyy-MM-dd,东八区,该日整天含在窗内) |
 | --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) |