Skip to content

ASRbox v0.1.1

Choose a tag to compare

@github-actions github-actions released this 25 Jul 13:54

ASRbox demo

ASRbox v0.1.1 是一个面向 macOS Apple Silicon 的本地优先音视频转写工具箱,并提供 Linux CPU Docker 部署与 AI 字幕核对工作区。本版本的主题是媒体文件不再强制复制:桌面端默认直接引用原文件,存储位置全面可配置。

中文 README · English README

当前 DMG 尚未签名或公证,仅支持 Apple Silicon Mac。Docker 镜像需从源码构建。

下载

下载后建议校验:

shasum -a 256 -c SHA256SUMS.txt

本版本亮点

AI 字幕核对

  • 桌面端默认引用原文件:导入音视频不再复制到应用目录,没有 importing 等待,大文件零额外占用;设置中可切回"复制到上传文件夹"模式。浏览器与 Docker 上传仍为托管复制。
  • 删除绝对安全:任务按 managed/external 记录媒体所有权,删除任务、批量删除与存储清理只移除 ASRbox 托管文件,绝不触碰你的原始文件。
  • 存储位置可配置:上传目录与派生音频目录均可在设置中修改(支持外置硬盘),仅对新任务生效;Docker 端通过 Compose 注释掉的 /data/uploads bind mount 挂载外置盘(含 macOS 与 Windows 示例)。
  • 拖拽导入一致化:桌面端拖拽改用原生系统事件,与文件选择器一样遵循引用/复制模式。
  • 源文件失踪可修复:源文件被移动或删除后,可在任务中"重新链接"到新路径。
  • 可选自动清理:转写成功后自动删除派生音频(规范化 WAV 与分片),进一步省空间。
  • 全部变化见 CHANGELOG

首次使用

  1. 下载 DMG,将 ASRbox.app 拖入"应用程序"。
  2. 因当前版本未签名,首次启动请右键应用并选择"打开",或在"系统设置 → 隐私与安全性"中允许打开。
  3. 等待界面显示后端在线。
  4. 在"模型"页先下载一个模型;快速验证可使用 faster-whisper-base,Apple Silicon 推荐尝试 mlx-whisper-turbo
  5. 新建任务,拖入或选择音频或视频——默认不再复制原文件;完成转写后导出所需字幕格式。

验证情况

  • 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 密钥在数据库中明文存储;模型需单独下载,可能占用较多磁盘与内存。