学习监督 手机app 【TomatoClaw 作品】

[leilei]

作品名称：学习监督

下载链接（安卓版）

StudyTracker-APK-v3.0.zip (2.7 MB)

截图预览

StudyTracker-Mobile（学习监督）

一个适合手机端长期使用的儿童学习监督工具。
支持 本地保存、Excel 导出、多孩子独立管理、异常提醒、每周复盘、APK 自动构建。

当前版本：v3.1
更新时间：2026-03-25

---

一眼看懂这个项目

StudyTracker-Mobile 不是普通的作业备忘录。

它更像一个给家长使用的、轻量但长期可用的学习监督工具，重点解决这几个真实问题：

• 今天到底布置了多少作业？
• 每项作业实际做了多久？
• 哪些作业最近明显偏慢或异常？
• 一周下来，哪个科目最稳定、哪个最该重点关注？
• 如果家里有两个孩子，数据怎么真正分开管理？

所以这个项目的核心价值，不只是“记录”，而是：

记录 + 异常识别 + 历史复盘 + 多孩子独立管理。

---

核心亮点

• 本地优先：数据默认本地保存，可真实导出 JSON / Excel
• 多孩子独立：资料、心情、今日作业、历史、报告都按孩子隔离
• 录入够快：支持预期 / 平均 / +15 / +30 / 回车提交
• 复盘够清楚：自动生成近 7 天趋势和本周复盘结论
• 手机端友好：持续紧凑化，尽量一屏多看、多点少按
• 可长期维护：支持 Android Studio、本地打包、GitHub Actions 自动构建 APK

---

适合谁用

这个项目特别适合：

• 想长期记录孩子作业完成情况的家长
• 想看学习时长趋势、异常波动的人
• 希望在手机上快速录入，而不是做复杂表格的人
• 家里有两个孩子，希望同一个 app 内独立管理的人
• 想把网页工具打包成 Android APK 自己长期使用的人

---

这版（V3.1）解决了什么

V3.1 的重点不是继续堆界面，而是把“多孩子长期可用”和“首页日常录入效率”真正补稳。

这一版重点落地了：

• 每个孩子独立保存科目模板
• 每个孩子独立保存自定义科目
• 首页今日作业按未完成优先排序
• 提交后自动跳到下一项未完成作业
• 时长输入框在为空时智能带入历史平均 / 预期时长
• 导入 / 恢复、多孩子切换、异常备注回写等逻辑继续修稳

---

当前核心功能

首页

• 孩子信息
• 今日心情
• 今日概览（轻量统计，不重复堆信息）
• 今日提醒（第一条自动给出当前最该做的下一步）
• 快速操作
• 今日作业列表（未完成优先自动排序）
• 提交后自动跳下一项
• 默认时长智能带入
• 当日完成历史

报告页

• 本周学习摘要
• 本周复盘结论
• 最近 7 天趋势图
• 作业数量占比图
• 学习时长占比图
• 学科分布统计
• 当前孩子切换

设置页

• 科目作业配置
• 孩子信息管理
• 数据备份与恢复
• Excel 导出
• 使用说明
• 版本信息

---

详细能力说明

1. 多孩子独立管理

• 支持添加多个孩子
• 首页 / 设置页 / 报告页都可切换孩子
• 每个孩子独立保存：
  • 基本资料
  • 头像
  • 今日心情
  • 今日作业
  • 完成历史
  • 科目模板配置
  • 自定义科目
• 旧单孩子数据可自动迁移为第一个孩子

2. 作业管理

• 按科目布置当天作业
• 支持自定义科目、Emoji 图标、主题颜色
• 每个科目可配置多个作业模板和预计时间
• 输入实际用时后自动同步到历史
• 自动对比历史平均时长，检测异常波动

3. 快捷录入

首页录入时长支持：

• 预期完成
• 平均完成
• +15
• +30
• 回车直接提交
• 输入框为空时自动带入历史平均 / 预期时长
• 提交成功后自动定位下一项未完成作业

这比纯手输和只靠滑条要快很多，适合日常高频记录。

