TVFileBox：Android TV 文件管理器

项目简介

TVFileBox 是一款专为 Android TV 盒子设计的轻量文件管理器，也兼容运行 Android 4.0（API 14）的老旧设备。它提供遥控器友好的文件浏览界面，并内置「远程传输」功能：在同一局域网下，用手机浏览器即可向电视盒子传文件。

界面语言跟随 Android 系统语言：中文系统使用简体中文，其余语言使用英文，手机上传网页同样如此。

主要功能

• 用遥控器或触摸屏浏览设备的默认共享存储目录。
• 在当前显示目录中新建并命名文件夹。
• 按 Home 键回到初始共享存储目录（如 /storage/emulated/0）。
• 按返回键进入上级目录，按 OK/Enter 打开文件或进入文件夹。
• 长按 OK/Enter（触屏长按行）弹出确认对话框后删除文件或文件夹。
• 按遥控器设置/菜单键打开当前选中行的操作菜单，支持重命名、删除、复制、剪切、粘贴。
• 调用 Android 系统安装器打开 APK 文件。
• 「远程传输」页面显示二维码，接收同一局域网内手机浏览器上传的文件，并展示上传进度、精确存储路径、历史记录以及打开/删除操作。
• 关闭远程传输页面后立即停止内置 HTTP 服务器。

遥控器操作

操作	遥控器输入
上下移动选择文件	方向键上/下
打开文件 / 进入文件夹	OK、方向键中键或 Enter
删除选中项	长按 OK、中键或 Enter
复制/剪切/粘贴/重命名/删除菜单	设置键或菜单键
返回上级目录	返回键
回到初始目录	应用工具栏的 Home 按钮

所有删除操作都会弹出二次确认对话框，且不可恢复。

复制、剪切与粘贴

1. 选中源文件或文件夹，按遥控器设置/菜单键。
2. 选择 Copy（复制）或 Cut（剪切）。
3. 导航到目标位置并选中某项：
   • 选中文件夹时，粘贴会把源项目放进该文件夹内部；
   • 选中文件时，粘贴会把源项目放到该文件所在的同级目录。
4. 再次按设置/菜单键，选择 Paste（粘贴）。

未复制或剪切任何内容前，菜单中不会显示粘贴。复制操作可重复粘贴；剪切在成功移动后自动清空。文件夹会递归复制，同名项目会自动追加 (1) 之类的后缀，并且会阻止把文件夹粘贴到自身或其子目录中。

安装与使用

从 Releases 页面下载 APK，按设备选择：

• TVFileBox-v1.2.5-armeabi-v7a.apk：32 位 ARM 电视盒子。
• TVFileBox-v1.2.5-arm64-v8a.apk：64 位 ARM 设备。
• TVFileBox-v1.2.5-universal.apk：通用版本，一般安装推荐使用。

TVFileBox 当前不包含原生 .so 库，因此三个按 ABI 命名的 APK 内容完全相同，ARMv7 与 ARM64 均可使用。最低系统版本为 Android 4.0（API 14）。这些 APK 使用调试签名，可覆盖安装此前同签名的 TVFileBox 版本。

从源码构建：

1. 用 Android Studio 打开本仓库。
2. 等待 Gradle 同步项目。
3. 连接 Android TV 盒子或模拟器。
4. 运行 app 配置，或在 PowerShell 中执行：

$env:JAVA_HOME='C:\Program Files\Android\Android Studio\jbr'
.\gradlew.bat clean testDebugUnitTest lintDebug assembleDebug

注意事项

• 默认上传目录来自 getExternalFilesDir("uploads")，卸载应用后 Android 会删除该目录。
• 普通非 root 应用无法浏览 /data 等受保护目录。
• Android 4.4 上对外置 SD 卡的写入可能受设备固件限制。
• APK 安装不会是静默的，必须在 Android 系统安装器中确认。
• Android 8 及更高版本可能需要为 TVFileBox 开启「安装未知应用」权限。
• 当前 targetSdk 为 28，以保留老电视盒子的旧式直接路径行为；该配置面向旁加载，不适合直接提交 Google Play。
• 部分厂商遥控器占用了设置键，此时可用菜单键作为替代。
• 上传 URL 包含随机会话令牌；内置 HTTP 服务器仅在远程传输页面可见时运行。
• 上传文件名会做净化处理以防路径穿越，上传内容先写入临时 .part 文件再定稿。
• 手机与电视必须处于同一局域网内，路由器的 AP 隔离可能阻断访问。

---

本作品整理自 GitHub 开源项目 w1lli4m666-droid/TVFileBox，原作者 @w1lli4m666-droid。中文介绍由 AI 根据项目 README 整理，以原仓库为准。