@social-data/social-neuron-subscription 1.0.0-beta.23 → 1.0.0-beta.25

package/manifest.json

@@ -401,7 +401,7 @@
               }
             ],
             "default": null,
-            "description": "每次执行最多导出的记录行数。省略则按模式取默认:普通批量的默认值和上限读取能力自定义参数 max_export_rows;传了 top(只取前 N 条)则默认 1,000、上限 10,000",
+            "description": "每次执行最多导出的记录行数。省略则按模式取默认:普通批量默认最多 500000 条，实际以服务端当前约束为准;传了 top(只取前 N 条)则默认 1,000、上限 10,000",
             "title": "Size"
           },
           "target": {
@@ -784,7 +784,7 @@
           "field": "size",
           "type": "integer",
           "required": false,
-          "desc": "每次执行最多导出的记录行数。省略则按模式取默认:普通批量的默认值和上限读取能力自定义参数 max_export_rows;传了 top(只取前 N 条)则默认 1,000、上限 10,000"
+          "desc": "每次执行最多导出的记录行数。省略则按模式取默认:普通批量默认最多 500000 条，实际以服务端当前约束为准;传了 top(只取前 N 条)则默认 1,000、上限 10,000"
         },
         {
           "flag": "--target",
@@ -1487,7 +1487,7 @@
           "size": {
             "anyOf": [
               {
-                "maximum": 500000,
+                "maximum": 2147483647,
                 "minimum": 1,
                 "type": "integer"
               },
@@ -1496,7 +1496,7 @@
               }
             ],
             "default": null,
-            "description": "覆盖本次导出行数;不传则继承 job 的 size,最大 500000",
+            "description": "覆盖本次导出行数；不传继承 job.size 并按系统当前上限收紧，显式超限拒绝",
             "title": "Size"
           }
         },
@@ -1589,7 +1589,7 @@
           "field": "size",
           "type": "integer",
           "required": false,
-          "desc": "覆盖本次导出行数;不传则继承 job 的 size,最大 500000"
+          "desc": "覆盖本次导出行数；不传继承 job.size 并按系统当前上限收紧，显式超限拒绝"
         }
       ],
       "transport": {
@@ -1921,7 +1921,7 @@
               }
             ],
             "default": null,
-            "description": "每次执行最多导出的记录行数；不传则不修改，普通批量按能力配置 max_export_rows 校验上限",
+            "description": "每次执行最多导出的记录行数；不传则不修改，普通批量默认上限 500000，TopN 默认上限 10000，实际以上游返回约束为准",
             "title": "Size"
           },
           "frequency": {
@@ -2332,7 +2332,7 @@
           "field": "size",
           "type": "integer",
           "required": false,
-          "desc": "每次执行最多导出的记录行数；不传则不修改，普通批量按能力配置 max_export_rows 校验上限"
+          "desc": "每次执行最多导出的记录行数；不传则不修改，普通批量默认上限 500000，TopN 默认上限 10000，实际以上游返回约束为准"
         },
         {
           "flag": "--frequency",
@@ -2831,7 +2831,7 @@
                   }
                 ],
                 "default": null,
-                "description": "每次执行最多导出的记录行数。省略则按模式取默认:普通批量的默认值和上限读取能力自定义参数 max_export_rows;传了 top(只取前 N 条)则默认 1,000、上限 10,000",
+                "description": "每次执行最多导出的记录行数。省略则按模式取默认:普通批量默认最多 500000 条，实际以服务端当前约束为准;传了 top(只取前 N 条)则默认 1,000、上限 10,000",
                 "title": "Size"
               },
               "target": {
@@ -3028,7 +3028,7 @@
                   }
                 ],
                 "default": null,
