diff --git a/skills/lark-base/references/lark-base-data-query.md b/skills/lark-base/references/lark-base-data-query.md index 148273c12..26c6e2e0b 100644 --- a/skills/lark-base/references/lark-base-data-query.md +++ b/skills/lark-base/references/lark-base-data-query.md @@ -428,8 +428,6 @@ value 使用预定义关键字机制,第一个元素为字符串常量名称 5. 若候选记录包含 link 字段,提取关联 `record_id` 后到关联表用 `+record-get` 批量读取展示字段。 6. 最终回答业务字段,不要把内部 `record_id` 当作用户可读答案。 -> **回查命令的输出格式**:`+record-list` 默认输出 markdown(给人看)。当结果要**交给脚本/程序处理**时,必须显式要求 JSON 输出:`+record-list` 支持 `--json` 作为 `--format json` 的简写(与 `--format` 同时显式指定时以 `--format` 为准),例如 `base +record-list --app-token --table-id --json`。该简写**仅** `+record-list` 可用——`+record-search` / `+record-get` 的 `--json` 是请求体 JSON 参数,不是输出格式简写,这两个命令的 JSON 输出仍用 `--format json`(例:`base +record-get --base-token --table-id --record-id --format json`;用户要 JSON 时让 CLI 直接输出,不要把文本结果手工改写成 JSON)。 - 不要把 `data-query pagination.limit` 理解为分页扫描;它只限制 Base 云端查询服务返回的聚合结果行数,不支持 offset。需要全量原始记录导出时回到 data analysis SOP 的 `+record-list` 分页规则。 ## 坑点 diff --git a/skills/lark-mail/references/lark-mail-triage.md b/skills/lark-mail/references/lark-mail-triage.md index 7c6780f5b..100b8f581 100644 --- a/skills/lark-mail/references/lark-mail-triage.md +++ b/skills/lark-mail/references/lark-mail-triage.md @@ -34,14 +34,6 @@ lark-cli mail +triage --filter '{"label":"重要邮件"}' # json/data 格式可配合 jq 处理 lark-cli mail +triage --format json | jq '.messages[].subject' -# --json 是 --format json 的简写 -lark-cli mail +triage --json --max 20 - -# 默认 table 输出是给人看的。当结果要交给脚本/程序处理、或用户只要特定字段 -# (如"只要主题列表")时,必须用 --json / --format json 拿结构化输出后提取, -# 不要把 table 原样贴给用户再从表格文本抠字段 -lark-cli mail +triage --json --max 20 # 然后从 .messages[].subject 提取 - # 分页:先取 10 条,再用 page_token 翻页 lark-cli mail +triage --max 10 --format json # 输出中包含 page_token,传入下一次请求 @@ -58,7 +50,6 @@ lark-cli mail +triage --page-size 10 | `--filter ` | — | 筛选条件(见下方字段说明) | | `--query ` | — | 全文搜索关键词 | | `--format ` | `table` | `table` / `json` / `data`(`json` 和 `data` 均输出含分页信息的对象) | -| `--json` | — | `--format json` 的简写;与 `--format` 同时显式指定时以 `--format` 为准 | | `--max ` | `20` | 最大返回条数(1-400),内部自动分页拉取 | | `--page-size ` | — | `--max` 的别名,两者含义相同;同时指定时 `--page-size` 优先 | | `--page-token ` | — | 上一次响应返回的分页令牌,传入后从该位置继续拉取。令牌带 `search:` 或 `list:` 前缀,标识来源路径,不可混用 | diff --git a/skills/lark-mail/references/lark-mail-watch.md b/skills/lark-mail/references/lark-mail-watch.md index 52b023515..78d19501d 100644 --- a/skills/lark-mail/references/lark-mail-watch.md +++ b/skills/lark-mail/references/lark-mail-watch.md @@ -48,7 +48,6 @@ lark-cli mail +watch --print-output-schema | `--mailbox ` | `me` | 订阅目标邮箱 | | `--msg-format ` | `metadata` | 输出模式:`metadata` / `minimal` / `plain_text_full` / `full` / `event` | | `--format ` | `data` | 输出样式:`json`(带 ok/data 信封的 NDJSON 流)/ `data`(裸 NDJSON 流) | -| `--json` | — | `--format json` 的简写;与 `--format` 同时显式指定时以 `--format` 为准 | | `--folder-ids ` | — | 文件夹 ID 过滤,如 `["INBOX","SENT"]` | | `--folders ` | — | 文件夹名称过滤(与 `--folder-ids` 取并集) | | `--label-ids ` | — | 标签 ID 过滤,如 `["FLAGGED","IMPORTANT"]` |