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 сети.
Это приложение, которое я устанавливаю, или сервер, который нужно разворачивать?Это приложение, которое устанавливается на управляемое устройство. Сервер разворачивать не нужно: банки вопросов, правила и записи об использовании хранятся прямо на самом устройстве.
Как установить это на телевизор?Телефоны и планшеты устанавливают APK напрямую со ссылок на GitHub или Pgyer (蒲公英). На телевизоре установите его через USB-накопитель или ADB. При первом запуске задаётся пароль администратора, а разрешения можно выдать позже.
Какие устройства поддерживаются?Планшеты, телефоны и телевизоры на Android 5.0+. HarmonyOS NEXT, Tizen и webOS пока не поддерживаются, а ограничения фоновой работы от производителя нужно проверять на каждом реальном устройстве.
Чем это отличается от обычного ограничителя экранного времени?Экранное время здесь зарабатывается, а не просто ограничивается. Дети отвечают на вопросы, чтобы разблокировать минуты: звёзды задают разные награды за вопросы с 1–5 звёздами, а за неверные ответы добавляются дополнительные задания, которые сохраняются между днями и перезапусками.
Можно ли свободно пользоваться телевизором вне учебных слотов?Да. Режим слотов «требуется ответ» требует ответов на вопросы только внутри своего временного окна и оставляет телевизор свободным вне его, не списывая баланс. Поэтому бабушки и дедушки могут смотреть телевизор днём, а блокировка действует вечером.
Поддерживаются ли формулы, рукописный ввод и голосовой ввод?Да. Условия вопросов и варианты ответов поддерживают формулы LaTeX, которые отображаются без интернета. Планшеты и телефоны поддерживают сенсорное управление, голосовой ввод и рукописный ввод, а на телевизоре используется пульт дистанционного управления.
Можно ли проверять развёрнутые ответы автоматически?Да, есть несколько вариантов: родитель может проверять вручную, агент вроде Codex может проверять ответы, или можно настроить совместимый API ИИ, например DeepSeek или Qwen.
Какие есть похожие проекты?cleanyourtv-app, dumbtv, streak, Android-Dex, tellyscope, get-it, Shizuku-Next, hilight-studio
Автор
chadyi
Размер
13.9 MB
Звёзды
1.7K
Возраст
17 д
Коммиты · 90 дней