反馈组件
反馈组件在你的产品内提供反馈入口。用户点开页面角落的面板，就能描述产品问题或建议，无需访问其他网站，也无需先选择看板或填写标题。
AI 会将每条消息判定为下文介绍的三种结果之一。本篇说明用户如何使用反馈组件，以及你可以配置哪些内容。接入步骤见安装反馈组件。
悬浮按钮
悬浮按钮是页面右下角一个 56 像素的圆形按钮，显示在页面其他内容之上。
它使用你 FeedLog 工作区的品牌色，可以在工作区设置中修改，不会继承所在页面的颜色。上例中，宿主网站使用靛蓝色，工作区品牌色是砖红色。若要保持一致，请在 FeedLog 中修改品牌色。FeedLog 不支持为不同站点分别设置颜色，门户也会使用同一个品牌色。
图标和位置固定，不支持修改。
面板
点击悬浮按钮后，其上方会展开一个 400 像素宽的面板。屏幕宽度小于 520 像素时，面板会改为全屏显示。
面板中的内容由 FeedLog 通过跨域 iframe 提供。你网站的 CSS 不会影响面板，面板也无法读取宿主页面的内容。FeedLog 更新面板功能时，你的产品无需重新发布。
从上往下看：
- 页头显示工作区 Logo；若未上传 Logo，则显示工作区名称的首字母。后面是固定标题反馈，以及包含工作区名称的说明：帮我们把 Acme 做得更好——说说问题和想法。若工作区未设置名称，这里会显示这个产品。如需显示名称，请在安装组件前完成设置。
- 两个入口。 我的反馈切到用户自己提过的内容，旁边带条数。全部反馈在新标签页里打开你的门户。
- 助手的开场白会说明它是 AI，而不是人工客服。它无法访问订单记录等客服系统。
- 输入框支持文字和图片，单张图片不超过 10MB。用户可以粘贴图片，也可以从文件对话框中选择。图片会附在生成的反馈上，但 AI 不会读取图片内容。只有截图、没有文字说明的消息无法被判定。
每条消息都会独立判定。面板采用聊天形式，但不会把之前的消息作为上下文：先发送*"坏了"，再发送"我是说导出按钮"*，会得到两次独立结果。原始消息不会保存；如果消息被提炼成反馈，系统只保存生成的反馈。
三种判定结果
每条消息最后都会落进三种之一：
| 结果 | 用户看到 | 系统处理 |
|---|---|---|
| 提炼成反馈 | 一句确认，加一张卡片：标题、看板、状态 | 在看板上创建反馈，作者为该用户 |
| 转给客服 | 一句致歉和你的客服邮箱 | 没有 |
| 无法识别 | 提示他把问题说清楚 | 没有 |
AI 会按以下顺序判定：先判断是否需要转给客服，再判断能否提炼成反馈，最后才是无法识别。启用相应的转客服规则后，*"我被重复扣款了"*这类与个人账号相关的请求不会进入公开看板。
提炼成反馈
AI 会生成一行标题，并用第一人称将消息整理为正文。正文保留用户的原意，不会添加消息中没有的细节。然后，AI 根据看板的名称和描述选择最匹配的看板。清楚的看板描述有助于提高分类准确性，见创建和管理看板。如果没有匹配的看板，反馈会进入第一个看板；如果尚未创建看板，反馈会保持未分类状态。
确认卡片会显示 AI 生成的标题、选中的看板、状态，以及在门户中打开这条反馈的链接。标题可能与用户的原始消息不同，因为 AI 会将请求改写为适合在反馈列表中显示的标题。
确认信息出现时，反馈已经发布到门户，其他用户可以投票和评论。它也会和其他反馈一样显示在控制台中，并将提交用户记录为作者。该用户会自动订阅这条反馈，并收到你的回复和状态变更通知。
转给客服
助手会说明这条消息需要人工处理，并提供你的客服邮箱。系统不会创建反馈或客服工单。这样可以避免退款等与个人账号相关的请求进入公开看板。
客服邮箱会显示为 mailto 链接，用户无需复制地址即可新建邮件。哪些消息会得到这一结果，由下一节的转客服规则决定。
无法识别
消息含糊、与产品无关，或者没有描述具体的产品问题时，助手会请用户补充哪里无法正常使用。系统不会创建反馈，用户可以立即重新提交。
没登录的用户
反馈组件没有单独的登录功能。它通过安装组件时配置的 getToken 函数，从你的产品获取当前用户身份。
当 getToken 返回 null 时，对话和输入框会替换为登录后即可提交反馈及登录按钮。该按钮调用你产品自己的登录流程，包括弹窗、登录页面或身份提供商。用户无需另行注册 FeedLog 账号。用户在你的产品中完成登录后，面板会更新为已登录状态。
组件会使用你的产品提供的姓名和邮箱，而不是将反馈作者显示为匿名。接入方式见安装反馈组件，token 规格见单点登录。
启用组件
前往控制台的设置 → 反馈组件，使用安装卡片中的启用组件开关。关闭后，SDK 不会在你的站点上渲染任何内容，包括悬浮按钮和角标，浏览器控制台也不会显示警告。这个设置会应用到所有已安装组件的站点，无需工程师重新发布产品。
反馈组件默认开启，尚未保存过这一页的工作区也一样。只有所有者和管理员可以修改这些设置，其他成员会看到无权修改的提示。
客服邮箱
联系客服卡片中的客服邮箱，是每次转给客服时向用户显示的地址。
留空不会关闭转客服功能。助手仍会告知用户需要联系人工客服，但无法提供邮箱地址。启用转客服规则前，请先填写客服邮箱。
转客服规则
每条规则用于补全**在以下情况引导联系客服……**这句话。已启用的规则会原样加入助手的指令。FeedLog 包含三条内置规则：
| 内置规则 | 什么情况下转客服 |
|---|---|
| 计费 | 用户就自己账号上的扣费、退款、支付失败或发票寻求帮助 |
| 账号访问 | 用户遇到登录问题、账号被锁或账号被盗用，无法访问账号 |
| 隐私与法律 | 用户就自己的数据或权利提出隐私、数据删除、版权或其他法律诉求 |
内置规则可以逐条关闭，但不能编辑或删除。自定义规则可以编辑或删除，每条不超过 180 个字符。同时启用的规则最多 10 条，包括内置规则和自定义规则。
规则应描述具体情况，不要只写宽泛的话题。*"用户咨询企业合同或定制报价"是一条规则，"计费"不是。AI 会判断用户意图：涉及用户自己账号、数据或付款的求助可以转给客服；即使包含相似词语，产品改进建议仍会作为反馈。例如，"加一个隐私政策页面"是反馈，"把我的账号删掉"*会转给客服。
一条规则都不开，就永远不会转客服
关闭三条内置规则且没有添加自定义规则时，系统不会改用 AI 的默认判断，而是从可选结果中移除“转给客服”。此后每条消息只会被提炼成反馈或判定为无法识别。退款请求如果被提炼成反馈，可能以用户名义出现在公开看板中。
所有规则都关闭时，设置页面不会发出提示。关闭所有转客服规则是受支持的配置。如果你希望将个人账号相关的请求交给客服处理，请保留相应的内置规则。
我的反馈与未读提醒
我的反馈会按时间倒序列出用户自己提交的反馈。每条记录包含状态、票数、提交时间，以及在门户中打开反馈的链接。用户尚未提交反馈时，面板会显示占满该区域的全部反馈入口，引导用户查看其他人的反馈。
当你回复反馈或更改其状态时，作者的悬浮按钮上会出现红色角标。未读角标始终为红色，不使用工作区品牌色。打开面板后，标签会显示3 条反馈 · 1 条有更新，对应的反馈前也会显示红点。打开这条反馈后，悬浮按钮角标、标签中的未读数和反馈前的红点会同时清除。
只有反馈作者会看到这些提醒，且仅限其本人提交的反馈。角标数字最多显示为 9+。
可能遇到的错误
产品中没有显示反馈组件。 可能是启用组件开关已关闭，也可能是 SDK 未成功初始化。请先检查开关，再按照安装反馈组件核对接入配置。
每条消息都返回“发送失败，请重试。” 对于自部署实例，常见原因是未配置 OPENAI_API_KEY，或者无法连接 AI 服务。此时组件仍能渲染，登录和我的反馈也能正常使用，但消息必须通过 AI 服务处理，因此无法发送。请按照配置外部服务检查 AI 服务配置。
用户已登录，但面板仍要求登录。 getToken 返回了 null，或者 FeedLog 拒绝了返回的 token。常见原因包括 token 已过期或使用了错误的密钥签名。请按照安装反馈组件检查 getToken 的三种返回状态和签名配置。
悬浮按钮的颜色与预期不符。 它使用 FeedLog 工作区品牌色，不会读取网站颜色。请前往设置 → 工作区修改；FeedLog 不支持为不同站点分别设置颜色。
反馈经常进入错误的看板。 没有匹配的看板时，AI 会使用第一个看板作为默认选项。请检查看板名称和描述，这两个字段会用于分类。
所有消息都被转给客服。 一条或多条规则可能只描述了宽泛话题，没有限定具体情况。请将*"任何跟计费有关的"改为更具体的规则，例如"用户就自己账号上的扣费寻求帮助"*。
消息在 AI 处理前被拒绝。 单条消息最多包含 4000 个字符，同一个网络每分钟大约可以发送 20 条。消息过长时请缩短内容；触发频率限制后，请等待一段时间再重试。