安装
Android 平板、手机和电视使用同一套规则，分别安装对应版本：
如果无法访问 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 次，可重新打开家长验证入口；面板里也可以修改密码。
玩法说明 · 新增需求使用说明 · 后台恢复与 tv-vigil 分析 · iPad / 旧 Android / MAXHUB 支持范围 · 题库与批改 API · 家庭自动化联动 · 与 Home Assistant 联动 · 示例题库
管理页面由被控设备在局域网内提供。离线题目直接在设备上完成；AI 批改需要网络和家长配置的服务。
截图
家长能设置什么
| 设置项 |
说明 |
| 每天最多看 |
超出后当天锁死，第二天重置 |
| 每次答题解锁 |
一组题答完解锁几分钟 |
| 每组题量 |
一组几道题 |
| 答对比例 |
答对多少题才算通过（百分比） |
| 每天最多答几组 |
答完上限即锁定 |
| 时段用途 |
仅时段内可用 / 仅时段内需要答题；按周设置，半小时一格，可选节假日按周日 |
| 系统设置保护 |
管控期间拦截，家长验证后临时放行；需无障碍或悬浮窗配合使用情况访问 |
| 间隔重复 |
开启后优先抽取到期复习题，再补新题 |
| 玩法 |
按组闯关、连续答对、自由练习 |
| 星级奖励 |
分别设置 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 |
社区建议与致谢
- LINUX DO xiuweng：支持手机管控、通过隐藏手势重新打开管理入口，以及答错后累计加练、重启保留加练池。
- LINUX DO free-swimming：设置题目星级难度，并为不同难度配置不同的时长奖励。
- Issue #2：补充修改密码、AI 服务预设与连接测试，改进题库管理，图表与公式按需加载。
- Issue #3：答题结果放在题目下方，显示正确答案、解析与鼓励语，由孩子手动继续；加强后台音频处理。
- Issue #4：区分可用时段与答题管控时段，增加自由时段、可选防卸载和音频静音兜底。
- Issue #5：补充开机启动说明。
这些建议也延伸到其他端，欢迎反馈使用体验。
本项目已链接并认可 LINUX DO 社区。
License
源码可查阅，仅限个人家庭使用，禁止商业用途和二次分发。欢迎 Issue 反馈问题。
商业授权请通过 GitHub Issues 联系作者。
评论