Repository navigation
AniBox 更新日志
v4.1.0(2026-10-24)
本版以修复为主:集中处理了一批用户反馈的播放、字幕、安装与显示问题;另有一个神秘小功能等你发现。
本版飞牛fpk应用无更新
🔧 修复(用户反馈专项)
- 影视版本精确显示:多版本播放时版本标签不再笼统显示「默认版本」——云端 / STRM 等无名称条目自动以文件名兜底,多版本选择器所见即所播。
- 收藏页面应用逻辑修复:收藏页红心状态不点亮的问题(列表未标记 is_favorite);手动元数据「使用此元数据 / 用此匹配」改为本地覆盖先行——选中立即生效并刷新界面,回填飞牛失败只提示不阻塞,观影记录等应用面同步补齐。
- MPV 外挂字幕:补齐 NAS 外挂字幕自动挂载链路(起播自动选最佳中文字幕、防错配、弹幕互不干扰);字幕列表接口的会话票据失效自动回退重试;mpv 字幕菜单里的「在线搜索字幕(简中/英文)」修复(此前接口权限报错),搜索、下载、挂载全链路可用。
- 安装界面显示异常:4K / 高缩放屏(如 225%)安装器界面放大被裁剪、改缩放无效的问题(DPI 声明与 WebView2 组件双升级);视口自适应兜底。
- PotPlayer 播放调用失败:「服务已关闭或地址错误」的根因修复(本地中转服务误吞播放列表路径);HLS 分段 / 密钥全量代转(分段请求带 Referer/UA);整季面板连播、失败原因行内可见。
- 首页封面加载失败:公网连接下封面整片裂图的根因修复(NAS 图片改用服务端缩略图,单张体积降约 85%,不再触发 NAS 限流);限流时自动退避重试。
- 媒体库查询翻页:大媒体库一次性全量拉取导致的加载慢 / 卡顿问题——改为按页查询 + 滚动到底自动翻页(带竞态防护),翻页判停与服务端总数统一口径。
- 首页剧集数显示异常:首页各媒体库条目计数曾固定显示 60(与实际数量不符)——改为服务端真实总数,不足一页的小库显示同样准确。
- 后台 cmd 窗口闪烁:进程存活探测未隐藏窗口,高频轮询时命令行窗口连续闪烁——已全部改为后台静默执行;另含弹幕、字幕、播放链路若干稳定性修复。
✨ 新增
- 新增一个神秘彩蛋小功能,等你发现。
📥 下载指南
💻 支持平台
- ✅ Windows 10 / 11 (x64)(主要平台,已实测)
- ✅ 飞牛 fnOS(NAS / fpk 微应用;x86_64 已实测、ARM64 未实测)
⚠️ macOS / Linux:构建配置已就绪,尚未验证
| 平台 | 文件类型 | 说明 |
|---|---|---|
| 💻 Windows | .exe(NSIS) |
AniBox_4.1.0_x64-setup.exe,由维护者手动上传至本 Release(不通过自动构建),已实测 |
| 🍎 macOS | .dmg / .app |
构建配置已就绪(bundle.targets = "all"),将通过 GitHub Actions 自动构建并上传至本 Release;未实测 |
| 🐧 Linux | .AppImage / .deb / .rpm |
构建配置已就绪,将通过 GitHub Actions 自动构建并上传至本 Release;未实测 |
| 🏠 飞牛 fnOS | .fpk |
微应用(NAS),按主机架构选包:x86 主机装 AniBox-<版号>.fpk(已实测);ARM 主机装 AniBox-<版号>-arm64.fpk(.fpk;不改影视应用任何文件,原生 5666 端口访问不受影响,卸载即还原。升级:应用中心卸载时勾选「保留数据」→ 安装新包,设置与缓存自动恢复 |
💻 Windows(x64,已实测)
- 安装包:
AniBox_4.1.0_x64-setup.exe(NSIS + 自绘安装界面),由维护者手动上传至本 Release;系统要求 Windows 10 / 11 x64。 - 安装步骤:双击安装包 → 选择安装模式(当前用户 / 所有用户)与安装路径 → 可选创建桌面 / 开始菜单快捷方式 → 完成后直接启动。
- WebView2 运行时:安装包已内置 x64 离线全量运行时(
bundle.windows.webviewInstallMode = offlineInstaller,silent),安装全程无需联网;最低版本109.0.0.0。系统已安装且版本达标时自动跳过。 - 安装包体积:因内置离线运行时,包体比在线版大约 127 MB(压缩后),属正常现象。
- 无法安装 / 白屏 / 报
0x80010108:先完全退出(含托盘)再启动或重启系统;仍失败时手动运行同目录的MicrosoftEdgeWebView2RuntimeInstallerX64.exe /silent /install修复运行时;仓库根目录安装WebView2.cmd为联网兜底入口。详细排查见docs/webview2-offline.md。 - 完整性校验:
Get-FileHash .\AniBox_4.1.0_x64-setup.exe -Algorithm SHA256,与发布说明中的指纹比对。本版指纹:FDB6424428BF133842395F895F8C4A8F4A2589AD984148B49E99C9E82BD64F75
🍎 macOS(构建配置就绪,将通过 GitHub Actions 自动构建,未实测)
- 产物形式:
src-tauri/tauri.conf.json的bundle.targets = "all",在 macOS 上构建会产出AniBox.app与AniBox_4.1.0_<arch>.dmg(Intel x64 与 Apple Silicon arm64 需分别在对应架构机器上构建,不产出通用二进制)。 - 系统要求:macOS 10.15 (Catalina) 及以上;渲染使用系统自带 WKWebView,无需额外运行时。
- 获取方式:将由 GitHub Actions 自动构建(构建配置已就绪,
bundle.targets = "all"),产物(.app/.dmg)发布到本 Release,无需自行构建。 - 安装步骤:打开
.dmg,把AniBox.app拖入「应用程序」。 - Gatekeeper(重要):项目未做 Apple 开发者签名与公证,首次打开会被系统拦截。可右键 App →「打开」并确认,或执行:
sudo xattr -dr com.apple.quarantine /Applications/AniBox.app - 无法打开时:确认包架构与本机一致(Intel 机不能装 arm64 包);可从终端
open /Applications/AniBox.app查看具体报错;若提示「已损坏」,执行上面的xattr -dr后再试。 - 播放依赖:随包
third_party/fntv-mpv、proxy.exe为 Windows 版二进制,macOS 构建需自行准备对应平台的 mpv 与代理,或在设置中把mpv_path指向本机 mpv(如brew install mpv)。
🐧 Linux(构建配置就绪,将通过 GitHub Actions 自动构建,未实测)
- 产物形式:同一份
bundle.targets = "all"配置,在 Linux 上构建会产出.deb、.rpm与.AppImage;发行版差异较大,产物将由 GitHub Actions 自动构建并发布到本 Release。 - 系统依赖:WebKitGTK 是系统共享库,无法像 WebView2 那样内置:
- Debian / Ubuntu 系:
sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 - Fedora / RHEL 系:
sudo dnf install webkit2gtk4.1 gtk3 - 构建机另需 Tauri 2 编译依赖(
build-essential、libwebkit2gtk-4.1-dev、libgtk-3-dev、librsvg2-dev、patchelf等)。
- Debian / Ubuntu 系:
- 安装步骤:
.deb:sudo apt install ./AniBox_4.1.0_amd64.deb(包管理器会自动补齐声明的依赖)。.rpm:sudo dnf install ./AniBox-4.1.0-1.x86_64.rpm。.AppImage:chmod +x AniBox_4.1.0_amd64.AppImage && ./AniBox_4.1.0_amd64.AppImage(便携,无需安装)。
- 注意事项:AppImage 虽打包了大部分库,仍依赖宿主机的 glibc、图形驱动与部分系统库,不保证「拷贝即用」;内网离线部署需自备 apt / dnf 依赖源。
- 播放依赖:弹幕与播放器配置已内置,但需自行安装 mpv(要求版本 > 0.37.0);随包
third_party/fntv-mpv、proxy.exe为 Windows 版二进制,Linux 构建需替换为对应平台的 mpv 与代理,或把mpv_path指向本机 mpv。 - 无法启动时:从终端运行可看到缺失库的具体报错(多为缺少
libwebkit2gtk-4.1);补齐上述依赖后重试。
📦 更新机制说明(4.0 起沿用双通道)
- 热补丁更新:只覆盖前端静态资源,应用内下载 → 校验 → 原子切换,重载生效,可一键回滚;Rust / 原生依赖改动不在热补丁范围。
- 全量包更新:应用内后台下载(支持断点续传)完成后拉起 NSIS 安装器覆盖安装。
⚠️ 本版为全量包更新(4.0.0 → 4.1.0):本批修复大部分位于原生(Rust)侧,热补丁覆盖不到,请在应用内直接更新或下载完整安装包覆盖安装;配置、缓存与观看记录自动保留。- 🏠 飞牛 fpk 版不参与上述自动更新:升级方式即上表「应用中心卸载(勾选保留数据)→ 安装新
.fpk」。
AniBox v4.1.0