争取支持的文档 — 未知项野外指南

上线提案 · 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，用的全是我们已经在运行的基础设施。它已经开发完成、挂在功能开关后面、通过了单会话 1.2 万条标注的压测，而且一个开关就能回滚。从这里到上线，只差下面这四个签核。

03 评审人会问什么

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

不会。导出走的是和审阅页面同一个可见性解析器：标记为 internal 的标注一律被排除，除非导出者持有 workspace:admin 权限并通过带明确文字说明的复选框主动勾选。已由 14 个权限矩阵测试覆盖。
↗ spec §4.2 — 可见性与权限

Q2碰上超大会话——几千条标注——会怎么样？

导出按每批 500 条标注分页，并以流式方式写出文件。用生产环境里最大的真实会话（一次包含 12,400 条标注的代理商审阅）做压测，3.1 秒完成；常规会话的 p95 是 340ms。
↗ 实现笔记，06-24 — 压测结果

Q3为什么做文件格式，而不是公开 API？

过去两个季度打了 export-request 标签的 212 张支持工单里，SRT + CSV + PDF 能覆盖 83%。API 适合作为第二阶段——它需要这次不涉及的鉴权作用域设计。文件能现在就解除用户的阻塞，又不会堵死 API 的设计空间。
↗ 指标 — 支持工单标签分析，Q1–Q2

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

零新增服务。SRT/CSV 在现有的 worker 池（services/render-workers）里内联渲染；PDF 复用已经在生成每周摘要的报表服务。没有新队列，没有新数据存储，没有 schema 迁移。
↗ spec §5.1 — 架构

Q5导出的客户内容，合规上怎么交代？

每一次导出都会在文件元数据里盖上工作区 ID、发起用户和时间戳，并写入审计日志（audit.annotation_export）。文件通过会过期的签名 URL（24 小时）分发，过期后绝不留存。
↗ spec §6 — 审计与留存

04 规格速览

方面	决策	出处
格式	SRT（带时间码的字幕）、CSV（扁平结构，含涂画的包围盒）、PDF（帧缩略图 + 评论）	§2
入口	标注面板 → 多选 → 导出所选；会话菜单中另有「全部导出」	§3.1
权限	需要 `session:comment` 或更高权限；`internal` 标注默认排除	§4.2
限制	每批 500 条标注，流式输出；单次导出硬上限 2.5 万条，超限有清晰的错误提示	§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 池这件事（spec §5.1）——这是唯一的共享基础设施依赖。

Elena Sorokin安全

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

Marcus Webb设计

对导出弹窗和错误状态做最后一轮把关——上面的原型就是当前最新版。

Dana Kim产品经理，协作方向

批准功能开关放量节奏（spec §8），并负责 changelog 条目。

以上所有内容都已在功能开关后面开发并测试完毕。请对你负责的部分回一个 ✓，或者到我的日历上约 15 分钟——目标：周一开始放量。