飞书综合工具箱

覆盖 feishu-cli 的 14 个功能模块，提供命令速查和核心用法。复杂模块的详细参考文档在 references/ 目录中。

feishu-cli：如尚未安装，请前往 riba2534/feishu-cli 获取安装方式。

模块速查表

1. 电子表格

支持 V2（简单二维数组）和 V3（富文本三维数组）两套 API。

常用命令

# 创建表格
feishu-cli sheet create --title "新表格"

# 获取表格信息
feishu-cli sheet get <token>

# 列出工作表
feishu-cli sheet list-sheets <token>

# V2 读写（二维数组）
feishu-cli sheet read <token> "Sheet1!A1:C10"
feishu-cli sheet write <token> "Sheet1!A1:B2" --data '[["姓名","年龄"],["张三",25]]'
feishu-cli sheet append <token> "Sheet1!A:B" --data '[["新行1","新行2"]]'

# V3 富文本读写（三维数组）
feishu-cli sheet read-plain <token> <sheet_id> "Sheet1!A1:C10"
feishu-cli sheet read-rich <token> <sheet_id> "Sheet1!A1:C10"
feishu-cli sheet write-rich <token> <sheet_id> --data-file data.json

# 行列操作
feishu-cli sheet add-rows <token> <sheet_id> --count 5
feishu-cli sheet add-cols <token> <sheet_id> --count 3
feishu-cli sheet delete-rows <token> <sheet_id> --start 2 --end 5
feishu-cli sheet delete-cols <token> <sheet_id> --start 1 --end 3

# 样式和格式
feishu-cli sheet merge <token> "Sheet1!A1:B2"
feishu-cli sheet unmerge <token> "Sheet1!A1:B2"
feishu-cli sheet style <token> "Sheet1!A1:C3" --bold --bg-color "#FF0000"

# 查找替换（--range 必填，范围不要超出实际数据区域）
feishu-cli sheet find <token> <sheet_id> "关键词" --range "A1:C10"
feishu-cli sheet replace <token> <sheet_id> "查找词" "替换词" --range "A1:C10"

API 限制

• 单次写入最多 5000 个单元格，单元格最大 50000 字符
• V2 范围格式：SheetID!A1:C10，支持整列 A:C 和整行 1:3
• V3 写入限制：单次最多 10 个范围

导出为 XLSX/CSV

# 导出为 XLSX（默认格式）
feishu-cli sheet export <spreadsheet_token> -o /tmp/report.xlsx

# 导出为 CSV（需指定工作表 ID）
feishu-cli sheet export <spreadsheet_token> -f csv --sheet-id <sheet_id> -o /tmp/data.csv

# 自定义轮询次数
feishu-cli sheet export <spreadsheet_token> -o /tmp/report.xlsx --max-retries 50

注意：导出为 CSV 时必须指定 --sheet-id，因为 CSV 只能导出单个工作表。

User Access Token 支持

所有 30 个 sheet 命令均支持 --user-access-token 参数，用于以用户身份访问无 App 权限但用户有权限的表格。Token 读取优先级：--user-access-token 参数 > FEISHU_USER_ACCESS_TOKEN 环境变量 > ~/.feishu-cli/token.json > 配置文件。未指定时自动回退到 App Token（租户身份）。

详细参考：读取 references/sheet-commands.md 获取 V3 富文本格式、工作表管理、单元格图片等完整说明。

权限要求：sheets:spreadsheet

2. 日历和日程

管理飞书日历、日程、参与人和忙闲查询。时间格式统一使用 RFC3339（如 2024-01-01T10:00:00+08:00）。

常用命令

# 日历
feishu-cli calendar list                    # 列出日历
feishu-cli calendar get <calendar_id>       # 获取日历详情
feishu-cli calendar primary                 # 获取主日历

# 日程 CRUD
feishu-cli calendar create-event \
  --calendar-id <id> \
  --summary "团队周会" \
  --start "2024-01-21T14:00:00+08:00" \
  --end "2024-01-21T15:00:00+08:00" \
  --description "讨论本周进展"

feishu-cli calendar list-events <calendar_id> --start-time <RFC3339> --end-time <RFC3339>
feishu-cli calendar get-event <calendar_id> <event_id>
feishu-cli calendar update-event <calendar_id> <event_id> --summary "新标题"
feishu-cli calendar delete-event <calendar_id> <event_id>

# 搜索日程
feishu-cli calendar event-search --calendar-id <id> --query "周会"

# 回复日程邀请
feishu-cli calendar event-reply <calendar_id> <event_id> --status accept   # accept/decline/tentative

# 参与人管理
feishu-cli calendar attendee add <calendar_id> <event_id> --user-ids id1,id2
feishu-cli calendar attendee list <calendar_id> <event_id>

# 忙闲查询
feishu-cli calendar freebusy \
  --start "2024-01-01T00:00:00+08:00" \
  --end "2024-01-02T00:00:00+08:00" \
  --user-id <user_id>

日程列表（展开重复日程）

# 查看今天的日程
feishu-cli calendar agenda [calendar_id]

# 指定日期范围
feishu-cli calendar agenda <calendar_id> \
  --start-date 2024-01-21 \
  --end-date 2024-01-28

# 分页
feishu-cli calendar agenda <calendar_id> --page-size 20 --page-token <token>

与 list-events 的区别：agenda 会展开重复日程为独立实例，适合查看某段时间内所有实际发生的日程。

详细参考：读取 references/calendar-commands.md 获取完整参数说明。

权限要求：calendar:calendar:readonly（读取），calendar:calendar（写操作，需单独申请）

3. 任务管理

管理飞书任务（V2 API），包括子任务、成员、提醒和任务清单。任务 ID 为 UUID 格式。

常用命令

# 任务 CRUD
feishu-cli task create --summary "完成代码审查" --description "详细描述" --due "2024-02-01"
feishu-cli task list [--completed | --uncompleted]
feishu-cli task get <task_id>
feishu-cli task update <task_id> --summary "新标题"
feishu-cli task complete <task_id>
feishu-cli task delete <task_id>

# 子任务
feishu-cli task subtask create <task_guid> --summary "子任务标题"
feishu-cli task subtask list <task_guid>

# 成员管理
feishu-cli task member add <task_guid> --members id1,id2 --role assignee    # assignee/follower
feishu-cli task member remove <task_guid> --members id1,id2 --role assignee

# 提醒
feishu-cli task reminder add <task_guid> --minutes 30     # 提前 30 分钟提醒，0=截止时
feishu-cli task reminder remove <task_guid> --ids id1,id2

# 任务清单
feishu-cli tasklist create --name "Sprint 计划"
feishu-cli tasklist list
feishu-cli tasklist get <tasklist_guid>
feishu-cli tasklist delete <tasklist_guid>

我的任务

# 查看我的所有任务（需 User Token）
feishu-cli task my

# 只显示未完成的任务
feishu-cli task my --uncompleted

# 只显示已完成的任务
feishu-cli task my --completed

# 指定每页数量
feishu-cli task my --page-size 20

注意：task my 需要 User Token，请先通过 auth login 授权。

重新打开任务

# 重新打开已完成的任务