# 评论与审阅讨论

> 将问题定位到单元格、文本、记录或元素，通过回复和解决状态跟踪审阅结论。

- Human documentation: [https://docs.univer.ai/zh-CN/overview/features/shared/comments](https://docs.univer.ai/zh-CN/overview/features/shared/comments)

- Agent Markdown: [https://docs.univer.ai/zh-CN/overview/features/shared/comments.md](https://docs.univer.ai/zh-CN/overview/features/shared/comments.md)

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.3.0`

- Source: [features/shared/comments.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/docs/features/shared/comments.zh-CN.mdx)

---

评论把讨论留在内容旁边。审阅者可以指出某个数值、段落或图形的问题，作者在同一线程中回复，其他参与者继续补充上下文；无需把讨论拆散到外部聊天中。

## 从问题到结论

1. **定位内容**：对单元格、选中文本、记录、元素或页面位置发起评论，保留对应的内容引用。
2. **回复讨论**：一条根评论与后续回复组成线程，展示作者、时间与讨论正文。
3. **解决或重新打开**：完成修改后将线程标为已解决；仍需跟进时可以重新打开，保留原有讨论。

评论面板可按全部、未解决、已解决或与当前用户相关的讨论筛选。已解决不等于删除，仍可回看处理过程。

## 各产品的评论与批注

以下使用同一组 Northstar 英文发布项目。截图由 Facade API 在真实编辑器中创建，展示前端评论与批注效果；点击图片可放大。

### 电子表格（Sheet）

将讨论定位到具体单元格，在预算数字旁确认预测口径、费用明细与审批结论。示例同时展示多条讨论、连续回复和已解决分组。单元格评论使用 `range.addCommentAsync()`；图片、图表和形状的对象评论需要相应的绘图评论插件。

![Sheets 评论：英文发布预算、单元格定位、多位审阅者回复与已解决讨论](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/sheets.png)

[查看产品接入与 API](https://docs.univer.ai/zh-CN/guides/sheets/features/comments.md)

### 文档（Doc）

对选中的文本范围发起评论，适合合同条款、方案表述或发布日期的审阅。评论卡片保留引用片段，文本编辑通过评论装饰维护定位。示例讨论发布日期、指标定义和旧流程替换；入口为 `document.getTextRange(...).createCommentAsync()`。

![Docs 评论：英文发布说明、文本引用与三条审阅讨论](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/docs.png)

[查看产品接入与 API](https://docs.univer.ai/zh-CN/guides/docs/features/comments.md)

### 演示文稿（Slide）

可以评论单个页面元素，也可以在幻灯片的自由位置放置评论。元素评论通过稳定 ID 关联文本框、图片、图表等对象；自由位置使用页面内的归一化坐标。示例在发布目标与版式旁展开讨论；入口为 `slide.createElementCommentAsync()` 和 `slide.createPositionCommentAsync()`。

![Slides 评论：发布评审幻灯片、元素定位与多角色回复](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/slides.png)

[查看产品接入与 API](https://docs.univer.ai/zh-CN/guides/slides/features/comments.md)

### 关系型表格（Relational Table）

评论绑定记录 ID，讨论围绕一条业务记录展开，不依赖当前视图中的显示行号。适合任务交接、客户跟进或验收确认。示例在发布跟踪表中讨论负责人和待审批事项，并在记录旁显示评论标记；入口为 `record.createCommentAsync()`。

![Relational Table 评论：发布跟踪记录、评论标记与交接讨论](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/bases.png)

[查看产品接入与 API](https://docs.univer.ai/zh-CN/guides/bases/features/thread-comment.md)

### 画布（Canvases）

将评论附在图形等元素上，或在画布的指定位置留下注释。元素评论关联对象，位置评论保存画布坐标，适合流程、架构和设计评审。示例围绕客户研究、开发交接与发布风险展开讨论；入口为 `board.createElementCommentAsync()` 和 `board.createPositionCommentAsync()`。

![Canvases 评论：彩色发布流程、元素及位置评论与连续回复](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/boards.png)

[查看产品接入与 API](https://docs.univer.ai/zh-CN/guides/boards/features/comments.md)

### PDF：页面批注

PDF 当前展示的是页面批注：高亮、下划线、删除线、波浪线和墨迹。它们是可保存的 PDF 批注对象，与前面可回复、可解决的评论线程不同。示例突出发布日期、标记验收指标，并划去旧审批流程；入口为 `page.insertAnnotation()`。

![PDF 批注：英文发布评审文档中的高亮、下划线、删除线和墨迹](https://raw.githubusercontent.com/dream-num/documentation/dev/public/assets/features/comments/pdfs.png)

[查看产品接入与 API](https://docs.univer.ai/zh-CN/guides/pdfs/features/core/annotations-and-native-text.md)

## 接入方式

**前端**：注册相应产品的评论功能与 UI 插件，调用 Facade 时导入通用评论和产品评论的 `/facade` 入口。各产品方法负责建立锚点，通用 `replyCommentAsync()`、`updateCommentAsync()`、`resolveCommentAsync()` 等方法负责后续讨论操作；`resolved: false` 用于重新打开线程。PDF 使用独立的批注 API。

**多人共享**：在核心协同之外接入 Comment Service、Comment Endpoint 与独立数据库适配器，并配置前端远程评论数据源。主文档保存随内容变化的锚点，Comment Service 保存正文、回复与解决状态，通过文档房间发布评论更新。参见[评论扩展包](https://docs.univer.ai/zh-CN/server/collaboration/packages.md#thread-comment)和 [Comments 示例](https://docs.univer.ai/zh-CN/server/collaboration/examples.md#comments)。

评论权限可独立于正文编辑权限配置。业务身份与服务端授权的接入方式见[权限与授权](https://docs.univer.ai/zh-CN/overview/features/shared/permissions.md)。

[返回功能总览](https://docs.univer.ai/zh-CN/overview/features.md)