恢复、存储与故障排查
第 6 章:恢复、存储与故障排查
Chrome 会打断扩展。这不是会不会,而是什么时候的问题 —— service worker 在空闲时休眠、标签页被关闭、Chrome 在压力下回收内存。本章讲述扩展如何存活,以及在裂缝显露时该怎么办。
一段话说清恢复模型
每段录音在进行中会将音频块与元数据写入 IndexedDB(浏览器的本地数据库)。若 Chrome 在录音中途杀掉扩展,这些块会留下。下次您打开侧边栏时,它们会出现在 saved on this device 列表中,附带 Upload all 按钮 —— 已登录用户可从中断处重试上传(得益于可续传的分块上传)。匿名用户可以将音频下载到电脑,或稍后登录后再上传。什么都不会悄悄丢失。
本节是概述;版本 1.6–1.9 的发布说明包含所替换的问题类别的完整历史。
"saved on this device" 列表
当有任何本地暂存的录音时,它会显示在侧边栏顶部。每一行显示:
- 会议标题(或"Untitled —
<date>",对于从未获得标题的录音)。 - 捕获的时长。
- 状态(准备上传/上传中/失败/已完成)。
- 按钮:Upload(已登录)或 Download / Delete。
列表顶部的 Upload all 会清空队列。它会在重放扫描发出完成信号后立即退出,而不是等待完整的四分钟截止时间,因此感觉响应灵敏。
当 Chrome 在录音中途杀掉扩展
以下任何一种情况都可能发生,并已处理:
- 您正在录制的标签页被关闭。 service worker 收到
tabs.onRemoved事件,并在 Chrome 让 service worker 休眠前触发正常的 Stop + 上传排空。 - 录音标签页崩溃。 麦克风内容脚本的中继死亡;在 5 秒无 PCM 帧后,侧边栏显示"microphone signal was lost"警告。录音被停止,截至该时刻捕获的块被暂存以便恢复。
- service worker 被 Chrome 回收。 冷启动时,扩展 ping 离屏文档;若它响应,录音无缝继续;否则,离屏被放弃,面板返回到设置状态,而暂存的块保持完好。
- 离屏文档在内存压力下被回收。 它的
pagehide处理程序强制停止录音。离屏内的 30 秒麦克风信号停滞兜底也会在所有外部信号丢失时停止录音。 - 录音期间浏览器被关闭。 录音会在您下次打开 Chrome 时出现在 "saved on this device" 列表中。
曾经悄悄丢数据的一种情况 —— Google Meet 会议以单页应用导航结束 —— 通过 service worker 直接监视标签页离开会议代码 URL 来处理,与内容脚本无关。
当上传失败时
上传使用可续传的分块传输。若某个部分失败,只重试该部分。若整个上传在传输中途死亡:
- 暂存的块保留在 IndexedDB 中。
- 录音出现在 "saved on this device" 列表中,状态为 Failed。
- 已登录:点击该行的 Upload 会从最后一个成功的部分继续传输。对长会议,这不是完整的重新上传。
- 匿名:Download 将音频作为
.webm文件保存到您的电脑;您可以在本地播放,或登录后稍后上传。
存储管理
本地录音 不再 在 30 天后自动删除。如果您将扩展当作独立录音工具使用 —— 录制会议、将文件保留在本地、从不登录 —— 旧录音以前会悄悄消失。这一点已修复。
只有两类会被安全地自动清理:
- 已完成的孤儿 —— 上传已确认录音已安全存入 R2,本地副本现在多余。
- 0 字节孤儿 —— 录音在任何音频被捕获前就死亡;没有可恢复的内容。
在暂存本地录音达到 500 MB 时,侧边栏顶部会出现黄色存储警告。它只是建议 —— 不会删除任何数据 —— 但提醒您登录并上传,或下载并清除。
要清除某段特定录音:点击 "saved on this device" 列表中该行的 Delete。若该录音有未上传的实时笔记,删除会请求确认。
常见问题
"扩展图标在 chrome://、edge:// 或 Chrome 网上应用店上灰显。"
Chrome 禁止扩展在 chrome:// 页面、edge:// 页面以及 Chrome 网上应用店本身运行。这是浏览器范围的限制;SeaMeet 无能为力。在普通标签页中打开会议。
"标签页捕获失败,提示 'Cannot access a chrome:// URL' 或 'Extension not allowed for this tab'。"
标签页是 在 您安装扩展 之前 打开的。Chrome 拒绝将 tab-capture 挂接到没有权限授予的标签页。重新加载标签页 并再试。
"录音在恢复列表中显示为 0:00。"
这是旧版本的一个 bug —— 时长仅在停止时才写入,因此中断的录音没有时长。现在时长在录音过程中被持久化,所以仅在录音在首次时长更新前结束时才会发生。未知时回退到 —。
"上传的文件可以播放,但显示未知/无限时长。"
不超过 100 MB 的录音在上传完成前会重写其时长元数据,因此这些已修复。更大或已续传的录音保持 Part-1 补丁兜底 —— 文件可以播放,但少数播放器可能无法正确定位。可尝试使用 VLC 作为变通。
"Meet 会议已结束,但录音还在继续。"
这一类 bug 已在 1.9 中修复。若在 1.9 或更高版本中发生,请报告 —— 附上来自 chrome://extensions/ 的版本号,并说明会议平台。
"会议中途字幕停止了。"
实时语音转文字会自动重连几次;耗尽后,"Retry captions" 横幅会出现在字幕上方。点击它 。录音全程继续 —— 不会丢失任何音频。
"来自 Meet 通话的录音标题错误(是标签页标题)。"
这已在 1.8 中修复 —— 扩展录音现在以 "Untitled — <date>" 开始,与网页应用的默认名称保护一致,因此 AI 生成的会议标题在上传后能正确替换它。若在 1.8 或更高版本中看到这种情况,AI 重命名通常在一分钟内跟上。
何时提交 bug
- 中断后录音未出现在 "saved on this device" 列表中。
- Upload all 声称成功,但录音不在您的网页库中。
- 扩展导致 Chrome 崩溃(而不是仅优雅地失败)。
- 任何静默的数据丢失。
在桌面应用仓库(seasalt-ai/seameet-app-desktop)提交,附上扩展版本、浏览器版本,若可能,附上侧边栏截图。
快速参考
| 症状 | 尝试 |
|---|---|
| 扩展没录音 | 重新加载标签页,然后重试 |
| 崩溃后录音丢失 | 检查侧边栏中的 "saved on this device" 列表 |
| 上传卡住 | 再次点击该行的 Upload —— 可续传的分块 |
| 字幕停止 | 点击字幕上方横幅中的 Retry captions |
| 500 MB 时的存储警告 | 登录并 Upload all,或 Download 并 Delete |
| 会议结束后录音仍在继续 | 若尚未,更新到 1.9+ |
最后更新:2026-08-27
发布日期: