94 lines
3.7 KiB
Markdown
94 lines
3.7 KiB
Markdown
# TVBox JSON Monitor
|
||
|
||
[](https://github.com/xixu-me/tvbox-json-monitor/actions/workflows/tvbox-json-monitor.yml)
|
||
|
||
TVBox JSON Monitor 定时抓取一个 TVBox 兼容端点，从 JPEG-like 响应里提取附加的配置载荷，解码为严格 JSON，并在内容变化时自动提交更新。
|
||
|
||
> [!IMPORTANT]
|
||
> 本仓库只保存从配置端点解码得到的 JSON 文件，不托管视频内容，不代理媒体流，也不提供播放服务。
|
||
|
||
## 输出文件
|
||
|
||
| 文件 | 说明 |
|
||
| --- | --- |
|
||
| [`data/tvbox.json`](data/tvbox.json) | 解码并格式化后的 TVBox 配置，保持为标准 JSON。 |
|
||
| [`data/tvbox.meta.json`](data/tvbox.meta.json) | 最近一次抓取与解码的元数据，包括哈希、大小、响应头和源地址。 |
|
||
|
||
推荐使用 [Xget](https://github.com/xixu-me/xget) 加速地址读取最新 JSON：
|
||
|
||
```text
|
||
https://xget.xi-xu.me/gh/xixu-me/tvbox-json-monitor/raw/refs/heads/main/data/tvbox.json
|
||
```
|
||
|
||
也可以直接使用 GitHub raw 地址：
|
||
|
||
```text
|
||
https://raw.githubusercontent.com/xixu-me/tvbox-json-monitor/main/data/tvbox.json
|
||
```
|
||
|
||
## 工作方式
|
||
|
||
上游端点返回给 TVBox 客户端的是一个 JPEG-like payload，真实配置追加在 JPEG EOI 标记 `FF D9` 之后。脚本会按以下步骤处理：
|
||
|
||
1. 使用 TVBox 风格的 `User-Agent` 请求配置端点。
|
||
2. 定位 JPEG EOI 标记 `FF D9`。
|
||
3. 读取 EOI 之后的附加载荷。
|
||
4. 在附加载荷中查找 `**` 分隔符。
|
||
5. 对分隔符之后的内容进行 Base64 解码。
|
||
6. 移除上游配置中的 JSONC 风格整行注释。
|
||
7. 解析并重新序列化为 2 空格缩进的严格 JSON。
|
||
|
||
## 自动更新
|
||
|
||
GitHub Actions 每 12 小时检查一次上游配置，也支持在 Actions 页面手动触发。定时任务使用 UTC 时间运行，当前计划为每天 `00:00` 和 `12:00` UTC。
|
||
|
||
当 `data/tvbox.json` 或 `data/tvbox.meta.json` 有变化时，工作流会提交类似下面的 commit：
|
||
|
||
```text
|
||
chore(tvbox): update decoded JSON 2026-05-13T16:00:00Z
|
||
```
|
||
|
||
如果上游端点临时不可用、返回格式异常或解码失败，本次更新会被跳过，已有数据保持不变，工作流不会因为这类上游问题失败。脚本使用退出码 `75` 标记这类上游问题；仓库变量缺失、脚本错误或文件写入失败等非上游问题仍会使工作流失败。
|
||
|
||
## 依赖更新
|
||
|
||
Dependabot 每周检查 GitHub Actions 依赖并创建更新 PR。仓库通过 `CI` workflow 校验 PR；当 Dependabot PR 关联的所有 checks 都为绿色时，`Dependabot auto-merge` workflow 会自动 squash-merge 该 PR 并删除更新分支。
|
||
|
||
自动合并 workflow 不 checkout PR 代码，也不执行 PR 分支中的脚本；它只读取 PR 元数据和 check 状态，并且只处理作者为 `dependabot[bot]`、目标分支为默认分支的同仓库 PR。
|
||
|
||
## 仓库配置
|
||
|
||
工作流依赖一个 GitHub Actions repository variable：
|
||
|
||
```text
|
||
Name: TVBOX_URL
|
||
Value: https://www.xn--sss604efuw.com/tv/
|
||
```
|
||
|
||
配置路径：
|
||
|
||
```text
|
||
Repository -> Settings -> Secrets and variables -> Actions -> Variables
|
||
```
|
||
|
||
由于工作流需要把生成文件提交回仓库，请确保 Actions 具备写入权限：
|
||
|
||
```text
|
||
Repository -> Settings -> Actions -> General -> Workflow permissions -> Read and write permissions
|
||
```
|
||
|
||
## 本地运行
|
||
|
||
项目只依赖 Python 标准库，可直接运行：
|
||
|
||
```bash
|
||
export TVBOX_URL="https://www.xn--sss604efuw.com/tv/"
|
||
export TVBOX_UA="okhttp/3.15"
|
||
export OUT_JSON="data/tvbox.json"
|
||
export OUT_META="data/tvbox.meta.json"
|
||
|
||
python3 scripts/extract_tvbox.py
|
||
```
|
||
|
||
运行成功后，脚本会更新 `data/tvbox.json` 和 `data/tvbox.meta.json`，并在终端输出本次解码元数据。
|