01 — 界面
从首页到播放
七个界面各司其职
首页全屏 Hero 轮播、发现页双面板、两栏沉浸式详情、观影记录、mpv 三源弹幕、PotPlayer 调用与演员入库检测，都是 AniBox 的实际运行界面。
首页全屏 Hero 轮播
全屏海报 Hero 随当前作品自动取色，标题替换为 TMDB 透明 Logo；竖向、横向、堆叠与立体堆叠四种轮播样式随时切换。
发现页 TMDB / Bangumi 双面板
TMDB 与 Bangumi 两套数据源左右并行，榜单、筛选与搜索各走各的，想按哪套资料找片都行。
两栏沉浸式详情页与标签页
大背板配玻璃信息层，左侧资料、右侧选集两栏排布；简介、演职人员与剧集等标签页随手切换。
观影记录与年度报告
自动记录观看进度与足迹，随时按时间回看；年度报告汇总观看时长、类型与偏好，一年看了什么一目了然。
mpv 三源弹幕丰富影视体验
独立 mpv 进程播放，接入三源弹幕，支持合集按集取分 P、手动搜索与锁定弹幕源，观感更热闹。
兼容本机自带 PotPlayer
一键改用本机已安装的 PotPlayer 播放，字幕、续播与进度回写照常工作，不必改变原有习惯。
演员信息入库检测
演职人员资料可一键回填 TMDB / Bangumi，并检测演员作品是否已入库，补全影人档案。
02 — Web 版
NAS 里装一次
全屋浏览器直开
Web 版把整套体验搬进浏览器：NAS 上装一次 fpk，电视、平板、手机、电脑打开地址就是增强版，零安装、免客户端，手机也做了适配。下面五个方面，看网页端把日常追番影库做到了什么程度。
浏览器里的全屏 Hero
打开网页就是全屏 Hero 轮播，海报随当前作品自动取色，TMDB 与 Bangumi 数据源随手切换。热播榜与「继续观看」就在首页，输入地址即用，什么都不用装。
- 全屏 Hero 轮播
- TMDB / Bangumi 切换
- 热播榜
- 继续观看
浏览器原生播放，弹幕照开
播放交给浏览器原生播放器，不必再装任何外部播放器。B 站弹幕在网页里直接渲染，设置、样式、屏蔽与来源面板一应俱全。
- 原生网页播放器
- B 站弹幕渲染
- 弹幕设置 / 样式
- 屏蔽与来源面板
两级详情，纯网页也能还原
一级详情是大背板配海报与选集，二级详情给出分集列表、演职人员与相关作品。层级和信息量都做足，却完全跑在浏览器里。
- 一级：大背板 · 海报 · 选集
- 二级：分集列表
- 演职人员
- 相关作品
热力图 + 海报墙，跨设备同步
日历热力图叠加活跃度统计，一眼看清最近的观影节奏；已看完与在观看各自成墙，自动归档。记录跟着账号走，换台设备接着看。
- 日历热力图
- 活跃度统计
- 已看完 / 在观看海报墙
- 跨设备同步
网页内直接查影人
演员资料卡汇集生平与代表作，作品墙按 TMDB 整理归类。在网页里点开就能查，不用跳去第三方站点来回翻。
- 演员资料卡
- 作品墙
- TMDB 整理
← 左右滑动查看 →
| 能力 | Web 版 · fpk | 本地客户端 |
|---|---|---|
| 形态 | fnOS 应用，NAS 装一次，全屋浏览器即用 | 各设备单独安装 |
| 海报墙 / 轮播 / 详情页美化 / Logo | ✓ | ✓ |
| B 站弹幕 + 自建源 + 手动搜索 | ✓ | ✓ |
| 豆瓣 / Bangumi / Trakt 同步 | ✓ | ✓ |
| 跳过片头 / 播放记忆 / 观影记录 | ✓ | ✓ |
| 手机网页适配 | ✓ | — |
| 原盘 / 高级字幕 / 外部播放器 | — | ✓ |
| 外接遥控 / 播放器内预览 | — | ✓ |
一句话总结：Web 版胜在「零安装、全屋全设备、手机适配」，本地客户端胜在「原盘与高级播放、外接遥控」——两者可共存，按场景各取所需。
02 — 架构与安装
fnOS 微应用
一条零改动的网关链路
Web 版不是改影视应用的文件，而是一个 fnOS 微应用：桌面图标经飞牛统一网关直达增强页面，影视应用本身零改动。装一次 fpk 到 NAS，电视、平板、手机、电脑的浏览器打开就是增强版——零安装、零文件改动，卸载即还原。
fnOS 微应用 · fpk
在 fnOS 应用中心装一个 fpk，桌面出现「影视 Plus」入口；增强前端打包成单文件 payload，随应用一起就位。
飞牛网关 /app/fntvplus/*
桌面入口与增强页面都走 fnOS 官方网关（Unix socket），先校验 NAS 登录态再转发；服务本体不对局域网开放任何 TCP 端口。
Go 服务注入 payload
影视网页取回后注入增强脚本，其余 API / 视频 206 / 图片请求原样透传；桥接接口解决浏览器 CORS 与签名问题。
/app/fntvplus/* → Go 反向代理注入 payload → 影视应用零改动 → 全设备浏览器。影视应用原样不动
增强只发生在取回网页后的注入层，影视应用本身从不被修改，官方升级与本应用互不影响。
NAS 装一次就够
电视、平板、手机、电脑用浏览器打开即增强版，手机尺寸也做了适配，不必逐台安装客户端。
卸载即回到原生
不写入系统目录、不监听公网端口；卸载 fpk 后走影视原生端口访问，一切如初。
三步装好，全屋可用
NAS 装一次，其余设备零安装。
- 1装 fpk 到 fnOS
应用中心「手动安装」上传对应架构的 fpk；桌面出现「影视 Plus」与设置两个入口。
- 2配置网关 / 反向代理
增强入口走飞牛统一网关、自动复用 NAS 登录态；按需在设置里填数据源与刮削服务。
- 3任意浏览器打开
电视 / 平板 / 手机 / 电脑浏览器打开即增强版，零文件改动；卸载 fpk 即还原原生影视。
安全与还原
✓不 root 以 fnOS 包用户身份运行，最小权限。✓不开放公网端口 主入口走统一网关，TCP 仅绑 127.0.0.1 供本机健康检查。✓不改文件 影视应用零改动，官方升级互不影响。✓可随时还原 卸载 fpk 后走原生端口访问，一切如初。✓数据留在本机 配置与缓存在应用数据目录，匿名统计可关闭。
02 — 架构
Tauri 2 + Rust
一条可替换的运行时链路
桌面外壳用 Tauri 2 承载，Rust 核心负责窗口、进程、网络与更新；界面是 React 19 + TypeScript + Vite。播放交给独立 mpv 进程，经命名管道 IPC 双向控制，也可调用本机 PotPlayer；元数据与更新走自建镜像，弹幕由本地 Node shim 提供，手柄由 Rust gilrs 原生监听。
React 19 + TypeScript + Vite
首页、发现、媒体库、详情、观影记录、反馈工单与设置都在 WebView2 里渲染，经 Tauri IPC 调用 Rust 命令并接收事件。
Tauri 2 + Rust
窗口、进程、网络、更新与本地状态都在 Rust 侧：config、fnapi/authx、mpv、player、update、bgm、tmdb、history、feedback 等模块各司其职。
mpv · Go 代理 · 弹幕 shim
Rust 拉起独立 mpv 进程（命名管道 JSON 行协议），同时守护本机 Go 代理与 Node 弹幕 shim；需要时改用 PotPlayer。
独立 mpv · 命名管道 IPC
mpv.exe 自带消息循环，uosc、右键菜单、缩略图与弹幕 Lua 脚本原生可用；Rust 通过 --input-ipc-server 命名管道下发指令并接收属性事件，同一进程内换集避免反复启动。
PotPlayer（可选）
可一键改用本机已安装的 PotPlayer，随包 potctl.exe 读取进度；需要请求头时走本地 relay。
Go 代理与自建镜像
本机 Go proxy.exe（:22346）负责 NAS 拉流中转；元数据、图片与更新优先走自建 Bangumi / TMDB / GitHub / 统计镜像，缺密钥或异常时按模块降级。
本地 Node shim
系统 Node 运行 danmaku-shim.cjs（:22347），为播放器提供弹幕能力，不依赖外部网页注入。
全局手柄
Rust 侧用 gilrs 原生监听手柄，事件推送到前端，用于界面导航与媒体控制，不要求窗口聚焦。
磁盘缓存 · 热补丁 / 全量
图片与 JSON 走内存 → 磁盘 → 网络三级缓存，磁盘按 LRU 淘汰；更新支持 NSIS 全量安装与 fntvweb 前端资源覆盖层热补丁。
← 左右滑动查看完整对比 →
| 服务端组件 | 职责 | 说明 |
|---|---|---|
| Go 代理 | NAS 拉流中转 | 本机 proxy.exe（127.0.0.1:22346），把媒体请求收口到本地，避免直连问题 |
| Bangumi 镜像 | 数据与图片 | 自建镜像，带准入签名；缺密钥时降级直连官方域 |
| TMDB 镜像 | 元数据与海报 | 自建镜像注入服务端 key；缺密钥时降级用户自己的 key |
| GitHub 镜像 | 更新与发布 | 版本检查与安装包解析走自建通道 |
| 统计镜像 | 匿名统计与反馈 | 可关闭，仅上报匿名 ID、版本与系统类型 |
| 磁盘缓存 | 图片 / JSON 两池 | 内存 → 磁盘 → 网络，磁盘按 LRU 淘汰，可在设置里查看与清理 |
镜像只做转发与缓存，不改变第三方数据的归属与署名；AniList 走官方 GraphQL 直连。
三步开始
下载安装包，按向导走完即可。
- 1安装
下载 Windows NSIS 安装包，双击安装；后续全量更新同样走 NSIS。
- 2连接
首次启动按向导选择本地媒体库，需要时可切换本机 PotPlayer。
- 3开始观影
首页、发现、媒体库、详情与观影记录即时可用；前端补丁在应用内完成。
隐私与合规
✓匿名统计可关闭 只上报匿名 ID、版本与系统类型，设置里一键关闭。✓日志脱敏 账号、令牌与密钥在导出前一律打码。✓本地优先 媒体库与配置留在本机，不上传你的内容。✓GPL-3.0 源码公开，可自行审计。✓第三方署名 保留 TMDB 与 Bangumi 的署名与使用条款。
03 — 能力
视觉之外
小功能一个不落
首页轮播、发现页双面板、沉浸式详情与观影记录构成浏览主线；mpv 三源弹幕、PotPlayer 调用与演员入库检测补齐播放与资料，每一项都是天天用得上的实在功能。
04 — 关于
AniBox 是一款基于 Tauri 2 的桌面影视客户端：Rust 后端负责原生窗口、进程与网络，React + TypeScript + Vite 构建界面。播放交给独立 mpv 进程，经命名管道 IPC 双向控制，也可调用本机 PotPlayer。服务端由 Go 代理统一接入自建的 Bangumi / TMDB / GitHub / 统计镜像。首页、发现、媒体库、详情、观影记录、反馈工单与弹幕构成完整体验；更新采用自建后台下载、NSIS 全量安装与前端资源覆盖层热补丁。匿名统计可关闭、日志脱敏，以 GPL-3.0 开源，并保留 TMDB 与 Bangumi 署名。
05 — 常见问题
你可能想问
AniBox 是一款基于 Tauri 2 的桌面影视客户端：Rust 后端负责原生窗口、进程与网络，React + TypeScript + Vite 构建界面。首页、发现、媒体库、详情、观影记录、反馈工单与弹幕都在同一个应用里。
播放交给独立的 mpv 进程，由 Rust 后端拉起，并通过命名管道 IPC 双向下发播放、暂停、跳转、字幕等指令；也可以选择调用本机已安装的 PotPlayer。
服务端由 Go 代理统一接入自建的 Bangumi / TMDB / GitHub / 统计镜像，避免公共接口限流。更新采用自建后台下载：全量走 NSIS 安装包，前端资源则通过覆盖层热补丁即时替换，小修小补无需重装。
匿名统计只上报「随机匿名 ID + 版本号 + 系统类型」，可在设置里一键关闭；日志默认脱敏，账号、令牌与密钥一律打码。软件以 GPL-3.0 开源，并保留 TMDB 与 Bangumi 的署名与使用条款。
不提供。AniBox 不提供在线资源观看 / 播放功能，也不存储、不分发任何影视内容；只用于播放你自己的本地媒体库。内容版权归原站与各自权利人所有。
应用内「反馈工单」可以直接写描述提交，也能一键附带脱敏后的日志（账号、令牌、密钥一律打码）；不方便联网时还可导出日志文件手动发我。
本站（690075.xyz）就是 AniBox 的官方网站。安装包在 GitHub Releases 官方首发，Gitee 为国内镜像，上方下载区给出直达链接；请勿使用来源不明的补丁包。
06 — 下载
装到桌面
现在就开始
GitHub Releases 为官方首发渠道，百度网盘为备用镜像（版本可能略有滞后）；请勿使用来源不明的补丁包。
桌面客户端
把追番与影库装进桌面：独立 mpv 进程经命名管道 IPC 播放，也可调用本机 PotPlayer；首页、发现、媒体库、详情与观影记录一站打通。
Web 版 fpk
NAS 里装一次，电视 / 平板 / 手机 / 电脑打开浏览器就是增强版，客户端一个都不用装，卸载即还原。fpk 包随桌面端同一个 Release 发布。