4. 完成历史

• 首页可看当日完成历史
• 独立“完成历史”弹窗支持按天查看
• 支持删除单条记录或整天记录
• 标签化显示：
  • 用时对比
  • 预期时长
  • 平均时长
  • 异常状态
  • 备注

5. 报告与复盘

报告页会基于历史记录自动计算：

• 总作业量
• 总学习分钟数
• 学习天数
• 日均分钟
• 日均作业量
• 各科目占比
• 本周复盘结论

6. 数据备份与恢复

JSON 备份

导出的备份文件包含：

• schemaVersion
• appVersion
• exportTime
• currentChild
• childForm
• childMood
• childAvatar
• todayHomework
• homeworkHistory
• subjectConfig
• customSubjects
• childrenList
• childrenData
• currentChildId

文件名示例：

学习进度备份_2026-03-20_07-58-10.json

Excel 导出

Excel 为真实 .xlsx 文件，包含 4 个工作表：

1. 基本信息
2. 每日汇总
3. 科目统计
4. 作业明细

文件名示例：

洪书豪_学习统计_2026-03-20_07-58-10.xlsx

恢复流程

1. 选择备份文件
2. 查看导入预览
3. 选择“覆盖恢复”或“合并恢复”
4. 确认导入

---

核心规则

年龄自动计算

年龄 = 当前年份 - 出生年份 - (当前月份 < 出生月份 || (当前月份 == 出生月份 && 当前日期 < 出生日期) ? 1 : 0)

年级自动匹配

当前内置年级范围：

一年级、二年级、三年级、四年级、五年级、六年级、初一、初二、初三、高一、高二、高三

异常检测

异常 = |当前用时 - 历史平均用时| / 历史平均用时 > 0.3

即：偏离历史平均值 30% 以上 视为异常。

---

界面与体验特点

• 渐变配色，整体更柔和
• 圆角卡片，适合手机端触控
• 持续紧凑化，提升一屏信息密度
• 年级选择改成按钮网格，替代原生大下拉
• 完成历史持续优化，减少一行堆太多信息
• 更适合家长在碎片时间快速打开、快速记录

---

本地开发

依赖

项目前端依赖已改为本地文件：

• www/lib/vue.global.prod.js
• www/lib/chart.umd.min.js
• www/lib/xlsx.full.min.js

常用命令

npm install
cordova prepare android
cordova run android

---

GitHub Actions 自动构建 APK

工作流文件：

.github/workflows/android-build.yml

当前统一版本：

• APP_VERSION: 3.1
• APP_VERSION_CODE: 310

当前统一分支：

• main

上传脚本：

upload-to-github.bat

支持双击运行，读取 .git_token，自动读取 config.xml 中版本号，只提交主项目源码，不提交 Android Studio 编译产物。

---

重要路径

项目根目录：

F:\leilei\StudyTracker-Mobile

Android Studio 实际资源目录：

F:\leilei\StudyTracker-Mobile\platforms\android\app\src\main\assets\www

注意：修改 www/index.html、帮助文档或前端资源后，需要同步到 Android Studio 目录，本仓库不提交 Android Studio 编译产物。

---

备份约定

修改关键文件前，统一先备份到：

bak\yyyyMMdd-HHmmss\

并保留原相对目录结构。

典型需要备份的文件：

