# IPTV 直播源自动更新库

> **程序特点**: 境外服务器每日自动抓取 → 逐级甄选 → 国内真实测速 → 原子发布。全流程零常驻 Web 服务依赖，天然适配 2GB 小内存机器。

## 使用地址(直接填入播放器)

| 用途 | 地址 |
|---|---|
| 通用 M3U（TiviMate / Kodi / VLC / IPTV播放器） | <code>https://gitea.zzjp.help/zjp/ip/raw/branch/main/all.m3u</code> |
| TVBox 壳/影视类应用 | <code>https://gitea.zzjp.help/zjp/ip/raw/branch/main/tvbox.json</code> |
| EPG 节目单(XMLTV) | <code>https://gitea.zzjp.help/zjp/ip/raw/branch/main/epg.xml</code> |
| 台标目录 | <code>https://gitea.zzjp.help/zjp/ip/raw/branch/main/logo/</code> |
| 运行状态页 | <code>https://zz.zzjp.help/iptv-status/</code> |

单一 M3U 内按“央视频道 / 卫视频道 / 港澳台频道 / 江苏地方频道 / 网络直播”分组；地方频道仅保留江苏省内行政区市县电视台。

## 实现结果(最近一次运行)

- 央视频道: 18 台 / 28 线 · 卫视频道: 25 台 / 32 线
- 港澳台: 3 台 / 3 线 · 江苏地方: 6 台 / 7 线 · 网络直播: 0 台 / 0 线
- 全库有效线路: 70 线；严格稳定: 132 台 / 144 线
  （近 5 次国内测速≥2 次、P30≥2500kbps、最低≥1500kbps；仅用于排序与淘汰，单入口发布不拆分）

## 运作逻辑(每 24h 一轮)

1. **关键词引擎**：AI(智谱/硅基) 依据历史命中扩写关键词，写入 `keywords` 表。
2. **多渠道抓取**：主流社区仓库(TXT/M3U)、tvbox 接口(递归展开)、Gitee/GitHub 代码搜索、Telegram 公开频道/大群白名单增量(仅读已登记实体，防 FloodWait)。
3. **解析入库**：m3u/txt/tvbox json 统一解析，按频道字典+AI 兜底归一化后写入 SQLite；外省地方台丢弃；点播/静态文件(.mp4 等)拒收。
4. **淘汰机制**：数据源 10 天无产出降权再淘汰；播放源“死亡”改由**国内测速**驱动(境外连不上/HTTP 失败不再累计失败次数，防误杀国内源)；连续失败≥3 次并冷却 3 天进复活池；10 天无存活删除；假源隔离删除。
5. **校验甄选**：HTTP 存活 + ffprobe 深度(编码/分辨率/码率)。深检与 AI 抽帧甄别优先作用于“国内测速已 playable”的源；CCTV/卫视/港澳台每日限量抽帧辨台标/录像/错台。
6. **国内真实测速**：码云 Gitee Go 多账号(zhoupeng8324/cs、fazhiyuan/css、zhou-jiepeng/csss)并行分片执行；单在途批次状态机、v2 协议(批次摘要+URL 哈希)防旧结果/错批污染；结果以“国内可播”为准恢复 active 与严格状态。
7. **稳定排序**：速度采用稳定度(变异系数)优先 → 国内测速通过 → active 的分层排序；严格稳定基于历史窗口(P30+最低值+样本数)，连续低质才降级。
8. **生成产物**：`out.next` 快照原子切换；单入口 all.m3u + tvbox.json + epg.xml + 台标；CCTV 自然序；防盗链 UA/Referer 按来源透传。
9. **同步发布**：推送到本仓库(Gitea zjp/ip)；Telegram 推送更新明细与推荐地址。
10. **更新日志**：每次自动运行与每次代码优化都会在下方“更新记录”追加一条，形成可回溯的软件更新说明。

## 播放与回放

- 通用 M3U 兼容 TiviMate、Kodi、VLC 与常见 IPTV 播放器；TVBox 使用独立 JSON。两者均按频道分组，央视以 1、2、3…10、11 自然顺序排列。
- 节目单由 EPG XMLTV 提供，**不等同于回放**。仅当源数据明确带有 <code>catchup="append"</code> 与 <code>catchup-source</code> 时，导出条目才会保留时移参数；支持该规范的播放器可按自身设置尝试回放。
- 本项目不会猜测、伪造或绕过运营商时移/订阅/地区限制；没有显式回放参数的频道只提供直播与节目单。

