smb-link

项目概述

SMB Link 是一款面向 Android 的局域网 4K 影库播放器，让手机直接连接 Windows 或 NAS 的 SMB 与 WebDAV 共享，无损播放本地下载的动漫与电影。它用 libmpv 作为播放内核，按文件夹自动把剧集聚合成海报墙媒体库，并通过 Bangumi 抓取海报、中文名与评分。界面提供简体中文与英文两种语言，采用 Kotlin 与 Jetpack Compose 开发。

手机不进片库，直连 NAS 也能拥有海报墙。

主要功能

• SMB2/3 直连：基于 smbj 协商最大读取块，可跑满千兆内网
• WebDAV 支持：同一套片库、断点与刮削能力，可连 Alist、群晖、威联通等入口
• libmpv 播放内核：4K HEVC 硬解，10bit 自动回退多线程软解，完整 libass 字幕栈
• 海报墙媒体库：按文件夹聚合番剧，用 Bangumi 刮削海报、中文名、评分与断点角标
• 播放体验：横屏沉浸、滑动手势、双击快进、长按 2 倍速、音轨字幕倍速切换与断点续播
• 跳片头：提供 +90s 一键跳过片头
• 凭据安全：密码经 Android Keystore AES-GCM 加密后落盘
• 局域网发现：扫描网段 445 端口找出共享主机
• 诊断报告：播放页可查看实时码率、硬解状态与 mpv 日志并一键复制
• 中英双语：界面跟随系统语言，诊断日志保持单语便于排障

适用人群

• 用 NAS 或 Windows 做影库的用户
• 在手机上看动漫与电影的追番党
• 关注播放性能与画质的用户
• 需要中英双语的用户

快速上手

1. 从 Releases 下载最新 APK（arm64）并安装
2. 打开应用，用局域网发现或手动填写共享主机地址与共享名
3. 输入 SMB 或 WebDAV 的账号与密码，连接后扫描媒体库
4. 等待片库刮削完成，在首页浏览海报墙
5. 点剧进入播放，用滑动手势控制音量、亮度与进度，+90s 跳过片头
6. 播放异常时打开播放页「诊断」开关查看实时状态并复制报告

核心优势

• 无损播放：libmpv 内核对 4K 与 10bit 内容友好，播放不转码
• 海报墙体验：自动聚合番剧并刮削海报与评分，选片更直观
• 凭据安全：密码用系统 Keystore 加密保存，不落明文
• 网络高效：协商最大读取块，千兆内网可跑满带宽

系统要求

项目	要求
操作系统	Android
支持架构	arm64-v8a
依赖	与共享主机同一局域网，需存储权限用于缓存

注意事项

• 部分海思设备因驱动兼容问题会回退软解，功耗较高属预期行为
• Bangumi 匹配取搜索第一名，同名多季可能拿错海报，暂需手动纠错
• smbj 无共享枚举能力，共享名需要手动填写
• 鸿蒙 NEXT 兼容层下会自动开启「流畅模式」，可在「设置 → 界面」切换