/base/

bitable tables

bitable records

bitable fields

bitable ≠ sheet： 操作多维表格（Base）， 操作电子表格（Sheets），两者是完全不同的产品和 API。

feishu-cli bitable create --name "项目管理" feishu-cli bitable create --name "数据库" --folder FOLDER_TOKEN feishu-cli bitable get <app_token>

feishu-cli bitable tables <app_token> feishu-cli bitable create-table <app_token> --name "任务表" feishu-cli bitable rename-table <app_token> <table_id> --name "新表名" feishu-cli bitable delete-table <app_token> <table_id>

feishu-cli bitable fields <app_token> <table_id> feishu-cli bitable fields <app_token> <table_id> -o json # JSON 输出（含完整 property） feishu-cli bitable create-field <app_token> <table_id> --field '{"field_name":"状态","type":3,"property":{"options":[{"name":"进行中"},{"name":"已完成"}]}}' feishu-cli bitable update-field <app_token> <table_id> <field_id> --field '{"field_name":"新名称","type":1}' feishu-cli bitable delete-field <app_token> <table_id> <field_id>

feishu-cli bitable records <app_token> <table_id> feishu-cli bitable records <app_token> <table_id> --page-size 100 feishu-cli bitable records <app_token> <table_id> --filter '{"conjunction":"and","conditions":[{"field_name":"状态","operator":"is","value":["进行中"]}]}' feishu-cli bitable records <app_token> <table_id> --sort '[{"field_name":"创建时间","desc":true}]' feishu-cli bitable records <app_token> <table_id> --field-names "名称,状态,金额" feishu-cli bitable get-record <app_token> <table_id> <record_id> feishu-cli bitable add-record <app_token> <table_id> --fields '{"名称":"测试","金额":100,"状态":"进行中"}' feishu-cli bitable add-records <app_token> <table_id> --data '[{"名称":"A","金额":100},{"名称":"B","金额":200}]' feishu-cli bitable add-records <app_token> <table_id> --data-file records.json feishu-cli bitable update-record <app_token> <table_id> <record_id> --fields '{"状态":"已完成"}' feishu-cli bitable delete-records <app_token> <table_id> --record-ids "recXXX,recYYY"

feishu-cli bitable views <app_token> <table_id> feishu-cli bitable create-view <app_token> <table_id> --name "看板" --type kanban feishu-cli bitable delete-view <app_token> <table_id> <view_id>

**别名**：`feishu-cli base` 等同于 `feishu-cli bitable`。

"文本内容"

100

"100"

"选项A"

["A","B"]

1770508800000

true

[{"id":"ou_xxx"}]

{"text":"名称","link":"https://..."}

["recuxxx"]

不支持 API 写入：公式、查找引用、创建时间、修改人、自动编号。

使用 更新单选（type=3）字段时，必须带上完整的 property（含 options 列表），否则选项被清空，所有记录中该字段的值丢失。

正确做法：先用 获取当前字段定义，合并修改后再更新：

undefined

feishu-cli bitable fields <app_token> <table_id> -o json

feishu-cli bitable update-field <app_token> <table_id> <field_id>
--field '{"field_name":"状态","type":3,"property":{"options":[{"name":"待处理"},{"name":"进行中"},{"name":"已完成"}]},"description":{"text":"任务状态"}}'

undefined

创建多维表格时自动创建一张默认表，里面有空记录（约 10 行）。写入数据前建议先清理：

undefined

feishu-cli bitable records <app_token> <table_id> -o json

feishu-cli bitable delete-records <app_token> <table_id> --record-ids "rec1,rec2,rec3"

undefined

复选框在 GUI 上容易误触。改用单选（type=3）配置"是/否"选项：

feishu-cli bitable create-field <app_token> <table_id> \
  --field '{"field_name":"必填","type":3,"property":{"options":[{"name":"是"},{"name":"否"}]}}'

重命名 的字段时必须带 字段，否则报 ：

undefined

feishu-cli bitable update-field ... --field '{"field_name":"新名称"}'

feishu-cli bitable update-field ... --field '{"field_name":"新名称","type":1}'

undefined

通过 API 创建的多维表格默认只有机器人能看到。创建后必须立即添加权限：

邮箱来源： 中的 ，或环境变量 。

undefined

feishu-cli perm add <app_token> --doc-type bitable --member-type email --member-id <owner_email> --perm full_access --notification

如果配置了 `transfer_ownership: true`，还需转移所有权：
```bash
feishu-cli perm transfer-owner <app_token> --doc-type bitable --member-type email --member-id <owner_email>

关联字段是"一列关联一张表"的设计，无法让不同行关联到不同子表。如果主表的不同记录需要对应到不同子表，直接靠命名约定（如工具名称 → 同名子表）更实用。

feishu-cli bitable create --name "项目管理" -o json

feishu-cli bitable tables <app_token>

feishu-cli bitable create-field <app_token> <table_id> --field '{"field_name":"负责人","type":1}' feishu-cli bitable create-field <app_token> <table_id> --field '{"field_name":"状态","type":3,"property":{"options":[{"name":"待处理"},{"name":"进行中"},{"name":"已完成"}]}}' feishu-cli bitable create-field <app_token> <table_id> --field '{"field_name":"优先级","type":3,"property":{"options":[{"name":"P0"},{"name":"P1"},{"name":"P2"}]}}' feishu-cli bitable create-field <app_token> <table_id> --field '{"field_name":"截止日期","type":5}'

feishu-cli bitable records <app_token> <table_id> -o json feishu-cli bitable delete-records <app_token> <table_id> --record-ids "..."

feishu-cli bitable add-records <app_token> <table_id> --data '[ {"标题":"完成需求文档","负责人":"张三","状态":"进行中","优先级":"P0"}, {"标题":"代码审查","负责人":"李四","状态":"待处理","优先级":"P1"} ]'

feishu-cli perm add <app_token> --doc-type bitable --member-type email --member-id user@example.com --perm full_access --notification

feishu-cli bitable create-view <app_token> <table_id> --name "状态看板" --type kanban

undefined