StudyOnTV README

The project's README from github.com/chadyi/StudyOnTV. As one markdown file: README.md.

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

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

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

Stars Release Platform License


安装

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

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

👉 安装指南 → docs/install.md


它能做什么

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

玩法说明 · 题库与批改 API · 示例题库

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


截图

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

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

手机公式与主观题作答
手机学习 · 与平板共用题库和规则

家长批改与 AI 设置
家长批改与 AI 设置

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



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



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



规则设置
规则设置
题库管理
题库管理
使用记录
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

社区建议与致谢

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


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

License

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

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

StudyOnTV (chadyi/StudyOnTV)

Searching Database…

What is this?An open-source Android app for TVs, tablets and phones that makes kids answer questions before they unlock screen time. It runs entirely on the device, with no server and no account. Parents manage questions and rules from a phone or PC on the same Wi-Fi.
Is it an app I install, or a server I have to host?It is an app you install on the device being controlled. There is no server to host: question banks, rules and usage records are stored on the device itself.
How do I install it on a TV?Phones and tablets install the APK directly from GitHub or the Pgyer (蒲公英) links. On a TV, install it via USB drive or ADB. On first launch you set an admin password, and permissions can be granted later.
Which devices are supported?Android 5.0+ tablets, phones and TVs. HarmonyOS NEXT, Tizen and webOS are not supported yet, and vendor background restrictions have to be checked on each real device.
How is it different from a plain screen-time limiter?Screen time is earned rather than just capped. Kids answer questions to unlock minutes, stars set different rewards for 1-5 star questions, and wrong answers add extra practice questions that persist across days and restarts.
Can the TV be used freely outside the study slots?Yes. The 'answer-required' slot mode only requires questions inside its window and leaves the TV free outside it without deducting balance, so grandparents can watch during the day while the lock applies in the evening.
Does it support formulas, handwriting and voice input?Yes. Question stems and options support LaTeX formulas that display offline. Tablets and phones support touch, voice input and handwriting, while TV uses the remote control.
Can open-ended answers be graded automatically?Yes, with options: a parent can grade manually, an agent such as Codex can grade them, or a compatible AI API such as DeepSeek or Qwen can be configured.
Creator
chadyi
Size
7.3 MB
Stars
405
Age
4d
Commits · 90 Days