## 更新记录(自动, 最新在上)

- **2026-09-09 17:23:59 · 自动运行更新 #20260909163841**
  自动运行 #20260909163841（2026-09-09 17:23:59）：
  央视 18台/28线 · 卫视 25台/32线 · 港澳台 3台/3线 · 江苏地方 6台/7线 · 网络直播 0台/0线
  全库有效 70 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 15:04 · 实时进度百分比升级**
  各阶段进度现在按实际文件、线路或频道数量计算；线路验证按本轮待处理线路实时回写，采集按已发现/已处理条目回写，EPG按频道数回写，生成按三个子步骤回写；无法精确计数的阶段使用历史耗时估算。修复阶段完成时覆盖真实计数的问题，并完成运行态、编译和线上 API 验证。

- **2026-09-09 14:38:52 · 自动运行更新 #20260909133700**
  自动运行 #20260909133700（2026-09-09 14:38:52）：
  央视 18台/28线 · 卫视 25台/32线 · 港澳台 3台/3线 · 江苏地方 6台/7线 · 网络直播 0台/0线
  全库有效 70 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 14:25 · 控制台中文界面与实时阶段进度修复**
  修复 IPTV 控制台中文显示、红绿运行灯、九阶段实时进度卡片、TV Logo、红黑科技风格和按钮反馈；修复 /iptv-ops/ 反代 API 路径、旧模板重复脚本和手动来源失败时误清空表单问题。已通过线上状态接口、主页/详情页、favicon、阶段数量和非法来源中文错误响应验证。

- **2026-09-09 13:23 · 来源新鲜度、Git/TVBox 扩展与实时控制台升级**
  来源增加上游更新时间、首次发现、最近成功、抓取历史和多来源关联，稳定但内容不变的来源不再误退役；GitHub/Gitee 改为目录树递归发现最新 m3u/m3u8/txt/json/php；TVBox lives 支持深度3和预算保护递归；新增私有实时运行态和控制台主页进度/红绿灯/详情页/人工数据源入口。已通过全包编译、数据库迁移、控制台 HTTP/API、非法地址和运行态读写自检。

- **2026-09-09 13:04:26 · 自动运行更新 #20260909130426**
  自动运行 #20260909130426（2026-09-09 13:04:26）：
  央视 18台/28线 · 卫视 25台/32线 · 港澳台 3台/3线 · 江苏地方 6台/7线 · 网络直播 0台/0线
  全库有效 70 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 11:41:36 · 自动运行更新 #20260909114006**
  自动运行 #20260909114006（2026-09-09 11:41:36）：
  央视 18台/28线 · 卫视 25台/32线 · 港澳台 3台/3线 · 江苏地方 6台/7线 · 网络直播 0台/0线
  全库有效 70 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 11:40 · 非目标历史线路已隔离**
  按新分类口径补扫历史库，额外隔离1035条不属于电视台或认可主流网络直播的线路；累计人工/规则隔离1571条。已重新发布默认产物：all.m3u、TVBox 仅保留国内真实媒体下载测速达标线路。

- **2026-09-09 11:35:56 · 自动运行更新 #20260909113425**
  自动运行 #20260909113425（2026-09-09 11:35:56）：
  央视 18台/28线 · 卫视 29台/37线 · 港澳台 3台/3线 · 江苏地方 29台/37线 · 网络直播 186台/193线
  全库有效 298 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 11:33 · 国内实测质量发布与私有控制台**
  默认 all.m3u/TVBox 改为仅发布国内真实媒体下载成功、active 且下载速率达标的 IPv4 线路；已隔离用户国内播放失败的 tv.cnbeijing.xyz 与非目标咪视界域名。三码云探针升级为 HLS 实际媒体读取(上限2MiB)，同域熔断跳过不再计入失败。网络直播仅保留斗鱼/虎牙/B站/抖音/快手并排除回放景区等；江苏地方模糊命中需有电视台/融媒体业务语义。新增私有控制台 https://zz.zzjp.help/iptv-ops/，可查看关键词/日志/探针并受控启动、停止、更新EPG和屏蔽错误URL。

