AI导哈

智能体工作流

feishu-cli-bitable

riba2534/feishu-cli

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

  • 648 次安装
  • 1400 星标
  • 收录于

安装命令

npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-bitable

SKILL.md

飞书多维表格（Bitable / Base）

通过 base/v3 API 操作飞书多维表格。bitable 也支持 base 别名。

API 切换：此技能已从旧的 bitable/v1 切换到新的 base/v3。字段名 app_token 和 base_token 在飞书文档里是同一个值的两种叫法（老 v1 叫 app_token，新 v3 叫 base_token），CLI 只认 --base-token（--app-token 已删除）。从多维表格 URL 里 /base/<token> 或 /bitable/<token> 片段里取 token 即可。

前置条件

  • 认证：所有命令支持 --as bot|user|auto 身份切换（详见下方「身份选择」），默认 auto（User 优先、Tenant 兜底）。已登录用 User Token，未登录自动回落 App Token；要稳定用 App Token 跑（cron）显式加 --as bot
  • App 凭证：应用 App ID + App Secret（base/v3 需要 X-App-Id header，自动注入）。--as bot / auto 回落 Tenant 时只靠 App 凭证，无需 auth login

身份选择 --as（命令组 persistent flag，所有子命令通用）

飞书 base/v3 与 bitable/v1 API 本身同时支持 User 和 Tenant(App) 两种身份，本技能据此提供三档：

相关 Skills

feishu-cli-toolkitriba2534/feishu-cli飞书轻量工具箱与分诊入口。仅在没有更专用 skill 时使用，主要覆盖普通电子表格、 日历/日程、任务/任务清单、基础文件/素材/评论、知识库、用户和部门查询、审批查询。 文档读写导入导出、云盘增强、多维表格、画板、消息/群聊、邮箱、搜索、权限、OAuth、 视频会议/妙记均优先使用对应 feishu-cli-* 专用技能。 sheet filter-view/dropdown 优先用 `feishu-cli-sheet`；calendar suggestion/room-find/rsvp 优先用 `feishu-cli-calendar`。文档办公1064feishu-cli-readriba2534/feishu-cli只读操作，不修改文档内容。读取飞书云文档、知识库内容或电子表格，分析文档结构。 支持普通 docx、普通 sheet、知识库 docx 和知识库 sheet。当用户请求"查看"、"阅读"、"分析"、"读取"、 "打开"、"read"、"view" 飞书文档、知识库或电子表格时使用。支持通过文档 ID、知识库 Token 或 URL 读取。 Markdown 仅作为分析中间态存放在 /tmp（不主动落地为用户文件）；如需主动导出到本地路径请用 feishu-cli-export， 写入请用 feishu-cli-write。文档办公874feishu-cli-msgriba2534/feishu-cli飞书消息发送。发送消息（text/post/interactive 卡片等 10 种类型：text/post/image/file/audio/media/sticker/interactive/share_chat/share_user；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 发送。设计与多媒体855feishu-cli-writeriba2534/feishu-cli向飞书文档写入内容、创建新文档、新建空白文档。支持 doc import 从 Markdown 创建、 doc content-update 精准追加/覆盖/替换/插入/删除，doc add/update/delete 低层块操作， 以及图片/文件插入。当用户请求创建文档、写文档、更新文档、替换章节、插入章节、 删除章节、追加内容、覆盖文档、插入图片或文件时使用。营销与写作854feishu-cli-exportriba2534/feishu-cli将飞书文档、知识库文档或电子表格导出到本地。支持 docx/wiki/sheet 导出 Markdown， doc export 内嵌电子表格自动展开，图片/画板素材下载，以及 doc export-file 异步导出 PDF/Word/Excel。当用户请求导出文档、保存为 Markdown、导出 PDF/Word/Excel、下载文档图片、 导出表格或表格转 Markdown 时使用。本地导入请用 feishu-cli-import 或 feishu-cli-drive。文档办公845feishu-cli-importriba2534/feishu-cli从 Markdown 文件导入创建飞书文档。支持嵌套列表、Mermaid/PlantUML 图表自动转画板、 大表格智能处理（超过 9 行用 insert_table_row 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。文档办公826