StudyOnTV README

项目的 README,来自 github.com/chadyi/StudyOnTV。合并为一个 markdown 文件:README.md。

题了个题 · 平板 / 手机 / TV

先学再看 · 让每一点进步被看见

Learn first. Watch later. · 支持Android 平板、手机和电视,不需要自建服务器

Stars Release Website Platform License


安装

Android 平板、手机和电视使用同一套规则,分别安装对应版本:

如果无法访问 GitHub,可使用蒲公英备用下载:

手机和平板直接下载安装;电视可通过 U 盘或 ADB 安装。首次打开设置管理密码,权限可以按需开启,也可以稍后再设置。

👉 安装指南 → docs/install.md


它能做什么

孩子先完成学习任务,再解锁设备使用时间,到时显示新的学习任务。平板和手机支持触屏、公式、语音输入与手写,电视支持遥控器。题库、规则、使用记录和加练池都保存在被控设备。

玩法说明 · 新增需求使用说明 · 后台恢复与 tv-vigil 分析 · iPad / 旧 Android / MAXHUB 支持范围 · 题库与批改 API · 家庭自动化联动 · 与 Home Assistant 联动 · 示例题库 · 题库格式参考

管理页面由被控设备在局域网内提供。离线题目直接在设备上完成;AI 批改需要网络和家长配置的服务。


截图

平板公式与主观题作答
平板学习 · 公式、文字与手写作答

平板手写作答
手写过程可提交家长、Agent 或图像模型批改

手机公式与主观题作答
手机学习 · 与平板共用题库和规则
家长批改与 AI 设置
家长批改与 AI 设置

电视端答题
遥控器选题,答完在下方显示对错、正确答案与解析



家长扫码连接
家长用手机扫码,同一个 WiFi 即可管理



未到可用时段
未到可用时段时停留提示页,显示下次可用日期和时间



按周设置可用时间
按周设置可用时间,节假日可同步
题库表格与 AI 出题
题库表格 · AI 出题
使用记录
7天使用记录

电脑上的家长管理面板
电脑管理 · 规则、题库、批改与学习记录


家长能设置什么

设置项 说明
每天最多看 超出后当天锁死,第二天重置
每次答题解锁 一组题答完解锁几分钟
每组题量 一组几道题
答对比例 答对多少题才算通过(百分比)
每天最多答几组 答完上限即锁定
时间规则 时段内答题解锁,时段外锁定或自由看;按周设置,半小时一格,可选节假日按周日时间;时区可单独指定
系统设置保护 管控期间拦截,家长验证后临时放行;需无障碍或悬浮窗配合使用情况访问
间隔重复 开启后优先抽取到期复习题,再补新题
错题优先 答错的题优先再出,加练题从错题里选;答对一次后回到正常顺序
玩法 按组闯关、连续答对、自由练习
星级奖励 分别设置 1–5 星每题奖励
答错加练 累计错误阈值与每次加练题量
主观题批改 家长 / Agent 或 AI API,支持及格分与评分标准

题库


它是怎么工作的

被控设备 App(手机 / 平板包,独立 TV 包)
├── 内置网页:答题 / 锁屏 / 扫码页(离线可用)
├── 内置 HTTP 服务:局域网 8099 端口
└── 本地 SQLite:规则 + 题库 + 事件记录

手机端
└── 扫二维码 → http://<设备IP>:8099/admin/ → 输入管理密码

管理密码在首次使用时设置。扫码只打开地址,面板和 API 都需要验证;没有项目自建云端和账号体系。


FAQ

Q:孩子把 App 强退了怎么办? A:可以按设备条件开启悬浮窗或无障碍,并允许后台运行。系统强制停止应用、撤销权限或卸载会影响管控;重新打开后可以在家长设置中调整权限。

Q:支持开机自启动吗? A:已接入 Android 开机与部分快速开机广播。请先打开 App 完成首次设置,并按厂商要求允许自启动、后台运行。小米等电视的遥控器待机、厂商清后台未必发送开机广播,需要在实际设备上验证,详见 安装指南。

Q:支持哪些设备? A:Android 5.0+ 的平板、手机和电视。厂商后台限制需要在实际设备上确认,鸿蒙 NEXT / Tizen / webOS 待支持。

Q:数据会传到网上吗? A:题库和记录保存在被控设备。开启 AI 批改后,题目和答案会发送到家长配置的服务;项目中已有的第三方统计配置另见 统计说明。

Q:更换电视会丢数据吗? A:题库可以在手机管理页导出 JSON,换电视后重新导入。


技术栈

层 技术
Android 原生 Kotlin,零第三方依赖
学习页面 原生 ES5 + CSS,兼容老 WebView
手机管理页 React + shadcn/ui
本地存储 SQLite(Android 内置)
局域网通信 Kotlin ServerSocket,HTTP/1.1

交流群

家长交流微信群二维码

家长交流群 · 使用问题、设备兼容和功能建议都可以在群里聊
微信群二维码 7 天内有效,过期请在 Issues 留言索取;也欢迎直接在 Issues 里反馈


社区建议与致谢

这些建议也延伸到其他端,欢迎反馈使用体验。


本项目已链接并认可 LINUX DO 社区。

License

源码可查阅,仅限个人家庭使用,禁止商业用途和二次分发。欢迎 Issue 反馈问题。

商业授权请通过 GitHub Issues 联系作者。

StudyOnTV (chadyi/StudyOnTV)

正在搜索数据库…

这是什么?一款开源的 Android 应用,适用于电视、平板和手机,要求孩子先答题,才能解锁屏幕使用时间。应用完全在设备本地运行,没有服务器,也不需要账号。家长可以在同一 Wi-Fi 下,通过手机或电脑管理题目和规则。
这是要安装的应用,还是要自己搭建的服务器?这是安装在被管控设备上的应用,无需搭建服务器:题库、规则和使用记录都直接保存在设备本身。
电视上怎么安装?手机和平板可直接从 GitHub 或蒲公英(Pgyer)链接安装 APK。电视端需通过 U 盘或 ADB 安装。首次启动时设置管理员密码,权限之后再授予即可。
支持哪些设备?Android 5.0 及以上版本的平板、手机和电视。HarmonyOS NEXT、Tizen 和 webOS 暂不支持,各厂商的后台限制需要在每台真实设备上分别检查。
它和普通的屏幕时间限制工具有什么不同?屏幕时间是靠答题赚来的,而不只是被限制。孩子通过答题解锁时长;1 到 5 星的题目对应不同奖励;答错会增加额外练习题,这些题会跨天和重启保留。
电视在学习时段之外能自由使用吗?可以。‘answer-required’ 时段模式只要求时段内答题,时段外电视可以自由使用,且不扣除余额,因此祖父母白天可以看电视,晚上则执行锁定。
支持公式、手写和语音输入吗?支持。题干和选项支持 LaTeX 公式,离线也能显示。平板和手机支持触屏、语音输入和手写,电视则使用遥控器操作。
开放式答案能自动批改吗?可以,有多种选择:家长可以手动批改,也可以由 Codex 等智能体批改,或者配置兼容的 AI 接口,如 DeepSeek 或通义千问(Qwen)。
作者
chadyi
大小
13.9 MB
星标
1.7K
时长
17天
提交 · 90 天