争取认可的文档 — 认清你的未知

上线提案 · Acme

90 秒阅读

批注导出已可上线

原型、规格和推出计划一应俱全。请求：周五前获得四项签字，周一启动标志灰度。

01 看它如何工作

Acme — q3_launch_teaser_v4.mp4 · 审阅

00:42 / 02:05

批注已选 0 条

Maya R. 00:23

Logo 出现太晚——提前 8 帧？

Devon P. 00:51

此处色彩与母版调色不一致

Maya R. 01:30

已通过——最终 CTA 效果很好

正在导出 3 条批注

正在收集批注…

导出就绪 q3_teaser_notes.srt · 3 条字幕

选择 → 导出 → 完成 · 自动循环

02 推介

审阅者在 Acme 留下反馈，然后重新输入到邮件、Notion 和剪辑软件——流失访谈中最常被提及的缺口（41% 的离开团队）。批注导出一键将任意选中的评论和绘图转为 SRT、CSV 或 PDF，使用我们已在运行的基础设施。已构建、已加标志、已压测至每会话 12k 条批注，一个开关即可回滚。距离上线只差下方四项签字。

03 审阅者会问什么

Q1这会把仅限内部的评论泄露给客户吗？

不会。导出经过与审阅页相同的可见性解析器：标记为 internal 的批注会被排除，除非导出者持有 workspace:admin 并通过带标签的复选框明确选择。14 项权限矩阵测试已覆盖。
↗ 规格 §4.2 — 可见性与权限

Q2超大场次——数千条批注——会怎样？

导出每批分页 500 条批注并流式输出文件。针对生产环境最大真实场次（12,400 条批注的机构审阅）的压力测试在 3.1 秒内完成；典型场次 p95 为 340ms。
↗ 实施笔记，06-24 — 压测结果

Q3为什么是文件格式而非公开 API？

SRT + CSV + PDF 覆盖过去两个季度 212 张标记 export-request 的支持工单中的 83%。API 是正确的第二阶段——需要本功能未涉及的鉴权范围工作。文件格式现在就能解除用户阻塞，且不阻碍 API 设计。
↗ 指标 — 支持标签分析，Q1–Q2

Q4这会增加我们需要运维的新基础设施吗？

零新服务。SRT/CSV 在现有 worker 池（services/render-workers）内联渲染；PDF 复用已在生成周报的报告服务。无新队列、无新数据存储、无 schema 迁移。
↗ 规格 §5.1 — 架构

Q5导出客户内容的合规故事是什么？

每次导出在文件元数据中加盖工作区 ID、请求用户和时间戳，并写入审计日志（audit.annotation_export）。文件通过过期签名 URL（24 小时）提供，绝不存储超过该窗口。
↗ 规格 §6 — 审计与保留

04 规格一览

领域	决策	参考
格式	SRT（带时间码字幕）、CSV（扁平，含绘图边界框）、PDF（帧缩略图 + 评论）	§2
入口	批注面板 → 多选 → 导出所选；会话菜单中也有「全部导出」	§3.1
权限	需要 `session:comment` 或以上；默认排除 `internal` 批注	§4.2
限制	每批 500 条批注，流式传输；每次导出硬上限 25k，有明确错误状态	§5.3
遥测	`export_started`、`export_completed`（格式、数量、时长）、`export_failed`	§7
特性标志	`annotation_export` — 关闭 → 5% → 50% → 100%，两周内完成	§8

05 风险、回滚与你需要配合的事项

风险与回滚

回滚只需一个开关。关闭 annotation_export——未上线 schema 迁移，无需撤销。
影响范围有界。导出在共享 worker 池中运行，每任务 30 秒超时；失控任务不会饿死审阅播放。
最可信的失败：签名 URL 清理滞后导致孤立导出文件——无论如何 24 小时内自行过期。
已知缺口：绘图批注在 CSV 中扁平化为边界框（完整矢量仅 PDF）。产品内已文档化；第二阶段事项。

我需要你配合的事项

Priya Natarajan工程负责人，播放与审阅

签字认可复用渲染 worker 池（规格 §5.1）——唯一的共享基础设施依赖。

Elena Sorokin安全

批准可见性规则和审计日志结构（规格 §4.2、§6）。

Marcus Webb设计

导出弹窗和错误状态的最终审核——上方原型为当前版本。

Dana Kim产品经理，协作

批准标志灰度计划（规格 §8）并负责更新日志条目。

以上内容均已构建并在标志后测试。就你负责的部分回复 ✓，或约我日历 15 分钟——目标：周一启动灰度。