飞书多维表格 · 方式 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 是否复制完整；发布新版本后部分凭证会重置，请以「凭证与基础信息」页的最新值为准。
提示「表格链接有误」？
请粘贴浏览器地址栏中的完整链接（含 table 参数）。知识库中的表格使用 /wiki/ 链接即可，无需手动换算。
编辑集成时需要重新填 App Secret 吗？ 不需要。编辑时留空 Secret 表示沿用原值；修改凭证或表格链接会触发重新校验。