tvbox

TVBox / 影视仓接口（源）订阅仓库。本身不是软件，只提供可被 TVBox 订阅的接口地址清单。

目录结构

tvbox/
├── D.json                  # 主仓库索引（TVBox「仓库」订阅入口）
├── sources/                # 仓库层：被 D.json 引用
│   ├── 主仓.txt             #   每频道精选 1 个源（28 条）
│   ├── 镜像仓.txt           #   引用 mirror/ 下 12 个接口快照
│   └── 备份仓.txt            #   主仓各频道的其余源，-2/-3 标识（5 条）
│   ├── DL主仓.json          #   多线系列主仓（43 条，原 DL/DL2/DL3/DL4 合并）
│   ├── DL备份仓.json         #   多线系列备份仓（9 条，源 -2/-3 标识）
│   ├── 其他主仓.json         #   多线2/木鱼/自用/吾爱 合并主仓（13 条）
│   ├── 其他备份仓.json        #   对应备份仓（1 条）
│   └── duo.txt             #   备用仓库索引（主仓+镜像仓+备份仓）
│   └── 木鱼.json / 自用仓库.txt / 吾爱仓库.txt / 多线2.json
├── mirror/                 # 接口层：可用接口的内容快照（上游挂掉也能用）
│   ├── manifest.json       #   镜像清单，定义抓取哪些源、存到哪个路径
│   └── *.json              #   12 个接口内容（均含 sites 字段）
├── retired/                # 归档（不参与订阅）
│   ├── 剔除记录.md          #   全部失效线路 + 替代方案 + 失效原因
│   └── 待收录-草稿.txt       #   待验证的新源草稿
└── tools/
    ├── check_sources.py    #   可用性检测工具
    ├── validate_layers.py  #   三层结构校验工具
    └── mirror.py           #   内容快照抓取工具

订阅地址

把下面地址填进 TVBox「仓库」即可：

https://cdn09022024.gitlink.org.cn/api/v1/repos/ddppff/tvbox/raw/master/D.json

层级说明（重要）

TVBox 订阅是严格三层结构，层与层之间不能混用：

层级	文件格式	位置	引用规则
仓库索引层	{"storeHouse":[{sourceName, sourceUrl}]}	D.json	sourceUrl 必须指向仓库层
仓库层	{"urls":[{name, url}]}	sources/*	url 必须指向接口层
接口层	{"sites":[...], "spider":...}	mirror/* 或远端	真正的播放源，只能被仓库层引用

常见错误：

• ❌ 把接口层（含 sites）直接写进 D.json 的 storeHouse
• ❌ 把仓库层（含 urls）塞进 mirror/
• ❌ 仓库层里再引用仓库层（仓库套仓库），TVBox 不会递归解析

用 tools/validate_layers.py 可自动校验全部本地引用。

校验三层结构

python3 tools/validate_layers.py          # 校验所有本地引用
python3 tools/validate_layers.py --json   # 机器可读输出

命名与备份规则

线路名 = 频道名（如 🐼肥猫、🚀俊佬）。规则：

1. 同一文件内名称唯一 —— 一个文件里不会出现两个同名线路。
2. 同名 · 不同源 = 互为备份 —— 同一频道在不同文件里各有一个源， 一个失效可切另一个。例：🐼肥猫 在 精选仓.txt（直连）、 镜像仓.txt（本地快照）、DL.json、DL4.json 各有一份。
3. 同源必须同名 —— 同一个地址在任何文件里都叫同一个名字， 否则看不出它们是同一频道。

查看当前备份矩阵：

python3 tools/validate_layers.py    # 层级
# 备份组（同名不同源）可用下面一行列出
python3 - <<'EOF'
import json,os,re
from collections import defaultdict
d=defaultdict(list)
for f in sorted(os.listdir('sources')):
    raw=open('sources/'+f,encoding='utf-8',errors='replace').read()
    j=json.loads(re.sub(r'^\s*//.*
,'',raw,flags=re.M))
    k='urls' if 'urls' in j else 'storeHouse'
    nk='name' if k=='urls' else 'sourceName'; uk='url' if k=='urls' else 'sourceUrl'
    for it in j[k]: d[it[nk]].append((f,it[uk]))
for n,l in sorted(d.items()):
    if len({u for _,u in l})>1:
        print(f'「{n}」备份于 {len(l)} 处:', ' + '.join(f for f,_ in l))
EOF

地址来源与挖掘

本仓库地址来自三个渠道，均经 tools/check_sources.py 实测：

1. 仓库原有清单（sources/DL*.json 等历史文件）
2. GitHub 活跃接口仓库 —— 抓取 wuxierj/TVBox、 Zhou-Li-Bin/Tvbox-QingNing、qist/tvbox、noimank/tvbox、 gaotianliuyun/gao 等仓库 README 中的地址
3. 本仓库 git 历史 —— 从全部历史 blob 中挖掘曾用地址（可能已恢复）

挖掘脚本思路：tools/check_sources.py --url <地址> 可单条测； 批量见 README 末尾的备份矩阵脚本。

注意：外源地址多为转载，失效极快。收录前必须实测， 且需连测两次（间隔数秒）取交集，避免把网络抖动误判为失效。

维护方式

检测源是否还活着

python3 tools/check_sources.py            # 检测 sources/ 下全部清单
python3 tools/check_sources.py --repos    # 只检测 D.json 里的仓库地址
python3 tools/check_sources.py --file sources/a.txt
python3 tools/check_sources.py --url <地址>
python3 tools/check_sources.py --json     # 机器可读输出

判定口径：

状态	含义
✅ OK	HTTP 200 且解析出 sites / urls / storeHouse 等 TVBox 字段
⚠️ WARN	HTTP 200 但内容是 HTML 页面或无 TVBox 字段
❌ FAIL	超时 / 非 200 / SSL 失败 / 内容损坏 / 域名停放页
⏭ SKIP	指向本仓库自身的地址（推送后才生效）、clan:// 等本地协议

指向本仓库的地址不做网络检测 —— 本地改了必须推送后远端才有， 检测它只会误报失效。同理，影视源抖动频繁，单次 FAIL 未必是真失效， 建议连测两次，取两次都 FAIL 的才算稳定失效。

刷新本地快照

python3 tools/mirror.py            # 按 mirror/manifest.json 重新抓取
python3 tools/mirror.py --dry-run  # 只预览

下线一条线路

1. 从 sources/ 对应清单里删掉该条；
2. 在 retired/剔除记录.md 中记录它（地址 + 失效原因），便于日后源恢复时找回；
3. 若能找到替代，把替代地址写回清单。

当前状态

项目	数量
D.json 仓库入口	10 个（1 个为本地 clan://）
sources/ 仓库文件	15 个
mirror/ 接口快照	26 个
清单内线路总数	112 条
已剔除失效线路	278 条（见 retired/剔除记录.md）

⚠️ 影视源失效极快，通常几周到几个月。建议每隔一段时间跑一次：

python3 tools/check_sources.py     # 看哪些线路死了
python3 tools/validate_layers.py   # 确认层级没错
python3 tools/mirror.py            # 刷新本地快照

说明

• 本仓库只做地址收集与整理，不保证内容的合法性，请自行判断。
• a.txt / b.txt / c.txt 的线路名带「多多」前缀，是原作者为防止商业引流所加，请勿去除。
• 内容镜像仅为可用性备份，版权归各接口原作者所有。