- **2026-09-09 11:28:19 · 自动运行更新 #20260909112645**
  自动运行 #20260909112645（2026-09-09 11:28:19）：
  央视 18台/28线 · 卫视 29台/37线 · 港澳台 3台/3线 · 江苏地方 29台/37线 · 网络直播 186台/193线
  全库有效 298 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 11:17:06 · 自动运行更新 #20260909111532**
  自动运行 #20260909111532（2026-09-09 11:17:06）：
  央视 21台/215线 · 卫视 47台/245线 · 港澳台 57台/70线 · 江苏地方 97台/107线 · 网络直播 879台/941线
  全库有效 1578 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 11:13:05 · 自动运行更新 #20260909111126**
  自动运行 #20260909111126（2026-09-09 11:13:05）：
  央视 21台/215线 · 卫视 47台/245线 · 港澳台 57台/70线 · 江苏地方 97台/107线 · 网络直播 879台/941线
  全库有效 1578 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 11:11:42 · 自动运行更新 #20260909111021**
  自动运行 #20260909111021（2026-09-09 11:11:42）：
  央视 21台/215线 · 卫视 47台/245线 · 港澳台 57台/70线 · 江苏地方 97台/107线 · 网络直播 879台/941线
  全库有效 1578 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 11:10:46 · 自动运行更新 #20260909110915**
  自动运行 #20260909110915（2026-09-09 11:10:46）：
  央视 21台/215线 · 卫视 47台/245线 · 港澳台 57台/70线 · 江苏地方 97台/107线 · 网络直播 879台/941线
  全库有效 1578 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 11:06:35 · 自动运行更新 #20260909110504**
  自动运行 #20260909110504（2026-09-09 11:06:35）：
  央视 21台/215线 · 卫视 47台/245线 · 港澳台 57台/70线 · 江苏地方 97台/107线 · 网络直播 879台/941线
  全库有效 1578 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 09:30 · Telegram 私有白名单支持**
  采集器白名单现支持管理员显式提供的 t.me/+邀请链接：私有频道/大群以 peer_id、access_hash 和 last_message_id 增量读取，邀请哈希不入库、不输出；仍拒绝普通小群与私聊。已加入自建「zjp 仓库」私有大群并实测读取 24 条含资源链接的消息。

- **2026-09-09 09:01 · Telegram 通知字段中文化**
  notify.build_stats_text「本次变动」的计数 key 由英文改为中文标签(新增直播线路/深度校验通过/下发国内测速候选/央视线路等); 嵌套 dict 亦汉化: generated 渲染为「央视21台、卫视61台…」, probe_push 压缩批次号为码云仓库并译状态(css:已推送), probe_waiting 同压缩。仅影响展示, 内部计数与 README 快照不变。

- **2026-09-09 08:51:29 · 自动运行更新 #20260909083350**
  自动运行 #20260909083350（2026-09-09 08:51:29）：
  央视 21台/284线 · 卫视 61台/378线 · 港澳台 61台/76线 · 江苏地方 102台/113线 · 网络直播 1106台/1263线
  全库有效 2114 线；严格稳定 132台/144线。主要入口 all.m3u / tvbox.json / epg.xml 已同步更新。

- **2026-09-09 08:32 · 智能甄选升级(方案 A/B/C/D)**
  A. 深检/视觉AI 聚焦“国内测速 playable”源, 资源投向真正会发布的线路。
  B. 播放源死亡改由国内测速驱动: 境外连不上/HTTP 失败不再累计 fail_count(防误杀 cmvideo 等国内源)。
  C. 线路排序加入稳定度(CV 变异系数): 稳定高速 → 国内测速 → active。
  D. 国内抓取(fetch)通道修复: 回传按请求 URL 覆盖校验防旧结果误判; cs 流水线补 hostGroupID。(实测 freetv.fun / tv.iill.top 境内外均不可达, 暂无可走通的列表站, 通道已就绪备用)

## 说明与免责

- 内容仅收集自公开互联网，仅供个人学习测试，请于 24h 内删除；版权归各电视台/平台所有。
- 播放源具有时效性，若失效通常次轮自动剔除并补充新线路。