恢复、存储与故障排查
第 6 章:恢复、存储与故障排查
Chrome 一定会打断扩展。这不是会不会的问题 —— service worker 在空闲时休眠、标签页被关闭、Chrome 在内存紧张时回收内存。本章讲述扩展如何挺过这些情况,以及在出现破绽时该怎么办。
一段话说清恢复模型
每段录音在进行过程中都会把音频(和视频)写入 IndexedDB,也就是浏览器的本地数据库。登录后,每个部分还会被上传,并在该部分安全进入云端后裁掉本地副本。没有账户时,整段录音都保留在您的设备上。如果 Chrome 在录音中途停止了扩展,已写入的内容会留下来。下次打开侧边栏时,它会出现在保存在此设备上的录音列表中:已登录用户可以上传它,从已在云端的部分继续;没有账户时,您可以下载它,或登录后保存它。什么都不会悄悄丢失。
"保存在此设备上"列表
只要设备上留有录音,侧边栏中就会显示这个列表,标题为 N 个录音保存在此设备上(<大小>)。每一行显示:
- 会议标题(从未获得标题的录音显示为 "Untitled —
<date>")。 - 时长、大小和日期。
- 一个说明录音所在位置的标签:
- 部分上传:部分内容已在云端;上传会从那里继续。
- 本地:只在此设备上。
- 上传失败:这段录音最近一次上传尝试失败了。您可以再试一次。
- 每一行都有 下载 和 删除,登录后还有 上传。上传进行时,按钮显示 上传中…。
列表一次显示两段录音;用下方的箭头和页码查看其余的。
列表顶部:
- 全部上传(已登录)上传列表中的每一段录音。
- 登录以保存全部(未登录)让您登录,然后上传它们。
- 删除全部 删除所有本地录音。
录音上传完成后会离开列表,面板提示 N 个录音已上传到云端。 已完成上传的录音不会显示。
当 Chrome 在录音中途停止扩展
以下任何一种情况都可能发生,并且都已处理:
- 您正在录制的标签页被关闭。 录音会像您点击了停止一样停止并保存;面板显示 录音标签页已关闭 — 录音已保存。
- 您关闭了侧边栏。 录音继续进行。重新打开面板即可看到。
- 录音标签页崩溃。 麦克风内容脚本的中继中断;连续 5 秒没有 PCM 帧后,侧边栏会显示"麦克风信号中断"警告。录音被停止,截至该时刻捕获的数据块被暂存以便恢复。
- service worker 被 Chrome 回收。 下次冷启动时,扩展会 ping 离屏文档;若它响应,录音无缝继续;若没有响应,离屏文档会被放弃,面板回到设置界面,而暂存的数据块完好无损。
- 离屏文档在内存紧张时被回收。 它的
pagehide处理程序会强制停止录音。离屏文档内部还有一个 30 秒麦克风信号停滞的兜底机制,在所有外部信号都丢失时也会停止录音。 - 录音期间浏览器被关闭。 下次打开侧边栏时,录音会出现在保存在此设备上的录音列表中。
曾经会悄悄丢数据的一种情况 —— Google Meet 会议以单页应用内导航的方式结束 —— 现在由 service worker 直接监视标签页离开会议代码 URL 来处理,与内容脚本无关。
当上传失败时
录音期间网络断开并不会结束录音。上传会暂停,录音保留在您的设备上,上传会在几分钟内反复重试,离线时则等待。如果仍然无法完成:
- 面板显示 上传中断 — 录音已保存在此设备上。请从本地录音列表重试。
- 该录音位于保存在此设备上的录音列表中,标记为 部分上传(部分内容已上传)或 上传失败。
- 已登录:点击该行的 上传,会从已在云端的部分继续,因此长会议不必从头再传一遍。
- 未登录:下载 会把录音保存到您的电脑(根据录制方式,格式为
.mp4或.webm),或者点击 登录以保存全部,把它上传到您新建的账户。
此后扩展不会再按计时器自动重试;请使用 上传 或 全部上传。
存储管理
本地录音 不再 在 30 天后自动删除。如果您把扩展当作独立录音工具使用 —— 录制会议、把文件保 留在本地、从不登录 —— 旧录音以前会悄悄消失。这一点已修复。
只有两类会被安全地自动清理:
- 已完成的孤立录音 —— 上传已确认录音安全存入 R2,本地副本因此多余。
- 0 字节的孤立录音 —— 录音在捕获到任何音频之前就中断了;没有可恢复的内容。
暂存的本地录音达到 500 MB 时,侧边栏顶部会出现黄色存储警告。它只是提醒 —— 不会删除任何数据 —— 但建议您登录并上传,或下载后清除。
要清除某段录音,点击该行的 删除;删除全部 会清空整个列表。两者都会请您确认(此操作无法撤销。),并在未上传的笔记也会被删除时发出警告。
常见问题
"扩展图标在 chrome://、edge:// 或 Chrome 网上应用店上灰显。"
Chrome 禁止扩展在 chrome:// 页面、edge:// 页面以及 Chrome 网上应用店本身运行。这是浏览器层面的限制;SeaMeet 无能为力。请在普通标签页中打开会议。
"标签页捕获失败,提示 'Cannot access a chrome:// URL' 或 'Extension not allowed for this tab'。"
该标签页是在您安装扩展 之前 打开的。Chrome 拒绝在没有 获得权限的标签页上进行标签页捕获。重新加载该标签页 后再试。
"录音在恢复列表中显示为 0:00。"
这是旧版本的一个 bug —— 时长只在停止时写入,因此中断的录音没有时长。现在时长会在录音过程中持续保存,所以只有在第一次时长更新之前录音就结束时才会出现。时长未知时显示 —。
"上传的文件可以播放,但显示时长未知或无限。"
不超过 100 MB 的录音会在上传完成前重写时长元数据,因此这些已经修复。更大的或续传过的 录音仍使用 Part-1 补丁兜底 —— 文件可以播放,但少数播放器可能无法正确跳转。可以改用 VLC 作为变通办法。
"Meet 会议已结束,但录音还在继续。"
这一类 bug 已在 1.9 中修复。如果在 1.9 或更高版本中发生,请报告 —— 附上 chrome://extensions/ 中显示的版本号,并说明会议平台。
"会议中途字幕停止了。"
实时语音转文字会自动重连几次;如果仍失败,转录区域会出现 重试字幕 按钮。点击它即可。录音全程继续 —— 不会丢失任何音频。
"来自 Meet 通话的录音标题错误(是标签页标题)。"
这已在 1.8 中修复 —— 扩展录音现在以 "Untitled — <date>" 开始,与网页应用的默认名称保护一致,因此上传后 AI 生成的会议标题能正确替换它。如果在 1.8 或更高版本中看到这种情况,AI 重命名通常会在一分钟内完成。
何时提交 bug
- 中断后,录音没有出现在保存在此设备上的录音列表中。
- 全部上传 显示成功,但录音不在您的网页资料库 中。
- 扩展导致 Chrome 崩溃(而不只是正常地报错)。
- 任何悄无声息的数据丢失。
请在桌面应用仓库(seasalt-ai/seameet-app-desktop)提交,附上扩展版本、浏览器版本,如有可能再附上侧边栏截图。
快速参考
| 症状 | 尝试 |
|---|---|
| 扩展没有录音 | 重新加载标签页,然后重试 |
| 崩溃后找不到录音 | 查看侧边栏中保存在此设备上的录音列表 |
| 上传失败 | 点击该行的 上传,或 全部上传;会从已上传的部分继续 |
| 未登录,想保留录音 | 登录以保存全部,或逐一 下载 |
| 字幕停止 | 点击转录区域中的 重试字幕 |
| 达到 500 MB 时出现存储警告 | 登录并全部上传,或下载后删除 |
| 会议结束后仍在录音 | 如果还没有,请更新到 1.9+ |
最后更新:2026-10-15
发布日期: