@social-data/social-neuron-subscription 1.0.0-beta.2 → 1.0.0-beta.4

package/manifest.json

@@ -144,7 +144,7 @@
         "additionalProperties": false,
         "properties": {
           "name": {
-            "description": "job 名称,全局唯一",
+            "description": "job 名称,同一凭证(token)下唯一",
             "maxLength": 128,
             "minLength": 1,
             "title": "Name",
@@ -240,15 +240,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"
           },
@@ -342,7 +342,7 @@
           "field": "name",
           "type": "string",
           "required": true,
-          "desc": "job 名称,全局唯一"
+          "desc": "job 名称,同一凭证(token)下唯一"
         },
         {
           "flag": "--rule-ids",
@@ -498,15 +498,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"
               },
@@ -644,8 +644,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": {
@@ -1068,7 +1068,7 @@
               }
             ],
             "default": null,
-            "description": "新名称(全局唯一)",
+            "description": "新名称(同一凭证下唯一)",
             "title": "Name"
           },
           "rule_ids": {
@@ -1214,15 +1214,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"
           },
@@ -1323,7 +1323,7 @@
           "field": "name",
           "type": "string",
           "required": false,
-          "desc": "新名称(全局唯一)"
+          "desc": "新名称(同一凭证下唯一)"
         },
         {
           "flag": "--rule-ids",
@@ -1497,10 +1497,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"
               },
@@ -1660,7 +1660,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;②单次拉数≤10 万行,超出截断;③投递仅 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.2",
+  "version": "1.0.0-beta.4",
   "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 取结果。"
+description: "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②单次拉数≤10 万行,超出截断;③投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。④如果拉取不到数据则不会产生文件上传，也就没有文件url信息"
 metadata:
   openclaw:
     requires: { bins: ['social-neuron-subscription'], skills: [] }
@@ -21,7 +21,7 @@ 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天到昨天) |
@@ -61,8 +61,8 @@ metadata:
 
 | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
-| 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天) |
@@ -111,12 +111,12 @@ 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天) |
@@ -132,7 +132,7 @@ metadata:
 示例: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。**无通知**:结果落
@@ -192,7 +192,7 @@ 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 |
@@ -233,8 +233,8 @@ metadata:
 
 | 字段 | 类型 | 必填 | 约束 | 说明 |
 |---|---|---|---|---|
-| 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天) |
@@ -272,11 +272,11 @@ 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 |
 | status | string | 是 | - | pending/running/success/failed/terminated |
 | file_info | object | 否 | - | 产物 + 下载入口,含 type 标识:octo→{type,name,format,rows,url};sftp→{...,url,path};kafka→{type,brokers,topic} |