mirror of
https://github.com/Silent1566/webhtv.git
synced 2026-11-17 18:56:13 +00:00
- Spider.java: 依赖取回失败改为 catch (Throwable) 并补无条件 e.printStackTrace(), SpiderDebug.log 经 DebugLogStore.acceptsTag 门控(调试日志默认关),只靠它会让 「依赖被跳过」在默认配置下不可见(同 PyLoader 的既有理由)。 - app.py: download() 状态门槛 >=400 改 >=300,避免跳转链走不尽时的跳转占位正文 被写入缓存;新增 '://' 分支,带 scheme 的非 http 源直接报错而不再把 URL 文本 当脚本缓存;manualVideoCheck/isVideoFormat 抽公共 optionalBool(),去掉同一模板 的两份拷贝。 - test_app_bridge_contract.py: 补 4xx、跳转走不尽的 3xx、file:// scheme 三个用例; 契约测试改为显式 REQUIRED(18) + 双向断言,不再由 Java 源码自证(原写法删掉最后 一个 callAttr 即可让集合变空)。 - docs: extensions.md / spider.md 同步日志通道、>=300 与 scheme 语义;任务文档补 第 2/3 轮评审与变异验证记录。 Verification: 双轴评审 3 轮:第1轮 3 项必修(Logcat 无门控通道、catch(Throwable)、契约集合反自证)已修;第2轮 3 项(注释事实、optionalBool 去重、文档例外)已修;第3轮变异验证(>=300 回退 -> failures=1;删 :// 分支 -> failures=1;callAttr download 改名 -> failures=2)证明断言有效。python -m unittest discover -s chaquo/src/test/python = Ran 49 tests OK;git diff --check CLEAN;:chaquo:compileArm64_v8aDebugJavaWithJavac BUILD SUCCESSFUL in 27s。 Task-Guard: PY-BRIDGE-DEPEND-01-review-fix Verification: 双轴评审 3 轮:第1轮 3 项必修(Logcat 无门控通道、catch(Throwable)、契约集合反自证)已修;第2轮 3 项(注释事实、optionalBool 去重、文档例外)已修;第3轮变异验证(>=300 回退 -> failures=1;删 :// 分支 -> failures=1;callAttr download 改名 -> failures=2)证明断言有效。python -m unittest discover -s chaquo/src/test/python = Ran 49 tests OK;git diff --check CLEAN;:chaquo:compileArm64_v8aDebugJavaWithJavac BUILD SUCCESSFUL in 27s。 Task-Guard: PY-BRIDGE-DEPEND-01-review-fix |
History
|
|
|---|---|---|
| .. | ||
| configuration.md | ||
| danmaku.md | ||
| extensions.md | ||
| live.md | ||
| parser.md | ||
| player.md | ||
| proxy-server.md | ||
| README.md | ||
| result-vod.md | ||
| spider.md | ||
| subtitle.md | ||
| vod-site.md | ||
WebHTV 开发者接入文档
本目录只记录当前仓库代码实际支持的接入能力。字段、默认值、调用链、返回协议和错误处理以源码为准。
索引
- 总配置接入:顶层配置、网络规则、Doh/Proxy/Headers/Rules。
- 点播源接入:Site 字段、站点类型、WebHome chrome、验证清单。
- Spider 接入协议:Java/JAR、JS、Python、CatSpider 与生命周期。
- Result 与 Vod 返回协议:列表、分类、筛选、详情和线路结构。
- 直播源接入:TXT/M3U/JSON/Spider、Group、Channel、Catchup、EPG、DRM。
- 解析器接入:解析类型、
ext.flag/header、playUrl前缀。 - 字幕接入:Spider
subs、格式、鉴权和局域网注入。 - 弹幕接入:Spider
danmaku、来源字段和注入。 - 播放结果与播放器接入:播放字段、多 URL、DRM、错误处理。
- 本地代理与服务端接口:本地服务、Spider proxy、Action 和端点。
- 扩展包接入:JAR/JS/Python/CatSpider 加载与验证。
推荐阅读顺序
- 总配置接入
- 根据场景读 点播源接入 或 直播源接入
- Spider 接入协议 与 Result 与 Vod 返回协议
- 播放结果与播放器接入,需要时读解析、字幕、弹幕和代理
- 使用非 Java 运行时读 扩展包接入
源码总览
- 配置:
app/src/main/java/com/fongmi/android/tv/api/config/ - Bean/协议模型:
app/src/main/java/com/fongmi/android/tv/bean/ - Spider 接口:
catvod/src/main/java/com/github/catvod/crawler/Spider.java - 运行时:
app/src/main/java/com/fongmi/android/tv/api/loader/、quickjs/、chaquo/ - 本地服务:
app/src/main/java/com/fongmi/android/tv/server/
更完整的 WebHome、管理页面、观影记录同步和构建说明见仓库根目录 README.md 和 webhome-devkit/docs/应用完整开发文档.md。