TVBox 接口助手

⬇️ 立即下载

📖 软件简介

本工具用于自动化获取饭太硬站点提供的 TVBox JSON 接口，并对其中的影视源进行严格自动过滤，只保留「电影 / 电视剧」类的纯点播源，剔除 P2P、网盘、体育、教育、动漫、直播、音乐、B站、磁力、预告等分类。

过滤完成后可通过可视化勾选进一步手动微调，最后一键导出 JSON 文件，可直接导入 TVBox / 影视仓 / OK影视 等 TVBox 系列播放器使用。

• 一键直解：模拟 TVBox 客户端请求接口，自动剥离伪装图片并解密出 JSON，1-3 秒搞定
• 59 个关键词严格过滤：覆盖 9 大分类，连玩偶哥哥、聚剧、抠抠搜搜等聚合网盘源也一并剔除
• 可视化微调：左栏保留的源可取消勾选，右栏过滤掉的源可勾选加回
• 拖拽排序：左栏列表项可拖动调整顺序，把常用源排到最前面
• 有效性验证：一键检测各源是否可达，红色徽章直接标出失效站点
• 原生桌面程序：提供便携版（免安装）和安装版（带桌面快捷方式）两种分发形式

🚀 快速开始（30 秒上手）

📋 详细使用指南

① 启动与界面概览

软件界面分为三个区域：

• 顶部操作栏：接口地址输入框、一键获取并过滤按钮、导出 JSON按钮
• 中间统计卡片：总数 / 保留数（绿） / 过滤数（橙） / 是否保留直播源（勾选项）
• 左右两栏列表：左栏为默认保留的影视源（全选），右栏为已被自动过滤的源（全不选），可点击复选框自由调整

② 完整操作流程

1. 确认接口地址

   默认已填入 http://www.饭太硬.cc/tv。如需修改，直接在顶部输入框编辑即可。

2. 点击「一键获取并过滤」

   软件会用 okhttp 客户端身份直接请求接口地址，拿到伪装成 BMP 图片的加密数据后，在内存中自动剥离 JPEG 头部并 Base64 解码出原始 JSON。整个过程通常 1-3 秒完成，状态栏会显示进度。

3. 查看统计结果

   4 张信息卡片会分别显示：原始总数、默认保留数、自动过滤数、直播源数。

4. 自由勾选微调

   左栏（保留列表）：点击复选框即可取消保留某个源；点击「全选/全不选」按钮可一键批量操作。
   右栏（过滤列表）：勾选后该源会被「加回」，导出时一并保留（例如你想恢复玩偶哥哥，就勾选它）。

5. 是否保留直播源

   统计卡片最右侧有「保留」复选框，勾选后导出时会一并保留原始的 lives 直播源（默认不保留）。

6. 点击「导出 JSON」

   弹出文件保存对话框，默认保存到桌面，文件名 fty_filtered.json。保存完成后状态栏会显示导出路径和大小。

③ 拖拽调整顺序

左栏每个保留的源前面都有一个 ⠿ 拖拽手柄，按住它上下拖动就能调整顺序。把最常用的源拖到最上面，导出时就会排在前面，TVBox 加载后也会优先展示。

拖动时会有紫色边框提示落点，松开鼠标即完成。拖拽过程中复选框状态会自动保留。

④ 验证源的有效性

点击左栏顶部的「🔍 验证有效性」按钮，软件会并发检测每个源是否可达，结果用三色徽章标注：

• 有效 绿色徽章 — 站点可正常访问
• 失效 红色徽章 — 站点不可达（鼠标悬停看原因）
• 免验证 灰色徽章 — 非 HTTP 协议，无法测试

验证原理：按站点类型分别处理

• csp_* 类型 → 测试 spider.jar 文件能否下载（所有 csp 站点共享一次结果）
• *.js 类型 → 测试 drpy 扩展 JS 文件能否下载
• http(s):// 类型 → 请求 ?ac=list 接口看是否响应正常

验证完成后，状态栏右侧会显示汇总：如 49/49 | 有效 49 · 失效 0。建议把红色失效的源去掉勾选后再导出。

⑤ 导入 TVBox

将导出的 JSON 文件通过 U 盘 / 共享文件夹 / 推送到 TVBox 设备（电视盒子 / 手机），在 TVBox 设置 → 配置地址 → 选择本地文件，导入即可。

🔍 过滤规则详解

程序基于 59 个关键词 对影视源的 name 字段进行包含匹配，命中即过滤。共分 9 大类：

主 6 类（严格过滤）

附加 3 类（用户确认一起过滤）

工具类（自动过滤）

💬 常见问题