• www/index.html
• help-doc.html
• README.md
• config.xml
• .github/workflows/android-build.yml
• upload-to-github.bat
• 如涉及依赖，也包括 www/lib/*.js

---

版本演进记录（保留历史）

v3.1（2026-03-25）

• 首页回调为更顺眼的旧风格，删除重复“今日统计”，保留清爽结构
• 首页提醒第一条智能化，直接提示当前最该做的一步
• 今日作业按未完成优先自动排序，减少来回找项目
• 提交后自动跳到下一项未完成作业，连续录入更顺手
• 时长输入框在为空时智能带入历史平均 / 预期时长
• 多孩子下的科目模板、自定义科目改为按孩子独立隔离
• 导入 / 恢复、异常备注回写、自动归档、恢复默认模板等逻辑继续修稳
• README、help-doc、应用内帮助同步更新到 V3.1

v3.0（2026-03-24）

• 首页第一阶段改造成效率型首页，打开先看“今日主状态”
• 首页新增“下一步建议”，只提示当前最该做的一步，减少家长判断成本
• 首页快速操作重排，优先保留选择作业、查看报告、查看历史、使用说明
• README、网页版帮助、应用内帮助同步更新到当前首页结构
• 导入恢复逻辑拆分为覆盖 / 合并两条流程，修复多孩子合并时先覆盖本地数据的风险
• 多孩子备份增加完整性校验，避免半残备份写坏孩子数据
• 多孩子自动归档、异常备注回写、新增科目保存、重新布置作业等流程继续修稳

v3.0（2026-03-20）

• 版本升级到 3.0 / 300
• 多孩子功能进入可用版，支持真正的数据隔离
• 每个孩子独立保存资料、头像、心情、今日作业、完成历史、报告统计
• 报告页新增孩子切换与独立统计提示
• 数据管理新增多孩子备份说明与孩子数量预览
• 完成历史继续抛光，日期头新增汇总，删除按钮弱化，标签更统一
• 新建孩子时重置今日作业 / 历史 / 心情，避免串数据
• README、帮助文档、更新日志同步升级到 V3.0

v2.1.4（2026-03-20）

• 文档整体更新，和当前真实功能保持一致
• 版本统一升级到 2.1.4 / 214
• 首页继续紧凑化，提升一屏信息密度
• 添加新科目弹窗继续收紧布局
• 孩子信息弹窗继续收紧布局
• 年级选择从原生下拉改为按钮网格，更适合手机端
• 完成历史区域与完成历史弹窗重排，减少信息拥挤
• 帮助说明同步补充快速录入、异常提醒、导入预览、复盘等能力

v2.1.3（2026-03-20）

• 备份数据升级为真实 .json 本地保存
• Excel 导出升级为真实 .xlsx 文件
• 安卓环境新增本地文件保存能力
• 导入恢复升级为预览优先，支持覆盖 / 合并恢复
• 新增今日概览、快速操作、异常提醒、本周复盘结论
• 修复日期偏移、本地保存、Cordova 平台与构建流程问题
• GitHub Actions、版本号、帮助说明和推送流程完成统一

v2.1.2（2026-03-17）

• 支持编辑自定义科目名称、图标、主题颜色
• 添加科目颜色推荐与随机切换优化
• 图表颜色与科目颜色联动更新
• 修复物理科目无法修改、名称残留、控制台无用报错等问题
• 优化 emoji 选择布局与异常备注查看体验

v2.1.1（2026-03-17）

• 新增添加科目 emoji 选择面板
• 新增已使用颜色参考与自动推荐未使用颜色
• 新增设置页底部版本信息显示
• 修复新增科目后不立即显示、重置全部未清空自定义科目等问题

v2.1.0（2026-03-14）

• 新增快捷时间输入：滑动条 + 快捷按钮
• 新增 Excel 导出功能
• 新增年龄自动计算与年级自动匹配
• 新增自定义科目：名称 / Emoji / 颜色
• 报告页升级为甜甜圈饼图
• 帮助文档补充核心算法说明

v2.0.0

• 自定义科目功能
• 甜甜圈饼图报表
• Excel 导出功能
• 年龄自动计算
• 完整帮助文档

v1.0.0

• 初始版本发布
• 完整的作业管理功能
• 详细的学习统计报告
• 灵活的科目配置
• 本地数据备份恢复
• 精美的 UI 设计

---

技术支持

如有问题或建议，欢迎联系：

• Email: 823921@qq.com
• GitHub: GitHub - tomatolei/StudyTracker-Mobile · GitHub

---

如果你只是想正常使用，最简单流程就是：

1. 设置孩子信息

2. 布置今日作业

3. 完成后录入用时

4. 定期备份数据

5. 在报告页查看每周复盘