rongshu/.agents/skills/lark-base/references/lark-base-dashboard-block-list.md

base +dashboard-block-list

前置条件： 先阅读 lark-base-dashboard.md 了解整体工作流。

分页列出仪表盘中的所有组件（Block）。常用于：1) 查看仪表盘有哪些组件；2) 获取组件 ID 和类型用于后续编辑/删除。

推荐命令

lark-cli base +dashboard-block-list \
  --base-token bascn***************CtadY \
  --dashboard-id blkxxx

参数

参数	必填	说明
--base-token <token>	是	Base Token
--dashboard-id <id>	是	仪表盘 ID
--page-size <n>	否	每页数量，默认 20，最大 100
--page-token <token>	否	分页标记
--format <fmt>	否	输出格式：json / pretty / table / csv / ndjson
--dry-run	否	预览 API 调用，不执行

返回示例

{
  "items": [
    {"block_id": "chtxxxxxxxx", "name": "图表", "type": "column"},
    {"block_id": "chtxxxxxxxx", "name": "总利润", "type": "statistics"}
  ],
  "total": 4,
  "has_more": false
}

返回重点

字段	说明
items	组件列表，每项包含 block_id（ID）、name（名称）、type（类型）
total	组件总数
has_more	是否有更多组件（为 true 时需用 page_token 继续获取）

坑点

• +dashboard-block-list 禁止并发调用；批量执行时只能串行。

参考

• lark-base-dashboard.md — dashboard 模块指引