首页 › Web SDK

一行 script，让任何访客
都能免安装反馈

把 SDK 放进你的站点，所有访客都会看到一个可拖拽的反馈悬浮球 —— 甲方、终端用户、UAT 验收人。报告自带截图、上下文，以及你显式传入的身份。

查看接入文档 免费注册，创建项目
index.html 
<script>
  window.BugCapturerConfig = {
    key: "bcpk_your_project_key",
    position: "bottom-right",
    requireContact: false,
    reporter: { uid: "", name: "", email: "" }
  };
</script>
<script src="https://api.bugcapturer.com/sdk/bugcapturer.js" async></script>
把 key 换成控制台里的项目 key；域名白名单会保护它不被滥用。
https://www.your-website.com
访客可拖到任意位置，并自动记住该位置
三步接入

三分钟上线

没有构建步骤、不依赖框架、不引入依赖 —— 只有一行 script。

1

创建项目

注册并添加站点，控制台会给你项目 key 与域名白名单配置。

→
2

粘贴一行代码

把 script 放进页面模板，或通过标签管理器注入。

→
3

访客开始反馈

悬浮球对每位访客可见，几秒内即可完成截图与提交。

为什么有效

为「绝不会安装任何东西的人」而设计

外部反馈最难的一步是安装。SDK 直接把这一步去掉。

🙋

免安装、免注册

访客在页面上直接提交，无需下载，也无需注册账号。

🧲

悬浮球可拖拽

悬浮球可以拖到任意位置，并记住访客上次放置的位置。

🛡️

Shadow DOM 隔离

悬浮球样式不会污染你的站点，你的 CSS 也不会影响它。

🔧

自带上下文

Console 错误、失败请求与环境信息会自动附加到每份报告。

反馈人身份

附带什么身份，由你决定

SDK 不会读取你的 Cookie 或 localStorage 来推断身份。身份由宿主站点显式传入 —— 或保持匿名。

默认匿名不调用 identify 时，报告以匿名方式提交
显式 identify调用 identify() 传入用户 ID、昵称与邮箱
服务端校验格式非法的身份字段会在落库前被丢弃
展示位置昵称会写入表格中的「反馈人」列
reporter.js 
// 在用户登录成功后调用
BugCapturer.identify({
  uid:   "user_1024",
  name:  "Alice Chen",
  email: "alice@acme.com"
});
可控与安全

可以放心嵌入任何站点

每一项保护都可以按项目配置，每一次提交都有速率限制。

🌐

域名白名单

只接受你在项目里登记的域名提交报告。

⏱️

速率限制

按项目每日与按 IP 每日双重限制，避免恶意刷表。

⏸️

随时暂停

在控制台关掉开关，悬浮球立刻从你的站点消失。

🔀

插件汇入开关

可决定装了插件的访客能否把报告汇入本站点项目。

对比

Web SDK 还是浏览器插件？

同一个项目、同一张表 —— 按「谁需要提交」来选。

浏览器插件Web SDK
谁可以提交装了插件的测试者与同事站点上的任何访客
安装要求Chrome 或 Edge 商店一行 script 标签
截图方式从真实标签页像素级截取浏览器共享授权后抓取真实画面
屏幕录制支持暂不支持
身份来源来自插件登录态由你的站点显式传入
报告去向由你选择的汇入目标决定项目绑定的集成
了解浏览器插件 了解报告去向
更多能力

继续了解 BugCapturer

🔗

分享链接

一条公开链接，对方浏览器打开即可查看。

→
🔧

自动上下文

Console、网络与环境信息随报告自动携带。

→
📊

集成总览

把报告写入飞书多维表格，或你自己的 Webhook。

→
🧪

UAT 与验收

内部验收阶段，测试人员与需求方都往同一个项目里提交反馈。

→