StudyOnTV StudyOnTV (Tiledaoti TV) — open-sour @codeKK AndroidOpen Source Website

StudyOnTV

Introduction: StudyOnTV (Tiledaoti TV) — open-source Android TV app where kids unlock screen time by answering questions. Runs fully on the TV: no server, no account. Parents scan a QR code and manage questions from the LAN. Learn first. Watch later.

More: Author ReportBugs

Tags:

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

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

安装

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

手机/平板/TV GitHub 下载（首选）

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

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

👉 安装指南 → docs/install.md

它能做什么

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

开放题型：单选、多选、判断、填空、主观题；题干和选项支持 LaTeX 公式，离线显示。
多种玩法：按组闯关、连续答对、自由练习，可设置正确率和任务数量。时段可选「仅时段内可用」或「仅时段内需要答题」；后者在时段外自由使用、不扣余额，适合白天老人看电视、17–21 点再管控。
星级奖励：1–5 星题目分别设置时长奖励，仍受每日上限约束。
累计加练：答错达到阈值就增加加练题，跨天、重启保留，答对加练题逐道扣除。
主观题批改：家长手动批改、WorkBuddy / Codex 等 Agent 批改，或配置 DeepSeek 等兼容 AI API。
间隔重复：在规则里打开后，优先复习到期题，答对后延长间隔，答错后提前复习，进度跨重启保留。
答题反馈：答完在下方显示对错、正确答案与解析，孩子按“继续”进入下一题；鼓励语可在面板自定义。
电视遥控器与音频：方向键即可完成作答、填空和更新。学习页出现时先暂停播放器、请求音频焦点；仍继续播放时静音兜底，退出管控后恢复原静音状态，原先未静音时恢复媒体音量。
深色 / 浅色：电视默认深色，手机和平板跟随系统，家长可在面板切换。
AI 批改更省心：内置 DeepSeek、通义千问、智谱、Kimi、硅基流动、本地 Ollama 等预设，一键测试连接、获取模型列表。
管控保护：规则可开启「管控期间拦截系统设置」，家长验证后可临时进入，自由时段不拦截。支持设备管理员的系统可另行授权防卸载；这些权限均可选。
开机恢复：接收 Android 开机、部分系统快速开机和覆盖升级广播，尝试恢复管理服务；厂商自启动及遥控器待机清后台场景见安装指南。
密码管理：首次设置管理密码，扫码面板和 API 都要验证。学习页标题连点 5 次，或焦点在最上方时遥控器「上」短按 5 次，可重新打开家长验证入口；面板里也可以修改密码。

玩法说明 · 题库与批改 API · 家庭自动化联动 · 与 Home Assistant 联动 · 示例题库

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

截图

_{平板学习 · 公式、文字与手写作答}

平板手写作答

_{手写过程可提交家长、Agent 或图像模型批改}

_{手机学习 · 与平板共用题库和规则}

_{家长批改与 AI 设置}

_{遥控器选题，答完在下方显示对错、正确答案与解析}

_{家长用手机扫码，同一个 WiFi 即可管理}

_{未到可用时段时停留提示页，显示下次可用日期和时间}

_{按周设置可用时间，节假日可同步}

_{题库表格 · AI 出题}

_{7 天使用记录}

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

家长能设置什么

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

题库

手机上新增、删除、即时生效
导出 JSON 发给群里其他家长，对方「导入」一贴即用
内置 50 题：唐诗填空、100 以内加减法、英语基础单词
让 AI 批量出题：把接口说明发给 WorkBuddy / Codex 等 Agent，让它直接往被控设备里写题

它是怎么工作的

被控设备 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