TVBoxOSC 上手指南：不编译也能拿到最新电视盒子版 TVBox-迪斯科星球

TVBoxOSC 上手指南：不编译也能拿到最新电视盒子版 TVBox

【免费下载链接】TVBoxOSCTVBoxOSC - 一个基于第三方项目的代码库，用于电视盒子的控制和管理。项目地址: https://gitcode.com/GitHub_Trending/tv/TVBoxOSC

TVBoxOSC 是 TVBoxOS/Box 电视盒子应用的构建分发仓库：CI 每天跟踪两个上游，有更新就自动构建签名 APK 并发布到 Release。不编译的用户直接装最新 APK；想自托管构建流程的，这里提供完整流水线。

项目速览：替你把 TVBox 编好的分发仓库

TVBoxOSC 本身不存应用源码，仓库里只有 README、签名材料和 CI 配置。每天按59 6 * * *定时检查 q215613905/TVBoxOS 与 takagen99/Box 两个上游的 main 分支，发现新提交就克隆源码、注入签名与版本号，执行assemblerelease构建，再把 APK 与源码包发到 Release 并推送 Telegram。当前同步到的上游提交记录在 README.md 的 "Updated:" 行。

功能	说明	适用场景
上游跟踪自动构建	监控两个上游 main 分支，有新提交自动重建并发布新版	不自己编译，只取最新 APK
双分支矩阵构建	同时构建 TVBoxOS 与 Box 两条线，Box 线用 Java 17，文件名带上游用户名	按习惯选择分支线
统一签名与版本标记	构建时注入签名配置（密钥库 TVBoxOSC.jks，别名与密码均为 TVBoxOSC），tag 取上游提交时间，格式`%Y%m%d-%H%M`	核对版本来源
Release 附 changelog	用两次提交间的 git log 生成 Changelog，写入 Release 说明	升级前确认本版改了什么
手动干预开关	workflow_dispatch 提供`rebuild`、`donotpublish`两个输入	强制重建，或只构建不发布

典型使用场景

电视盒子换新包：从 Release 取最新版

背景：上游常有新提交，自己跑 Gradle、配签名很麻烦，这个仓库把构建自动化了。操作：看 README.md 的 "Updated:" 行确认两条线各自同步到的提交，再到项目 Release 页面下载 tag 最新的TVBox_<上游名>_<构建时间>.apk，拷到盒子安装。效果：装好打开应用"关于"页，能看到构建时注入的日期，与 APK 文件名对得上。

升级前核对：changelog 怎么看

背景：想确认某个 APK 基于哪个上游提交、具体改了什么。操作：打开对应 Release 的说明，读 Credit（上游出处）、Commit（提交哈希）、Changelog 三部分。效果：把 Commit 与 README.md 里 "Updated:" 的哈希比对，就能确认该版本是否为当前同步点。

自托管构建：流水线怎么读

背景：想改构建时间、签名或上游分支，再自己部署。操作：克隆仓库后读 .github/workflows/test.yml，重点看 matrix（两个上游与 Java 版本）、签名注入段和构建命令；Telegram 推送逻辑在 .github/scripts/upload.py。效果：改 schedule 的 cron 或矩阵项，构建行为随之变化；签名换成自己的密钥库即可复用。

最短上手路径

获取仓库

git clone https://gitcode.com/GitHub_Trending/tv/TVBoxOSC

拿到流水线与同步记录，在 README.md 里查两条线各自最新的上游提交。

安装运行

adb install TVBox_上游名_构建时间.apk

把 Release 页面中 tag 最新的 APK 传到电视盒子，用 adb 或文件管理器安装。

首次验证

git log --oneline -1

最新提交信息就是上游提交哈希，用它核对已装 APK 的版本是否来自当前同步点。

关键配置解读

配置项	位置	默认行为	何时修改
schedule cron	.github/workflows/test.yml 的 on.schedule	`59 6 * * *`，每天 6:59 检查上游	想换检查时间
`rebuild`	workflow_dispatch 输入	不勾选；上游无新提交则跳过构建	想忽略构建记录强制重建
`donotpublish`	workflow_dispatch 输入	不勾选；构建成功自动发布新 Release	只想构建验证、不发布
签名配置	gradle.properties（构建时注入）	密钥库 .github/workflows/TVBoxOSC.jks，`RELEASE_KEY_ALIAS=TVBoxOSC`，密码同为`TVBoxOSC`	自托管时换自己的密钥库
crosswalk 镜像	build.gradle（构建时注入）	自动追加备用镜像源，防源挂掉	一般无需修改

高频坑点

仓库里找不到应用源码。现象：克隆后只有 README.md 和 .github 目录。原因：应用源码是构建时从上游动态克隆的，仓库只存流水线。解决：源码以sourceCode-<提交哈希前7位>.tar.xz压缩包随 Release 发布，需要看源码时解压它。
版本号像时间戳。现象：tag 形如20260716-0936。原因：tag 取上游提交时间，格式%Y%m%d-%H%M。解决：按日期判断新旧，不要按数字大小比较版本。
同一版本有两个 APK。现象：Release 里出现两个包。原因：矩阵同时构建 q215613905/TVBoxOS 与 takagen99/Box 两条线。解决：按文件名TVBox_<上游名>_<tag>.apk前缀选择，并对照 README 中该上游的 "Updated:" 哈希。
好几天没有新版。现象：Release 长时间不更新。原因：只有上游 main 出现新提交才触发构建。解决：等上游更新，或手动触发 workflow 并勾选rebuild。

下一步看项目的 Release 页面（最新 APK、源码包与 changelog）和 README.md 的 Credits（上游出处）；构建细节在 .github/workflows/test.yml，社区渠道见 README 标注的 Telegram 频道。

【免费下载链接】TVBoxOSCTVBoxOSC - 一个基于第三方项目的代码库，用于电视盒子的控制和管理。项目地址: https://gitcode.com/GitHub_Trending/tv/TVBoxOSC

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析