feishu-cli

飞书轻量工具箱与分诊入口。仅在没有更专用 skill 时使用，主要覆盖普通电子表格、 日历/日程、任务/任务清单、基础文件/素材/评论、知识库、用户和部门查询、审批查询。 文档读写导入导出、云盘增强、多维表格、画板、消息/群聊、邮箱、搜索、权限、OAuth、 视频会议/妙记均优先使用对应 feishu-cli- 专用技能。 sheet filter-view/dropdown 优先用 feishu-cli-sheet；calendar suggestion/room-find/rsvp 优先用 feishu-cli-calendar。

只读操作，不修改文档内容。读取飞书云文档、知识库内容或电子表格，分析文档结构。 支持普通 docx、普通 sheet、知识库 docx 和知识库 sheet。当用户请求"查看"、"阅读"、"分析"、"读取"、 "打开"、"read"、"view" 飞书文档、知识库或电子表格时使用。支持通过文档 ID、知识库 Token 或 URL 读取。 Markdown 仅作为分析中间态存放在 /tmp（不主动落地为用户文件）；如需主动导出到本地路径请用 feishu-cli-export， 写入请用 feishu-cli-write。

飞书消息发送。发送消息（text/post/interactive 卡片等 10 种类型：text/post/image/file/audio/media/sticker/interactive/sharechat/shareuser；system 分割线 CLI 暂未直接支持，需用 feishu-cli api 透传）、回复消息、 转发/合并转发、消息加急、消息书签（flag 收藏/list/cancel）、下载消息资源（图片/文件）。 发送/回复/转发/加急默认 App Token（Bot 身份）；msg flag 收藏/书签必需 User Token（im:feed.flag:read/write）； msg resource-download 已登录时优先 User Token，未登录回落 App Token。 当用户明确请求通过飞书即时消息/Bot 消息发送、回复、转发、合并转发、加急、消息收藏/书签、 下载消息图片或文件时使用。邮件走 feishu-cli-mail；文档评论/共享权限走对应 skill。 注意：Reaction/Pin/获取消息详情/批量获取消息/话题回复/消息历史/搜索群聊/群聊管理， 以及消息删除（默认 App Token 用于 Bot 自撤回，可选 User Token 让管理员撤回他人） 请使用 feishu-cli-chat 技能。 发送 interactive 卡片时，先用 feishu-cli-card 构造 v2 JSON， 再回到本技能用 --msg-type interactive --content-file 发送。

向飞书文档写入内容、创建新文档、新建空白文档。支持 doc import 从 Markdown 创建、 doc content-update 精准追加/覆盖/替换/插入/删除，doc add/update/delete 低层块操作， 以及图片/文件插入。当用户请求创建文档、写文档、更新文档、替换章节、插入章节、 删除章节、追加内容、覆盖文档、插入图片或文件时使用。

将飞书文档、知识库文档或电子表格导出到本地。支持 docx/wiki/sheet 导出 Markdown， doc export 内嵌电子表格自动展开，图片/画板素材下载，以及 doc export-file 异步导出 PDF/Word/Excel。当用户请求导出文档、保存为 Markdown、导出 PDF/Word/Excel、下载文档图片、 导出表格或表格转 Markdown 时使用。本地导入请用 feishu-cli-import 或 feishu-cli-drive。

从 Markdown 文件导入创建飞书文档。支持嵌套列表、Mermaid/PlantUML 图表自动转画板、 大表格智能处理（超过 9 行用 inserttablerow API 追加保持单 block，超过 9 列拆分保留首列）、公式、Callout 高亮块。 内置飞书侧渲染规范（references/doc-guide.md + references/mermaid-spec.md）， 覆盖图表花括号/par 等语法限制、表格 9 行/列阈值、Callout 6 种颜色映射等飞书兼容性规则。 当用户请求"导入 Markdown"、"从 md 创建文档"、"从 md 文件创建文档"、"把 Markdown 转换到飞书"、 "上传 Markdown"、"Markdown 转飞书"、"md 导入"、"批量导入"，或排查"飞书 Mermaid 渲染失败"、 "Callout 颜色不对"、"飞书表格被拆"、"飞书文档导入兼容性"等问题时使用。 注意：仅支持 Markdown 源文件导入为飞书文档。Markdown 表格创建电子表格请用 feishu-cli-toolkit 的 sheet import-md； DOCX/XLSX 导入为云文档请使用 feishu-cli-drive 的 drive import。

