BAS 弹幕时间轴编辑器,基于 Tauri 2 + Vue 3 + TypeScript 构建的桌面客户端,同时保留纯 Web 版本(GitHub Pages)。
项目结构与打包方式参考 cc-switch。
├── src/ # 前端(Vue 3 + Vite)
├── public/ # 静态资源(bas.js、vendor/jquery 等)
├── src-tauri/ # Tauri 2 Rust 端
│ ├── src/main.rs # 入口
│ ├── src/lib.rs # 应用构建、插件注册
│ ├── src/commands.rs # 前端可调用的 Tauri commands
│ ├── capabilities/ # 窗口权限声明
│ ├── icons/ # 应用图标(由 assets/app-icon.svg 生成)
│ └── tauri.conf.json # Tauri 配置(版本号读取 package.json)
├── assets/ # 图标源文件
├── rust-toolchain.toml # Rust 工具链版本
└── .github/workflows/ # CI、Release 打包、Pages 部署
- Node 20.19+ / 22.12+,pnpm(版本见
package.json的packageManager) - Rust(版本见
rust-toolchain.toml) - 各平台 Tauri 系统依赖,见 Tauri Prerequisites
- Linux:
libwebkit2gtk-4.1-dev libgtk-3-dev librsvg2-dev libayatana-appindicator3-dev libsoup-3.0-dev
- Linux:
pnpm install # 安装依赖
pnpm dev # 启动桌面客户端(tauri dev,自动拉起 Vite)
pnpm dev:renderer # 仅启动 Web 前端(浏览器调试)
pnpm type-check # vue-tsc 类型检查
pnpm build:renderer # 类型检查 + 构建前端到 dist/
pnpm build # 打包桌面客户端(tauri build)
pnpm tauri icon assets/app-icon.svg -o src-tauri/icons # 重新生成图标打包产物位于 src-tauri/target/release/bundle/。
- 同步修改
package.json与src-tauri/Cargo.toml中的version - 推送
v<版本号>tag(如v0.1.0),Releaseworkflow 会构建:- Windows x86_64 / ARM64:
.msi、NSIS-Setup.exe、单文件-Portable.exe、-Portable.zip - macOS Universal:
.dmg、.zip - Linux x86_64 / ARM64:
.AppImage、.deb、.rpm
- Windows x86_64 / ARM64:
- 产物上传到草稿(draft)GitHub Release,确认后手动发布
手动触发 Release workflow 为干跑,仅在 workflow artifacts 中保留产物。
Windows 的 -Portable.exe 可直接运行,无需安装应用;-Portable.zip 解压后使用方式相同。两者均依赖系统已安装 Microsoft Edge WebView2 Runtime,不包含独立浏览器运行时;缺少时请先安装 WebView2,或使用 -Setup.exe 安装版。免安装版仍将设置及近期项目记录保存在系统用户数据目录中,项目文件保存在用户选择的位置。
正式桌面构建启动 1 秒后检查最新正式版本,之后每 6 小时检查一次;设置页也可手动检查。自动下载默认关闭,可在设置中开启。更新下载后先验证签名,用户点击“保存工程并安装重启”后才安装;当前工程保存失败时中止安装。下载包缓存在 Rust 进程内存中,退出应用后需重新下载。选择“稍后”会隐藏该版本提示,设置页仍可安装。
Windows MSI 与 NSIS 安装版分别下载同类型安装包,macOS 使用 Universal .app.tar.gz 更新包,Linux AppImage 支持应用内安装。Windows 便携版、Linux DEB/RPM 和开发构建仅提供手动下载入口。Web 版随网站部署更新,不调用桌面更新接口。
Release workflow 要求仓库 Actions Secret TAURI_SIGNING_PRIVATE_KEY;加密私钥还需配置 TAURI_SIGNING_PRIVATE_KEY_PASSWORD。私钥必须与 src-tauri/tauri.conf.json 中 updater 的公钥配对,不能随意轮换,也不要提交到仓库。可用 pnpm tauri signer generate --ci -w <仓库外的私钥路径> 为新项目生成密钥。已有客户端只能接受原公钥对应私钥签名的更新。
构建会生成安装包签名,并在发布前生成 latest.json,任一平台的更新包或签名缺失都会导致发布失败。.sig、latest.json、.app.tar.gz 属于自动更新文件,无需手动下载。草稿和预发布版本不会通过 releases/latest 推送;检查完产物后将草稿发布为正式版本,客户端才能检测到。首次接入此功能之前的旧客户端不含更新器,需要先手动安装一次带更新功能的新版本。
本地仅编译可运行 pnpm tauri build --no-bundle;生成便携版使用 pnpm tauri build --no-bundle --features portable,该构建明确禁用自动安装,即使 EXE 被重命名也不会改变。workflow 在安装包生成后单独编译便携版,避免沿用打包器写入的安装类型标识。生成带更新签名的安装包时,需要在本机设置对应的 TAURI_SIGNING_PRIVATE_KEY。验证命令:pnpm test:updater、pnpm test:storage、pnpm build:renderer,以及 src-tauri 下的 cargo fmt --check、cargo clippy -- -D warnings 和 cargo test --lib。
macOS 签名/公证为可选项:在仓库 secrets 中配置 APPLE_CERTIFICATE、APPLE_CERTIFICATE_PASSWORD、APPLE_SIGNING_IDENTITY(以及公证用的 APPLE_ID、APPLE_PASSWORD、APPLE_TEAM_ID)后自动启用。
窗口控制按平台适配:macOS 使用原生红绿灯和叠加式标题栏,Windows 使用右上角应用内按钮,Linux 默认开启“使用应用内窗口按钮”,用户可在设置中关闭以改用桌面环境提供的原生标题栏和按钮,立即生效;偏好保存在应用配置目录的 window-preferences.json,下次启动会在窗口显示前恢复。按钮位置和外观由 Linux 桌面环境决定,程序不识别或模拟红绿灯主题。Web 版不显示桌面窗口控制选项。
Linux 会根据当前显示器的可用工作区与缩放比例调整窗口最小尺寸,并为系统标题栏预留空间,避免小屏幕或高缩放下固定的最小尺寸阻止系统最大化。移动到其他显示器或改变分辨率后会重新计算约束;启动时过大的普通窗口也会缩小到可用区域。
项目以 <项目名>.basproj 保存在用户选定的目录,不要求目录为空;同名项目文件不会被覆盖。已有的 project.basproj 仍可打开。桌面端近期项目列表保存在 Tauri 应用配置目录的 recent-projects.json。Web 端在 localStorage 保存近期列表,并在 IndexedDB 中仅保存项目文件夹句柄;项目内容和素材仍保存在文件系统。重新打开时会检查文件夹权限;如原文件夹不可用,可通过“打开本地项目”重新选择。
工程文件记录文字、按钮、Path 和音频资产、虚拟素材箱及时间轴编辑数据。素材箱只改变工程内分类,不移动磁盘文件。桌面端导入音频默认引用原文件的绝对路径;Web 端受浏览器限制,将音频复制到项目辅助目录。原文件移动或删除后,可在素材离线提示中重新链接。删除素材或时间轴片段不会删除原始音频;删除项目文件时也保留素材和备份。
素材箱的新建、重命名、删除确认及素材右键重命名使用应用内对话框。名称不能为空;可按回车提交,或按 Esc 取消。
桌面端和 Web 端统一使用 .<项目文件名>.danmakucut 作为辅助目录,保存备份和项目内素材。打开旧版 Web 项目时,程序会将旧 .danmakucut-<项目 ID> 目录中的数据复制到统一目录;旧目录不会被自动删除,同名文件内容冲突时也不会覆盖。工作台可通过“集中打包工程”创建包含音频的独立副本,不修改原项目和原始素材。BAS 文本导出包含可编译的文字、按钮和 Path,音频仅用于编辑预览,不写入 BAS。
旧版本项目在打开时转换为当前工程格式;自动保存前保留历史备份。项目在切回工作台及保存前检查外部更改,发现冲突时提示用户并拒绝覆盖;浏览器无法完全阻止检查与写入之间发生跨进程更改。Web 项目需要支持 File System Access API 的浏览器,文件夹内的同名文件不会被有意覆盖,但浏览器无法完全阻止其他程序同时创建或修改文件。