反馈如何运作
本页介绍反馈的完整流程：谁能提交、三种提交方式、附件、投票、评论、状态，以及各项操作会发送哪些通知。
谁能提交
任何人都能在不登录的情况下浏览门户，包括全部看板、反馈、评论、票数、路线图和更新日志。
提交反馈、投票、评论和给评论点赞都需要账号。未登录时执行这些操作，页面会打开登录框。可用的登录方式取决于工作区配置，包括邮箱密码、Google、GitHub；配置单点登录后，用户还可以从你的产品自动登录 FeedLog。
反馈的提交方式
从门户提交
点击新建反馈打开表单。选择一个看板，然后填写标题（最长 200 个字符）和正文（Markdown，最长 10000 个字符）。看板为必选项，不能通过此表单提交未归入看板的反馈。
从标题的第三个字符开始，FeedLog 会查找主题相同的现有反馈，并将结果列在编辑器下方。提交者可以在创建新反馈前确认是否已有相似内容。已经提交的重复反馈可以按查找和合并重复反馈中的方法处理。
也可以直接给出一个已经填好的表单链接：
https://feedback.yourdomain.com/?new=1&title=Dark%20mode&body=It%20burns这是唯一允许未登录访客先打开草稿、再登录提交的入口。登录提示会在提交时出现，登录后草稿仍会保留。超过长度限制的值会被截断，而不会导致表单被拒绝。表单打开后，FeedLog 会从地址栏移除这些参数，因此刷新页面不会再次载入草稿，复制当前网址也不会包含草稿内容。
从反馈组件提交
反馈组件是嵌入你自己产品的面板。用户用自己的话描述问题后，AI 会把消息整理成包含标题、正文和看板的反馈，或者引导用户联系你的客服。通过反馈组件创建的反馈与门户中提交的反馈相同，都支持投票、评论和通知。判断规则和可配置项见反馈组件，安装方法见安装反馈组件。
管理员代录
团队成员可以代为录入通过邮件、电话或客服会话收到的反馈。控制台的反馈页和路线图页使用同一个提交表单，提交后，团队成员自己的账号会成为反馈作者。
所有者和管理员不会订阅反馈，包括自己创建的反馈。使用团队成员的账号代录，也不会让原始客户自动订阅。客户如需收到后续通知，必须使用自己的账号提交、投票或订阅这条反馈。
附件
附件仅支持图片，单张最大 10 MB。日志文件、PDF、视频等其他文件类型不受支持。
可以通过编辑器工具栏中的图片按钮上传，也可以从剪贴板粘贴图片。将文件拖到编辑器上不会触发上传。反馈正文和评论都支持图片，两种上传方式都要求先登录。
上传的文件使用当前工作区的存储路径前缀，并通过 FeedLog 提供访问，不会直接暴露存储桶地址，因此存储桶无需设为公开。自部署实例的存储后端配置见配置外部服务。未配置存储后端时，Docker 使用本地磁盘；Vercel 和 Cloudflare Workers 无法上传图片。
上传失败时，页面不会显示错误消息，图片也不会插入正文或评论。请重新上传图片。
投票
每人可以给每条反馈投一票，再次点击投票按钮会收回这一票。重复发送同一个投票或撤票请求不会产生重复票数。
反馈上的数字代表不同投票者的人数。合并两条反馈时，FeedLog 不会直接把票数相加；如果同一个人给两条反馈都投过票，合并后只计算一次。详情见查找和合并重复反馈。
投票也会订阅这条反馈。收回投票不会取消订阅。如需停止接收这条反馈的通知，请点击取消订阅。
所有者和管理员除外。他们的投票会计入票数，但不会因此订阅反馈，因为他们不接收反馈通知邮件。
已合并的反馈不再接受投票或评论，这两项操作仍可在合并后保留的反馈上进行。
评论
评论支持 Markdown 和图片，最长 5000 个字符。每条评论都可以获得点赞。
评论最多嵌套一层。 你可以回复顶层评论。回复已有回复时，不会创建第三层；新评论仍会归入同一条顶层评论，并通过 @ 提及标明回复对象。此限制由服务端执行，因此通过界面以外的方式提交评论时也同样适用。
只有作者本人可以编辑评论。所有者和管理员可以删除他人的评论，但不能编辑。修改过的评论会显示*(已编辑)*标记。
作者可以删除自己的评论，所有者和管理员可以删除任何评论。删除顶层评论时，其下的回复也会一并删除，确认框会说明这一影响。
状态
FeedLog 有四种反馈状态：开放、计划中、进行中和已完成。新反馈的初始状态为开放。
所有者和管理员可以在门户反馈详情页的右侧栏或控制台详情页中修改状态。目前不支持批量修改。状态没有固定的流转顺序，也可以改回之前的状态。
计划中、进行中和已完成的反馈会出现在公开路线图上，开放状态不会。详情见路线图与更新日志。
修改状态本身不会发送邮件。 状态修改后，侧栏会显示提示，询问是否通过邮件通知关注这条反馈的人。关闭提示不会撤销状态修改，也不会发送邮件。
发送状态通知时，可以填写最长 2000 个字符的说明，用来替换邮件正文中的默认内容。如果提示仍然打开时其他人再次修改了状态，FeedLog 会拒绝发送通知，避免邮件描述已经过期的状态。
通知邮件
反馈相关操作会发送以下两类通知邮件：
| 邮件 | 所有者和管理员 | 其他人 | 什么时候发 |
|---|---|---|---|
| 状态变更 | 从不 | 关注这条反馈的人 | 管理员改了状态，并且接着选择公布 |
| 正式回复 | 从不 | 关注这条反馈的人 | 所有者或管理员写了一条顶层评论 |
FeedLog 不发送“新反馈”或通用的“新评论”邮件。提交反馈、普通用户发表评论，以及回复评论都不会发送邮件。只有所有者或管理员发布的顶层评论才算正式回复。
FeedLog 的其他邮件，包括邮箱验证、密码重置和工作区邀请，属于账号功能，不属于反馈通知。完整清单见配置外部服务。
谁在关注一条反馈
用户在提交反馈、投票或点击订阅后，会关注这条反馈。用户不能替其他人订阅。
每次发送通知时，系统会排除所有者、管理员和触发该事件的人。所有者和管理员看不到订阅按钮，也不会通过其他操作关注反馈。
合并反馈时会保留订阅关系。如果你关注的反馈被合并到另一条反馈中，你会继续收到合并后保留反馈的通知。
发送正式回复时，评论框会向管理员显示通知点赞者开关。这里的“点赞者”指给反馈投过票的用户。关闭该选项后，邮件仍会发送给反馈作者和手动点击订阅的用户，但不会发送给仅因投票而关注反馈的用户。状态通知没有对应选项，会发送给所有关注这条反馈的人。
取消订阅
取消订阅按钮位于反馈页面，与订阅按钮位置相同，仅对当前反馈生效。
目前没有账号级别的通知总开关，邮件中也没有退订链接，只会说明收件人收到邮件的原因。如需停止所有反馈通知，必须逐条取消订阅。
自部署实例未配置邮件服务时，通知邮件不会发出，系统也不会抛出错误。邮件内容会带有 [DEV EMAIL] 前缀并写入日志。配置方法见配置外部服务。