飞书画板全能操作 · 5 种画图路径任选其一： (A) Mermaid/PlantUML 服务端渲染（思维导图/时序图/类图/饼图/流程图/甘特图，整图作为一个节点，飞书自动排版） (B) Mermaid 本地引擎 whiteboard-cli（绕开 par/参与方数等服务端限制，每个节点可点击编辑） (C) SVG 自由作图（任意视觉：飞轮/鱼骨/Dashboard/海报/插画/架构图等，每个 SVG 元素 → 1 个原生节点可单独编辑） → 使用 scripts/svgtoboard.py 把 SVG 翻译为飞书原生节点 (D) 简单 SVG 单节点装饰（图标/印章/小元素，2KB 以内 SVG） (E) 精排架构图（手写节点 JSON，绝对坐标 + 配色 + 连线 ID 引用） 当用户请求"画图/画板/whiteboard/画架构图/画流程图/画飞轮/画鱼骨/画路线图/画 Dashboard/画插画/画海报/ AI 自由作图/SVG 落画板/克隆画板/上传图片到画板/可视化/节点图/精排"时使用。 特别地，当用户反馈"右下角半截楼""zindex 错乱""节点翻倍""复杂图渲染不全""mermaid 服务端失败" 务必读 references/pitfalls.md 排障。 写类（add-board/create-notes/update/delete/clone/svg-import/upload-image/import）使用 App Token（默认 Bot 身份）， 无需登录；即使用户已 auth login，写类命令仍保持 App 身份不切换。 读类（image/nodes/export-code/svg-export/lint）登录后自动用 User Token，未登录回落 App Token。 svg-export 导出整板 SVG 视觉快照（POST /export，base64 解码），对任意画板有效（不限 svg 节点）， 配合 svgtoboard.py / board import 可实现「导出 → 编辑 → 回写」闭环。

飞书 OAuth 认证和 User Access Token 管理（Device Flow，RFC 8628）。 支持一键创建飞书应用、按域申请推荐权限、auth check 预检 scope、auth login 登录、Token 自动刷新。 覆盖 AI Agent 两步授权（--no-wait 拿链接 → --device-code 续轮询）、JSON 事件流解析、部分 scope 未授予（missingscopes）的判读与补授。 当用户请求登录飞书、获取 Token、OAuth 授权、用户身份授权、device flow、权限缺失、Token 过期、create-app、99991672、99991679， 或其他飞书技能遇到 User Access Token 问题时使用。 本技能同时承载两个相关子命令：doctor 做配置/网络/代理体检（错误信息不指向 scope/token 时用）， profile 管理多 App / 多账号独立配置（多租户切换）。 注意：profile 指 CLI 配置切换，与邮箱 mailbox profile（feishu-cli-mail）无关。

搜索飞书云文档、消息和应用。当用户请求"搜索文档"、"搜索消息"、"搜索应用"、"找文档"、 "search docs"、"查找飞书文档"、"有没有关于 xxx 的飞书文档"时使用。 也适用于：用户想查找某个主题的飞书文档或 Wiki、按关键词检索消息记录、查找内部应用。 搜索 API 必须使用 User Access Token，本技能包含完整的认证前置检查流程。

飞书云文档权限管理。支持添加/更新/删除/查看协作者、公开权限管理、分享密码、批量添加、 权限检查、转移所有权。当用户请求"添加权限"、"权限管理"、"共享文档"、"授权"、 "协作者"、"fullaccess"、"转移所有权"时使用。

飞书会话浏览、消息互动与群聊管理。看聊天记录（单聊/群聊/话题群）、搜群、获取消息详情、 Reaction 表情回应、Pin 置顶/取消置顶、删除消息，以及群聊信息管理（获取/更新/解散/成员）。 当用户请求"看群消息记录 / 拉群聊天记录 / 导出聊天记录 / 获取群历史 / 看话题回复 / 搜群 / 看私聊记录 / dump 飞书消息"时使用本技能；包括话题群（chatmode=thread）的整线程展开。 读类（msg history/list/get/mget/thread-messages）登录后默认 User Token、未登录回落 Bot； 互动类（reaction/pin/search-chats/chat get/update/delete/member）必需 User Token； msg delete 默认 App Token 用于 Bot 自撤回，可显式 User Token 给管理员撤回场景； chat create/link 默认 Bot 身份创建群/获取群链接。

