常见问题

大家常问的问题,
先在这里找答案。

接入、截图、通知、Agent 和账号数据的常见问题汇总。找不到答案时,可以去帮助中心排查,或直接回到首页给我们提交一条反馈。

FAQ

接入与来源
截图与隐私
通知与账号

接入

siteKey 需要保密吗?

不需要。siteKey 是网站的公开标识,会随嵌入脚本出现在页面源码中,本身不能用于登录或管理。查看和处理反馈必须登录控制台或使用 API token;如果担心别人拿你的 siteKey 乱提交,配置下面的“允许提交反馈的网站地址”即可。

“允许提交反馈的网站地址”是什么意思?必须填吗?

它是一份来源白名单:只有来自这些地址(协议 + 域名 + 端口,如 https://example.com)的页面才允许提交反馈。留空表示不限制。注意 https://example.comhttps://www.example.com 是两个不同地址,本地调试需要单独加上 http://localhost:端口

页面上看不到反馈按钮怎么办?

依次检查:脚本是否被 CSP、广告拦截器或错误路径拦截;浏览器控制台是否有报错;如果使用自定义按钮,确认设置了 launcher: false,并在脚本加载完成后再调用 FeedbackPlus.open()

我不想用默认悬浮按钮,可以放在自己的菜单里吗?

可以。初始化时设置 launcher: false,然后在任意按钮的点击事件里调用 FeedbackPlus.open()。接入弹窗和帮助中心都有一键复制的示例代码。

支持 WordPress、React、Vue 或 Google Tag Manager 吗?

支持。创建网站后的接入弹窗提供标准 script、WordPress、React、Vue、GTM 五种一键复制版本,选择适合你技术栈的即可。

不在网站上装脚本,也能收集反馈吗?

可以。每个网站都有一个托管反馈页(/f/<siteKey>),把链接发到邮件、社群或文档里,对方打开就能提交,反馈同样进入你的控制台。

反馈与截图

一条反馈会自动带哪些信息?

反馈内容、提交者可选填写的联系方式、页面地址、页面标题、浏览器、操作系统、设备与视口信息,以及一张可选的页面截图。

截图会不会拍到密码、金额等敏感信息?

默认会排除带 data-feedback-private 属性的区域,也可以通过 exclude 配置自己的选择器。建议给密码框、支付面板、个人信息卡片都加上该属性,并在上线前提交一条测试反馈确认截图内容。

截图缺失、不完整或太大怎么办?

跨域图片、iframe、视频和 canvas 可能无法完整进入 DOM 截图,属于已知限制;截图过大或弱网较慢时,把 screenshotMode 调为 balancedcompact

通知与处理

有新反馈时怎么通知我?

在控制台“消息设置”里添加通知渠道,支持钉钉、飞书、Telegram、Discord、Slack 和自定义 Webhook,新反馈会按站点推送到你选择的渠道。

反馈多了怎么管理?

控制台可以按站点、状态、优先级和分类筛选与搜索反馈;每条反馈保留用户原文,同时生成标题、分类、优先级等可处理信息。

可以让 AI Agent 帮我处理反馈吗?

可以。安装 fbpp CLI 或按 Agent Skill 文档接入,Agent 可以拉取反馈、下载截图、更新处理状态。API token 在“账号设置”里生成,等同于账号密码,不要泄露或提交到代码仓库。

账号与数据

Feedback++ 收费吗?

目前可以免费接入和使用。如果未来推出付费计划,会提前在官网和控制台通知。

我的数据归谁所有?可以删除吗?

反馈和截图归你所有。删除网站或反馈会同时删除其关联截图;保留、删除与导出的完整说明见隐私协议

可以自托管吗?

可以。Feedback++ 提供 Node 本地运行时(要求 Node ≥ 24),克隆仓库后执行 npm run dev 即可运行;生产环境使用 Cloudflare Workers + D1 + R2 部署。

在哪里修改密码或 API token?

在控制台左下角点击头像打开“账号设置”:可以修改姓名和密码(修改后其他设备需要重新登录),也可以重新生成 API token(旧 token 立即失效)。