概述
配置飞书多维表格集成后，你在 BugCapturer 插件中生成的每一条分享报告，都会自动写入你指定的多维表格，新增一行完整记录：描述、页面、环境、诊断摘要、截图链接、分享链接——不打扰群里任何人，团队随时筛选回看。
核心特性：
- 零门槛接入：推荐 Webhook 触发方式，无需创建飞书应用、无需管理员审批，几分钟完成配置
- 多表分流：最多可添加 3 个集成，各自指向不同表格，满足「Bug 追踪表 + 产品需求表」分开管理
- 配置即校验：保存时服务端向 Webhook 地址发送测试请求，连通性当场确认
- 失败可感知：写入失败自动重试，投递日志可查；连续 20 次失败自动暂停并邮件提醒
v1.3.2 起，飞书多维表格支持两种接入方式：
- 方式 A：自动化 Webhook 触发（推荐）——无需创建飞书应用，在多维表格「自动化」里新建 Webhook 触发流程，粘贴地址即可，几分钟完成配置
- 方式 B：企业自建应用 API——保存时自动创建 13 个标准列、免字段映射，适合需要统一列结构的团队
两种方式的详细对比与分步指引见官方文档 · 集成总览。
准备工作：在飞书里创建 Webhook 流程
打开你的多维表格，点击右上角「自动化」→「新建流程」：
不用创建飞书应用，也不需要管理员审批，准备工作就这三步。
在 BugCapturer 中配置
- 名称：如「Bug 追踪表」
- Webhook 地址：粘贴上一步复制的地址
- Bearer Token（可选）：仅在飞书侧开启 Token 校验时填写
完成字段映射
回到飞书流程编辑页：
完成后点集成卡片上的「测试」，表格里立刻出现一条新记录，接入就完成了。
表格会写入哪些字段
| 列名 | 内容 |
|---|---|
| 描述 | 报告的问题描述 |
| 页面 URL | 发生问题的页面地址（敏感参数已脱敏） |
| 页面标题 | 页面标题 |
| 浏览器 / 操作系统 / 分辨率 | 环境信息 |
| 控制台错误数 / 网络错误数 | 诊断摘要条数（正文不含在内，点分享链接查看完整内容） |
| 截图 | 截图链接（点击可直接打开） |
| 分享链接 | BugCapturer 分享页（含完整标注、录屏、诊断详情） |
| 提交时间 / 到期时间 / 同步时间 | 时间戳 |
想省去手动映射、让服务端自动创建上述标准列，可改用方式 B · 企业自建应用 API。
你可以在表格中自由增删自有列（如「负责人」「优先级」「状态」），集成不受影响。
日常使用
配置完成后无需任何额外操作：插件里点「分享」→ 表格自动新增一行。分享成功面板会显示「已自动同步到 N 个表格」。
- 测试写入：设置页每个集成卡片都有「测试」按钮，随时验证写入是否正常
- 投递日志：查看最近 20 次写入的状态、失败原因与飞书记录 ID
- 暂停 / 恢复：临时不想同步时暂停，随时恢复
- 连续失败保护：写入连续失败 20 次（如 Webhook 地址失效、流程被停用）会自动暂停集成并邮件通知你，修复后点「测试」验证即可恢复
常见问题
保存时提示「校验 Webhook 地址」失败？ 检查地址是否完整复制（包含 https://），不要混入空格或换行。BugCapturer 仅支持公网 https 地址。
保存成功但表格里没有数据？ 确认飞书流程已保存并启用；「输出设置」若未配置字段映射，收到请求也不会写表。可点集成卡片上的「测试」重新触发一条测试记录。
写入表格的是截图文件本体吗？ 目前写入的是截图链接（不过期），点开即看高清原图。表格附件直传在规划中。
数据安全吗？ 集成写入仅在你主动分享时触发；隐私政策已披露这一数据流向，详见隐私政策。
更多文档：分步配置指引见官方文档——方式 A · 自动化 Webhook 触发 / 方式 B · 企业自建应用 API。