ASRbox v0.1.1
ASRbox v0.1.1 是一个面向 macOS Apple Silicon 的本地优先音视频转写工具箱,并提供 Linux CPU Docker 部署与 AI 字幕核对工作区。本版本的主题是媒体文件不再强制复制:桌面端默认直接引用原文件,存储位置全面可配置。
当前 DMG 尚未签名或公证,仅支持 Apple Silicon Mac。Docker 镜像需从源码构建。
下载
- ASRbox_0.1.1_aarch64.dmg — macOS Apple Silicon 安装包
- SHA256SUMS.txt — DMG 与源码包校验值
- ASRbox-ffmpeg-source-8.1.2.tar.gz — 内置 FFmpeg 对应源码与构建材料
下载后建议校验:
shasum -a 256 -c SHA256SUMS.txt本版本亮点
- 桌面端默认引用原文件:导入音视频不再复制到应用目录,没有 importing 等待,大文件零额外占用;设置中可切回"复制到上传文件夹"模式。浏览器与 Docker 上传仍为托管复制。
- 删除绝对安全:任务按 managed/external 记录媒体所有权,删除任务、批量删除与存储清理只移除 ASRbox 托管文件,绝不触碰你的原始文件。
- 存储位置可配置:上传目录与派生音频目录均可在设置中修改(支持外置硬盘),仅对新任务生效;Docker 端通过 Compose 注释掉的
/data/uploadsbind mount 挂载外置盘(含 macOS 与 Windows 示例)。 - 拖拽导入一致化:桌面端拖拽改用原生系统事件,与文件选择器一样遵循引用/复制模式。
- 源文件失踪可修复:源文件被移动或删除后,可在任务中"重新链接"到新路径。
- 可选自动清理:转写成功后自动删除派生音频(规范化 WAV 与分片),进一步省空间。
- 全部变化见 CHANGELOG。
首次使用
- 下载 DMG,将
ASRbox.app拖入"应用程序"。 - 因当前版本未签名,首次启动请右键应用并选择"打开",或在"系统设置 → 隐私与安全性"中允许打开。
- 等待界面显示后端在线。
- 在"模型"页先下载一个模型;快速验证可使用
faster-whisper-base,Apple Silicon 推荐尝试mlx-whisper-turbo。 - 新建任务,拖入或选择音频或视频——默认不再复制原文件;完成转写后导出所需字幕格式。
验证情况
- GitHub Actions CI:TypeScript typecheck、Web UI 构建、后端 pytest(182 项,含媒体摄取/删除守卫/重新链接覆盖)、Rust check/test 与 Playwright 浏览器冒烟全部通过。
- Docker 构建与部署冒烟(健康检查、持久化、token、模型存储迁移)在 CI 与 Release 流程中通过。
- Release 资产经过校验脚本核对。
已知限制
- 仅支持 macOS Apple Silicon;Docker 为 Linux CPU(不含 MLX),默认绑定回环地址,不是公网网关。
- 引用模式下移动或删除源文件会使相关任务的播放与重转写失败,需通过"重新链接"修复。
- 备份仅覆盖应用数据目录内的托管数据;被引用的原始媒体不在备份范围内。
- Provider 密钥在数据库中明文存储;模型需单独下载,可能占用较多磁盘与内存。

