npm - @social-data/social-neuron-subscription - Versions diffs - 1.0.0-beta.1 → 1.0.0-beta.10 - Mend

@social-data/social-neuron-subscription 1.0.0-beta.1 → 1.0.0-beta.10

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 (5) hide show

package/bin/cli.js +8 -3
package/bin/install-skills.js +1 -1
package/manifest.json +415 -52
package/package.json +1 -1
package/skills/social-neuron-subscription/SKILL.md +58 -28

package/bin/cli.js CHANGED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 "use strict";
-// ⚠️ 本文件由 backend/app/cli_spec/gen.py 生成,请勿手改;要改改 gen.py 的 _CLI_JS 后重跑 gen。
+// ⚠️ 本文件由 core/cli/gen.py 生成,请勿手改;要改改 gen.py 的 _CLI_JS 后重跑 gen。
 //
 // 能力 CLI —— 通用薄运行时(纯 JS,零依赖):一能力一命令、一包、一配置文件,互不影响。
 //   <cmd> <action> [--flags]                       调用一条命令
@@ -40,7 +40,11 @@ function resolveConfig() {
 function emit(env) {
   process.stdout.write(JSON.stringify(env) + "\n");
-  process.exit(env.ok ? 0 : (EXIT[env.error && env.error.type] ?? 1));
+  const dataExit = env.ok && env.data && env.data.meta && env.data.meta.exit_code;
+  const status = env.ok
+    ? ([0, 1, 2].includes(dataExit) ? dataExit : 0)
+    : (EXIT[env.error && env.error.type] ?? 1);
+  process.exit(status);
 }
 function fail(type, code, message, extra) {
   emit({ ok: false, error: { type, code, message, ...(extra || {}) } });
@@ -167,7 +171,8 @@ function parseArgs(cmd, argv) {
 }
 async function main() {
-  const argv = process.argv.slice(2);
+  let argv = process.argv.slice(2);
+  if (argv.length === 0 && MANIFEST.default_action) argv = [MANIFEST.default_action];
   if (argv.length === 0 || argv[0] === "--help" || argv[0] === "-h") return printHelp();
   if (argv[0] === "--version" || argv[0] === "-V") { process.stdout.write(VERSION + "\n"); return; }
   if (argv[0] === "bind") return doBind(argv.slice(1));

package/bin/install-skills.js CHANGED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 "use strict";
-// ⚠️ 本文件由 backend/app/cli_spec/gen.py 生成,请勿手改。
+// ⚠️ 本文件由 core/cli/gen.py 生成,请勿手改。
 // postinstall:把包内 SKILL.md 覆盖写到 OpenClaw 技能目录(OPENCLAW_SKILLS_DIR 或 ~/.openclaw/skills)。
 const fs = require("fs");

package/manifest.json CHANGED Viewed

@@ -2,6 +2,7 @@
   "revision": 6,
   "capability": "subscription",
   "command": "social-neuron-subscription",
+  "default_action": null,
   "mcp_path": "/subscription/mcp",
   "tools": [
     {
@@ -84,7 +85,7 @@
           },
           "SftpTarget": {
             "additionalProperties": false,
-            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。",
+            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
             "properties": {
               "type": {
                 "const": "sftp",
@@ -114,10 +115,23 @@
                 "type": "string"
               },
               "remote_path": {
-                "description": "远端目录/路径",
+                "description": "远端目录/路径。可在**任意一层**用日期变量,但变量必须**独占一层**:`/data/sub/yyyyMM/yyyyMMdd` 合法,`/data/sub_yyyyMMdd` 非法。只认 yyyyMMdd / yyyyMM / yyyy 三种;不允许 '..'、空目录层。",
                 "title": "Remote Path",
                 "type": "string"
               },
+              "filename_template": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "自定义文件名模板(不含扩展名)。只允许字母、数字、'_'、'-' 与日期变量,且变量前后必须是 '_' 或首尾:`daily_yyyyMMdd_export`、`yyyyMM_summary` 合法,`dailyyyyyMMdd`、`report-yyyyMMdd-x` 非法。系统统一追加 `_<task_id>` 与扩展名。不传=沿用默认 `<job_id>_<task_id>.<ext>`。",
+                "title": "Filename Template"
+              },
               "format": {
                 "default": "json",
                 "description": "文件格式:csv/excel/json(默认 json)",
@@ -144,7 +158,7 @@
         "additionalProperties": false,
         "properties": {
           "name": {
-            "description": "job 名称,全局唯一",
+            "description": "job 名称,同一凭证(token)下唯一",
             "maxLength": 128,
             "minLength": 1,
             "title": "Name",
@@ -171,15 +185,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,
@@ -196,6 +234,14 @@
             "title": "Fields",
             "type": "array"
           },
+          "size": {
+            "default": 500000,
+            "description": "每次执行最多导出的记录行数,默认且最大为 500000",
+            "maximum": 500000,
+            "minimum": 1,
+            "title": "Size",
+            "type": "integer"
+          },
           "target": {
             "anyOf": [
               {
@@ -224,7 +270,7 @@
               }
             ],
             "default": null,
-            "description": "投递目标;省略默认 octo(excel)。本期仅接受 octo",
+            "description": "投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。",
             "title": "Target"
           }
         },
@@ -240,15 +286,15 @@
       },
       "output_schema": {
         "additionalProperties": false,
-        "description": "订阅 job 出参对象(= sub_job 全字段,id 暴露为 job_id)。",
+        "description": "订阅 job 出参对象。",
         "properties": {
           "job_id": {
-            "description": "job ID(sub_job.id)",
+            "description": "job ID",
             "title": "Job Id",
             "type": "integer"
           },
           "name": {
-            "description": "job 名称,全局唯一",
+            "description": "job 名称,同一凭证(token)下唯一",
             "title": "Name",
             "type": "string"
           },
@@ -269,10 +315,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": {
@@ -281,6 +351,11 @@
             "title": "Fields",
             "type": "array"
           },
+          "size": {
+            "description": "每次执行最多导出的记录行数,范围 1–500000",
+            "title": "Size",
+            "type": "integer"
+          },
           "frequency": {
             "description": "自然语言频率",
             "title": "Frequency",
@@ -292,7 +367,7 @@
             "type": "string"
           },
           "target_type": {
-            "description": "投递类型:octo(本期)/sftp/kafka",
+            "description": "投递类型:octo、sftp、kafka(暂不支持)",
             "title": "Target Type",
             "type": "string"
           },
@@ -324,7 +399,10 @@
           "rule_ids",
           "source",
           "published",
+          "idate",
+          "udate",
           "fields",
+          "size",
           "frequency",
           "cron",
           "target_type",
@@ -342,7 +420,7 @@
           "field": "name",
           "type": "string",
           "required": true,
-          "desc": "job 名称,全局唯一"
+          "desc": "job 名称,同一凭证(token)下唯一"
         },
         {
           "flag": "--rule-ids",
@@ -361,9 +439,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",
@@ -379,12 +471,19 @@
           "required": false,
           "desc": "拉取/导出字段;不填拉全量"
         },
+        {
+          "flag": "--size",
+          "field": "size",
+          "type": "integer",
+          "required": false,
+          "desc": "每次执行最多导出的记录行数,默认且最大为 500000"
+        },
         {
           "flag": "--target",
           "field": "target",
           "type": "object(json)",
           "required": false,
-          "desc": "投递目标;省略默认 octo(excel)。本期仅接受 octo"
+          "desc": "投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。"
         }
       ],
       "transport": {
@@ -498,15 +597,15 @@
         "$defs": {
           "SubJob": {
             "additionalProperties": false,
-            "description": "订阅 job 出参对象(= sub_job 全字段,id 暴露为 job_id)。",
+            "description": "订阅 job 出参对象。",
             "properties": {
               "job_id": {
-                "description": "job ID(sub_job.id)",
+                "description": "job ID",
                 "title": "Job Id",
                 "type": "integer"
               },
               "name": {
-                "description": "job 名称,全局唯一",
+                "description": "job 名称,同一凭证(token)下唯一",
                 "title": "Name",
                 "type": "string"
               },
@@ -527,10 +626,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": {
@@ -539,6 +662,11 @@
                 "title": "Fields",
                 "type": "array"
               },
+              "size": {
+                "description": "每次执行最多导出的记录行数,范围 1–500000",
+                "title": "Size",
+                "type": "integer"
+              },
               "frequency": {
                 "description": "自然语言频率",
                 "title": "Frequency",
@@ -550,7 +678,7 @@
                 "type": "string"
               },
               "target_type": {
-                "description": "投递类型:octo(本期)/sftp/kafka",
+                "description": "投递类型:octo、sftp、kafka(暂不支持)",
                 "title": "Target Type",
                 "type": "string"
               },
@@ -582,7 +710,10 @@
               "rule_ids",
               "source",
               "published",
+              "idate",
+              "udate",
               "fields",
+              "size",
               "frequency",
               "cron",
               "target_type",
@@ -644,8 +775,8 @@
       "action": "job-trigger",
       "op": "job_trigger",
       "name": "subscription/job_trigger",
-      "summary": "临时触发一次本人 job,落一条 sub_task(manual);默认用 job 存的 target,可覆盖。",
-      "description": "临时触发一次本人 job,落一条 sub_task(manual);默认用 job 存的 target,可覆盖。\n\n落 pending task 后触发 Airflow DAG(``social_neuron_subscription``)跑取数→组装→投递(上传取 url);\n未配 airflow_base_url 时(本地/测试)触发被跳过,仅留 pending task。**无通知**:结果落\n``file_info.url``,调用方轮询 ``task-list`` 拉取。",
+      "summary": "临时触发一次本人 job,落一条 ik_subscription_task(manual);默认用 job 存的 target,可覆盖。",
+      "description": "临时触发一次本人 job,落一条 ik_subscription_task(manual);默认用 job 存的 target,可覆盖。\n\n落 pending task 后触发 Airflow DAG(``social_neuron_subscription``)跑取数→组装→投递(上传取 url);\n未配 airflow_base_url 时(本地/测试)触发被跳过,仅留 pending task。**无通知**:结果落\n``file_info.url``,调用方轮询 ``task-list`` 拉取。",
       "input_schema": {
         "$defs": {
           "KafkaTarget": {
@@ -720,7 +851,7 @@
           },
           "SftpTarget": {
             "additionalProperties": false,
-            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。",
+            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
             "properties": {
               "type": {
                 "const": "sftp",
@@ -750,10 +881,23 @@
                 "type": "string"
               },
               "remote_path": {
-                "description": "远端目录/路径",
+                "description": "远端目录/路径。可在**任意一层**用日期变量,但变量必须**独占一层**:`/data/sub/yyyyMM/yyyyMMdd` 合法,`/data/sub_yyyyMMdd` 非法。只认 yyyyMMdd / yyyyMM / yyyy 三种;不允许 '..'、空目录层。",
                 "title": "Remote Path",
                 "type": "string"
               },
+              "filename_template": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "自定义文件名模板(不含扩展名)。只允许字母、数字、'_'、'-' 与日期变量,且变量前后必须是 '_' 或首尾:`daily_yyyyMMdd_export`、`yyyyMM_summary` 合法,`dailyyyyyMMdd`、`report-yyyyMMdd-x` 非法。系统统一追加 `_<task_id>` 与扩展名。不传=沿用默认 `<job_id>_<task_id>.<ext>`。",
+                "title": "Filename Template"
+              },
               "format": {
                 "default": "json",
                 "description": "文件格式:csv/excel/json(默认 json)",
@@ -787,6 +931,7 @@
           "start_time": {
             "anyOf": [
               {
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                 "type": "string"
               },
               {
@@ -794,12 +939,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"
               },
               {
@@ -807,9 +953,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": [
               {
@@ -840,6 +1042,21 @@
             "default": null,
             "description": "覆盖本次投递目标",
             "title": "Target"
+          },
+          "size": {
+            "anyOf": [
+              {
+                "maximum": 500000,
+                "minimum": 1,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "覆盖本次导出行数;不传则继承 job 的 size,最大 500000",
+            "title": "Size"
           }
         },
         "required": [
@@ -882,14 +1099,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",
@@ -897,6 +1142,13 @@
           "type": "object(json)",
           "required": false,
           "desc": "覆盖本次投递目标"
+        },
+        {
+          "flag": "--size",
+          "field": "size",
+          "type": "integer",
+          "required": false,
+          "desc": "覆盖本次导出行数;不传则继承 job 的 size,最大 500000"
         }
       ],
       "transport": {
@@ -992,7 +1244,7 @@
           },
           "SftpTarget": {
             "additionalProperties": false,
-            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。",
+            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
             "properties": {
               "type": {
                 "const": "sftp",
@@ -1022,10 +1274,23 @@
                 "type": "string"
               },
               "remote_path": {
-                "description": "远端目录/路径",
+                "description": "远端目录/路径。可在**任意一层**用日期变量,但变量必须**独占一层**:`/data/sub/yyyyMM/yyyyMMdd` 合法,`/data/sub_yyyyMMdd` 非法。只认 yyyyMMdd / yyyyMM / yyyy 三种;不允许 '..'、空目录层。",
                 "title": "Remote Path",
                 "type": "string"
               },
+              "filename_template": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "自定义文件名模板(不含扩展名)。只允许字母、数字、'_'、'-' 与日期变量,且变量前后必须是 '_' 或首尾:`daily_yyyyMMdd_export`、`yyyyMM_summary` 合法,`dailyyyyyMMdd`、`report-yyyyMMdd-x` 非法。系统统一追加 `_<task_id>` 与扩展名。不传=沿用默认 `<job_id>_<task_id>.<ext>`。",
+                "title": "Filename Template"
+              },
               "format": {
                 "default": "json",
                 "description": "文件格式:csv/excel/json(默认 json)",
@@ -1068,7 +1333,7 @@
               }
             ],
             "default": null,
-            "description": "新名称(全局唯一)",
+            "description": "新名称(同一凭证下唯一)",
             "title": "Name"
           },
           "rule_ids": {
@@ -1110,11 +1375,7 @@
           "published": {
             "anyOf": [
               {
-                "enum": [
-                  "T-0",
-                  "T-1",
-                  "T-7"
-                ],
+                "pattern": "^T-\\d+~T-\\d+$",
                 "type": "string"
               },
               {
@@ -1122,9 +1383,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": [
               {
@@ -1142,6 +1431,21 @@
             "description": "整组全量覆盖",
             "title": "Fields"
           },
+          "size": {
+            "anyOf": [
+              {
+                "maximum": 500000,
+                "minimum": 1,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "每次执行最多导出的记录行数;不传则不修改,最大 500000",
+            "title": "Size"
+          },
           "frequency": {
             "anyOf": [
               {
@@ -1214,15 +1518,15 @@
       },
       "output_schema": {
         "additionalProperties": false,
-        "description": "订阅 job 出参对象(= sub_job 全字段,id 暴露为 job_id)。",
+        "description": "订阅 job 出参对象。",
         "properties": {
           "job_id": {
-            "description": "job ID(sub_job.id)",
+            "description": "job ID",
             "title": "Job Id",
             "type": "integer"
           },
           "name": {
-            "description": "job 名称,全局唯一",
+            "description": "job 名称,同一凭证(token)下唯一",
             "title": "Name",
             "type": "string"
           },
@@ -1243,10 +1547,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": {
@@ -1255,6 +1583,11 @@
             "title": "Fields",
             "type": "array"
           },
+          "size": {
+            "description": "每次执行最多导出的记录行数,范围 1–500000",
+            "title": "Size",
+            "type": "integer"
+          },
           "frequency": {
             "description": "自然语言频率",
             "title": "Frequency",
@@ -1266,7 +1599,7 @@
             "type": "string"
           },
           "target_type": {
-            "description": "投递类型:octo(本期)/sftp/kafka",
+            "description": "投递类型:octo、sftp、kafka(暂不支持)",
             "title": "Target Type",
             "type": "string"
           },
@@ -1298,7 +1631,10 @@
           "rule_ids",
           "source",
           "published",
+          "idate",
+          "udate",
           "fields",
+          "size",
           "frequency",
           "cron",
           "target_type",
@@ -1323,7 +1659,7 @@
           "field": "name",
           "type": "string",
           "required": false,
-          "desc": "新名称(全局唯一)"
+          "desc": "新名称(同一凭证下唯一)"
         },
         {
           "flag": "--rule-ids",
@@ -1342,9 +1678,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-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": "--udate",
+          "field": "udate",
+          "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": "--fields",
@@ -1353,6 +1703,13 @@
           "required": false,
           "desc": "整组全量覆盖"
         },
+        {
+          "flag": "--size",
+          "field": "size",
+          "type": "integer",
+          "required": false,
+          "desc": "每次执行最多导出的记录行数;不传则不修改,最大 500000"
+        },
         {
           "flag": "--frequency",
           "field": "frequency",
@@ -1497,10 +1854,10 @@
         "$defs": {
           "SubTask": {
             "additionalProperties": false,
-            "description": "订阅 task 出参对象(**对外精简**:只给调用方轮询/下载所需;其余字段仅存 sub_task 表供排查)。",
+            "description": "订阅 task 出参对象(**对外精简**:只给调用方轮询/下载所需)。",
             "properties": {
               "task_id": {
-                "description": "task ID(sub_task.id)",
+                "description": "task ID",
                 "title": "Task Id",
                 "type": "integer"
               },
@@ -1509,6 +1866,11 @@
                 "title": "Job Id",
                 "type": "integer"
               },
+              "size": {
+                "description": "本次执行最多导出的记录行数",
+                "title": "Size",
+                "type": "integer"
+              },
               "status": {
                 "description": "pending/running/success/failed/terminated",
                 "title": "Status",
@@ -1555,6 +1917,7 @@
             "required": [
               "task_id",
               "job_id",
+              "size",
               "status",
               "created_at",
               "updated_at"
@@ -1660,7 +2023,7 @@
   ],
   "skill": {
     "slug": "social-neuron-subscription",
-    "description": "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②单次拉数≤10 万行,超出截断;③投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。",
+    "description": "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②单次拉数可指定 size,默认且最大 50 万行,超出截断;③投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。④如果拉取不到数据则不会产生文件上传，也就没有文件url信息",
     "actions": [
       "job-create",
       "job-delete",

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@social-data/social-neuron-subscription",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.10",
   "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

@@ -1,6 +1,6 @@
 ---
 name: social-neuron-subscription
-description: "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②单次拉数≤10 万行,超出截断;③投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。"
+description: "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②单次拉数可指定 size,默认且最大 50 万行,超出截断;③投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。④如果拉取不到数据则不会产生文件上传，也就没有文件url信息"
 metadata:
   openclaw:
     requires: { bins: ['social-neuron-subscription'], skills: [] }
@@ -21,13 +21,16 @@ metadata:
 | flag | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|---|
-| --name | name | string | 是 | minLen=1, maxLen=128 | job 名称,全局唯一 |
+| --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 |
+| --size | size | integer | 否 | min=1, max=500000 | 每次执行最多导出的记录行数,默认且最大为 500000 |
+| --target | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。 |
 **对象 `KafkaTarget`** —— kafka(规划):把记录流投送到 topic(无文件)。
@@ -46,6 +49,8 @@ metadata:
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 **对象 `SftpTarget`** —— sftp(本期):把导出文件上传到 SFTP 远端目录。
+目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task
+重跑多少次,远端路径与文件名都不变。
 | 键 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
@@ -54,22 +59,26 @@ metadata:
 | port | integer | 否 | - | 端口,默认 22 |
 | username | string | 是 | - | 登录用户名 |
 | password | string | 是 | - | 登录密码 |
-| remote_path | string | 是 | - | 远端目录/路径 |
+| remote_path | string | 是 | - | 远端目录/路径。可在**任意一层**用日期变量,但变量必须**独占一层**:`/data/sub/yyyyMM/yyyyMMdd` 合法,`/data/sub_yyyyMMdd` 非法。只认 yyyyMMdd / yyyyMM / yyyy 三种;不允许 '..'、空目录层。 |
+| filename_template | string | 否 | - | 自定义文件名模板(不含扩展名)。只允许字母、数字、'_'、'-' 与日期变量,且变量前后必须是 '_' 或首尾:`daily_yyyyMMdd_export`、`yyyyMM_summary` 合法,`dailyyyyyMMdd`、`report-yyyyMMdd-x` 非法。系统统一追加 `_<task_id>` 与扩展名。不传=沿用默认 `<job_id>_<task_id>.<ext>`。 |
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 **出参 `SubJob`**
 | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
-| job_id | integer | 是 | - | job ID(sub_job.id) |
-| name | string | 是 | - | job 名称,全局唯一 |
+| job_id | integer | 是 | - | job ID |
+| 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] | 是 | - | 拉取/导出字段(空=全量) |
+| size | integer | 是 | - | 每次执行最多导出的记录行数,范围 1–500000 |
 | 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) |
@@ -111,28 +120,31 @@ metadata:
 | items | list[SubJob] | 是 | - | 本人 job 列表,按创建时间倒序(全量) |
 | total | integer | 是 | - | 命中总数 |
-**对象 `SubJob`** —— 订阅 job 出参对象(= sub_job 全字段,id 暴露为 job_id)。
+**对象 `SubJob`** —— 订阅 job 出参对象。
 | 键 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
-| job_id | integer | 是 | - | job ID(sub_job.id) |
-| name | string | 是 | - | job 名称,全局唯一 |
+| job_id | integer | 是 | - | job ID |
+| 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] | 是 | - | 拉取/导出字段(空=全量) |
+| size | integer | 是 | - | 每次执行最多导出的记录行数,范围 1–500000 |
 | 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) |
 | updated_at | string | 是 | - | 更新时间(ISO8601,UTC+8) |
-示例:social-neuron-subscription job-list
+示例:social-neuron-subscription job-list
 ### social-neuron-subscription job-trigger
-临时触发一次本人 job,落一条 sub_task(manual);默认用 job 存的 target,可覆盖。
+临时触发一次本人 job,落一条 ik_subscription_task(manual);默认用 job 存的 target,可覆盖。
 落 pending task 后触发 Airflow DAG(``social_neuron_subscription``)跑取数→组装→投递(上传取 url);
 未配 airflow_base_url 时(本地/测试)触发被跳过,仅留 pending task。**无通知**:结果落
@@ -143,9 +155,14 @@ 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 | 否 | - | 覆盖本次投递目标 |
+| --size | size | integer | 否 | min=1, max=500000 | 覆盖本次导出行数;不传则继承 job 的 size,最大 500000 |
 **对象 `KafkaTarget`** —— kafka(规划):把记录流投送到 topic(无文件)。
@@ -164,6 +181,8 @@ metadata:
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 **对象 `SftpTarget`** —— sftp(本期):把导出文件上传到 SFTP 远端目录。
+目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task
+重跑多少次,远端路径与文件名都不变。
 | 键 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
@@ -172,7 +191,8 @@ metadata:
 | port | integer | 否 | - | 端口,默认 22 |
 | username | string | 是 | - | 登录用户名 |
 | password | string | 是 | - | 登录密码 |
-| remote_path | string | 是 | - | 远端目录/路径 |
+| remote_path | string | 是 | - | 远端目录/路径。可在**任意一层**用日期变量,但变量必须**独占一层**:`/data/sub/yyyyMM/yyyyMMdd` 合法,`/data/sub_yyyyMMdd` 非法。只认 yyyyMMdd / yyyyMM / yyyy 三种;不允许 '..'、空目录层。 |
+| filename_template | string | 否 | - | 自定义文件名模板(不含扩展名)。只允许字母、数字、'_'、'-' 与日期变量,且变量前后必须是 '_' 或首尾:`daily_yyyyMMdd_export`、`yyyyMM_summary` 合法,`dailyyyyyMMdd`、`report-yyyyMMdd-x` 非法。系统统一追加 `_<task_id>` 与扩展名。不传=沿用默认 `<job_id>_<task_id>.<ext>`。 |
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 **出参 `SubJobTriggerResult`**
@@ -192,11 +212,14 @@ metadata:
 | flag | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|---|
 | --job-id | job_id | integer | 是 | - | 目标 job |
-| --name | name | string | 否 | minLen=1, maxLen=128 | 新名称(全局唯一) |
+| --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 | 整组全量覆盖 |
+| --size | size | integer | 否 | min=1, max=500000 | 每次执行最多导出的记录行数;不传则不修改,最大 500000 |
 | --frequency | frequency | string | 否 | minLen=1, maxLen=64 | 传入则按新频率重算 cron(用法同创建;支持一天多次,如「每天9点和15点」);无法解析为 cron 会被拒绝 |
 | --target | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 整体替换投递目标 |
 | --active | active | enum(0、1) | 否 | - | 启停:1 / 0 |
@@ -218,6 +241,8 @@ metadata:
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 **对象 `SftpTarget`** —— sftp(本期):把导出文件上传到 SFTP 远端目录。
+目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task
+重跑多少次,远端路径与文件名都不变。
 | 键 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
@@ -226,22 +251,26 @@ metadata:
 | port | integer | 否 | - | 端口,默认 22 |
 | username | string | 是 | - | 登录用户名 |
 | password | string | 是 | - | 登录密码 |
-| remote_path | string | 是 | - | 远端目录/路径 |
+| remote_path | string | 是 | - | 远端目录/路径。可在**任意一层**用日期变量,但变量必须**独占一层**:`/data/sub/yyyyMM/yyyyMMdd` 合法,`/data/sub_yyyyMMdd` 非法。只认 yyyyMMdd / yyyyMM / yyyy 三种;不允许 '..'、空目录层。 |
+| filename_template | string | 否 | - | 自定义文件名模板(不含扩展名)。只允许字母、数字、'_'、'-' 与日期变量,且变量前后必须是 '_' 或首尾:`daily_yyyyMMdd_export`、`yyyyMM_summary` 合法,`dailyyyyyMMdd`、`report-yyyyMMdd-x` 非法。系统统一追加 `_<task_id>` 与扩展名。不传=沿用默认 `<job_id>_<task_id>.<ext>`。 |
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 **出参 `SubJob`**
 | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
-| job_id | integer | 是 | - | job ID(sub_job.id) |
-| name | string | 是 | - | job 名称,全局唯一 |
+| job_id | integer | 是 | - | job ID |
+| 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] | 是 | - | 拉取/导出字段(空=全量) |
+| size | integer | 是 | - | 每次执行最多导出的记录行数,范围 1–500000 |
 | 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) |
@@ -272,12 +301,13 @@ metadata:
 | items | list[SubTask] | 是 | - | task 列表,按 created_at 排序(方向由 sort 定,默认倒序) |
 | total | integer | 是 | - | 命中总数 |
-**对象 `SubTask`** —— 订阅 task 出参对象(**对外精简**:只给调用方轮询/下载所需;其余字段仅存 sub_task 表供排查)。
+**对象 `SubTask`** —— 订阅 task 出参对象(**对外精简**:只给调用方轮询/下载所需)。
 | 键 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
-| task_id | integer | 是 | - | task ID(sub_task.id) |
+| task_id | integer | 是 | - | task ID |
 | job_id | integer | 是 | - | 所属 job |
+| size | integer | 是 | - | 本次执行最多导出的记录行数 |
 | status | string | 是 | - | pending/running/success/failed/terminated |
 | file_info | object | 否 | - | 产物 + 下载入口,含 type 标识:octo→{type,name,format,rows,url};sftp→{...,url,path};kafka→{type,brokers,topic} |
 | error_msg | string | 否 | - | 失败原因(status=failed 时给出;成功/进行中为空) |