#评论功能

#功能概述

评论功能提供文档内的协作讨论能力，支持对整篇文档发表评论和回复，便于团队协作文档时的沟通与反馈。

---

#打开评论面板

#入口：文档信息菜单

1. 打开任意文档
2. 点击编辑器工具栏最右侧的 ⋮ 更多按钮
3. 在下拉菜单中点击 评论
4. 右侧滑出评论面板

评论面板会显示当前文档的所有评论，按时间倒序排列（最新的在最上面）。

---

#发表评论

#评论输入框

在评论面板顶部的输入框中输入评论内容：

• 支持纯文本输入
• 最多 512 字符
• 实时显示剩余字数提示

点击发送按钮发表评论。发表后：

• 评论立即出现在列表中
• 显示你的访客昵称
• 显示评论发表时间（相对时间，如「5 分钟前」）

---

#回复评论

每篇根评论下可以嵌套多条回复，形成讨论线程：

1. 找到想要回复的评论
2. 点击该评论右下角的 回复 按钮
3. 在出现的输入框中输入回复内容（最多 512 字符）
4. 点击发送

回复会显示在对应根评论的下方，缩进显示，并标注回复人。

---

#删除评论

#权限说明

你只能删除自己发表的评论或回复，无论它是根评论还是回复。

#删除操作

1. 找到自己发表的评论
2. 评论右下角会显示红色的 删除 按钮
3. 点击删除，弹出确认对话框
4. 点击确定完成删除

删除后该评论会从列表中即时消失。

#删除根评论的影响

删除根评论时，该评论下的所有回复也会被一并删除。

---

#评论计数

评论面板顶部显示当前文档的有效评论数：

• 只统计未删除的评论
• 根评论和回复合计计数
• 实时更新（发表/删除后立即刷新）

---

#权限规则

操作	权限要求
查看评论	能阅读该文档即可
发表评论	有该文档的编辑权限
发表回复	有该文档的编辑权限
删除评论	仅该评论的发表者

#不同场景下的权限表现

文档权限	能否查看评论	能否发表/回复	能否删除自己的评论
公开可读	✅ 可以	❌ 不可以	❌ 不可以
公开可编辑	✅ 可以	✅ 可以	✅ 可以
受限域成员	✅ 可以	✅ 可以	✅ 可以
被邀请只读	✅ 可以	❌ 不可以	❌ 不可以
被邀请可编辑	✅ 可以	✅ 可以	✅ 可以

---

#使用建议

#建议用于

• 文档反馈：对内容提出修改建议
• 疑问讨论：就文档中的某个点提问和解答
• 协作备忘：记录编辑思路和决策理由

#不建议用于

• 存储敏感信息（评论无加密，与文档内容同级别安全）
• 长篇大论（建议直接编辑文档正文）
• 发送与文档无关的闲聊消息

---

#常见问题

#评论保存在哪里？会同步吗？

评论存储在服务器数据库中，与文档绑定，不会写入 Markdown 文件。所有访问该文档的访客都能看到相同的评论列表。

#可以编辑评论吗？

目前不支持编辑已发表的评论，只能删除后重新发表。

#评论有通知吗？

目前没有通知机制，需要手动打开评论面板查看新评论。

#删除的评论可以恢复吗？

不可以。删除操作不可逆，请谨慎操作。

#为什么我看不到删除按钮？

只有评论的发表者才能看到删除按钮。如果不是你发的评论，就不会显示该按钮。