@social-data/social-neuron-subscription 1.0.0-beta.8 → 1.0.0-beta.9

package/bin/cli.js

@@ -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/manifest.json

@@ -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 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task 重跑多少次,远端路径与文件名都不变。",
+            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
             "properties": {
               "type": {
                 "const": "sftp",
@@ -233,6 +234,14 @@
             "title": "Fields",
             "type": "array"
           },
+          "size": {
+            "default": 500000,
+            "description": "每次执行最多导出的记录行数,默认且最大为 500000",
+            "maximum": 500000,
+            "minimum": 1,
+            "title": "Size",
+            "type": "integer"
+          },
           "target": {
             "anyOf": [
               {
@@ -342,6 +351,11 @@
             "title": "Fields",
             "type": "array"
           },
+          "size": {
+            "description": "每次执行最多导出的记录行数,范围 1–500000",
+            "title": "Size",
+            "type": "integer"
+          },
           "frequency": {
             "description": "自然语言频率",
             "title": "Frequency",
@@ -388,6 +402,7 @@
           "idate",
           "udate",
           "fields",
+          "size",
           "frequency",
           "cron",
           "target_type",
@@ -456,6 +471,13 @@
           "required": false,
           "desc": "拉取/导出字段;不填拉全量"
         },
+        {
+          "flag": "--size",
+          "field": "size",
+          "type": "integer",
+          "required": false,
+          "desc": "每次执行最多导出的记录行数,默认且最大为 500000"
+        },
         {
           "flag": "--target",
           "field": "target",
@@ -640,6 +662,11 @@
                 "title": "Fields",
                 "type": "array"
               },
+              "size": {
+                "description": "每次执行最多导出的记录行数,范围 1–500000",
+                "title": "Size",
+                "type": "integer"
+              },
               "frequency": {
                 "description": "自然语言频率",
                 "title": "Frequency",
@@ -686,6 +713,7 @@
               "idate",
               "udate",
               "fields",
+              "size",
               "frequency",
               "cron",
               "target_type",
@@ -823,7 +851,7 @@
           },
           "SftpTarget": {
             "additionalProperties": false,
-            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task 重跑多少次,远端路径与文件名都不变。",
+            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
             "properties": {
               "type": {
                 "const": "sftp",
@@ -1014,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": [
@@ -1099,6 +1142,13 @@
           "type": "object(json)",
           "required": false,
           "desc": "覆盖本次投递目标"
+        },
+        {
+          "flag": "--size",
+          "field": "size",
+          "type": "integer",
+          "required": false,
+          "desc": "覆盖本次导出行数;不传则继承 job 的 size,最大 500000"
         }
       ],
       "transport": {
@@ -1194,7 +1244,7 @@
           },
           "SftpTarget": {
             "additionalProperties": false,
-            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task 重跑多少次,远端路径与文件名都不变。",
+            "description": "sftp(本期):把导出文件上传到 SFTP 远端目录。\n目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task\n重跑多少次,远端路径与文件名都不变。",
             "properties": {
               "type": {
                 "const": "sftp",
@@ -1381,6 +1431,21 @@
             "description": "整组全量覆盖",
             "title": "Fields"
           },
+          "size": {
+            "anyOf": [
+              {
+                "maximum": 500000,
+                "minimum": 1,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "每次执行最多导出的记录行数;不传则不修改,最大 500000",
+            "title": "Size"
+          },
           "frequency": {
             "anyOf": [
               {
@@ -1518,6 +1583,11 @@
             "title": "Fields",
             "type": "array"
           },
+          "size": {
+            "description": "每次执行最多导出的记录行数,范围 1–500000",
+            "title": "Size",
+            "type": "integer"
+          },
           "frequency": {
             "description": "自然语言频率",
             "title": "Frequency",
@@ -1564,6 +1634,7 @@
           "idate",
           "udate",
           "fields",
+          "size",
           "frequency",
           "cron",
           "target_type",
@@ -1632,6 +1703,13 @@
           "required": false,
           "desc": "整组全量覆盖"
         },
+        {
+          "flag": "--size",
+          "field": "size",
+          "type": "integer",
+          "required": false,
+          "desc": "每次执行最多导出的记录行数;不传则不修改,最大 500000"
+        },
         {
           "flag": "--frequency",
           "field": "frequency",
@@ -1788,6 +1866,11 @@
                 "title": "Job Id",
                 "type": "integer"
               },
+              "size": {
+                "description": "本次执行最多导出的记录行数",
+                "title": "Size",
+                "type": "integer"
+              },
               "status": {
                 "description": "pending/running/success/failed/terminated",
                 "title": "Status",
@@ -1834,6 +1917,7 @@
             "required": [
               "task_id",
               "job_id",
+              "size",
               "status",
               "created_at",
               "updated_at"
@@ -1939,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 取结果。④如果拉取不到数据则不会产生文件上传，也就没有文件url信息",
+    "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

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

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

@@ -1,6 +1,6 @@
 ---
 name: social-neuron-subscription
-description: "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②单次拉数≤10 万行,超出截断;③投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。④如果拉取不到数据则不会产生文件上传，也就没有文件url信息"
+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: [] }
@@ -29,6 +29,7 @@ metadata:
 | --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 | 拉取/导出字段;不填拉全量 |
+| --size | size | integer | 否 | min=1, max=500000 | 每次执行最多导出的记录行数,默认且最大为 500000 |
 | --target | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。 |
 
 **对象 `KafkaTarget`** —— kafka(规划):把记录流投送到 topic(无文件)。
@@ -48,7 +49,8 @@ metadata:
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 
 **对象 `SftpTarget`** —— sftp(本期):把导出文件上传到 SFTP 远端目录。
-目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task 重跑多少次,远端路径与文件名都不变。
+目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task
+重跑多少次,远端路径与文件名都不变。
 
 | 键 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
@@ -73,6 +75,7 @@ metadata:
 | 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(暂不支持) |
@@ -129,6 +132,7 @@ metadata:
 | 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(暂不支持) |
@@ -137,7 +141,7 @@ metadata:
 | 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,落一条 ik_subscription_task(manual);默认用 job 存的 target,可覆盖。
@@ -158,6 +162,7 @@ metadata:
 | --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(无文件)。
 
@@ -176,7 +181,8 @@ metadata:
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 
 **对象 `SftpTarget`** —— sftp(本期):把导出文件上传到 SFTP 远端目录。
-目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task 重跑多少次,远端路径与文件名都不变。
+目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task
+重跑多少次,远端路径与文件名都不变。
 
 | 键 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
@@ -213,6 +219,7 @@ metadata:
 | --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 |
@@ -234,7 +241,8 @@ metadata:
 | format | enum(csv、excel、json) | 否 | - | 文件格式:csv/excel/json(默认 json) |
 
 **对象 `SftpTarget`** —— sftp(本期):把导出文件上传到 SFTP 远端目录。
-目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task 重跑多少次,远端路径与文件名都不变。
+目录与文件名都支持日期变量 ``yyyyMMdd`` / ``yyyyMM`` / ``yyyy``,同一个 task
+重跑多少次,远端路径与文件名都不变。
 
 | 键 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
@@ -259,6 +267,7 @@ metadata:
 | 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(暂不支持) |
@@ -298,6 +307,7 @@ metadata:
 |---|---|---|---|---|
 | 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 时给出;成功/进行中为空) |