PoHW · Proof of Homework

给 Android 电视加一道门槛：到点弹出一道题，答对才能继续看。

不上架应用商店 · 家长自行下载 · 默认离线 · 不收集任何数据

• 跨应用答题：到点用全屏遮罩盖住任意界面，四选一答对才放行；连错 2 次自动换题并记入错题库。
• 9,544 道内置题：随 APK 发布、零网络请求，覆盖小学 1–6 年级语数外，按教材册次、单元与课标知识点组织。
• 按组闯关：默认一组 5 题、答对 60% 通过，题量与门槛可配；答题时尽力暂停 / 恢复播放。
• 跟着进度走：年级、上下学期、已学单元、教材学制（自动 / 六三制 / 五四制）都可设，不抽超纲题。
• 生效时段与节假日：内置 2026–2027 法定节假日与调休补班，另有假期模式与「今天临时」，上学时段不打扰。
• 家长密码：4–8 位数字密码，关闭守护需就地验证；悬浮窗授权被撤销时主动提示，可选无障碍备用通道。
• 两个后台：电视遥控器设置 + 可选手机扫码管理（默认不监听、数据不出局域网），两端设置同步。
• 练习模式：独立自由答题页，切学科 / 年级 / 难度并显示统计，退出自动恢复守护。

功能细节 · 题库统计 · 官网

1. 到 官网下载最新版（历史版本见 Releases）。
2. APK 拷进 U 盘 → 插到电视 → 用电视自带「文件管理器」打开安装，按提示允许「未知来源」。
3. 打开 APP：授权悬浮窗 → 设置 4–8 位家长密码 → 设年级 / 频率 / 学科配比 → 首页点「开启守护」。

已有旧版直接覆盖安装即可（同一签名证书，密码、设置与错题库都保留）；换签名才需要卸载重装。

• 开机 / 重启后守护没起来？ 先看首页状态栏：部分电视（海信 VIDAA、TCL 等）重启后会撤销悬浮窗授权，重新授权即可；「开机自启」默认关闭，还需在厂商设置里放行。「自动守护」只管打开 APP 时拉起，不等于开机自启。详见 开机自启引导 与 Issue #20。
• 不是设备锁 / 应用锁，不阻止卸载，也不阻止换设备看视频；暂停视频是尽力而为的系统级请求。
• 默认零请求：版本检查、在线题库源、手机管理三项都可关，全关后不产生对外请求；不含统计 / 广告 / 支付 SDK。
• 难度是倾向加权不是硬过滤；站点难度系数噪声大，选「高」仍可能遇到偏易题。完整边界见 docs/ARCHITECTURE.md。

在线题库是可选的：想补充自己的题目，直接抄 docs/online-bank/ 里的 index.json 模板， 改完题目跑一次 build_index.py 重新生成 sha256，整目录托管到 HTTPS 静态服务即可。

零 Gradle：JDK 17 + Android SDK 34，命令行 aapt2 → javac → d8 → zipalign → apksigner。

JAVA_HOME=/opt/jdk17 ANDROID_HOME=/path/to/sdk \
POHW_KEYSTORE=/path/to/release.keystore POHW_KEYSTORE_PASS=*** \
bash app/build.sh

bash tests/run.sh                  # JVM 单测
python3 tests/mutation_suite.py    # 发布前负向变异回归

所有改动走 feature 分支 → Pull Request → .github/workflows/ci.yml 的 auto-review 检查 → 合入 main；tag / Release 由维护者用同一发布密钥创建。 build.sh 会比对成品证书与已发布证书，不一致直接失败，保证旧设备能覆盖安装。 逐次变更见 CHANGELOG.md。

代码沿用 MIT。题库内容权利归各自权利人所有，不随 MIT 一并授权； 如涉及版权或其他权益问题，请通过 GitHub Issue 联系，核实后会及时删除或替换。 完整说明见 docs/DATA_SOURCES.md。