# feishu-cli **Repository Path**: ktwu/feishu-cli ## Basic Information - **Project Name**: feishu-cli - **Description**: feishu-cli 是一个功能完整的飞书开放平台命令行工具。它将飞书文档、知识库、电子表格、消息、日历、任务等操作封装为简洁的命令行接口，核心能力是 Markdown ↔ 飞书文档双向无损转换。 - **Primary Language**: Go - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-01 - **Last Updated**: 2026-07-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

feishu-cli Logo

feishu-cli

飞书开放平台命令行工具 — Markdown 与飞书文档双向转换，AI Agent 的飞书操控引擎。

Release Go Stars License

介绍 · 核心能力 · 快速开始 · 命令参考 · AI 技能 · 贡献

--- ## feishu-cli 是什么 feishu-cli 是一个功能完整的飞书开放平台命令行工具。它将飞书文档、知识库、电子表格、消息、日历、任务等操作封装为简洁的命令行接口，**核心能力是 Markdown ↔ 飞书文档双向无损转换**。 除了传统的 CLI 用法，feishu-cli 还为 [Claude Code](https://claude.ai/claude-code) 等 AI 编程助手提供了 **27 个开箱即用的技能文件**，让 AI Agent 能够直接创建文档、发送消息、管理权限 — 无需任何额外配置。 > **注意**：feishu-cli 主要面向 AI Agent（如 Claude Code）使用，通过技能文件让 AI 直接操控飞书。虽然人类也可以直接使用命令行，但大多数场景下建议通过 AI Agent 调用，体验更佳。 ### 为什么选择 feishu-cli - **双向转换零损耗** — 支持 40+ 种块类型，Markdown 导入飞书后再导出，内容完整保留 - **图表原生渲染** — Mermaid（8 种图表类型）和 PlantUML 自动转换为飞书画板，不是截图，是可编辑的矢量图 - **大规模文档处理** — 三阶段并发管道架构，实测 10,000+ 行 / 127 个图表 / 170+ 个表格一次导入 - **P2P 私聊原生可读** — `msg history --user-email` 一条命令打通「搜用户 → 反查 p2p chat_id → 读消息」，输出自动带 `sender_names` 映射，AI Agent 直接拿结构化带名消息流，无需额外查群成员 - **AI Agent 原生** — 27 个技能文件覆盖飞书全功能，AI 助手即装即用 - **一个工具覆盖全平台** — 文档、知识库、表格、多维表格、消息、邮箱、日历、任务、考勤、OKR、视频会议、妙记、云盘、权限、画板、Slides、事件、Schema、Profile、健康检查 ## 核心能力 ### Markdown ↔ 飞书文档 将本地 Markdown 文件一键上传到飞书，或将飞书文档导出为 Markdown。支持完整语法转换： ```bash # 导入：Markdown → 飞书文档 feishu-cli doc import report.md --title "技术报告" --verbose # 导出：飞书文档 → Markdown feishu-cli doc export -o doc.md --download-images ``` **支持的语法**：标题（6 级）、段落、列表（无限深度嵌套）、任务列表、代码块、引用、Callout（6 种类型）、表格（自动拆分）、分割线、图片、链接、公式、粗体 / 斜体 / 删除线 / 下划线 / 行内代码 / 高亮 ### Mermaid / PlantUML 图表 Markdown 中的 Mermaid 和 PlantUML 代码块**自动转换为飞书画板**（可编辑矢量图，非截图）： ````markdown ```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） - **列宽自定义**（v1.29+，issue #156）— 支持紧邻表格上方注释 ``（单位 px / 百分比 / `*` 走 auto）或 CLI flag `--table-column-width=auto|fixed|N1,N2,...` 全局覆盖；注释优先级高于 flag - **大表格保持单表连贯** — 行数超过飞书 `create_block` 9 行限制时，先创建 9 行初始表，剩余行通过 `insert_table_row` API 追加到同一个 block，视觉上为一张连贯的表，不再拆成多张独立表格 - **批量填充加速**（v1.29+，issue #159）— 单元格填充改用 `batch_update` API（每批 ≤30）+ 文档级 3 QPS 节流，典型 4×6×8 表场景从 ~70s 降到 ~3s - **单元格多块内容** — 支持 bullet / heading / text 混合内容 ### 三阶段并发管道 导入大文档时，feishu-cli 使用三阶段并发管道最大化吞吐量： 1. **阶段一（顺序）** — 按文档顺序创建所有块，收集图表和表格任务 2. **阶段二（并发）** — 图表 worker 池 + 表格 worker 池并发处理 3. **阶段三（逆序）** — 处理失败图表，降级为代码块 ```bash feishu-cli doc import large-doc.md --title "大文档" \ --upload-images --diagram-workers 5 --table-workers 3 --image-workers 2 --verbose ``` ### 全功能 API 覆盖 | 模块 | 能力 | |------|------| | **文档** | 创建、导入、导出、编辑、批量更新、Callout、画板、异步导出/导入文件 | | **知识库** | 空间列表、节点增删改查、导出、空间详情、成员管理 | | **电子表格** | V2 基础读写 + V3 富文本 API，行列操作、样式、批量样式、合并、查找替换、导出 XLSX/CSV、浮动图片读写、素材上传、单元格写图、筛选视图与筛选条件 CRUD、下拉菜单数据验证 | | **多维表格** | base/v3 + bitable/v1 全覆盖：数据表/字段/记录 CRUD（含批量获取）、记录附件上传/下载/移除、视图配置（filter/sort/group/visible-fields/timebar/card）、仪表盘 CRUD 与智能排版、仪表盘块 CRUD、表单 CRUD 与分享详情/提交、表单问题 CRUD、角色 CRUD 与协作者管理、高级权限、数据聚合、工作流 CRUD、多维表格重命名与权限设置 | | **消息** | 发送（text/post/image/file/card 等 11 种类型）、转发、合并转发、回复、Pin、表情回复、消息书签（flag create/list/cancel）、搜索群聊（Bot/User 双身份）、历史记录（群聊 / P2P 私聊，支持 `--user-email` / `--user-id` 自动反查 p2p chat_id）、批量获取、资源下载、话题回复、**发送者名字自动解析**（输出顶层 `sender_names` 映射，覆盖退群成员） | | **群聊** | 创建、获取、更新、删除、分享链接、成员管理 | | **邮箱** | 收件箱分类/搜索、邮件详情（单条/批量/线程）、发送（默认草稿，支持 CID 内联图片自动扫描）、草稿管理、回复/全部回复/转发、邮件模板 create/list、邮箱签名查看（需 User Token） | | **日历** | 日历列表、主日历、日程增删改查、搜索、回复邀请、参与者管理、忙闲查询、日程视图（agenda）、智能时段建议、会议室查找、RSVP | | **任务** | 创建、查看、完成、重新打开、子任务、成员管理、提醒、评论、我的任务、任务清单（CRUD + 任务关联 + 成员管理） | | **视频会议** | 多维搜索（query/主持人/参会者/会议室）、会议纪要（三路径批量获取 + AI 产物 + 逐字稿下载）、录制查询、会议机器人入会/离会/会议事件（需 User Token） | | **妙记** | 妙记详情 + AI 产物（摘要/待办/章节）、音视频媒体批量下载（SSRF 防护 + 速率限制）（需 User Token） | | **审批** | 审批定义与实例详情查询、当前登录用户审批任务查询（待办 / 已办 / 已发起 / 抄送）、发起/撤回/抄送审批实例、通过/拒绝/转交审批任务 | | **考勤** | 查询用户打卡记录与日/月度考勤统计（tenant token，日期范围最长 31 天） | | **OKR** | 周期列表、目标/关键结果进展记录列表与创建 | | **权限** | 添加 / 更新 / 删除协作者、批量添加、公开权限管理、分享密码、权限检查、转移所有权 | | **云盘增强** | 大文件分块上传（>20MB 自动分片）、流式下载、异步导出（docx→markdown 快捷路径 + sheet/bitable CSV）、异步导入、文件夹移动（自动轮询）、富文本评论（wiki URL 解析）、异步任务查询 | | **原生 Markdown 文件** | Drive `.md` 文件 create/fetch/overwrite，整体保留 Markdown 源码，不转换为飞书 docx 块；本地比对远端最新与历史版本 | | **文件** | 云空间文件列表、创建、移动、复制、删除、上传、下载、版本管理、元数据、统计 | | **素材** | 上传 / 下载（图片、文件、音视频） | | **画板** | 精排绘图（create-notes）、Mermaid / PlantUML 导入、截图下载、节点管理 | | **Slides** | 创建空白演示文稿、上传媒体到演示文稿 | | **评论** | 列出、添加、解决/恢复评论、回复管理 | | **搜索** | 消息搜索（默认返回消息 ID，`--enrich` 补全内容/发送者/群名/时间）、应用搜索、文档搜索（需 User Access Token） | | **用户** | 获取用户信息、用户搜索、部门用户列表 | | **通讯录** | 部门详情、子部门列表 | | **实时事件** | WebSocket 长连接订阅应用事件，支持 EventKey 列表/schema/consume/status/stop | | **Raw API** | `api GET/POST/PUT/DELETE/PATCH ` 裸调任意未封装的 OpenAPI 接口，自动鉴权与错误码处理，支持 dry-run、自定义超时、jq 过滤与 json/pretty/table/ndjson/csv 多格式输出 | | **OpenAPI Schema** | 本地查询内置 OpenAPI service/resource/method、路径、参数和 scope，无需 token | | **Profile 多配置** | 多 App / 多账号配置 add/list/use/current/rename/remove/migrate，支持 `FEISHU_PROFILE` 临时切换 | | **健康检查** | `doctor` 一次检查配置、User Token、端点、代理和本地依赖 | ## 快速开始 ### 安装 **一键安装（推荐）** 自动检测平台，下载最新版本并安装到 `/usr/local/bin`： ```bash curl -fsSL https://raw.githubusercontent.com/riba2534/feishu-cli/main/install.sh | bash ``` 已安装的用户执行同样的命令即可更新到最新版本。
其他安装方式 **手动下载** 从 [Releases](https://github.com/riba2534/feishu-cli/releases/latest) 页面下载对应平台的压缩包： | 平台 | 文件 | |------|------| | 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` | ```bash tar -xzf feishu-cli_*_linux-amd64.tar.gz sudo mv feishu-cli_*/feishu-cli /usr/local/bin/ ``` **使用 go install** ```bash go install github.com/riba2534/feishu-cli@latest ``` **从源码编译** ```bash git clone https://github.com/riba2534/feishu-cli.git cd feishu-cli && make build # 二进制文件输出到 bin/feishu-cli ```
### 配置凭证 **一键创建应用（推荐）** 无需手动访问飞书开放平台后台，一条命令自动完成应用注册： ```bash # 自动创建飞书应用并保存凭证到 ~/.feishu-cli/config.yaml feishu-cli config create-app --save ``` 执行后终端会输出一个授权链接，用飞书扫码确认即可。CLI 自动获取 App ID 和 App Secret 并写入配置文件，后续命令直接可用。 然后在飞书开放平台的**应用权限管理**页面为新创建的应用开通所需 scope。最快的方式是复制 [权限要求](#权限要求) 章节的 JSON，在权限管理页面的 **导入权限** 入口粘贴即可一次性申请全部。
手动配置（不推荐） 如果你有特殊需求（如企业应用、自定义应用类型），也可以手动配置： 1. 在 [飞书开放平台](https://open.feishu.cn/app) 创建应用，获取 App ID 和 App Secret 2. 给应用添加所需权限（参见[权限要求](#权限要求)） 3. 配置凭证（二选一）： ```bash # 方式一：环境变量 export FEISHU_APP_ID="cli_xxx" export FEISHU_APP_SECRET="xxx" # 方式二：配置文件 feishu-cli config init # 生成模板后手动编辑填入凭证 ```
（可选）如果需要使用搜索、审批任务查询等需要用户身份的功能，还需完成 OAuth 用户授权： ```bash feishu-cli auth login ``` ### 验证安装 ```bash feishu-cli doc create --title "Hello Feishu" ``` 如果返回文档 ID，说明配置成功。 ## 命令参考 ``` feishu-cli [subcommand] [flags] Commands: doc 文档操作（创建、导入、导出、编辑、异步导出/导入文件） wiki 知识库操作（节点增删改查、空间详情、成员管理） sheet 电子表格（读写、样式、batch-set-style、V3 富文本 API、导出 XLSX/CSV、image、filter-view + condition、dropdown） bitable 多维表格（base/v3 + bitable/v1：数据表/字段/记录/附件/视图/仪表盘/表单/角色/权限/聚合/工作流，87 命令） msg 消息操作（发送、转发、合并转发、回复、Pin、表情回复、书签、批量获取、资源下载） chat 群聊管理（创建、更新、删除、成员管理） mail 邮箱操作（分类/搜索、发送、草稿、回复、转发、CID 内联图片、模板、签名） drive 云盘增强（分块上传、流式下载、异步导出/导入、移动、评论，8 命令） markdown Drive 原生 Markdown 文件 CRUD（.md 整体读写、版本比对，不转换 docx 块） vc 视频会议（多维搜索、纪要、录制查询、会议机器人入会/离会/事件） minutes 妙记操作（详情 + AI 产物、媒体批量下载） file 文件管理（列出、移动、复制、删除、上传、下载、版本管理） media 素材操作（上传、下载） perm 权限管理（添加、删除、批量添加、公开权限、密码、转移所有权） calendar 日历操作（日程增删改查、搜索、参与者、忙闲查询、agenda、suggestion、room-find、rsvp） task 任务操作（增删改查、子任务、成员、提醒、评论、我的任务） tasklist 任务清单管理（CRUD、任务关联、成员管理） attendance 考勤操作（打卡记录查询、统计数据查询） okr OKR 操作（周期列表、进展记录列表与创建） slides Slides 演示文稿（创建、媒体上传） user 用户操作（获取信息、搜索、部门用户列表） dept 部门操作（详情、子部门列表） board 画板操作（导入图表、下载图片） comment 评论操作（列出、添加、解决/恢复、回复管理） approval 审批操作（定义/实例详情、任务查询、实例创建/撤回/抄送、任务通过/拒绝/转交） search 搜索操作（消息、应用、文档） event 实时事件订阅（WebSocket 长连接、list/schema/consume/status/stop） schema 本地浏览飞书 OpenAPI 方法（无需 token） api 通用 OpenAPI 透传调用（任意 method/path，自动鉴权 + 错误码翻译，覆盖 2500+ 端点） profile 多 App / 多账号配置切换 doctor 环境健康检查（config/user_token/endpoints/proxy/deps） auth 身份认证（OAuth 登录、状态、退出、scope 预检） config 配置管理 ```
文档操作 ```bash # 创建文档 feishu-cli doc create --title "新文档" # 导入 Markdown（核心功能，默认上传图片） feishu-cli doc import doc.md --title "文档标题" --upload-images --verbose # 导出为 Markdown feishu-cli doc export -o output.md --download-images # 导出他人文档（自动从 auth login 读取 User Token，或手动指定） feishu-cli doc export -o output.md --user-access-token # 获取文档信息 feishu-cli doc get # 获取所有块 feishu-cli doc blocks --all # 添加内容（JSON 格式） feishu-cli doc add -c '' # 添加内容（Markdown 格式） feishu-cli doc add README.md --content-type markdown # 添加高亮块 feishu-cli doc add-callout "提示内容" --callout-type info # 批量更新 feishu-cli doc batch-update '[...]' --source-type content # 异步导出为文件（PDF/DOCX/XLSX） feishu-cli doc export-file --type pdf -o output.pdf # 异步导入本地文件为飞书文档 feishu-cli doc import-file local_file.docx --type docx --name "文档名" ```
知识库操作 ```bash feishu-cli wiki spaces # 列出知识空间 feishu-cli wiki get # 获取节点 feishu-cli wiki nodes # 列出节点 feishu-cli wiki export -o doc.md # 导出为 Markdown feishu-cli wiki export-tree -o ./backup # 递归导出知识库子树 feishu-cli wiki create --space-id --title "新节点" feishu-cli wiki move-docs --space-id # 移动云空间文档至知识空间 feishu-cli wiki space-get # 获取知识空间详情 feishu-cli wiki space-create --name "新知识库" # 创建知识库（v1.29+） feishu-cli wiki space-list --page-all -o json # 列出所有可见知识库（v1.29+） feishu-cli wiki node-copy --space-id --node-token --target-space-id # 复制节点（v1.29+） feishu-cli wiki delete-space --yes # 删除整个知识空间（异步任务自动轮询） # 知识空间成员管理 feishu-cli wiki member add --member-type userid --member-id USER_ID --role admin feishu-cli wiki member list feishu-cli wiki member remove --member-type userid --member-id USER_ID --role admin ```
电子表格操作 ```bash # V2 API - 基础读写 feishu-cli sheet read "Sheet1!A1:C10" feishu-cli sheet write "Sheet1!A1:B2" --data '[["姓名","年龄"],["张三",25]]' # V3 API - 富文本支持 feishu-cli sheet read-rich "sheet!A1:C10" feishu-cli sheet write-rich --data-file data.json # 行列操作 feishu-cli sheet add-rows --count 5 feishu-cli sheet add-cols --count 3 # 样式与合并 feishu-cli sheet style "Sheet1!A1:C3" --bold --font-size 14 feishu-cli sheet merge "Sheet1!A1:C1" ```
消息操作 ```bash # 发送文本消息 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 # 获取群聊历史消息（已 auth login 时自动用 User Token；未登录回落 Bot Token，要求 Bot 在群里） feishu-cli msg history --container-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 --receive-id --receive-id-type email # 回复消息 feishu-cli msg reply --text "回复内容" # 合并转发 feishu-cli msg merge-forward --receive-id user@example.com --receive-id-type email --message-ids id1,id2 # 消息加急 feishu-cli msg urgent --user-id-type open_id --user-ids ou_xxx,ou_yyy feishu-cli msg urgent --urgent-type phone --user-id-type user_id --user-ids u_123,u_456 feishu-cli msg urgent --urgent-type sms --user-id-type union_id --user-ids on_xxx,on_yyy # 表情回复 feishu-cli msg reaction add --emoji-type THUMBSUP feishu-cli msg reaction remove --reaction-id REACTION_ID feishu-cli msg reaction list # Pin 消息 feishu-cli msg pin feishu-cli msg unpin feishu-cli msg pins --chat-id CHAT_ID ```
权限管理 ```bash # 添加 / 更新协作者 feishu-cli perm add --doc-type docx --member-type email \ --member-id user@example.com --perm full_access --notification feishu-cli perm update --doc-type docx --member-type email \ --member-id user@example.com --perm edit # 查看 / 删除协作者 feishu-cli perm list --doc-type docx feishu-cli perm delete --doc-type docx --member-type email --member-id user@example.com # 公开权限管理 feishu-cli perm public-get feishu-cli perm public-update --external-access --link-share-entity anyone_readable # 分享密码 feishu-cli perm password create feishu-cli perm password delete # 批量添加协作者 feishu-cli perm batch-add --members-file members.json --notification # 权限检查 feishu-cli perm auth --action view # 转移所有权 feishu-cli perm transfer-owner --member-type email --member-id user@example.com ```
群聊管理 ```bash # 群聊 CRUD feishu-cli chat create --name "群聊名" --user-ids id1,id2 feishu-cli chat get feishu-cli chat update --name "新群名" feishu-cli chat delete feishu-cli chat link # 群成员管理 feishu-cli chat member list feishu-cli chat member add --id-list id1,id2 feishu-cli chat member remove --id-list id1,id2 ```
文件管理 ```bash # 基础操作 feishu-cli file list [folder_token] feishu-cli file mkdir "新文件夹" --parent # 上传 / 下载 feishu-cli file upload local_file.pdf --parent FOLDER_TOKEN feishu-cli file download -o output.pdf feishu-cli file download -o large.zip --user-access-token u-xxx --timeout 30m # 大文件自动 Range 分片兜底 # 版本管理 feishu-cli file version list --doc-type docx feishu-cli file version create --doc-type docx --name "v1.0" feishu-cli file version get --doc-type docx feishu-cli file version delete --doc-type docx # 元数据与统计 feishu-cli file meta TOKEN1 TOKEN2 --doc-type docx feishu-cli file stats --doc-type docx ```
搜索操作 搜索 API 需要 User Access Token。推荐使用 `auth login` 一键获取（Token 自动保存和刷新），也可通过 `--user-access-token` 参数或环境变量手动指定。 ```bash # 获取 User Access Token（推荐，一次登录自动刷新） feishu-cli auth login # 搜索消息（默认返回消息 ID，-o json 输出 {MessageIDs,HasMore,PageToken}） 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 messages "会议" --enrich # 补全内容/发送者/群名/时间 # 搜索应用 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 export FEISHU_USER_ACCESS_TOKEN="u-xxx" feishu-cli search docs "产品需求" ```
审批操作 `approval get` 使用应用权限查询审批定义（审批模板/流程定义），支持 `--output raw-json` 查看飞书 API 原始响应，需要开通 `approval:approval:readonly`；`approval instance get` 对齐官方 `instances/uat_get`，必须使用 User Token，需要开通 `approval:instance:read`；`approval task query` 对齐官方 `tasks/uat_query`，必须使用 User Token，需要开通 `approval:task:read`。审批写流程覆盖 `instance create/cancel/cc`、`task approve/reject/transfer`；其中 `instance create` 是本项目额外应用态能力，其余写命令均对齐官方 `uat_*` 用户态接口。 输出说明： - 不传 `--output`：输出便于阅读的文本摘要 - `--output json`：输出 CLI 归一化后的 JSON，部分字段会做拍平和字符串化处理 - `--output raw-json`：输出飞书 API 原始响应，便于排查字段差异 ```bash # 查询审批定义详情（审批模板/流程定义） feishu-cli approval get # 输出完整 JSON feishu-cli approval get --output json # 输出飞书 API 原始响应 feishu-cli approval get --output raw-json # 查询审批实例详情（User Token） feishu-cli approval instance get --instance-code feishu-cli approval instances get --instance-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 # 显式指定 User Access Token feishu-cli approval task query --topic cc-unread --user-access-token # 发起审批实例（form.json 为飞书审批表单 JSON 数组） feishu-cli approval instance create --approval-code --user-id ou_xxx --form-file form.json # 撤回 / 抄送审批实例 feishu-cli approval instance cancel --instance-code feishu-cli approval instance cc --instance-code --cc-user-ids ou_a,ou_b # 通过 / 拒绝审批任务 feishu-cli approval task approve --instance-code --task-id --comment "同意" feishu-cli approval task reject --instance-code --task-id --comment "信息不完整" # 转交审批任务（User Token） feishu-cli approval task transfer --instance-code --task-id --transfer-user-id ou_target --comment "请代审" ```
身份认证（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。 ```bash # 按业务域申请推荐权限（推荐） 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 --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` 时会自动清理
更多命令 ```bash # 文档异步导出/导入 feishu-cli doc export-file --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 # 日历 feishu-cli calendar list feishu-cli calendar get feishu-cli calendar primary feishu-cli calendar create-event --calendar-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 --query "关键词" feishu-cli calendar event-reply --status accept feishu-cli calendar attendee add --user-ids id1,id2 feishu-cli calendar attendee list 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 feishu-cli task subtask create --summary "子任务" feishu-cli task subtask list feishu-cli task member add --members id1,id2 --role assignee feishu-cli task reminder add --minutes 30 feishu-cli task upload-attachment --task-guid --file ./report.pdf # 任务列表 feishu-cli tasklist create --name "任务列表" feishu-cli tasklist list feishu-cli tasklist get feishu-cli tasklist delete # 画板（v1.25+ 新增 5 个子命令 + Mermaid 本地引擎 + Markdown ```svg fence 自动识别） feishu-cli board create-notes nodes.json -o json # 精排绘图（JSON 控制坐标、颜色、连线） feishu-cli board import "graph TD; A-->B" --source-type content --syntax mermaid --diagram-type flowchart # 服务端渲染 feishu-cli board import diagram.mmd --syntax mermaid --engine local # 本地引擎（whiteboard-cli 翻译，每个节点可单独编辑） feishu-cli board import diagram.puml --syntax plantuml # 导入 PlantUML feishu-cli board svg-import drawing.svg # 单 svg 节点装饰（图标/印章 < 2KB） feishu-cli board clone --batch-size 10 # 克隆画板（含 connector ID 重映射 + 分批节流） feishu-cli board upload-image photo.png # 上传本地图片为 image 节点（自动推断像素尺寸） feishu-cli board lint # 几何质检（重叠/字号一致性/容量/综合评分） feishu-cli board export-code --merge --output-path design.svg # 反向导出 SVG（按 z_index 排序） feishu-cli board update nodes.json --overwrite --snapshot old.json # 覆盖更新+快照备份 feishu-cli board nodes # 获取画板所有节点 feishu-cli board image output.png # 下载画板截图 # ⭐ AI 自由作图（飞轮/鱼骨/Dashboard/插画/周期表/赛博朋克等）：用 skill 的一键脚本，每个矢量元素都可单独点击编辑 python3 skills/feishu-cli-board/scripts/svg_to_board.py drawing.svg # 内置 5 步管道：whiteboard-cli 翻译 → 修 z_index → 修剪 viewBox 溢出 → 分批 create-notes → 验证 # 评论 feishu-cli comment list --type docx feishu-cli comment add --type docx --text "评论内容" feishu-cli comment resolve --type docx feishu-cli comment unresolve --type docx feishu-cli comment reply list --type docx feishu-cli comment reply delete --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 batch-delete --base-token bscnxxxx --table-id tblxxx --record-ids rec_1,rec_2,rec_3 feishu-cli bitable record batch-get --base-token bscnxxxx --table-id tblxxx --record-ids rec_1,rec_2 # 批量获取记录 feishu-cli bitable record share-link --base-token bscnxxxx --table-id tblxxx --record-ids rec_1,rec_2 # 批量共享链接（v1.29+） 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 # 记录附件（上传 / 下载 / 移除） feishu-cli bitable record upload-attachment --base-token bscnxxxx --table-id tblxxx \ --record-id recxxx --field-id fldxxx --file ./report.pdf --file ./shot.png feishu-cli bitable record download-attachment --base-token bscnxxxx --table-id tblxxx \ --record-id recxxx --output ./downloads/ feishu-cli bitable record remove-attachment --base-token bscnxxxx --table-id tblxxx \ --record-id recxxx --field-id fldxxx --file-token boxcnxxxx # 仪表盘（CRUD + 智能排版 + 仪表盘块） feishu-cli bitable dashboard create --base-token bscnxxxx --name "运营看板" feishu-cli bitable dashboard block create --base-token bscnxxxx --dashboard-id dsbxxxx \ --type column --name "按月统计" --data-config '{"table_name":"任务","group_by":"月份"}' feishu-cli bitable dashboard arrange --base-token bscnxxxx --dashboard-id dsbxxxx # 表单（CRUD + 分享 token 详情/提交 + 表单问题） feishu-cli bitable form create --base-token bscnxxxx --table-id tblxxx --name "报名表" feishu-cli bitable form field create --base-token bscnxxxx --table-id tblxxx --form-id vewxxx \ --questions '[{"type":"text","title":"你的名字","required":true}]' feishu-cli bitable form detail --share-token shrcnxxxx # 无需 base_token feishu-cli bitable form submit --share-token shrcnxxxx --content '{"评分":5,"评价":"很好"}' # 角色协作者（member list/create/delete/batch-create/batch-delete） feishu-cli bitable role member list --base-token bscnxxxx --role-id rolxxxx feishu-cli bitable role member create --base-token bscnxxxx --role-id rolxxxx --member-id ou_xxx --member-id-type open_id feishu-cli bitable role member delete --base-token bscnxxxx --role-id rolxxxx --member-id ou_xxx --member-id-type open_id feishu-cli bitable role member batch-create --base-token bscnxxxx --role-id rolxxxx --member-ids ou_a,ou_b --member-id-type open_id # 多维表格元信息更新（重命名 / 高级权限开关） feishu-cli bitable update --base-token bscnxxxx --name "新表名" # 重命名 feishu-cli bitable update --base-token bscnxxxx --is-advanced # 开启高级权限（--is-advanced=false 关闭） # 工作流（list/get/create/update/enable/disable；update 为整体替换 PUT） feishu-cli bitable workflow list --base-token bscnxxxx feishu-cli bitable workflow get --base-token bscnxxxx --workflow-id wkfxxxx feishu-cli bitable workflow update --base-token bscnxxxx --workflow-id wkfxxxx --config-file wf.json feishu-cli bitable workflow enable --base-token bscnxxxx --workflow-id wkfxxxx feishu-cli bitable workflow disable --base-token bscnxxxx --workflow-id wkfxxxx # 云盘增强（drive） feishu-cli drive upload --file big.zip --folder-token fldxxx feishu-cli drive download --file-token boxxxx --output ./downloads/ --overwrite feishu-cli drive download --file-token boxxxx --output ./big.zip --timeout 30m # 大文件自动 Range 分片兜底 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":"评论"}]' # v1.29+ 新增 ⭐ feishu-cli drive inspect --url "https://xxx.feishu.cn/docx/doxxxx" # 解析 URL → type/title/token feishu-cli drive apply-permission --token "" --perm view --remark "申请理由" # 向 owner 发申请 # 云盘 ↔ 本地单向镜像（pull/push/status） feishu-cli drive status --folder-token fldxxx --local-dir ./mirror feishu-cli drive pull --folder-token fldxxx --local-dir ./mirror --if-exists overwrite feishu-cli drive push --folder-token fldxxx --local-dir ./mirror --if-exists skip feishu-cli drive pull --folder-token fldxxx --local-dir ./mirror --delete-local --yes # 高危：双确认 # 云盘 v2 搜索（扁平 filter；search docs 走 v1，drive search 走 v2） feishu-cli drive search --query "季度报告" --doc-types DOC,SHEET --sort edit_time feishu-cli drive search --folder-tokens fldxxx --only-title # 邮箱（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 send --to user@example.com --subject "周报" --body "$(cat report.html)" \ --html --inline-images-auto-scan --confirm-send feishu-cli mail template create --name "周报模板" --subject "本周进度" --body "$(cat template.html)" feishu-cli mail template list feishu-cli mail reply --message-id msg_xxx --body "收到" --confirm-send feishu-cli mail forward --message-id msg_xxx --to team@example.com --body "请关注" feishu-cli mail signature # 列出邮箱签名 feishu-cli mail signature --detail 7012345678901234567 -o json # 单个签名详情 # 视频会议（vc）：search/notes/recording 需 User Token；bot meeting-join/leave 默认 Bot/Tenant 身份 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 feishu-cli vc bot meeting-join --meeting-number 123456789 # 机器人入会（Bot/Tenant 身份） feishu-cli vc bot meeting-leave --meeting-id 6911188411932033028 # 机器人离会（Bot/Tenant 身份） feishu-cli vc bot meeting-events --meeting-id 6911188411932033028 --start 2026-03-01 --end 2026-03-31 # 需 User Token（端点拒收 Tenant） # 妙记（minutes，需 User Token） feishu-cli minutes get --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 calendar suggestion --attendee-ids ou_aaa,ou_bbb --duration 30m feishu-cli calendar room-find --slot 2026-03-28T14:00:00+08:00~2026-03-28T15:00:00+08:00 \ --city "北京" --min-capacity 6 feishu-cli calendar rsvp --event-id EVENT_xxx --action accept # 任务增强 feishu-cli task my # 查看我的任务 feishu-cli task reopen # 重新打开 feishu-cli task comment add --content "评论" feishu-cli tasklist task-add --task-ids guid1,guid2 feishu-cli tasklist member add --members ou_xxx # 消息增强 feishu-cli msg mget --message-ids om_xxx,om_yyy feishu-cli msg resource-download --type image -o photo.png feishu-cli msg resource-download --type file --user-access-token u-xxx -o attachment.bin # 用户可见但 Bot 不可见的资源 feishu-cli msg resource-download --type file --user-access-token u-xxx -o large.bin --timeout 30m # 大文件自动 Range 分片兜底 feishu-cli msg thread-messages --page-size 20 feishu-cli msg flag create om_xxx # 收藏消息 feishu-cli msg flag create om_xxx --flag-type feed # feed 层自动识别 thread/msg_thread feishu-cli msg flag list --page-size 50 feishu-cli msg flag cancel om_xxx # 尽量取消消息层 + feed 层 # interactive 卡片返回原始 schema（不再返回渲染后的 文本） feishu-cli msg get om_xxx --card-content-type user # userDSL（开发者视角的 schema 2.0 JSON） feishu-cli msg get om_xxx --card-content-type raw # cardDSL（平台内部完整描述） feishu-cli msg mget --message-ids om_xxx,om_yyy --card-content-type user feishu-cli msg list --container-id oc_xxx --card-content-type user # 文档增强 feishu-cli doc content-update --mode append --markdown "## 新内容" feishu-cli doc content-update --mode overwrite --markdown "# 全新文档" feishu-cli doc content-update --mode replace_range --selection-by-title "## 旧章节" --markdown "## 新章节" feishu-cli doc media-insert --file photo.png --type image --align center feishu-cli doc media-download -o image.png feishu-cli doc media-download --doc-token DOC_TOKEN --doc-type docx -o image.png # 妙笔BOX HTML 小组件（文档里跑动画 / ECharts / 可交互图表，唯一能"动"的载体） feishu-cli doc htmlbox create --html-file widget.html feishu-cli doc htmlbox update --html-file widget-v2.html feishu-cli doc htmlbox get --raw > current.html feishu-cli doc htmlbox delete # 电子表格导出 feishu-cli sheet export -o output.xlsx feishu-cli sheet export --format csv --sheet-id SHEET_ID -o output.csv feishu-cli sheet export --format markdown -o output.md feishu-cli sheet filter-view create --spreadsheet-token shtcnxxxx --sheet-id SHEET_ID \ --range "SHEET_ID!A1:H100" --name "P0 高优" feishu-cli sheet filter-view list --spreadsheet-token shtcnxxxx --sheet-id SHEET_ID feishu-cli sheet filter-view update --token shtcnxxxx --sheet-id SHEET_ID \ --filter-view-id pH9xxxx --name "新名字" # 筛选条件（按列字母定位） feishu-cli sheet filter-view condition create --token shtcnxxxx --sheet-id SHEET_ID \ --filter-view-id pH9xxxx --condition-id E --filter-type number --compare-type less --expected '["6"]' feishu-cli sheet filter-view condition list --token shtcnxxxx --sheet-id SHEET_ID --filter-view-id pH9xxxx feishu-cli sheet dropdown set --token shtcnxxxx --range "SHEET_ID!B2:B100" \ --options "待办,处理中,已完成" feishu-cli sheet dropdown update --token shtcnxxxx --sheet-id SHEET_ID \ --ranges "SHEET_ID!A1:A100" --options "P0,P1,P2" --multiple --colors "#FF4D4F,#FAAD14,#52C41A" feishu-cli sheet dropdown get --token shtcnxxxx --range "SHEET_ID!A1:A100" feishu-cli sheet dropdown delete --token shtcnxxxx --ranges "SHEET_ID!A1:A100" # 浮动图片 / 单元格写图 / 批量样式 feishu-cli sheet image media-upload shtcnxxxx ./logo.png # 返回 file_token feishu-cli sheet image write-image shtcnxxxx SHEET_ID --range "A1" --image ./logo.png feishu-cli sheet batch-set-style shtcnxxxx \ --data '[{"ranges":["SHEET_ID!A1:A2"],"style":{"font":{"bold":true},"backColor":"#FF0000"}}]' # Drive 原生 Markdown 文件（不做 docx 块转换） feishu-cli markdown create --name README.md --content-file ./README.md --folder-token fldxxx feishu-cli markdown create --file ./README.md --folder-token fldxxx feishu-cli markdown fetch --file-token boxcnxxx --output-path ./remote.md feishu-cli markdown overwrite --file-token boxcnxxx --file ./remote.md feishu-cli markdown diff --file-token boxcnxxx --file ./local.md # 远端最新 vs 本地 feishu-cli markdown diff --file-token boxcnxxx --from-version 2 --to-version 5 # 远端版本 A vs B # 用户 feishu-cli user info 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 feishu-cli dept children # 考勤（tenant token） feishu-cli attendance user-task query --employee-type open_id --user-ids ou_xxx \ --start 2026-03-01 --end 2026-03-31 feishu-cli attendance user-stats query --employee-type open_id --user-ids ou_xxx \ --current-user-id ou_xxx --start 2026-03-01 --end 2026-03-31 # OKR feishu-cli okr cycle list feishu-cli okr progress list --objective-id 7xxx feishu-cli okr progress create --key-result-id 7xxx --content "本周完成核心模块联调" # Slides 演示文稿 feishu-cli slides create --title "Q2 OKR" --output json feishu-cli slides media-upload --file ./cover.png --presentation-token # 实时事件订阅 feishu-cli event list feishu-cli event schema im.message.receive_v1 feishu-cli event consume im.message.receive_v1 --max-events 5 --timeout 60s feishu-cli event status feishu-cli event stop --all # OpenAPI schema / 健康检查 / 多配置 feishu-cli schema list --service im feishu-cli schema im.messages.delete --format json feishu-cli doctor --json feishu-cli profile migrate feishu-cli profile add work --app-id cli_xxx --app-secret secret_xxx --use feishu-cli profile use - # 通用 OpenAPI 透传（v1.29+）⭐ 覆盖 2500+ 未封装端点 feishu-cli api GET /open-apis/authen/v1/user_info --as user feishu-cli api GET /open-apis/im/v1/chats --params '{"page_size":10}' --as user feishu-cli api POST /open-apis/im/v1/messages --params '{"receive_id_type":"email"}' \ --data '{"receive_id":"u@example.com","msg_type":"text","content":"{\"text\":\"hi\"}"}' --as bot feishu-cli api DELETE /open-apis/im/v1/messages/om_xxx --as bot --dry-run # 预览 feishu-cli auth token --as user # 导出 token 给其他工具用（如果需要） ```
## AI 技能集成 `skills/` 目录包含 **27 个** 为 [Claude Code](https://claude.ai/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` | 消息发送、回复、转发、加急、消息书签（flag）、资源下载 | "发消息给 xxx" | | `feishu-cli-card` | interactive 卡片 V2 构造 | "做一张飞书卡片" | | `feishu-cli-chat` | 会话浏览、消息互动与群聊管理 | "查看群聊历史消息" | | `feishu-cli-toolkit` | 综合工具箱（表格导出/日历agenda/任务/清单/文件/评论/知识库/通讯录） | "读取飞书表格数据" | | `feishu-cli-board` | 画板操作（精排绘图/Mermaid 导入/截图/节点管理） | "画个架构图"、"在飞书里画图" | | `feishu-cli-bitable` | 多维表格全功能（base/v3 + bitable/v1：表/字段/记录/视图/仪表盘/表单/角色协作者/工作流/数据查询） | "创建多维表格"、"查询记录" | | `feishu-cli-api` | 裸调任意飞书 OpenAPI 接口（覆盖未封装接口，支持 jq 过滤与多格式输出） | "调用这个飞书接口"、"raw api" | | `feishu-cli-vc` | 视频会议与妙记（搜索/纪要/录制/AI 产物/逐字稿/媒体下载） | "搜索最近的会议"、"下载会议纪要" | | `feishu-cli-drive` | 云盘增强（分块上传/流式下载/异步导出导入/评论） | "上传文件到飞书" | | `feishu-cli-mail` | 飞书邮箱（收件箱/发送/回复/转发/草稿/CID 内联图片/模板） | "查看邮件"、"发邮件" | | `feishu-cli-auth` | OAuth 认证、Token、Profile 与配置诊断 | "登录飞书"、"检查配置"、"切换 profile" | | `feishu-cli-search` | 搜索飞书文档 / 消息 / 应用 | "搜索飞书文档" | | `feishu-cli-approval` | 审批查询与写流程 | "发起审批"、"通过审批" | | `feishu-cli-attendance` | 考勤打卡与统计查询 | "查考勤记录" | | `feishu-cli-calendar` | 智能日历（找时段/找会议室/RSVP） | "帮我找会议时间" | | `feishu-cli-event` | WebSocket 实时事件订阅 | "监听飞书消息事件" | | `feishu-cli-markdown` | Drive 原生 Markdown 文件 CRUD | "把 md 源文件存到飞书云盘" | | `feishu-cli-okr` | OKR 周期与进展记录 | "更新 OKR 进展" | | `feishu-cli-schema` | 本地浏览 OpenAPI schema | "查这个飞书 API 参数" | | `feishu-cli-sheet` | 电子表格筛选视图与下拉菜单 | "给表格加下拉框" | | `feishu-cli-slides` | Slides 演示文稿创建与媒体上传 | "创建飞书 PPT" | | `feishu-cli-htmlbox` | 妙笔BOX HTML 小组件（文档里跑 CSS/JS 动画、ECharts、可交互图表） | "在飞书文档里做动画"、"妙笔BOX" | **安装方法**： ```bash # 一键安装全部技能（推荐） 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 | 大表格自动拆分 | | `![](url)` | Image | 27 | 图片（API 限制，创建占位块） | | `$$公式$$` | Equation | 16 | 块级公式（降级为行内） | | 附件 | File | 23 | 文件块 | | `