0
Fork 0
mirror of https://github.com/Silent1566/webhtv.git synced 2026-11-17 18:56:13 +00:00
webhtv-mys/docs/integration
Silent1566 8ef4dbf34f review(PY-BRIDGE-DEPEND-01): 修复评审必修项并加固依赖下载契约
- 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 2026-10-24 02:52:11 +08:00
..
configuration.md docs: expand developer integration guides 2026-09-21 14:01:20 +08:00
danmaku.md docs: expand developer integration guides 2026-09-21 14:01:20 +08:00
extensions.md review(PY-BRIDGE-DEPEND-01): 修复评审必修项并加固依赖下载契约 2026-10-24 02:52:11 +08:00
live.md docs: 修正开发者接入文档与当前源码不一致的描述 2026-09-21 14:10:39 +08:00
parser.md docs: 修正开发者接入文档与当前源码不一致的描述 2026-09-21 14:10:39 +08:00
player.md docs: expand developer integration guides 2026-09-21 14:01:20 +08:00
proxy-server.md docs: 修正开发者接入文档与当前源码不一致的描述 2026-09-21 14:10:39 +08:00
README.md docs: expand developer integration guides 2026-09-21 14:01:20 +08:00
result-vod.md docs: expand developer integration guides 2026-09-21 14:01:20 +08:00
spider.md review(PY-BRIDGE-DEPEND-01): 修复评审必修项并加固依赖下载契约 2026-10-24 02:52:11 +08:00
subtitle.md docs: expand developer integration guides 2026-09-21 14:01:20 +08:00
vod-site.md docs: 修正开发者接入文档与当前源码不一致的描述 2026-09-21 14:10:39 +08:00

WebHTV 开发者接入文档

本目录只记录当前仓库代码实际支持的接入能力。字段、默认值、调用链、返回协议和错误处理以源码为准。

索引

推荐阅读顺序

  1. 总配置接入
  2. 根据场景读 点播源接入 或 直播源接入
  3. Spider 接入协议 与 Result 与 Vod 返回协议
  4. 播放结果与播放器接入,需要时读解析、字幕、弹幕和代理
  5. 使用非 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。