# 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 线 · 卫视频道: 29 台 / 37 线
- 港澳台: 3 台 / 3 线 · 江苏地方: 29 台 / 37 线 · 网络直播: 186 台 / 193 线
- 全库有效线路: 298 线；严格稳定: 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 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 境内外均不可达, 暂无可走通的列表站, 通道已就绪备用)

- **2026-09-09 08:32 · 运行稳定性 + 三账号国内测速分片**
  · 修复 iptv-scraper.service 被 SIGTERM 连杀 8 次(oneshot 并发冲突): flock 防并发 + MemoryHigh/Max + OOMScoreAdjust, 完整一轮不再中断。
  · validate 分批 200/轮 + gc; HTTP=1/ffprobe=0 资源收紧; webcast 去虚胖(max 2 线+最低样本)。
  · 严格保真门槛临时放宽(样本≥2/P30≥2500/最低≥1500) 以让 verified 起量, 后续样本充足可收紧。
  · 国内测速扩展为码云三账号并行分片: zhoupeng8324/cs、fazhiyuan/css、zhou-jiepeng/csss; 1800 候选 3×600 一次跑完, 国内指标源 272→512。
  · Telegram 采集改公开白名单(8 频道)+megagroup 支持; 新增 Collect-IPTV(zilong7728) 数据源。

- **2026-09-09 08:32 · 初版构建上线**
  境外服务器 9 阶段流水线(init→keywords→collect→validate→speedtest→epg→generate→sync→notify)每日自动抓取并发布。
  数据源: 社区 M3U/TVBox(递归展开)/Git 代码搜索/网页种子; 产物单入口 all.m3u+tvbox.json+epg.xml; 台标/EPG 日更。

## 说明与免责

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