飞书多维表格（Bitable/Base）操作。底层使用 base/v3 新 API，支持视图完整配置写入、 记录 upsert、记录批量获取、记录附件上传下载、记录修改历史、角色 CRUD + 协作者增删、 多维表格本体重命名/高级权限开关、数据聚合查询、 仪表盘 + 仪表盘块 CRUD、表单 + 表单问题 CRUD、工作流 CRUD 等。 当用户请求"创建多维表格"、"操作数据表"、"添加记录"、"查询记录"、"管理字段"、 "多维表格"、"base"、"bitable"、"数据表"、"视图排序"、"视图过滤"、"视图分组"、 "角色"、"role"、"高级权限"、"advperm"、"数据聚合"、"data query"、 "仪表盘"、"dashboard"、"表单"、"form"、"工作流"、"workflow"、"记录附件"、 "复制多维表格"时使用。 支持 --as botuserauto 身份切换：默认 auto（User 优先、Tenant 兜底）， --as bot 用 App Token 操作多维表格，无需 auth login、永不过期， 适合 cron / 无人值守 / 脚本自动抓取多维表格内容。 凡涉及"App Token 读写 bitable"、"不登录抓多维表格"、"cron 定时同步多维表格"、 "bitable 报需要 User Token / 91403 没权限"时也应使用本技能。

飞书文档 Markdown 编写规范，尤其是 Mermaid/PlantUML、Callout、表格、图片、公式等 导入兼容性检查。当用户要生成将导入飞书的 Markdown、排查 doc import 渲染失败、 或需要飞书兼容图表语法时使用。

飞书视频会议与妙记操作。多维搜索历史会议、获取会议纪要/AI 产物/逐字稿、 查询会议录制、下载妙记媒体文件、会议机器人入会/离会/会议事件。支持 meeting-ids / minute-tokens / calendar-event-ids 三路径入口。当用户请求"搜索会议"、"会议记录"、 "会议纪要"、"逐字稿"、"妙记"、"meeting"、"vc search"、"vc recording"、"minutes"、 "下载妙记"、"妙记视频"、"会议录制"、"会议机器人"、"机器人入会"、"vc bot"、 "从日程找会议"时使用。

飞书云文档正文：读取与总结 docx/wiki/sheet（含转成可直接发 IM 的 Markdown），从零创作文档（PRD、方案、报告、纪要等体裁模板，DocxXML 草稿与 doc script 预检），创建与编辑 docx（带内容新建并上传本地图片/附件/HTML 块/画板源文件、追加、覆盖、按章节或 block 精确替换/删除/移动、插入本地或剪贴板图片、设置文档封面、历史版本查看与回滚），Markdown 导入（Mermaid/PlantUML/SVG 转画板），导出 Markdown/PDF/Word/Excel 与下载或预览文档素材，云盘原生 .md 文件的上传、diff 与覆盖，以及读取和编辑已有思维笔记的节点。用户要阅读、总结、撰写、写入或改写飞书文档，把 Markdown 导入飞书，把文档导出到本地，设置文档封面，操作思维笔记节点，或把误改的文档回滚时使用。不用于：评论（即使请求提到文档）、协作者与权限、DOCX/XLSX 等二进制导入、上传文件的版本和云盘目录，使用 feishu-cli-storage；按单元格读写表格使用 feishu-cli-data；文档内 HTMLBox/ECharts 动态组件使用 feishu-cli-visual；获取会议的纪要、妙记与逐字稿使用 feishu-cli-meetings（撰写纪要类文档仍用本 Skill）。

飞书电子表格 Sheet 与多维表格 Bitable/Base：按范围读写单元格、类型保真整表读写、样式/合并/冻结/行列增删移动与隐藏、筛选与筛选视图、下拉框、原生单元格图片与浮动图片、Markdown 互转与 XLSX/CSV 导出；Bitable 表、字段、记录（结构化筛选、upsert、批量）、视图、链接解析、角色与成员、仪表盘、表单与分享、工作流和数据聚合，支持 --as bot 的 cron 无人值守。用户给出 /sheets/、/base/ 链接或要处理表格数据时使用。不用于：只需通读或总结整张表（feishu-cli-docs）、把本地 XLSX/CSV 文件导入成飞书表格和文档协作者权限（feishu-cli-storage）、图表可视化展示（feishu-cli-visual）、未封装 OpenAPI 透传（feishu-cli-platform）。

飞书 OpenAPI 裸调。api GET/POST/PUT/DELETE/PATCH 直接调用任意飞书 OpenAPI 接口， 覆盖 feishu-cli 尚未封装的接口（对齐 lark-cli 的 api 能力）。支持 --params(query)/--data(body JSON)/--data-file(从文件读 body)/ --as autouserbot 身份/--dry-run 预览/-o 二进制下载/--format/--jq。 当用户请求"调用 X API"、"裸调飞书接口"、"feishu-cli 没封装的接口怎么调"、"raw api"、 "用 api 命令发请求"、"下载飞书媒体/文件 binary"时使用。 不适用：仅查 schema 不调用（用 feishu-cli schema）；已有专用命令的高频场景（用对应 feishu-cli ）。