-                "description": "每次执行最多导出的记录行数；不传则不修改，普通批量按能力配置 max_export_rows 校验上限",
+                "description": "每次执行最多导出的记录行数；不传则不修改，普通批量默认上限 500000，TopN 默认上限 10000，实际以上游返回约束为准",
                 "title": "Size"
               },
               "frequency": {
@@ -3428,7 +3428,7 @@
                 "type": "integer"
               },
               "size": {
-                "description": "本次执行最多导出的记录行数;取全部命中时上限 500000,只取前 N 条时上限 10000",
+                "description": "本次任务记录的导出数量；实际执行受系统当前总量上限约束，TopN 默认上限 10000 条",
                 "title": "Size",
                 "type": "integer"
               },
@@ -3601,7 +3601,7 @@
   ],
   "skill": {
     "slug": "social-neuron-subscription",
-    "description": "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task;普通批量创建/取数配置修改有数据量预检，可选 precheck 只读预览；超量先提示调整参数或征求用户确认，明确同意系统超限规则后才以 confirmed=true 重提，导出仍按上限截断；另有三个只读发现接口:list_sites / list_fields 用于建 job 前对齐站点与字段取值;get_field_values 给出枚举值 / 编码值的中文字典,仅在用户明确要求把导出的码值换成中文时按需取用(换值由调用方拿到数据后自行完成,系统不自动回显)。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②两种取数模式二选一:**默认**给命中条件的全部数据、size 创建时默认/上限读能力配置 max_export_rows（未配置为 50 万）、多规则各自拉(同时命中多条规则的数据会重复出现);传 **top** 则不改筛选条件、只在同一批命中里按指定字段跨全部日期/站点/规则排序后取前 N 条、size 默认 1000 最大 10000、多规则 OR 合并(同时命中多条的只出一份),排序字段只能是 keyword/long/double/date 类型;这与平台自身的热搜/热门榜单无关;③导出数据的 kw_ruleId 字段**恒为数组**(列出本行命中的 rule_id;此前是字符串,按老格式解析的下游需改);④投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。⑤如果拉取不到数据则不会产生文件上传，也就没有文件url信息",
+    "description": "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task;普通批量创建/取数配置修改有数据量预检，可选 precheck 只读预览；超量先提示调整参数或征求用户确认，明确同意系统超限规则后才以 confirmed=true 重提，导出仍按上限截断；另有三个只读发现接口:list_sites / list_fields 用于建 job 前对齐站点与字段取值;get_field_values 给出枚举值 / 编码值的中文字典,仅在用户明确要求把导出的码值换成中文时按需取用(换值由调用方拿到数据后自行完成,系统不自动回显)。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②两种取数模式二选一:**默认**给命中条件的全部数据、size 默认/最大 50 万、多规则各自拉(同时命中多条规则的数据会重复出现);传 **top** 则不改筛选条件、只在同一批命中里按指定字段跨全部日期/站点/规则排序后取前 N 条、size 默认 1000 最大 10000、多规则 OR 合并(同时命中多条的只出一份),排序字段只能是 keyword/long/double/date 类型;这与平台自身的热搜/热门榜单无关;③导出数据的 kw_ruleId 字段**恒为数组**(列出本行命中的 rule_id;此前是字符串,按老格式解析的下游需改);④投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。⑤如果拉取不到数据则不会产生文件上传，也就没有文件url信息",
     "actions": [
       "get-field-values",
       "job-create",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@social-data/social-neuron-subscription",
-  "version": "1.0.0-beta.23",
+  "version": "1.0.0-beta.25",
   "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;普通批量创建/取数配置修改有数据量预检，可选 precheck 只读预览；超量先提示调整参数或征求用户确认，明确同意系统超限规则后才以 confirmed=true 重提，导出仍按上限截断；另有三个只读发现接口:list_sites / list_fields 用于建 job 前对齐站点与字段取值;get_field_values 给出枚举值 / 编码值的中文字典,仅在用户明确要求把导出的码值换成中文时按需取用(换值由调用方拿到数据后自行完成,系统不自动回显)。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②两种取数模式二选一:**默认**给命中条件的全部数据、size 创建时默认/上限读能力配置 max_export_rows（未配置为 50 万）、多规则各自拉(同时命中多条规则的数据会重复出现);传 **top** 则不改筛选条件、只在同一批命中里按指定字段跨全部日期/站点/规则排序后取前 N 条、size 默认 1000 最大 10000、多规则 OR 合并(同时命中多条的只出一份),排序字段只能是 keyword/long/double/date 类型;这与平台自身的热搜/热门榜单无关;③导出数据的 kw_ruleId 字段**恒为数组**(列出本行命中的 rule_id;此前是字符串,按老格式解析的下游需改);④投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。⑤如果拉取不到数据则不会产生文件上传，也就没有文件url信息"
+description: "使用场景:定时导出/订阅推送/定期拉数/大批量出文件——需异步产出文件并下载时用能力:按魔方规则、定时 cron 或手动触发,把大库数据异步导出为文件,上传 octo/sftp,产出下载 url 供调用方轮询拉取;可创建/修改/列出/删除/触发订阅 job、翻页查询 task;普通批量创建/取数配置修改有数据量预检，可选 precheck 只读预览；超量先提示调整参数或征求用户确认，明确同意系统超限规则后才以 confirmed=true 重提，导出仍按上限截断；另有三个只读发现接口:list_sites / list_fields 用于建 job 前对齐站点与字段取值;get_field_values 给出枚举值 / 编码值的中文字典,仅在用户明确要求把导出的码值换成中文时按需取用(换值由调用方拿到数据后自行完成,系统不自动回显)。概念:job=订阅定义(数据范围+频率+投递方式,系统按频率生成 cron);task=job 的一次执行,产物与下载地址落在 file_info。边界:①每 token 生效 job 默认≤10;②两种取数模式二选一:**默认**给命中条件的全部数据、size 默认/最大 50 万、多规则各自拉(同时命中多条规则的数据会重复出现);传 **top** 则不改筛选条件、只在同一批命中里按指定字段跨全部日期/站点/规则排序后取前 N 条、size 默认 1000 最大 10000、多规则 OR 合并(同时命中多条的只出一份),排序字段只能是 keyword/long/double/date 类型;这与平台自身的热搜/热门榜单无关;③导出数据的 kw_ruleId 字段**恒为数组**(列出本行命中的 rule_id;此前是字符串,按老格式解析的下游需改);④投递仅 octo/sftp(kafka 规划中,暂不支持),无主动通知、须轮询 task 取结果。⑤如果拉取不到数据则不会产生文件上传，也就没有文件url信息"
 metadata:
   openclaw:
     requires: { bins: ['social-neuron-subscription'], skills: [] }
@@ -48,7 +48,7 @@ metadata:
 
 | 模式 | 创建/修改流程 | 数量限制 |
 |---|---|---|
-| 普通批量（不传 top） | 可先独立预检，也可直接提交；命中数据超量时询问是否继续 | 创建默认值和上限读取 max_export_rows；确认后仍按上限截断 |
+| 普通批量（不传 top） | 可先独立预检，也可直接提交；命中数据超量时询问是否继续 | 默认最多 50 万行；确认后仍按上限截断 |
 | TopN（传 top） | 沿用原有创建/修改流程，不新增命中量预检或超量确认 | size 默认 1000、最大 10000；超过最大量直接拒绝，confirmed 不能放行 |
 
 **下面的可选预检与确认流程针对普通批量。创建或修改取数配置前，先说明可以选择预检，
@@ -108,7 +108,7 @@ TopN 维持原样，不进入本次数据量预检确认流程。
   `windows` 的三个时间维度；REST 对应 `data.precheck`，MCP 错误附加文本块为 `{code,data}` JSON。
   询问用户是调整参数，还是确认继续并接受系统超限规则。等待明确选择，不自动加 confirmed 重试。
 - `42224`（size 超过系统上限）：依据 `system_limit` 请用户调整 size；confirmed=true 无法放行。
-- `50331` / `50332`（配置不可用/统计失败）：说明本次未保存，按错误处理；不作为超量确认处理。
+- `50332`（统计失败）：说明本次未保存，按错误处理；不作为超量确认处理。
 - 成功响应的 `warnings` 非空时，把截断提醒告知用户；不要声称已导出全部命中数据。
 
 用户提示示例：“当前至少命中 500001 条，单次最多导出 500000 条。可以调整规则、站点或时间范围
@@ -192,7 +192,7 @@ social-neuron-subscription get-field-values --field kw_tag_brand --keyword 兰
 | | 默认(不传 `--top`) | 传 `--top` |
 |---|---|---|
 | 给什么 | 命中条件的**全部**数据 | 同一批命中里,排序后的**前 N 条** |
-| `--size` | 创建时默认/上限读系统 max_export_rows（未配置为 50 万），到顶截断 | 默认 **1000**、最大 **10000** |
+| `--size` | 默认/最大 **50 万**，到顶截断 | 默认 **1000**、最大 **10000** |
 | 多条规则 | **各规则分别拉、结果拼接** | **OR 合并:命中任一规则即可** |
 | 同时命中多条规则的数据 | **出现多次**(每条规则各一份) | **只出现一次** |
 | 导出的 `kw_ruleId` | `["r1"]`(该份属哪条规则) | `["r1","r2"]`(命中的全部规则) |
@@ -252,7 +252,7 @@ json 格式下就是 JSON 数组;csv / excel 下这一列落成紧凑 JSON 字
 ### 九、容易踩的
 
 - **拉不到数据就不会有文件**,`file_info` 里也就没有 url —— 这不是失败,是没命中。
-- 普通批量创建的 `--size` 默认值和上限由能力配置 `max_export_rows` 决定（未配置为 **50 万行**），显式超限报错；历史 job 不自动改写；传了 `--top` 则默认 **1000**、最大 **10000**,超出报错。
+- 普通批量 `--size` 默认/最大 **50 万行**，超限按服务端提示处理；传了 `--top` 则默认 **1000**、最大 **10000**,超出报错。
 - 每个 token 生效的 job 默认 **≤10 个**,满了要先 `job-delete` 或停用。
 - `--source` 只能填**已配置站点的中文名**(用 `list-sites` 查);写 `douyin.com` 这类域名会被拒。
 - 投递目标本期只支持 **octo / sftp**(kafka 规划中);省略 `--target` 默认 octo。
@@ -427,7 +427,7 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | --udate | udate | string | 否 | - | **更新时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 AND 一层:更新时间落在本区间的数据。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。 |
 | --frequency | frequency | string | 是 | minLen=1, maxLen=64 | 自然语言同步频率,系统转 cron(东八区)。可指定具体时间、并**支持一天多次**:如「每天9点」「每天9点和15点」(一天跑两次)「每周一9点」「每小时」「每30分钟」。无法解析为 cron 会被拒绝。 |
 | --fields | fields | list[string] | 否 | minLen=1 | _id 自动输出，禁止在 fields 中填写；拉取/导出字段;不填拉全量 |
-| --size | size | integer | 否 | min=1, max=2147483647 | 每次执行最多导出的记录行数。省略则按模式取默认:普通批量的默认值和上限读取能力自定义参数 max_export_rows;传了 top(只取前 N 条)则默认 1,000、上限 10,000 |
+| --size | size | integer | 否 | min=1, max=2147483647 | 每次执行最多导出的记录行数。省略则按模式取默认:普通批量默认最多 500000 条，实际以服务端当前约束为准;传了 top(只取前 N 条)则默认 1,000、上限 10,000 |
 | --target | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。 |
 | --top | top | list[TopSpec] | 否 | - | 只取前 N 条(可选)。**不改变筛选条件** —— 省略时给命中条件的全部数据,传了则在同一批命中结果里按指定字段排序、只取前 size 条。排序跨发布窗内所有日期 / 站点 / 规则**全局生效**(不是每天各取 N)。多字段按顺序作排序优先级(前者相同时比后者)。字段必须是可排序类型(keyword / long / double / date)。该模式下 size 默认 1,000、最大 10,000;且多条规则改为 OR 合并并去重,导出的 kw_ruleId 恒为 topN、无法区分来源规则 |
 
@@ -589,7 +589,7 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | --udate-start | udate_start | string | 否 | - | **更新时间**闭区间下界(东八区,支持日期/分钟);与 udate_end 同传同不传;不传则按 job 上的 udate 相对口径折算,job 也没配=该维度不过滤 |
 | --udate-end | udate_end | string | 否 | - | **更新时间**闭区间上界(东八区,精度须与下界一致) |
 | --target | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 覆盖本次投递目标 |
-| --size | size | integer | 否 | min=1, max=500000 | 覆盖本次导出行数;不传则继承 job 的 size,最大 500000 |
+| --size | size | integer | 否 | min=1, max=2147483647 | 覆盖本次导出行数；不传继承 job.size 并按系统当前上限收紧，显式超限拒绝 |
 
 **对象 `KafkaTarget`** —— kafka(规划):把记录流投送到 topic(无文件)。
 
@@ -647,7 +647,7 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | --idate | idate | string | 否 | - | **入库时间**口径。不传=不改;传空串 ""=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。 |
 | --udate | udate | string | 否 | - | **更新时间**口径。不传=不改;传空串 ""=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。 |
 | --fields | fields | list[string] | 否 | minLen=1 | 业务字段整组全量覆盖；_id 自动输出，禁止在 fields 中填写 |
-| --size | size | integer | 否 | min=1, max=2147483647 | 每次执行最多导出的记录行数；不传则不修改，普通批量按能力配置 max_export_rows 校验上限 |
+| --size | size | integer | 否 | min=1, max=2147483647 | 每次执行最多导出的记录行数；不传则不修改，普通批量默认上限 500000，TopN 默认上限 10000，实际以上游返回约束为准 |
 | --frequency | frequency | string | 否 | minLen=1, maxLen=64 | 传入则按新频率重算 cron(用法同创建;支持一天多次,如「每天9点和15点」);无法解析为 cron 会被拒绝 |
 | --target | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 整体替换投递目标 |
 | --top | top | list[TopSpec] | 否 | - | 只取前 N 条的排序规格:传入则整组替换,不传则不修改。切到该模式后 size 最大 10,000;传空数组 [] 表示改回「给全部命中数据」 |
@@ -807,7 +807,7 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | udate | string | 否 | - | **更新时间**口径(选填,不传=该维度不过滤)。在发布时间窗**之内**再 AND 一层:更新时间落在本区间的数据。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。 |
 | frequency | string | 是 | minLen=1, maxLen=64 | 自然语言同步频率,系统转 cron(东八区)。可指定具体时间、并**支持一天多次**:如「每天9点」「每天9点和15点」(一天跑两次)「每周一9点」「每小时」「每30分钟」。无法解析为 cron 会被拒绝。 |
 | fields | list[string] | 否 | minLen=1 | _id 自动输出，禁止在 fields 中填写；拉取/导出字段;不填拉全量 |
-| size | integer | 否 | min=1, max=2147483647 | 每次执行最多导出的记录行数。省略则按模式取默认:普通批量的默认值和上限读取能力自定义参数 max_export_rows;传了 top(只取前 N 条)则默认 1,000、上限 10,000 |
+| size | integer | 否 | min=1, max=2147483647 | 每次执行最多导出的记录行数。省略则按模式取默认:普通批量默认最多 500000 条，实际以服务端当前约束为准;传了 top(只取前 N 条)则默认 1,000、上限 10,000 |
 | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 投递目标;省略默认 octo(json)。本期支持 octo(上传存储→CDN url)与 sftp(账密上传远端,路径/文件名可用日期变量);kafka: 暂未实现。 |
 | top | list[TopSpec] | 否 | - | 只取前 N 条(可选)。**不改变筛选条件** —— 省略时给命中条件的全部数据,传了则在同一批命中结果里按指定字段排序、只取前 size 条。排序跨发布窗内所有日期 / 站点 / 规则**全局生效**(不是每天各取 N)。多字段按顺序作排序优先级(前者相同时比后者)。字段必须是可排序类型(keyword / long / double / date)。该模式下 size 默认 1,000、最大 10,000;且多条规则改为 OR 合并并去重,导出的 kw_ruleId 恒为 topN、无法区分来源规则 |
 
@@ -824,7 +824,7 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 | idate | string | 否 | - | **入库时间**口径。不传=不改;传空串 ""=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。 |
 | udate | string | 否 | - | **更新时间**口径。不传=不改;传空串 ""=**清除**该维度(恢复成不过滤)。支持两种相对时间口径:**按天 T-M~T-N** 与**按分钟 T-M@HH:mm~T-N@HH:mm**。M/N 是相对基准日的天数偏移,HH:mm 使用 24 小时制(00:00–23:59);基准时间取本次触发的 cron 槽位时间(东八区),手动触发取触发时间。**两个端点都必须写全且精度必须一致**:不接受 T-1 单值简写,也不允许T-1@07:00~T-0 这类按天、按分钟混用。所有口径均为左闭右闭区间 [start,end],即起止端点都包含。按天格式包含首尾自然日,查询时起始日补 00:00:00、结束日补 23:59:59。例如:T-0~T-0=今天;T-1~T-1=昨天;T-2~T-1=前天到昨天;T-7~T-1=近7天到昨天。按分钟格式包含首尾分钟,查询时起始分钟补 :00、结束分钟补 :59。例如:T-1@07:00~T-0@06:59=昨天07:00:00至今天06:59:59,完整覆盖昨天7点到今天6点时段;T-0@09:30~T-0@10:45=今天09:30:00至10:45:59。起点不得晚于终点;跨度最多 731 天(两年)、偏移最多 915 天(30个月),超限直接报错(不会静默回落)。 |
 | fields | list[string] | 否 | minLen=1 | 业务字段整组全量覆盖；_id 自动输出，禁止在 fields 中填写 |
-| size | integer | 否 | min=1, max=2147483647 | 每次执行最多导出的记录行数；不传则不修改，普通批量按能力配置 max_export_rows 校验上限 |
+| size | integer | 否 | min=1, max=2147483647 | 每次执行最多导出的记录行数；不传则不修改，普通批量默认上限 500000，TopN 默认上限 10000，实际以上游返回约束为准 |
 | frequency | string | 否 | minLen=1, maxLen=64 | 传入则按新频率重算 cron(用法同创建;支持一天多次,如「每天9点和15点」);无法解析为 cron 会被拒绝 |
 | target | OctoTarget、SftpTarget、KafkaTarget | 否 | - | 整体替换投递目标 |
 | top | list[TopSpec] | 否 | - | 只取前 N 条的排序规格:传入则整组替换,不传则不修改。切到该模式后 size 最大 10,000;传空数组 [] 表示改回「给全部命中数据」 |
@@ -875,7 +875,7 @@ social-neuron-subscription job-update --job-id 1001 --active false -y
 |---|---|---|---|---|
 | task_id | integer | 是 | - | task ID |
 | job_id | integer | 是 | - | 所属 job |
-| size | integer | 是 | - | 本次执行最多导出的记录行数;取全部命中时上限 500000,只取前 N 条时上限 10000 |
+| size | integer | 是 | - | 本次任务记录的导出数量；实际执行受系统当前总量上限约束，TopN 默认上限 10000 条 |
 | top | list[object] | 否 | - | 本次生效的排序快照 [{field, order}];null = 取了命中条件的全部数据。非 null 时本次只取按该排序排在前 size 条的数据 |
 | status | string | 是 | - | pending/running/success/failed/terminated |
 | file_info | object | 否 | - | 产物 + 下载入口,含 type 标识:octo→{type,name,format,rows,url};sftp→{...,url,path};kafka→{type,brokers,topic} |