用途：在文件评审流程中管理评论。评论可锚定到三种目标之一：行范围（保留被标注的源文本）、视频时间轴上的毫秒偏移，或没有时间轴的静态图片；视频或图片评论还可携带画面上的标记。适用于代理对指定行留下评审反馈、修改前先读取评论、回复/解决/重开/编辑/删除评论，以及在评论中 @提及协作者。
主要能力：GET 列出评论（可按 pending/resolved 过滤，分页），POST 新建顶层评论或回复（仅一级嵌套，回复不能再回复），PATCH 编辑文本或改状态（解决会级联到回复），DELETE 软删除（顶层删除连带回复）。GET /mention-candidates 返回可提及用户（最多10个，可用 q 过滤）。
必要用法：认证使用 Authorization: Bearer $SPUREE_ACCESS_TOKEN 或 X-API-Key: $SPUREE_API_KEY；基础地址 https://data.spuree.com/api/v1/files/{fileId}，评论在 /comments 下。顶层评论须提供行三件套（startLine、endLine、sourceText）或时间/图片 anchor，两者不可同发，回复两者都不带。时间锚点用毫秒，endMs 默认等于 startMs；图片锚点不带时间与行字段。@提及格式为 <@DisplayName|userId>。
适用场景与限制：适合代码、视频、静图的人工评审协作。限制包括：评论文本上限2000字符、sourceText上限5000字符、每图最多24个形状且每形状最多256点、坐标须在0..1；绘制标记应读取展示而非由代理编写；时间锚点依赖 fileVersion 校验，替换视频后旧时间码可能失准；仅有查看权限时 canComment 为 false、canEdit 也为 false；无权限将返回401/403/404。价格与收费暂未提供。