对于TVBox规则开发者与维护者而言，“手动修改JSON文件”“远程资源难以备份”“规则调试无实时反馈”是长期痛点。而TVBox Rule Master的出现，恰好解决了这些问题——作为一款基于Web的TVBox规则一站式解决方案，它集成了规则管理、图形化编辑、在线调试、资源本地化、设备推送等功能，无需复杂操作，就能大幅提升TVBox规则的开发与维护效率，让开发者彻底告别“逐行修改JSON”的繁琐流程。
一、核心功能：从“管理”到“调试”，覆盖规则全生命周期
TVBox Rule Master的功能设计围绕“规则开发全流程”展开，从配置文件加载到最终推送到设备，每个环节都有对应的优化工具，核心功能可分为五大模块：
1. 多功能编辑界面：宏观管理+微观编辑，兼顾效率与精准
针对不同编辑需求，工具提供三种编辑模式，满足从“整体配置”到“单个规则”的操作场景：
- 主管理面板：负责宏观管理完整配置文件（如常见的m.json），支持对“爬虫规则”“解析规则”“直播源”等模块进行列表式操作——可直接增删改查，还能复制、粘贴规则条目，无需在JSON文件中手动定位代码块，尤其适合批量调整配置；
- 图形化规则编辑器：针对单个爬虫规则文件（如XYQ Hiker规则），提供可视化表单编辑——将JSON中的字段（如“影片标题选择器”“列表数组路径”）转化为输入框、下拉菜单等表单元素，开发者只需填写参数，无需手动编写JSON语法，避免格式错误；
- Ace在线代码编辑器：对.json、.js、.py等文件提供专业代码编辑体验，支持语法高亮、主题切换（如深色/浅色模式）、快捷键操作（如代码折叠、查找替换），适合需要手动修改代码的进阶场景，兼顾灵活性与专业性。
2. 现代化窗口系统：拖拽缩放，适配多设备体验
工具的UI基于WinBox.js构建，所有弹窗（如编辑窗口、文件浏览器、设置面板）均支持拖拽移动、自由缩放，操作逻辑类似电脑桌面窗口，大幅提升操作灵活性；同时针对移动端做了适配——在手机、平板等设备上打开时，弹窗会自动最大化，避免小屏操作不便，实现“电脑端精细操作、移动端快速编辑”的无缝切换。
特别优化的“编辑”功能：以往编辑规则需跳转新窗口，容易打乱操作流程，现在编辑窗口会在当前页面以最大化弹窗形式打开，编辑完成后关闭弹窗即可返回原页面，操作连贯性更强。
3. 一键资源本地化：自动备份，实现离线可用
远程配置文件中常引用外部资源（如jar包、ext扩展、spider脚本），一旦远程链接失效，规则就会报错。TVBox Rule Master的“一键资源本地化”功能可彻底解决这一问题：
- 点击“下载”按钮后，工具会自动分析配置文件中的所有外部资源链接；
- 将jar、ext、spider等资源批量下载到服务器的/box目录下；
- 自动将配置文件中原本的远程路径，替换为服务器本地的相对路径（如将“https://xxx.com/spider.js”改为“./spider.js”）；
整个过程无需手动干预，既能实现配置的完整备份，又能让规则在离线环境下正常使用，尤其适合需要长期维护的规则项目。
4. 强大在线调试：实时反馈，快速定位问题
规则开发中，“无法实时验证效果”常导致反复修改、效率低下。工具的在线调试功能提供两种核心能力：
- 实时CSS选择器测试：在图形化编辑器中，针对“影片标题”“播放链接”“封面图片”等任意规则项，输入CSS选择器后点击“测试”，工具会立即抓取目标内容并展示结果，无需保存后在TVBox中验证，快速判断选择器是否正确；
- 一键自动化测试：针对规则的关键流程（如首页加载、分类筛选、详情页解析），点击“自动化测试”后，工具会模拟TVBox的请求逻辑，自动完成“首页→分类→详情页”的连续测试，生成测试报告，标注出解析失败的环节（如“分类页无数据”“详情页播放链接为空”），帮助开发者快速定位问题。
5. 设备直达与辅助功能：简化部署，保障规则可用性
除了开发与调试，工具还提供两类实用辅助功能：
- 推送到TVBox：内置设备推送功能，可自动识别TVBox的版本，将配置文件的URL或搜索指令（如“搜索电影《xxx》”）一键推送到指定设备，无需手动在TVBox中输入链接，简化部署流程；
- 资源健康度检查：点击“检测”按钮，工具会批量验证规则中引用的网络资源（如直播源、远程脚本）是否有效，对失效链接进行标注，方便开发者及时替换；
- 内置文件浏览器：可直接查看服务器/box目录下的所有规则文件，支持点击加载、重命名、删除等操作，无需通过FTP工具管理文件，操作更便捷。
二、技术栈：轻量无依赖，易于部署
TVBox Rule Master的技术栈设计以“轻量、易部署”为核心，无需复杂的框架依赖，适合各类服务器环境：
- 后端：基于PHP 7.4开发，采用自定义轻量级MVC模式，无第三方框架依赖，部署时无需安装额外扩展（仅需开启cURL扩展，用于处理HTTP代理请求）；
- 前端：使用原生JavaScript（ES6+）开发，同样无前端框架依赖，核心组件仅包含三个轻量级工具：
- WinBox.js：提供可拖拽、缩放的窗口系统，保障多设备操作体验；
- Handlebars.js：用于动态渲染HTML模板（如规则列表、文件列表），提升页面加载效率；
- Ace Editor：提供专业代码编辑功能，满足进阶开发需求。
三、安装与部署：两种方案，适配不同用户
工具提供“服务器常规部署”与“Windows离线一键启动”两种方案，无论是有服务器的开发者，还是零基础的普通用户，都能快速上手：
1. 常规部署（适用于服务器）：三步完成，支持伪静态
（1）环境要求
- 支持PHP的Web服务器（如Nginx、Apache）；
- PHP版本≥7.4，且已开启cURL扩展（多数服务器默认开启）。
（2）部署步骤
- 将项目所有文件上传到服务器的网站根目录（如Nginx的/www/html目录）；
- 在根目录手动创建两个文件夹：box（用于存放本地化资源与规则文件）、cache（用于缓存临时数据）；
- 为/box和/cache目录设置写入权限（推荐755，部分环境需设置为777）；
- （可选）修改默认登录密码：打开config.php文件，找到“PASSWORD”字段，将默认密码替换为自定义密码（如define(‘PASSWORD’, ‘your-new-password’)）；
- （可选）启用URL伪静态：将config.php中的“REWRITE”设置为true，然后为Web服务器配置重写规则（Nginx需在配置文件中添加location规则，Apache需启用mod_rewrite并添加.htaccess文件，项目文档提供了详细示例）。
2. 离线一键启动包（Windows）：开箱即用，仅6.91MB
针对不熟悉服务器配置的用户，项目提供Windows离线整合包，无需安装任何环境：
- 核心优势：内置轻量级Web服务器与PHP环境，无需手动安装Apache、Nginx或PHP；整个压缩包仅6.91MB，绿色便携，不占用过多磁盘空间；
- 使用步骤：
- 从GitHub releases页面（https://github.com/xMydev/TVBoxRuleMaster/releases）下载离线包（格式为.7z）；
- 将压缩包解压到任意目录（注意：路径不能包含中文，否则可能报错）；
- 双击运行解压目录中的“start.bat”文件，程序会自动启动Web服务，并在默认浏览器中打开工具首页，直接开始使用。
四、快速使用指南：四步完成规则开发与部署
掌握基础操作后，通过以下四步即可完成从“加载配置”到“推送设备”的全流程：
1. 加载配置文件
- 方式一：在首页的“远程URL”输入框中，粘贴TVBox规则的远程JSON配置链接（如“https://xxx.com/m.json”），点击“加载”；
- 方式二：若规则文件已上传到服务器/box目录，点击“选择服务器文件”，在文件浏览器中找到对应的JSON文件，点击“加载”。
2. 管理规则列表
加载成功后，通过顶部的“爬虫”“解析”“直播源”等标签页切换不同模块；每个规则以卡片形式展示，点击卡片可展开详情，点击卡片上的按钮可执行操作：
- 点击“编辑”：打开图形化编辑器或Ace代码编辑器，修改规则参数；
- 点击“复制”：复制当前规则，生成新的规则条目，可快速基于现有规则修改；
- 点击“检测”：验证规则中引用的资源是否有效，排查失效链接。
3. 编辑与调试规则
- 编辑单个爬虫规则：在“爬虫”列表中点击“编辑”，打开图形化编辑器，填写“规则名称”“请求URL”“CSS选择器”等参数，如需测试选择器，点击“实时测试”查看结果；
- 修改代码文件：若需编辑.js或.py文件，点击“编辑”后会打开Ace代码编辑器，修改后点击“保存”即可。
4. 本地化与推送设备
- 本地化配置：点击顶部“下载”按钮，设置保存路径（如“./my-rules”）和文件名（如“m.json”），点击“确认”，工具会自动完成资源下载与路径替换；
- 推送到TVBox：点击“推送”按钮，选择目标设备（需确保设备与工具在同一局域网），输入配置URL或搜索指令，点击“推送”，TVBox会自动接收并应用配置。
对于TVBox规则开发者而言，TVBox Rule Master的价值不仅在于“减少手动改JSON的麻烦”，更在于将“管理-编辑-调试-部署”的全流程整合到一个Web工具中，大幅降低规则开发的技术门槛与时间成本。无论是个人维护少量规则，还是团队协作开发复杂项目，都能通过它提升效率，尤其适合零基础用户快速上手TVBox规则开发。
评论