lark-base

base

何时使用

使用本 skill：

• 用户明确提到 Base / 多维表格 / bitable，或给出 /base/ 链接。
• 用户要在 Base 内建表、改表、管理字段、写记录、查记录、配视图。
• 用户要在 Base 内做公式字段、lookup 字段、跨表计算、派生指标、筛选聚合、TopN、统计分析。
• 用户要管理 Base 表单、仪表盘、workflow、高级权限或角色。
• 用户要用应用模式（BaseApp）：新建应用、管理应用页面、在页面上加图表/列表/富文本组件，或整理 Workspace 目录。
• 用户明确提到 BaseApp / AppMode / 应用模式 / Workspace 内应用，或给出应用模式的 /app/ 链接（链接可能同时携带 /base/workspace/<workspace_token> 路径信息），并要查询页面或组件；这类应用属于 Base，不走 lark-apps。
• 用户要把旧 Base 聚合式命令或旧写法迁移到当前 lark-cli base +... shortcut。

不要使用本 skill：

• 只是认证、初始化配置、切换身份、处理 scope 或权限授权恢复，转 lark-shared。
• 把本地文件导入成 Base，或将 Base 导出为本地文件，转 lark-drive。
• 泛化数据分析、字段设计、公式讨论，但没有 Base/多维表格上下文。

使用边界

• BaseApp 复制是明确的停止边界：本期没有 BaseApp 复制命令。识别到复制 / 克隆应用模式的诉求后，直接说明当前 CLI 无法完成并停止，不要调用 +base-copy（包括 --help / --dry-run）、+app-create、Drive copy 或任何写命令试探、拼装替代方案。
• Base 业务操作只使用 lark-cli base +... shortcut，不使用旧聚合式 +table / +field / +record / +view / +history / +workspace。
• 执行 update 前必须先查当前 shortcut 的 --help 或对应 reference。若命令要求完整配置，首次请求必须基于可信的当前配置执行 read-modify-write：只修改用户明确指定的内容，保留其他仍适用的可写配置，并按命令要求的结构提交。若命令支持局部／delta update，按其契约提交最小合法 payload；不得以不完整请求试错补参。
• Base CLI/OpenAPI 当前不支持视图行高、冻结列、列宽等 UI-only 外观设置。遇到这类需求，说明能力边界并停止，不要猜测未文档化参数或改走 raw API。
• 高频：数据分析。 数据表记录用于查询、分析、解析或比较时，先读取 Base 数据表查询与分析 SOP；进入本地分析路径后，使用 +record-list --output <path>.ndjson 导出分析数据（同时生成 <path>.manifest.json）。
• 低频：在线复制。 复制整个 Base 使用 +base-copy，复制 Base 内单张数据表使用 +table-copy。
• 更低频：文件导入/导出。 本地文件与 Base 之间的导入/导出转 lark-drive；具体格式、参数、路径限制和仅结构导出规则由 lark-drive 负责，导入完成后再回到 Base 命令。
• 认证、初始化、scope、身份切换、权限不足恢复属于 lark-shared；Base 文档只保留会影响 Base 路径选择的权限规则。

应用模式与 Workspace 心智模型

• Workspace 是组织 Base 和 BaseApp 的空间容器；BaseApp 创建时必须归属一个 Workspace，workspace_token 标识这个容器。
• BaseApp（应用模式）不是 Base 的别名。它用 Page 组织界面，每个 Page 再包含图表、列表或富文本 Block；app_token、page_id、block_id 分别标识这三层对象。
• Base 保存表、字段和记录等数据。BaseApp 的组件通过 data_config 引用 Base 中的数据，但引用关系不会把 Base 变成 App 的子对象。
• App 的列表组件最多引用一个 Base，而且该 Base 必须与 App 位于同一 Workspace；App 图表的多个数据源也共用一个 base_token。
• Workspace 负责资源归属，App 负责页面和组件，Base 负责数据。按操作对象选择 +workspace-*、+app-* 或 Base 数据命令，不要混用 token。