前言

首先感谢原本“飞书多维表格”、“飞书多维表格（RPA）”指令的作者，节省了大家很多时间。

痛点

但是多维表格的操作有几条前置条件：

1. 被添加为企业开发者
2. 进入开放平台，添加一个企业自建应用，拿到App ID和App Secret
3. 进入多维表格页面，添加文档应用
4. 拿到多维表格的baseId（也叫appToken）

总体还是有诸多障碍的

转机

最近在研究飞书多维表格插件，发现插件也能够读写多维表格

边栏插件开发指南

挖了一下鉴权链路，发现是另外一套体系

BaseOpenSDK 文档索引  

BaseOpenSDK（Python）官方文档

可以发现，绝大多数接口都是兼容原本open-api的（少部份接口没有，怀疑BaseOpenSDK背后的API是拷贝的OpenAPI的旧版本魔改的）

过程

然后就花了点时间

从写py、做测试、再到装修指令，中间的坑还是不少的

1. BaseOpenSDK就像是一个阉割版的lark-oapi SDK，部分指令/接口是没有实现的（例如：获取单个数据表信息、用ID批量获取记录）
2. 目前只能给feishu_bitable_sdk的每个公开函数加对应的可视化流程做包装，再添加指令描述信息，这一步花了我60%的时间

成果

最后，搞出了下图的这些指令（大部分指令的使用方式还是 抄袭 致敬“飞书多维表格（RPA）”的）

特性

1. 全局初始化一次SDK，后续无需传递SDK实例（设计如此，就是为了简化。如果真有需求切换读写多个多维表的话，就需要重新初始化了）
2. 获取/写入数据接口有行数限制的，指令里已内置连续翻页/自动分批逻辑。无需再计算行数、手动分页
3. 针对高频的“表/视图名称 -> 表/视图ID”转换，内置了两层缓存（数据表、视图），在方便使用的同时，减少大量API请求次数
4. 增加了两个高频场景的指令：
1. 字典列表写入飞书多维表
2. Excel写入飞书多维表

最后这两个指令都会根据字典键、表头的变化，动态新增多维表字段（同时自动根据对应键、列的值推断字段类型）。

同时提供了额外字段（一个字典）的填充，自动给所有数据追加这些额外字段，再写入多维表。

比如平台下载的当日数据，你希望在写入多维表时多一个日期纬度，方便后面分析历史趋势。你只需要在指令的“额外字段”参数设置 {"日期": "2025-09-03"}

以上设计，我的希望是极大程度减少“简单变更”引起的维护量（适用于某些平台下载账单的表头经常变更、新增的情况）

顺便给大家看一下如何获取多维表格授权码

指令暂时没有渠道分享，直接打压缩包给大家了

 点我点我

彩蛋

海绵宝宝：你一开始不是要搞飞书多维表格插件吗？怎么分享个RPA指令就完了

派大星：还在搞～还在搞～ 点我查看