Feishu Bitable (Read Only) Piece

这是为 Activepieces 测试环境设计的最小飞书只读 Piece。

能力

• 用自建应用 app_id / app_secret 获取 tenant_access_token；
• 分页读取指定 Base 的数据表元数据；
• 输出脱敏 Base 标识、表数量、table_id 和表名；
• 不提供记录新增、更新、删除或任意自定义 API 动作。

安全边界

• 凭据通过 CustomAuth Connection 输入，动作输出不包含凭据或 Token；
• 仅允许访问 https://open.feishu.cn/open-apis 中代码写死的 Token 与 table-list 路径；
• 代码中没有写入方法或写入端点；
• 连接校验会真实获取 Token，因此只有在获准只读联调后才点击保存/测试连接；
• 使用专用测试应用和测试 Base，禁止生产凭据。

构建与安装状态

当前目录是供 Activepieces 官方 monorepo 构建体系使用的 Piece 源码。尚未安装依赖、构建 tarball、上传到 Activepieces 或修改 Docker。

官方文档说明私有 Piece 文件上传属于付费版本。社区版后续需要在以下路径中选择一个：

1. 将 Piece 作为公开社区包发布到 npm；
2. 在 Activepieces 官方源码仓库/私有 fork 中本地构建包含该 Piece 的镜像；
3. 若现有实例具备付费许可，从 Platform Admin → Setup → Pieces 上传构建后的 .tgz。

任何安装路径都属于下一道施工门禁，执行前须确认版本、许可和回滚方式。