diff --git a/README.md b/README.md
index 77ce59f..6191e18 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,42 @@
-# IPTV 测试
+> ⚠️ **Beta 预览**: 线路以“可探测”状态首批入库,最终“可用且国内实测”榜单每日由流水线自动替换本说明。
-HTTP 推送冒烟测试 v2
+# IPTV 直播源自动更新库
+
+> **最新更新 2026-09-08 07:43:34** · 本仓库由境外服务器每日自动抓取/校验/测速后生成,重启不影响运行。
+
+## 使用地址(直接填入播放器)
+
+| 用途 | 地址 |
+|---|---|
+| M3U 全量(央视/卫视/港澳台/地方/网络) | https://gitea.zzjp.help/zjp/ip/raw/branch/main/all.m3u |
+| TXT 全量 | https://gitea.zzjp.help/zjp/ip/raw/branch/main/all.txt |
+| TVBox 壳/uzn影视 | https://gitea.zzjp.help/zjp/ip/raw/branch/main/tvbox.json |
+| EPG 节目单(XMLTV) | https://gitea.zzjp.help/zjp/ip/raw/branch/main/epg.xml |
+| 台标目录 | https://gitea.zzjp.help/zjp/ip/raw/branch/main/logo/ |
+
+分类文件: cctv.m3u · satellite.m3u · hk_mo_tw.m3u · local.m3u · webcast.m3u(对应各 .txt)。
+
+## 本次统计
+
+- 央视频道: 20 台 / 186 线
+- 卫视频道: 55 台 / 222 线
+- 港澳台频道: 18 台 / 18 线
+- 地方频道(含江苏扬州): 93 台 / 102 线
+- 网络直播: 822 台 / 865 线
+
+## 运作逻辑(每 24h 一轮)
+
+1. **关键词引擎**:用 AI(智谱/硅基) 依据历史命中扩写关键词,写入 `keywords` 表。
+2. **多渠道抓取**:GitHub/Gitee 代码搜索、Telegram 群组频道(账号检索)、tvbox 接口、主流社区仓库/博客。
+3. **解析入库**:m3u/txt/tvbox json 统一解析,按频道字典归一化后写入 SQLite(断点续跑)。
+4. **淘汰机制**:数据源 10 天无产出降权再淘汰;播放源连续失败冷却后进复活池、10 天无存活删除;假源标记隔离。
+5. **校验**:HTTP 存活 + ffprobe 深度(编码/分辨率/码率) + AI 抽帧甄别假源/录像/错台(每日限量, 仅疑点)。
+6. **国内测速**:候选源下发码云 `zhoupeng8324/cs` 仓库,Gitee Go 国内节点实测延迟/速率并回写。
+7. **分类排序**:央视/卫视/港澳台/地方台/网络直播五类,每台最多 6 条线路按国内速度升序。
+8. **生成产物**:m3u/txt/tvbox.json + epg.xml(每日多源刷新) + 台标;注入 tvg-id/台标, 信息齐全。
+9. **同步发布**:推送到本仓库(Gitea)与码云测速仓库;Telegram 推送更新明细,README 最新信息置顶。
+
+## 说明与免责
+
+- 内容仅收集自公开互联网,仅供个人学习测试,请于 24h 内删除;版权归各电视台/平台所有。
+- 播放源具有时效性,若失效通常次轮自动剔除并补充新线路。