飞书多维表格 · 方式 B：企业自建应用 API
如果你需要 BugCapturer 自动创建标准列、统一表格结构，可以使用飞书开放平台的「企业自建应用」API 接入。该方式需要在开放平台创建应用，适合由管理员统一搭建团队台账的场景；个人快速试用请优先使用方式 A（自动化 Webhook 触发）。
- 一个飞书账号（个人版即可创建企业自建应用）
- 目标多维表格的访问权限
- 约 10 分钟的配置时间
第一步：创建飞书企业自建应用
Section titled “第一步：创建飞书企业自建应用”- 打开飞书开放平台，登录后进入「开发者后台」
- 点击「创建企业自建应用」，填写应用名称（如 BugCapturer）与描述
- 创建完成后，在「凭证与基础信息」页复制 App ID（
cli_开头）与 App Secret
第二步：开通多维表格权限并发布
Section titled “第二步：开通多维表格权限并发布”- 在应用内进入「权限管理」，搜索并开通
bitable:app（查看、评论、编辑和管理多维表格） - 进入「版本管理与发布」，创建版本并发布应用
- 个人版 / 自建应用通常无需管理员审核即可自用；企业版可能需要管理员审批
第三步：把应用添加为表格协作者
Section titled “第三步：把应用添加为表格协作者”- 打开目标多维表格，点击右上角「…」→「更多」→「添加文档应用」
- 搜索你的应用名称并添加，权限选择「可编辑」
第四步：在 BugCapturer 中添加集成
Section titled “第四步：在 BugCapturer 中添加集成”- 登录 app.bugcapturer.com，进入「集成」设置页
- 左侧平台目录选择「飞书多维表格」→ 点击「添加集成」→ 选择「企业自建应用 API」
- 填写 App ID、App Secret，并粘贴浏览器地址栏中的多维表格链接（需包含
table参数，形如https://xxx.feishu.cn/base/bascnXXXX?table=tblYYYY&view=vewZZZ；知识库/wiki/链接同样支持） - 点击「验证并保存」
保存时服务端会依次执行四步校验：验证凭证 → 解析表格 → 自动创建缺失的标准列 → 写入一条测试记录。任何一步失败都会在页面上标明原因。
自动创建的标准列
Section titled “自动创建的标准列”校验通过后，如果你的表格缺少以下列，BugCapturer 会自动创建（已有的同名列保持原样，不会改动类型）：
| 列名 | 类型 | 说明 |
|---|---|---|
| 描述 | 多行文本 | 问题描述 |
| 类型 | 多行文本 | bug / suggestion |
| 页面 URL | 多行文本 | 问题发生页面 |
| 页面标题 | 多行文本 | 问题发生页面标题 |
| 浏览器 | 多行文本 | 浏览器信息 |
| 操作系统 | 多行文本 | 操作系统信息 |
| 分辨率 | 多行文本 | 屏幕分辨率 |
| 控制台错误数 | 数字 | 控制台错误条数 |
| 网络错误数 | 数字 | 网络错误条数 |
| 截图 | 超链接 | 截图链接 |
| 分享链接 | 超链接 | 分享报告完整链接 |
| 提交时间 | 日期 | 报告提交时间 |
| 到期时间 | 日期 | 分享到期时间 |
| 同步时间 | 日期 | 本条记录写入时间 |
与方式 A 的取舍
Section titled “与方式 A 的取舍”| 方式 A：自动化 Webhook 触发 | 方式 B：企业自建应用 API | |
|---|---|---|
| 创建应用 | 不需要 | 需要 |
| 标准列 | 手动映射 | 自动创建 |
| 附件列支持 | 仅链接 | 截图以超链接写入 |
| 管理员审批 | 不需要 | 企业版可能需要 |
| 推荐场景 | 个人 / 小团队快速接入 | 统一结构的团队台账 |
两种方式可以并存：同一个账号可以为不同表格分别配置方式 A 与方式 B 的集成（共 3 个）。
提示「凭证无效」？ 检查 App ID / App Secret 是否复制完整；发布新版本后部分凭证会重置，请以「凭证与基础信息」页的最新值为准。
编辑集成时需要重新填 App Secret 吗？ 不需要。编辑时留空 Secret 表示沿用原值；修改凭证或表格链接会触发重新校验。
常见报错排查
Section titled “常见报错排查”保存失败时，页面会显示具体报错与错误码。按报错对号入座（均为实测高频坑）：
| 报错 / 错误码 | 原因与解决 |
|---|---|
| 「应用尚未开通所需权限」 （code 99991672） | 权限没开通全或未生效：点报错里的链接开通权限（普通表格 bitable:app；知识库表格还需 wiki:wiki:readonly），然后必须创建并发布新版本——只开权限不发布版本，权限不会生效 |
| 「表格链接有误」/「文档不存在」 （code 131005） | 飞书对应用无权访问的知识库节点也返回「不存在」，先当权限问题排查：① 应用已添加「机器人」能力并发布版本；② 在目标表格页面右上角「…」→「更多」→「添加文档应用」添加过该应用；③ 链接是浏览器地址栏复制的完整链接。个人版知识库可能没有「添加文档应用」入口——把表格移到「我的空间」改用 /base/ 链接即可绕开 |
| 「应用未获表格协作权限」 （code 91403） | 应用没加为这张表的协作者：打开表格 → 右上角「…」→「更多」→「添加文档应用」→ 搜索应用名 → 添加并给「可编辑」 |
| 「标准列创建失败」 | 协作者权限给成了「可阅读」：重新以「可编辑」添加后重试。已有同名列会自动跳过，不需要手动删除表头 |