讯飞录音笔云端数据本地备份

讯飞录音笔录音本身在云端，转写、AI 总结、思维导图也都在网页端能看到，但真到需要长期整理时，只靠网页端不太方便：文件分散，账号切换容易混，后续要搜索、归档、再加工也不顺手。

iflytekRecordDownload 就是为这个场景写的一个小工具。它从讯飞录音笔网页端读取云端录音列表，把录音音频、转写文本、AI 总结和思维导图同步到本地。同步后的文件按账号、日期和录音时间组织，适合长期备份。

它解决什么问题

这个工具主要做几件事：

  • 下载每条录音对应的 WAV 音频。
  • 导出转写文本为 Markdown。
  • 同步云端生成的 AI 总结和思维导图。
  • 按不同讯飞账号分目录保存。
  • 按录音当天日期建文件夹，同一天多条录音再按时分秒区分。
  • 自动生成当天的转写合并文档，方便快速回看。

最后得到的目录大概是这样：

1
2
3
4
5
6
7
8

~/录音笔同步/工作账号/
  2026年05月14日/
    17时26分49秒.wav
    17时26分49秒.md
    17时26分49秒_AI总结.md
    17时26分49秒_思维导图.md
    17时26分49秒_raw.json
    2026年05月14日_转写合并.md

这个结构的好处是后续处理很简单。音频、转写、总结和思维导图都在同一个时间点下面，不需要再从一堆文件里猜谁和谁对应。

实现思路

讯飞录音笔网页端本身会调用接口读取录音列表和详情。工具没有绕过登录流程，而是让用户先在浏览器里正常登录，然后从开发者工具里复制一次 Copy as cURL。脚本会从这段 cURL 里解析出 X-Session 和 X-User-Id，再用同样的登录态去访问云端接口。

为了减少手动维护，脚本会动态生成请求签名，也会在同步前校验当前云端账号。如果配置里是 A 账号，但浏览器复制出来的会话实际对应 B 账号，脚本会停止同步，避免把不同账号的录音混到一起。

同步过程是增量的。已经下载过的录音会跳过；如果后面云端才生成 AI 总结或思维导图，再次运行时也会补齐这些文件。

使用方式

第一次运行：

1

./sync.sh --setup

脚本会打开讯飞录音笔网页端。登录后，在浏览器 Network 面板里找到 api.iflyjz.com 请求，右键选择 Copy as cURL，把整段内容粘贴回终端。

之后日常同步只需要：

1

./sync.sh

macOS 上也可以安装每天自动备份：

1

./install-daily-sync.sh

默认是每天 02:00 运行，也可以指定时间：

1

./install-daily-sync.sh 23 30

安全边界

这个项目会处理登录态，所以最重要的是不要把真实配置提交到公开仓库。仓库里只保留了 files/iflytek_config.example.json，真实配置文件 files/iflytek_config.json 已经放进 .gitignore。

同样不应该提交的还有完整 Copy as cURL、录音文件、转写文本、接口返回 JSON、音频下载 URL 和飞书 Webhook。项目里也保留了一些检查逻辑，尽量避免误把旧账号的数据同步到新账号目录里。

项目地址

GitHub 仓库：

https://github.com/onecaicai/iflytekRecordDownload

如果你也有长期备份讯飞录音笔云端内容的需求，可以直接从 README 的快速开始部分配置。这个工具没有复杂的后台服务，也不需要数据库，核心目标就是把云端数据稳定、清楚地落到本地文件系统里。