飞书开放平台命令行工具 — Markdown 与飞书文档双向转换，AI Agent 的飞书操控引擎。
介绍 · 核心能力 · 快速开始 · 命令参考 · AI 技能 · 贡献
feishu-cli 是一个功能完整的飞书开放平台命令行工具。它将飞书文档、知识库、电子表格、消息、日历、任务等操作封装为简洁的命令行接口，核心能力是 Markdown ↔ 飞书文档双向无损转换。
除了传统的 CLI 用法，feishu-cli 还为 Claude Code 等 AI 编程助手提供了 16 个开箱即用的技能文件，让 AI Agent 能够直接创建文档、发送消息、管理权限 — 无需任何额外配置。
注意：feishu-cli 主要面向 AI Agent（如 Claude Code）使用，通过技能文件让 AI 直接操控飞书。虽然人类也可以直接使用命令行，但大多数场景下建议通过 AI Agent 调用，体验更佳。
- 双向转换零损耗 — 支持 40+ 种块类型，Markdown 导入飞书后再导出，内容完整保留
- 图表原生渲染 — Mermaid（8 种图表类型）和 PlantUML 自动转换为飞书画板，不是截图，是可编辑的矢量图
- 大规模文档处理 — 三阶段并发管道架构，实测 10,000+ 行 / 127 个图表 / 170+ 个表格一次导入
- P2P 私聊原生可读 —
msg history --user-email一条命令打通「搜用户 → 反查 p2p chat_id → 读消息」，输出自动带sender_names映射，AI Agent 直接拿结构化带名消息流，无需额外查群成员 - AI Agent 原生 — 16 个技能文件覆盖飞书全功能，AI 助手即装即用
- 一个工具覆盖全平台 — 文档、知识库、表格、多维表格、消息、邮箱、日历、任务、视频会议、妙记、云盘、权限、画板、评论、搜索
将本地 Markdown 文件一键上传到飞书，或将飞书文档导出为 Markdown。支持完整语法转换：
# 导入：Markdown → 飞书文档
feishu-cli doc import report.md --title "技术报告" --verbose
# 导出：飞书文档 → Markdown
feishu-cli doc export <document_id> -o doc.md --download-images支持的语法：标题（6 级）、段落、列表（无限深度嵌套）、任务列表、代码块、引用、Callout（6 种类型）、表格（自动拆分）、分割线、图片、链接、公式、粗体 / 斜体 / 删除线 / 下划线 / 行内代码 / 高亮
Markdown 中的 Mermaid 和 PlantUML 代码块自动转换为飞书画板（可编辑矢量图，非截图）：
```mermaid
flowchart TD
A[开始] --> B{判断}
B -->|是| C[处理]
B -->|否| D[结束]
```| 图表类型 | 声明 | 说明 |
|---|---|---|
| 流程图 | flowchart TD / flowchart LR |
支持 subgraph |
| 时序图 | sequenceDiagram |
参与者建议 ≤ 8 |
| 类图 | classDiagram |
|
| 状态图 | stateDiagram-v2 |
必须用 v2 |
| ER 图 | erDiagram |
|
| 甘特图 | gantt |
|
| 饼图 | pie |
|
| 思维导图 | mindmap |
PlantUML 同样支持：时序图、活动图、类图、用例图、组件图、ER 图、思维导图等全部类型（```plantuml 或 ```puml）。
实测数据：88 个 Mermaid 图表导入成功率 93.2%，失败图表自动降级为代码块。
- 列宽自动计算 — 根据内容智能调整，中英文字符区分宽度（中文 14px，英文 8px）
- 大表格自动拆分 — 超过 9 行自动拆分为多个表格并保留表头（飞书 API 限制）
- 单元格多块内容 — 支持 bullet / heading / text 混合内容
导入大文档时，feishu-cli 使用三阶段并发管道最大化吞吐量：
- 阶段一（顺序） — 按文档顺序创建所有块，收集图表和表格任务
- 阶段二（并发） — 图表 worker 池 + 表格 worker 池并发处理
- 阶段三（逆序） — 处理失败图表，降级为代码块
feishu-cli doc import large-doc.md --title "大文档" \
--upload-images --diagram-workers 5 --table-workers 3 --image-workers 2 --verbose| 模块 | 能力 |
|---|---|
| 文档 | 创建、导入、导出、编辑、批量更新、Callout、画板、异步导出/导入文件 |
| 知识库 | 空间列表、节点增删改查、导出、空间详情、成员管理 |
| 电子表格 | V2 基础读写 + V3 富文本 API，行列操作、样式、合并、查找替换、导出 XLSX/CSV |
| 多维表格 | base/v3 API 全覆盖：数据表/字段/记录 CRUD、视图配置（filter/sort/group/visible-fields/timebar/card）、角色 CRUD、高级权限、数据聚合、工作流（48 个命令） |
| 消息 | 发送（text/post/image/file/card 等 11 种类型）、转发、合并转发、回复、Pin、表情回复、搜索群聊（Bot/User 双身份）、历史记录（群聊 / P2P 私聊，支持 --user-email / --user-id 自动反查 p2p chat_id）、批量获取、资源下载、话题回复、发送者名字自动解析（输出顶层 sender_names 映射，覆盖退群成员） |
| 群聊 | 创建、获取、更新、删除、分享链接、成员管理 |
| 邮箱 | 收件箱分类/搜索、邮件详情（单条/批量/线程）、发送（默认草稿）、草稿管理、回复/全部回复/转发（需 User Token） |
| 日历 | 日历列表、主日历、日程增删改查、搜索、回复邀请、参与者管理、忙闲查询、日程视图（agenda） |
| 任务 | 创建、查看、完成、重新打开、子任务、成员管理、提醒、评论、我的任务、任务清单（CRUD + 任务关联 + 成员管理） |
| 视频会议 | 多维搜索（query/主持人/参会者/会议室）、会议纪要（三路径批量获取 + AI 产物 + 逐字稿下载）、录制查询（需 User Token） |
| 妙记 | 妙记详情 + AI 产物（摘要/待办/章节）、音视频媒体批量下载（SSRF 防护 + 速率限制）（需 User Token） |
| 审批 | 审批定义详情查询、当前登录用户审批任务查询（待办 / 已办 / 已发起 / 抄送） |
| 权限 | 添加 / 更新 / 删除协作者、批量添加、公开权限管理、分享密码、权限检查、转移所有权 |
| 云盘增强 | 大文件分块上传（>20MB 自动分片）、流式下载、异步导出（docx→markdown 快捷路径 + sheet/bitable CSV）、异步导入、文件夹移动（自动轮询）、富文本评论（wiki URL 解析）、异步任务查询 |
| 文件 | 云空间文件列表、创建、移动、复制、删除、上传、下载、版本管理、元数据、统计 |
| 素材 | 上传 / 下载（图片、文件、音视频） |
| 画板 | 精排绘图（create-notes）、Mermaid / PlantUML 导入、截图下载、节点管理 |
| 评论 | 列出、添加、解决/恢复评论、回复管理 |
| 搜索 | 消息搜索、应用搜索、文档搜索（需 User Access Token） |
| 用户 | 获取用户信息、用户搜索、部门用户列表 |
| 通讯录 | 部门详情、子部门列表 |
一键安装（推荐）
自动检测平台，下载最新版本并安装到 /usr/local/bin：
curl -fsSL https://raw.githubusercontent.com/riba2534/feishu-cli/main/install.sh | bash已安装的用户执行同样的命令即可更新到最新版本。
其他安装方式
手动下载
从 Releases 页面下载对应平台的压缩包：
| 平台 | 文件 |
|---|---|
| Linux x64 | feishu-cli_*_linux-amd64.tar.gz |
| Linux ARM64 | feishu-cli_*_linux-arm64.tar.gz |
| macOS Intel | feishu-cli_*_darwin-amd64.tar.gz |
| macOS Apple Silicon | feishu-cli_*_darwin-arm64.tar.gz |
| Windows x64 | feishu-cli_*_windows_amd64.tar.gz |
tar -xzf feishu-cli_*_linux-amd64.tar.gz
sudo mv feishu-cli_*/feishu-cli /usr/local/bin/使用 go install
go install github.com/riba2534/feishu-cli@latest从源码编译
git clone https://github.com/riba2534/feishu-cli.git
cd feishu-cli && make build
# 二进制文件输出到 bin/feishu-cli一键创建应用（推荐）
无需手动访问飞书开放平台后台，一条命令自动完成应用注册：
# 自动创建飞书应用并保存凭证到 ~/.feishu-cli/config.yaml
feishu-cli config create-app --save执行后终端会输出一个授权链接，用飞书扫码确认即可。CLI 自动获取 App ID 和 App Secret 并写入配置文件，后续命令直接可用。
然后在飞书开放平台的应用权限管理页面为新创建的应用开通所需 scope。最快的方式是复制 权限要求 章节的 JSON，在权限管理页面的 导入权限 入口粘贴即可一次性申请全部。
手动配置（不推荐）
如果你有特殊需求（如企业应用、自定义应用类型），也可以手动配置：
# 方式一：环境变量
export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"
# 方式二：配置文件
feishu-cli config init # 生成模板后手动编辑填入凭证（可选）如果需要使用搜索、审批任务查询等需要用户身份的功能，还需完成 OAuth 用户授权：
feishu-cli auth loginfeishu-cli doc create --title "Hello Feishu"如果返回文档 ID，说明配置成功。
feishu-cli <command> [subcommand] [flags]
Commands:
doc 文档操作（创建、导入、导出、编辑、异步导出/导入文件）
wiki 知识库操作（节点增删改查、空间详情、成员管理）
sheet 电子表格（读写、样式、V3 富文本 API、导出 XLSX/CSV）
bitable 多维表格（base/v3 API：数据表/字段/记录/视图/角色/权限/聚合/工作流，48 命令）
msg 消息操作（发送、转发、合并转发、回复、Pin、表情回复、批量获取、资源下载）
chat 群聊管理（创建、更新、删除、成员管理）
mail 邮箱操作（分类/搜索、发送、草稿、回复、转发，10 命令）
drive 云盘增强（分块上传、流式下载、异步导出/导入、移动、评论，8 命令）
vc 视频会议（多维搜索、纪要、录制查询）
minutes 妙记操作（详情 + AI 产物、媒体批量下载）
file 文件管理（列出、移动、复制、删除、上传、下载、版本管理）
media 素材操作（上传、下载）
perm 权限管理（添加、删除、批量添加、公开权限、密码、转移所有权）
calendar 日历操作（日程增删改查、搜索、参与者、忙闲查询、agenda）
task 任务操作（增删改查、子任务、成员、提醒、评论、我的任务）
tasklist 任务清单管理（CRUD、任务关联、成员管理）
user 用户操作（获取信息、搜索、部门用户列表）
dept 部门操作（详情、子部门列表）
board 画板操作（导入图表、下载图片）
comment 评论操作（列出、添加、解决/恢复、回复管理）
approval 审批操作（定义详情、当前登录用户任务查询）
search 搜索操作（消息、应用、文档）
auth 身份认证（OAuth 登录、状态、退出、scope 预检）
config 配置管理
文档操作
# 创建文档
feishu-cli doc create --title "新文档"
# 导入 Markdown（核心功能，默认上传图片）
feishu-cli doc import doc.md --title "文档标题" --upload-images --verbose
# 导出为 Markdown
feishu-cli doc export <doc_id> -o output.md --download-images
# 导出他人文档（自动从 auth login 读取 User Token，或手动指定）
feishu-cli doc export <doc_id> -o output.md --user-access-token <token>
# 获取文档信息
feishu-cli doc get <doc_id>
# 获取所有块
feishu-cli doc blocks <doc_id> --all
# 添加内容（JSON 格式）
feishu-cli doc add <doc_id> -c '<JSON>'
# 添加内容（Markdown 格式）
feishu-cli doc add <doc_id> README.md --content-type markdown
# 添加高亮块
feishu-cli doc add-callout <doc_id> "提示内容" --callout-type info
# 批量更新
feishu-cli doc batch-update <doc_id> '[...]' --source-type content
# 异步导出为文件（PDF/DOCX/XLSX）
feishu-cli doc export-file <doc_token> --type pdf -o output.pdf
# 异步导入本地文件为飞书文档
feishu-cli doc import-file local_file.docx --type docx --name "文档名"知识库操作
feishu-cli wiki spaces # 列出知识空间
feishu-cli wiki get <node_token> # 获取节点
feishu-cli wiki nodes <space_id> # 列出节点
feishu-cli wiki export <node_token> -o doc.md # 导出为 Markdown
feishu-cli wiki create --space-id <id> --title "新节点"
feishu-cli wiki space-get <space_id> # 获取知识空间详情
# 知识空间成员管理
feishu-cli wiki member add <space_id> --member-type userid --member-id USER_ID --role admin
feishu-cli wiki member list <space_id>
feishu-cli wiki member remove <space_id> --member-type userid --member-id USER_ID --role admin电子表格操作
# V2 API - 基础读写
feishu-cli sheet read <token> "Sheet1!A1:C10"
feishu-cli sheet write <token> "Sheet1!A1:B2" --data '[["姓名","年龄"],["张三",25]]'
# V3 API - 富文本支持
feishu-cli sheet read-rich <token> <sheet_id> "sheet!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 style <token> "Sheet1!A1:C3" --bold --font-size 14
feishu-cli sheet merge <token> "Sheet1!A1:C1"消息操作
# 发送文本消息
feishu-cli msg send --receive-id-type email --receive-id user@example.com --text "Hello"
# 发送富文本消息
feishu-cli msg send --receive-id-type email --receive-id user@example.com \
--msg-type post --content-file msg.json
# 搜索群聊（Bot 身份，仅返回 Bot 所在的群）
feishu-cli msg search-chats --query "关键词"
# 搜索群聊（User 身份，可搜到用户所在的群）
feishu-cli msg search-chats --query "关键词" --user-access-token <token>
# 获取群聊历史消息（Bot 不在群内时使用 --user-access-token）
feishu-cli msg history --container-id <chat_id> --container-id-type chat
# 获取和某人的私聊记录（邮箱入口，自动搜用户 + 反查 p2p chat_id）
feishu-cli msg history --user-email user@example.com --page-size 50 -o json
# 已知 open_id 时直接传
feishu-cli msg history --user-id ou_xxx --page-size 50 -o json
# 输出 JSON 自动携带顶层 sender_names 映射（open_id → 姓名），AI Agent 可直接引用
# {"Items":[...], "sender_names":{"ou_abc":"张三","ou_def":"李四"}}
# 转发消息
feishu-cli msg forward <message_id> --receive-id <id> --receive-id-type email
# 回复消息
feishu-cli msg reply <message_id> --text "回复内容"
# 合并转发
feishu-cli msg merge-forward --receive-id user@example.com --receive-id-type email --message-ids id1,id2
# 消息加急
feishu-cli msg urgent <message_id> --user-id-type open_id --user-ids ou_xxx,ou_yyy
feishu-cli msg urgent <message_id> --urgent-type phone --user-id-type user_id --user-ids u_123,u_456
feishu-cli msg urgent <message_id> --urgent-type sms --user-id-type union_id --user-ids on_xxx,on_yyy
# 表情回复
feishu-cli msg reaction add <message_id> --emoji-type THUMBSUP
feishu-cli msg reaction remove <message_id> --reaction-id REACTION_ID
feishu-cli msg reaction list <message_id>
# Pin 消息
feishu-cli msg pin <message_id>
feishu-cli msg unpin <message_id>
feishu-cli msg pins --chat-id CHAT_ID权限管理
# 添加 / 更新协作者
feishu-cli perm add <doc_id> --doc-type docx --member-type email \
--member-id user@example.com --perm full_access --notification
feishu-cli perm update <doc_id> --doc-type docx --member-type email \
--member-id user@example.com --perm edit
# 查看 / 删除协作者
feishu-cli perm list <doc_token> --doc-type docx
feishu-cli perm delete <doc_token> --doc-type docx --member-type email --member-id user@example.com
# 公开权限管理
feishu-cli perm public-get <doc_token>
feishu-cli perm public-update <doc_token> --external-access --link-share-entity anyone_readable
# 分享密码
feishu-cli perm password create <doc_token>
feishu-cli perm password delete <doc_token>
# 批量添加协作者
feishu-cli perm batch-add <doc_token> --members-file members.json --notification
# 权限检查
feishu-cli perm auth <doc_token> --action view
# 转移所有权
feishu-cli perm transfer-owner <doc_token> --member-type email --member-id user@example.com群聊管理
# 群聊 CRUD
feishu-cli chat create --name "群聊名" --user-ids id1,id2
feishu-cli chat get <chat_id>
feishu-cli chat update <chat_id> --name "新群名"
feishu-cli chat delete <chat_id>
feishu-cli chat link <chat_id>
# 群成员管理
feishu-cli chat member list <chat_id>
feishu-cli chat member add <chat_id> --id-list id1,id2
feishu-cli chat member remove <chat_id> --id-list id1,id2文件管理
# 基础操作
feishu-cli file list [folder_token]
feishu-cli file mkdir --name "新文件夹" --folder-token <token>
# 上传 / 下载
feishu-cli file upload local_file.pdf --parent FOLDER_TOKEN
feishu-cli file download <file_token> -o output.pdf
# 版本管理
feishu-cli file version list <doc_token> --doc-type docx
feishu-cli file version create <doc_token> --doc-type docx --name "v1.0"
feishu-cli file version get <doc_token> <version_id> --doc-type docx
feishu-cli file version delete <doc_token> <version_id> --doc-type docx
# 元数据与统计
feishu-cli file meta TOKEN1 TOKEN2 --doc-type docx
feishu-cli file stats <file_token> --doc-type docx搜索操作
搜索 API 需要 User Access Token。推荐使用 auth login 一键获取（Token 自动保存和刷新），也可通过 --user-access-token 参数或环境变量手动指定。
# 获取 User Access Token（推荐，一次登录自动刷新）
feishu-cli auth login
# 搜索消息
feishu-cli search messages "关键词"
feishu-cli search messages "会议" --chat-ids oc_xxx,oc_yyy
feishu-cli search messages "你好" --chat-type p2p_chat # 搜索私聊消息
# 搜索应用
feishu-cli search apps "审批"
# 搜索文档和 Wiki
feishu-cli search docs "产品需求"
feishu-cli search docs "季度报告" --docs-types doc,sheet
feishu-cli search docs "技术方案" --count 10 --offset 0
# 也可以手动指定 Token
feishu-cli search docs "产品需求" --user-access-token <token>
export FEISHU_USER_ACCESS_TOKEN="u-xxx"
feishu-cli search docs "产品需求"审批操作
approval get 使用应用权限查询审批定义（审批模板/流程定义），支持 --output raw-json 查看飞书 API 原始响应，需要开通 approval:approval:readonly；approval task query 会优先根据当前 auth login 登录态自动识别当前用户，需要开通 approval:task 并完成用户授权。
输出说明：
- 不传
--output：输出便于阅读的文本摘要 --output json：输出 CLI 归一化后的 JSON，部分字段会做拍平和字符串化处理--output raw-json：输出飞书 API 原始响应，便于排查字段差异
# 查询审批定义详情（审批模板/流程定义）
feishu-cli approval get <approval_code>
# 输出完整 JSON
feishu-cli approval get <approval_code> --output json
# 输出飞书 API 原始响应
feishu-cli approval get <approval_code> --output raw-json
# 查询当前登录用户的待我审批
feishu-cli approval task query --topic todo
# 查询我已审批的任务
feishu-cli approval task query --topic done
# 查询我发起的审批
feishu-cli approval task query --topic started --output json
# 输出飞书 API 原始响应
feishu-cli approval task query --topic started --output raw-json
# 翻页查询
feishu-cli approval task query --topic todo --page-size 20 --page-token <token>
# 显式指定 User Access Token
feishu-cli approval task query --topic cc-unread --user-access-token <token>身份认证（Device Flow）
通过 OAuth 2.0 Device Flow（RFC 8628） 获取 User Access Token，用于搜索、审批待办查询等需要用户授权的功能。无需在飞书开放平台配置任何重定向 URL 白名单。
v1.18+ 变更：Authorization Code Flow（
--print-url/auth callback/--manual/--port/--method/--scopes）已全部删除，只保留 Device Flow。
# 按业务域申请推荐权限（推荐）
feishu-cli auth login --domain search --recommend
# 显式申请某组 scope
feishu-cli auth login --scope "minutes:minutes.basic:read minutes:minutes.transcript:export"
# JSON 事件流输出（AI Agent 推荐，配合 run_in_background 使用）
feishu-cli auth login --domain search --recommend --json
# 两步模式：先立即输出 device_code，不启动轮询
feishu-cli auth login --domain vc --domain minutes --recommend --no-wait --json
# 两步模式：用已有 device_code 继续轮询
feishu-cli auth login --device-code <device_code> --json
# 预检 token 是否包含所需 scope（AI Agent 推荐在执行业务命令前调用）
feishu-cli auth check --scope "search:docs:read"
feishu-cli auth check --scope "search:docs:read im:message:readonly"
# 查看当前授权状态
feishu-cli auth status
feishu-cli auth status -o json # JSON 格式输出
# 退出登录（清除本地 token）
feishu-cli auth logout登录时 CLI 在 stderr 打印验证链接和 user_code，用户在任意设备（电脑、手机）浏览器打开链接完成授权即可。本地桌面会尝试自动打开浏览器，SSH 远程失败静默忽略。
授权范围策略：
- CLI 会显式声明本次请求的 scope，不再依赖“后台开了什么就全量返回”
- 推荐先用
auth check --scope "REQ_SCOPES"预检，再用auth login --scope "..."或auth login --domain ... --recommend补授权 - 即使显式请求业务 scope，CLI 也会自动追加最小核心 scope（如
auth:user.id:read）用于识别当前登录用户 - 要真正拿到某个 scope，仍然必须先在飞书开放平台应用权限管理页面开通它
Token 管理：
- Token 保存在
~/.feishu-cli/token.json，Access Token 有效期约 2 小时 - Access Token 过期时自动使用 Refresh Token 刷新（Refresh Token 有效期 30 天）
offline_access由 CLI 自动追加，无需手动声明- Token 优先级：
--user-access-token参数 >FEISHU_USER_ACCESS_TOKEN环境变量 >token.json>config.yaml - 审批任务查询会缓存当前登录用户资料到
~/.feishu-cli/user_profile.json，登录态变化或执行auth logout时会自动清理
更多命令
# 文档异步导出/导入
feishu-cli doc export-file <doc_token> --type pdf -o output.pdf
feishu-cli doc import-file local_file.docx --type docx --name "文档名"
# 素材上传
feishu-cli media upload image.png --parent-type docx_image --parent-node <doc_id>
# 日历
feishu-cli calendar list
feishu-cli calendar get <calendar_id>
feishu-cli calendar primary
feishu-cli calendar create-event --calendar-id <id> --summary "会议" \
--start "2024-01-01T10:00:00+08:00" --end "2024-01-01T11:00:00+08:00"
feishu-cli calendar event-search --calendar-id <id> --query "关键词"
feishu-cli calendar event-reply <calendar_id> <event_id> --status accept
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-ids id1,id2
# 任务
feishu-cli task create --summary "待办事项"
feishu-cli task complete <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
feishu-cli task reminder add <task_guid> --minutes 30
# 任务列表
feishu-cli tasklist create --name "任务列表"
feishu-cli tasklist list
feishu-cli tasklist get <tasklist_guid>
feishu-cli tasklist delete <tasklist_guid>
# 画板
feishu-cli board create-notes <whiteboard_id> nodes.json -o json # 精排绘图（JSON 控制坐标、颜色、连线）
feishu-cli board import <whiteboard_id> --source-type content -c "graph TD; A-->B" --syntax mermaid # 导入 Mermaid
feishu-cli board import <whiteboard_id> diagram.puml --syntax plantuml # 导入 PlantUML
feishu-cli board nodes <whiteboard_id> # 获取画板所有节点
feishu-cli board image <whiteboard_id> output.png # 下载画板截图
# 评论
feishu-cli comment list <file_token> --type docx
feishu-cli comment add <file_token> --type docx --content "评论内容"
feishu-cli comment resolve <file_token> <comment_id> --type docx
feishu-cli comment unresolve <file_token> <comment_id> --type docx
feishu-cli comment reply list <file_token> <comment_id> --type docx
feishu-cli comment reply delete <file_token> <comment_id> <reply_id> --type docx
# 多维表格（base/v3 API）
feishu-cli bitable create --name "项目管理" --time-zone Asia/Shanghai
feishu-cli bitable table list --base-token bscnxxxx
feishu-cli bitable table create --base-token bscnxxxx --name "任务"
feishu-cli bitable field list --base-token bscnxxxx --table-id tblxxx
feishu-cli bitable field create --base-token bscnxxxx --table-id tblxxx --config '{"name":"状态","type":"select"}'
feishu-cli bitable record upsert --base-token bscnxxxx --table-id tblxxx --config '{"fields":{"名称":"测试"}}'
feishu-cli bitable record upsert --base-token bscnxxxx --table-id tblxxx --record-id recxxx --config '{"fields":{"状态":"完成"}}'
feishu-cli bitable record batch-create --base-token bscnxxxx --table-id tblxxx --config '{"fields":["fld1"],"rows":[["val1"],["val2"]]}'
feishu-cli bitable record list --base-token bscnxxxx --table-id tblxxx
feishu-cli bitable view list --base-token bscnxxxx --table-id tblxxx
feishu-cli bitable view view-filter-get --base-token bscnxxxx --table-id tblxxx --view-id vewxxx
feishu-cli bitable role list --base-token bscnxxxx
# 云盘增强（drive）
feishu-cli drive upload --file big.zip --folder-token fldxxx
feishu-cli drive download --file-token boxxxx --output ./downloads/ --overwrite
feishu-cli drive export --token docxxxx --doc-type docx --file-extension markdown --output-dir ./exports
feishu-cli drive export --token sheetxxxx --doc-type sheet --file-extension csv --sub-id sheet_1 --output-dir ./out
feishu-cli drive import --file report.docx --type docx --folder-token fldxxx
feishu-cli drive move --file-token fldxxx --type folder --folder-token fldyyy
feishu-cli drive add-comment --doc docxxx --content '[{"type":"text","text":"评论"}]'
# 邮箱（mail，需 User Token）
feishu-cli mail triage --folder INBOX --unread-only --page-size 20
feishu-cli mail triage --query "周会"
feishu-cli mail message --message-id msg_xxx
feishu-cli mail send --to user@example.com --subject "测试" --body "hi" # 默认存草稿
feishu-cli mail send --to user@example.com --subject "测试" --body "hi" --confirm-send # 立即发送
feishu-cli mail reply --message-id msg_xxx --body "收到" --confirm-send
feishu-cli mail forward --message-id msg_xxx --to team@example.com --body "请关注"
# 视频会议（vc，需 User Token）
feishu-cli vc search --query "周会" --start 2026-03-20 --end 2026-03-28
feishu-cli vc notes --meeting-ids 69xxxx,70xxxx
feishu-cli vc notes --minute-tokens obcnxxxx --with-artifacts --download-transcript --output-dir ./notes
feishu-cli vc recording --meeting-ids 69xxxx
# 妙记（minutes，需 User Token）
feishu-cli minutes get <minute_token> --with-artifacts
feishu-cli minutes download --minute-tokens obcnxxxx --output ./media
feishu-cli minutes download --minute-tokens obcnxxxx --url-only
# 日历增强
feishu-cli calendar agenda # 查看今日日程
feishu-cli calendar agenda --start-date 2026-03-28 --end-date 2026-03-29
# 任务增强
feishu-cli task my # 查看我的任务
feishu-cli task reopen <task_guid> # 重新打开
feishu-cli task comment add <task_guid> --content "评论"
feishu-cli tasklist task-add <tasklist_guid> --task-ids guid1,guid2
feishu-cli tasklist member add <tasklist_guid> --members ou_xxx
# 消息增强
feishu-cli msg mget --message-ids om_xxx,om_yyy
feishu-cli msg resource-download <message_id> <file_key> --type image -o photo.png
feishu-cli msg thread-messages <thread_id> --page-size 20
# 文档增强
feishu-cli doc content-update <doc_id> --mode append --markdown "## 新内容"
feishu-cli doc content-update <doc_id> --mode overwrite --markdown "# 全新文档"
feishu-cli doc content-update <doc_id> --mode replace_range --selection-by-title "## 旧章节" --markdown "## 新章节"
feishu-cli doc media-insert <doc_id> --file photo.png --type image --align center
feishu-cli doc media-download <file_token> -o image.png
# 电子表格导出
feishu-cli sheet export <token> -o output.xlsx
feishu-cli sheet export <token> --format csv --sheet-id SHEET_ID -o output.csv
# 用户
feishu-cli user info <user_id>
feishu-cli user search --email user@example.com # 邮箱查 user_id；带 User Token 时自动补 open_id + 姓名
feishu-cli user search --mobile 13800138000
feishu-cli user search --query "张三" # 按姓名/关键词模糊搜索，需 User Token
feishu-cli user list --department-id DEPT_ID
# 部门
feishu-cli dept get <department_id>
feishu-cli dept children <department_id>skills/ 目录包含 16 个 为 Claude Code 设计的技能文件，让 AI Agent 能够直接操作飞书 — 创建文档、发送消息、管理权限，全部通过自然语言驱动。
| 技能 | 功能 | 触发示例 |
|---|---|---|
feishu-cli-read |
读取飞书文档 / 知识库 | "读一下这个飞书链接" |
feishu-cli-write |
创建 / 写入 / 更新文档 | "创建一个新飞书文档" |
feishu-cli-import |
从 Markdown 导入创建文档 | "把这个 md 文件上传到飞书" |
feishu-cli-export |
导出为 Markdown / PDF / Word | "把飞书文档导出来" |
feishu-cli-perm |
权限管理 | "给文档添加权限" |
feishu-cli-msg |
消息全功能管理 | "发消息给 xxx" |
feishu-cli-chat |
会话浏览、消息互动与群聊管理 | "查看群聊历史消息" |
feishu-cli-toolkit |
综合工具箱（表格导出/日历agenda/任务/清单/文件/评论/知识库/通讯录） | "读取飞书表格数据" |
feishu-cli-board |
画板操作（精排绘图/Mermaid 导入/截图/节点管理） | "画个架构图"、"在飞书里画图" |
feishu-cli-bitable |
多维表格全功能（base/v3 API，48 命令） | "创建多维表格"、"查询记录" |
feishu-cli-vc |
视频会议与妙记（搜索/纪要/录制/AI 产物/逐字稿/媒体下载） | "搜索最近的会议"、"下载会议纪要" |
feishu-cli-drive |
云盘增强（分块上传/流式下载/异步导出导入/评论） | "上传文件到飞书" |
feishu-cli-mail |
飞书邮箱（收件箱/发送/回复/转发/草稿） | "查看邮件"、"发邮件" |
feishu-cli-auth |
OAuth 认证、Token 管理、按域精细授权 | "登录飞书"、"获取 Token" |
feishu-cli-search |
搜索飞书文档 / 消息 / 应用 | "搜索飞书文档" |
feishu-cli-doc-guide |
飞书文档创建规范 | 其他技能内部引用 |
安装方法：
# 一键安装全部技能（推荐）
npx skills add riba2534/feishu-cli --global --yes --agent claude-code --copy
# 或手动复制
# 将 skills/ 目录复制到 ~/.claude/skills/Markdown ↔ 飞书块类型完整对照表
| Markdown | 飞书块类型 | block_type | 说明 |
|---|---|---|---|
# 标题 |
Heading 1-9 | 3-11 | 支持 9 级标题（Markdown 规范 6 级） |
| 段落文本 | Text | 2 | 普通文本 |
- 列表 |
Bullet | 12 | 无序列表（支持无限深度嵌套） |
1. 列表 |
Ordered | 13 | 有序列表（支持无限深度嵌套） |
- [ ] 任务 |
Todo | 17 | 任务列表 |
```lang``` |
Code | 14 | 代码块 |
```mermaid``` |
Board (Diagram) | 21 → 43 | 自动转画板 |
```plantuml``` |
Board (Diagram) | 21 → 43 | 自动转画板 |
> 引用 |
QuoteContainer | 34 | 引用容器 |
> [!NOTE] |
Callout | 19 | 6 种类型（NOTE/WARNING/TIP/CAUTION/IMPORTANT/SUCCESS） |
--- |
Divider | 22 | 分割线 |
| 表格 | |
Table | 31 | 大表格自动拆分 |
 |
Image | 27 | 图片（API 限制，创建占位块） |
$$公式$$ |
Equation | 16 | 块级公式（降级为行内） |
| 附件 | File | 23 | 文件块 |
<iframe> |
Iframe | 26 | 内嵌网页 |
💡 推荐做法：一键创建机器人
新用户不需要手动去飞书开放平台后台创建应用，feishu-cli 自带 Device Flow 协议的一键创建机器人工作流，在终端扫码确认即可自动注册「个人代理应用」：
# 1. 一键创建飞书应用（扫码确认后自动把 App ID / App Secret 写入 ~/.feishu-cli/config.yaml） feishu-cli config create-app --save # 2. OAuth 用户授权（搜索、审批等需要用户身份的功能） feishu-cli auth login关于权限：创建应用后，你需要在飞书开放平台的应用权限管理页面为应用开通所需 scope。下面的完整权限清单可以直接在权限管理页面粘贴 JSON 导入，一次性开通全部功能。
权限的开通是你自己的责任（飞书开放平台一般需要 tenant 管理员审批），feishu-cli 不做自动化。
feishu-cli 涵盖文档、知识库、电子表格、多维表格、消息、群聊、日历、任务、审批、画板、权限管理、搜索、视频会议、邮件等全部功能。下面这份 JSON 可以直接在飞书开放平台的应用权限管理页面导入：
{
"scopes": {
"tenant": [
"aily:run:write",
"aily:session:read",
"aily:session:write",
"aily:skill:read",
"aily:skill:write",
"aily:table:read",
"app_engine:application.event:read",
"app_engine:application.log:read",
"app_engine:application.metric:read",
"application:application.app_message_stats.overview:readonly",
"application:application.app_version:readonly",
"application:application.bot.operator_name:readonly",
"application:application.feedback.feedback_info",
"application:application:self_manage",
"application:bot.menu:readonly",
"application:bot.menu:write",
"base:app:copy",
"base:app:create",
"base:app:read",
"base:app:update",
"base:collaborator:create",
"base:collaborator:delete",
"base:collaborator:read",
"base:dashboard:copy",
"base:dashboard:read",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:field_group:create",
"base:form:read",
"base:form:update",
"base:record:create",
"base:record:delete",
"base:record:read",
"base:record:retrieve",
"base:record:update",
"base:role:create",
"base:role:delete",
"base:role:read",
"base:role:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:workflow:read",
"base:workflow:write",
"block:message",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"board:whiteboard:node:update",
"calendar:calendar.free_busy:read",
"cardkit:card:read",
"cardkit:card:write",
"comment_sdk:comment_sdk",
"component:url_preview",
"contact:user.employee_id:readonly",
"contact:user.id:readonly",
"directory:department.external_id:read",
"directory:employee.base.external_id:read",
"directory:employee.idconvert:read",
"directory:employee.work.job_number:read",
"directory:job_title.status:read",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.comment:write_only",
"docs:document.content:read",
"docs:document.media:download",
"docs:document.media:upload",
"docs:document.subscription",
"docs:document.subscription:read",
"docs:document:copy",
"docs:document:export",
"docs:document:import",
"docs:event.document_deleted:read",
"docs:event.document_edited:read",
"docs:event.document_opened:read",
"docs:event:subscribe",
"docs:permission.member:auth",
"docs:permission.member:create",
"docs:permission.member:delete",
"docs:permission.member:retrieve",
"docs:permission.member:transfer",
"docs:permission.member:update",
"docs:permission.setting:read",
"docs:permission.setting:readonly",
"docs:permission.setting:write_only",
"docs_tool:docs_tool",
"docx:document.block:convert",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:drive.search:readonly",
"drive:drive:version",
"drive:drive:version:readonly",
"drive:file.like:readonly",
"drive:file.meta.sec_label.read_only",
"drive:file:download",
"drive:file:favorite",
"drive:file:favorite:readonly",
"drive:file:upload",
"drive:file:view_record:readonly",
"event:failed_event:readonly",
"event:ip_list",
"im:app_feed_card:write",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.announcement:read",
"im:chat.announcement:write_only",
"im:chat.chat_pins:read",
"im:chat.chat_pins:write_only",
"im:chat.collab_plugins:read",
"im:chat.collab_plugins:write_only",
"im:chat.managers:write_only",
"im:chat.members:bot_access",
"im:chat.members:read",
"im:chat.members:write_only",
"im:chat.menu_tree:read",
"im:chat.menu_tree:write_only",
"im:chat.moderation:read",
"im:chat.tabs:read",
"im:chat.tabs:write_only",
"im:chat.top_notice:write_only",
"im:chat.widgets:read",
"im:chat.widgets:write_only",
"im:chat:create",
"im:chat:delete",
"im:chat:moderation:write_only",
"im:chat:operate_as_owner",
"im:chat:read",
"im:chat:update",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message.urgent",
"im:message.urgent.status:write",
"im:message.urgent:phone",
"im:message.urgent:sms",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_depts",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"im:url_preview.update",
"im:user_agent:read",
"llpp:model:write",
"llpp:resource",
"minutes:minute:download",
"minutes:minutes",
"minutes:minutes.basic:read",
"minutes:minutes.media:export",
"minutes:minutes.statistics:read",
"minutes:minutes.transcript:export",
"minutes:minutes:readonly",
"myai:message:read",
"sheets:spreadsheet.meta:read",
"sheets:spreadsheet.meta:write_only",
"sheets:spreadsheet:create",
"sheets:spreadsheet:read",
"sheets:spreadsheet:write_only",
"space:document.event:read",
"space:document:create",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"space:document:shortcut",
"space:folder:create",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:tasklist:read",
"task:tasklist:write",
"wiki:member:create",
"wiki:member:retrieve",
"wiki:member:update",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:node:update",
"wiki:setting:read",
"wiki:setting:write_only",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only",
"wiki:wiki:readonly"
],
"user": [
"aily:run:read",
"aily:run:write",
"aily:session:read",
"aily:session:write",
"aily:skill:read",
"aily:skill:write",
"aily:table:read",
"app_engine:application.event_subscriber:read",
"base:app:copy",
"base:app:create",
"base:app:read",
"base:app:update",
"base:collaborator:create",
"base:collaborator:delete",
"base:collaborator:read",
"base:dashboard:create",
"base:dashboard:delete",
"base:dashboard:read",
"base:dashboard:update",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:field_group:create",
"base:form:create",
"base:form:delete",
"base:form:read",
"base:form:update",
"base:record:create",
"base:record:delete",
"base:record:read",
"base:record:retrieve",
"base:record:update",
"base:role:create",
"base:role:delete",
"base:role:read",
"base:role:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:workflow:create",
"base:workflow:delete",
"base:workflow:read",
"base:workflow:update",
"base:workflow:write",
"base:workspace:list",
"board:whiteboard:node:create",
"board:whiteboard:node:delete",
"board:whiteboard:node:read",
"board:whiteboard:node:update",
"calendar:calendar.acl:create",
"calendar:calendar.acl:delete",
"calendar:calendar.acl:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"calendar:calendar:create",
"calendar:calendar:delete",
"calendar:calendar:read",
"calendar:calendar:subscribe",
"calendar:calendar:update",
"calendar:time_off:create",
"calendar:time_off:delete",
"cardkit:card:read",
"cardkit:card:write",
"comment_sdk:comment_sdk",
"component:user_profile",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user.basic_profile:readonly",
"contact:user.email:readonly",
"contact:user.employee_id:readonly",
"contact:user.id:readonly",
"contact:user:search",
"directory:department.external_id:read",
"directory:employee.base.external_id:read",
"directory:employee.idconvert:read",
"directory:employee.work.job_number:read",
"docs:component",
"docs:document.comment:create",
"docs:document.comment:delete",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.comment:write_only",
"docs:document.content:read",
"docs:document.media:download",
"docs:document.media:upload",
"docs:document.subscription",
"docs:document.subscription:read",
"docs:document:copy",
"docs:document:export",
"docs:document:import",
"docs:event.document_deleted:read",
"docs:event.document_edited:read",
"docs:event.document_opened:read",
"docs:event:subscribe",
"docs:permission.member:apply",
"docs:permission.member:auth",
"docs:permission.member:create",
"docs:permission.member:delete",
"docs:permission.member:retrieve",
"docs:permission.member:transfer",
"docs:permission.member:update",
"docs:permission.setting:read",
"docs:permission.setting:readonly",
"docs:permission.setting:write_only",
"docs_tool:docs_tool",
"docx:document.block:convert",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:drive.search:readonly",
"drive:drive:version",
"drive:drive:version:readonly",
"drive:file.like:readonly",
"drive:file.meta.sec_label.read_only",
"drive:file:download",
"drive:file:favorite",
"drive:file:favorite:readonly",
"drive:file:upload",
"drive:file:view_record:readonly",
"event:ip_list",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.announcement:read",
"im:chat.announcement:write_only",
"im:chat.chat_pins:read",
"im:chat.chat_pins:write_only",
"im:chat.collab_plugins:read",
"im:chat.collab_plugins:write_only",
"im:chat.managers:write_only",
"im:chat.members:read",
"im:chat.members:write_only",
"im:chat.moderation:read",
"im:chat.tabs:read",
"im:chat.tabs:write_only",
"im:chat.top_notice:write_only",
"im:chat:delete",
"im:chat:moderation:write_only",
"im:chat:read",
"im:chat:update",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message.urgent.status:write",
"im:message:readonly",
"im:message:recall",
"im:message:update",
"im:special_focus",
"llpp:model:write",
"llpp:resource",
"mail:event",
"mail:user_mailbox.mail_contact:read",
"mail:user_mailbox.mail_contact:write",
"mail:user_mailbox.message.address:read",
"mail:user_mailbox.message.body:read",
"mail:user_mailbox.message.subject:read",
"mail:user_mailbox:readonly",
"minutes:minute:download",
"minutes:minutes",
"minutes:minutes.artifacts:read",
"minutes:minutes.basic:read",
"minutes:minutes.media:export",
"minutes:minutes.search:read",
"minutes:minutes.statistics:read",
"minutes:minutes.transcript:export",
"minutes:minutes:readonly",
"offline_access",
"search:docs:read",
"search:message",
"sheets:spreadsheet.meta:read",
"sheets:spreadsheet.meta:write_only",
"sheets:spreadsheet:create",
"sheets:spreadsheet:read",
"sheets:spreadsheet:write_only",
"slides:presentation:create",
"slides:presentation:read",
"slides:presentation:update",
"slides:presentation:write_only",
"space:document.event:read",
"space:document:create",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"space:document:shortcut",
"space:folder:create",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:tasklist:read",
"task:tasklist:write",
"vc:meeting",
"vc:meeting.meetingevent:read",
"vc:meeting.meetingid:read",
"vc:meeting.participant:write",
"vc:meeting.search:read",
"vc:meeting:export",
"vc:meeting:readonly",
"vc:note:read",
"vc:record",
"vc:record:readonly",
"vc:reserve",
"vc:reserve:readonly",
"wiki:member:create",
"wiki:member:retrieve",
"wiki:member:update",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:node:update",
"wiki:setting:read",
"wiki:setting:write_only",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only",
"wiki:wiki:readonly"
]
}
}| 组件 | 选型 | 说明 |
|---|---|---|
| 语言 | Go 1.21+ | |
| CLI 框架 | cobra | 子命令、自动补全 |
| 飞书 SDK | oapi-sdk-go/v3 | 官方 SDK |
| 配置管理 | viper | YAML / 环境变量 |
| Markdown | goldmark | GFM 扩展支持 |
feishu-cli/
├── cmd/ # CLI 命令（每个子命令一个文件）
│ ├── root.go # 根命令、全局配置
│ ├── import_markdown.go # Markdown 导入（三阶段并发管道）
│ ├── export_markdown.go # 导出为 Markdown
│ └── ...
├── internal/
│ ├── client/ # 飞书 API 封装
│ ├── converter/ # Markdown ↔ Block 转换器
│ └── config/ # 配置管理
├── skills/ # Claude Code AI 技能文件
├── main.go
├── Makefile
└── install.sh # 一键安装脚本
# 克隆项目
git clone https://github.com/riba2534/feishu-cli.git
cd feishu-cli
# 安装依赖
go mod tidy
# 构建
make build # 输出到 bin/feishu-cli
make build-all # 多平台构建
# 测试
go test ./...
# 代码检查
go vet ./...欢迎提交 Issue 和 Pull Request！
- Fork 本仓库
- 创建特性分支：
git checkout -b feature/amazing-feature - 提交更改：
git commit -m 'feat: add amazing feature' - 推送分支：
git push origin feature/amazing-feature - 提交 Pull Request
提交信息请遵循 Conventional Commits 规范。
- 飞书开放平台 — 创建应用、获取凭证
- 飞书 API 文档 — 接口参考
- Claude Code — AI 编程助手
- HappyClaw — 基于 Claude Agent SDK 的自托管多用户 AI Agent 系统