爬虫源与订阅管理

爬虫源和订阅是项目的核心功能

一、爬虫源管理

进入管理后台 「爬虫源」 页面，可对爬虫源进行增删改、启用/禁用、脚本编辑与调试、环境变量配置等。

1.1 添加爬虫源

1. 点击 「新建爬虫源」。
2. 填写基本信息：
   • 源名称：在列表中显示的名称。
   • 脚本类型：选择 JavaScript 或 Python。
   • 备注（可选）：便于区分用途。
   • 标签（可选）：用于分类或筛选。
   • 首页导航 / 推送站点：常规源可勾选「首页导航」；推送类源勾选「推送站点」。
   • 启用：创建后是否立即启用。
   • 优先级：数值越大排序越靠前（可选）。
3. 保存后进入该源的 脚本编辑 页面，编写或粘贴脚本代码（需实现 detail、play 等接口，见 爬虫开发）。

1.2 获取现成脚本

若不想从零开发，可先添加一个空源（选好类型），再在脚本编辑器中从 脚本仓库 复制脚本内容后粘贴。脚本内可通过注释声明 @downloadURL、@version，之后可在列表中 「检查更新」，并 「从远端更新」 到最新版本。

1.3 日常管理

• 编辑：修改名称、备注、启用状态、优先级、首页导航/推送站点等；脚本需进入「编辑脚本」或「调试」页面修改。
• 启用/禁用：禁用后该源不会出现在订阅中，也不会被客户端请求。
• 复制：复制一份新源（含脚本），可改名为新源再调整。
• 删除：删除后不可恢复，若该源已加入订阅，需先在订阅中移除再删。
• 环境变量：在源详情/编辑中配置该源独享的环境变量（如 API 地址、密钥），脚本内通过 OmniBox.getEnv(name) 或 process.env / os.environ 读取。
• 依赖管理：若脚本依赖其他 JS/Python 包，可在「依赖管理」中配置，由系统在运行前安装。
• 调试：在「调试」中选择方法（如 home、detail、play），传入测试参数，查看返回结果与日志，便于排查问题。

1.4 脚本更新

• 列表中每个源支持 「检查更新」：根据脚本内 @downloadURL、@version 与远端对比，有更新时显示更新按钮。
• 点击 「从远端更新」 将用远端脚本覆盖当前脚本（建议更新前备份或确认变更）。
• 支持批量检查、批量从远端更新（仅更新提示为「有更新」的源）。

---

二、订阅管理

订阅用于把多个爬虫源组合成一份配置，客户端（TVBox、猫源、UZ、Emby 等）只需配置一个订阅地址即可使用这些源。

2.1 创建订阅

1. 进入 「订阅管理」，点击 「新建订阅」。
2. 填写：
   • 名称：订阅显示名称（如「我的影视合集」）。
   • 描述（可选）：说明该订阅包含哪些源或用途。
   • Token：用于鉴权，系统会预填随机 Token，也可自行修改；客户端访问订阅链接时需带此 Token。
3. 在 「选择爬虫源」 中勾选要加入该订阅的源（可多选），保存。

2.2 编辑订阅

• 编辑：修改名称、描述、Token，或重新勾选爬虫源（增删源后保存即可生效）。
• 删除：删除订阅后，原有订阅链接将失效，客户端需改用新订阅或其它订阅。

2.3 获取订阅链接

在订阅列表中点击某条订阅的 「查看订阅链接」（链接图标），可看到该订阅在不同客户端下的使用方式：

客户端/协议	说明
TVBox	订阅地址，在 TVBox 等支持该协议的 App 中填入即可。
猫源	需先点击「生成猫源订阅」生成订阅文件，再使用生成的猫源订阅地址。
UZ	需先确认/生成 UZ 订阅文件，再使用生成的 UZ 订阅地址。
Emby	服务器地址为当前站点域名，用户名固定为 omnibox，密码为该订阅的 Token。

复制对应链接或参数到客户端中配置即可；Token 请勿泄露给他人，否则他人可使用你的订阅。

---

三、组合使用流程小结

1. 爬虫源：在「爬虫源」中新建或导入脚本 → 配置环境变量、依赖（如有）→ 启用源 → 需要时用「检查更新」从远端更新脚本。
2. 订阅：在「订阅管理」中新建订阅 → 勾选要包含的爬虫源 → 保存 → 打开「查看订阅链接」复制 TVBox/猫源/UZ/Emby 的地址或参数。
3. 客户端：在 TVBox、猫源、UZ、Emby 等客户端中添加该订阅地址（及 Token），即可在网页、手机、电视等全平台使用这些爬虫源。

如需自己开发或修改爬虫脚本，请参阅 爬虫开发 文档。