概述
配置飞书多维表格集成后，你在 BugCapturer 插件中生成的每一条分享报告，都会自动写入你指定的多维表格，新增一行完整台账：描述、类型、页面、环境、诊断摘要、截图链接、分享链接——不打扰群里任何人，团队随时筛选回看。 核心特性：- 零手工建表：保存集成时自动创建 14 个标准列（已有同名列直接复用）
- 多表分流：最多可添加 3 个集成，各自指向不同表格，满足「Bug 追踪表 + 产品需求表」分开管理
- 自动校验：保存前服务端完整跑通「验证凭证 → 校验可写 → 建列 → 写测试记录」四步，配置即验证
- 失败可感知：写入失败自动重试，投递日志可查；连续 20 次失败自动暂停并邮件提醒
- 方式 A：自动化 Webhook 触发（推荐）——无需创建飞书应用，在多维表格「自动化」里新建 Webhook 触发流程，粘贴地址即可，几分钟完成配置
- 方式 B：企业自建应用 API——即本文介绍的对接方式，保存时自动创建 14 个标准列，适合需要统一列结构的团队
准备工作：创建飞书应用
飞书多维表格通过企业自建应用（App ID + App Secret）对接，共四步：1. 创建企业自建应用
打开 飞书开放平台 → 开发者后台 → 创建企业自建应用，填写应用名称与描述（如「BugCapturer 台账同步」）。2. 开通 Bitable 权限
进入应用 → 权限管理 → 搜索并开通以下权限：bitable:app（查看、评论、编辑和管理多维表格）
- 如使用知识库中的表格，另需
wiki:wiki:readonly（查看知识库）
3. 发布应用
进入版本管理与发布 → 创建版本 → 提交发布。企业自建应用通常由管理员直接通过。4. 把应用加为表格协作者
打开你的多维表格 → 右上角「...」→ 更多 → 添加文档应用 → 搜索你的应用并添加为可编辑协作者。 > 没有这一步，应用会因「未获表格协作权限」而无法写入，这是最常见的配置遗漏。在 BugCapturer 中配置
- 名称：如「Bug 追踪表」
- App ID：cli_ 开头
- App Secret：在应用的凭证与基础信息页复制
- 多维表格 URL：粘贴浏览器地址栏中的完整链接（含
table=参数；知识库链接同样支持，会自动解析）
表格会写入哪些字段
首次保存时自动创建以下标准列（表格中已有的同名列直接复用，不会改动你的列类型）：| 列名 | 内容 |
|---|---|
| 描述 | 报告的问题描述 |
| 类型 | Bug / 功能 / 建议 / 评价 |
| 页面 URL | 发生问题的页面地址（敏感参数已脱敏） |
| 页面标题 | 页面标题 |
| 浏览器 / 操作系统 / 分辨率 | 环境信息 |
| 控制台错误数 / 网络错误数 | 诊断摘要条数（正文不含在内，点分享链接查看完整内容） |
| 截图 | 截图链接（点击可直接打开） |
| 分享链接 | BugCapturer 分享页（含完整标注、录屏、诊断详情） |
| 提交时间 / 到期时间 / 同步时间 | 时间戳 |
日常使用
配置完成后无需任何额外操作：插件里点「分享」→ 表格自动新增一行。分享成功面板会显示「已自动同步到 N 个表格」。- 测试写入：设置页每个集成卡片都有「测试」按钮，随时验证写入是否正常
- 投递日志：查看最近 20 次写入的状态、失败原因与飞书记录 ID
- 暂停 / 恢复：临时不想同步时暂停，随时恢复
- 连续失败保护：写入连续失败 20 次（如密钥轮换、应用被移除协作者）会自动暂停集成并邮件通知你，修复后点「测试」验证即可恢复