# welearn **Repository Path**: cola_estarhy/WeLearn ## Basic Information - **Project Name**: welearn - **Description**: 面向 考研 的本地学习计划应用(Flutter 开发),涵盖 数学一 / 数学二 / 408 / 英语二 / 政治,帮助你规划每日任务、管理章节计划、查看学习统计、并使用专注番茄钟,专注提升学习效率。 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-27 - **Last Updated**: 2026-10-08 ## Categories & Tags **Categories**: instructional **Tags**: None ## README # WeLearn 这是一款面向 **考研** 的本地学习计划应用(Flutter 开发),涵盖 **数学一 / 数学二 / 408 / 英语二 / 政治**,帮助你规划每日任务、管理章节计划、查看学习统计、并使用专注番茄钟,专注提升学习效率。 > **版权声明**:© 2026 抖音@还下雨 所有 · 仅供个人学习使用,禁止商用。 --- ## ✨ 功能特性 - **今日任务**:按计划选择当天要完成的章节,左滑完成、右滑删除,实时进度反馈。 - **章节计划**:教材章节库,支持搜索、展开/折叠、英语二专项(每日单词 + 自定义计划)。 - **学习统计**:月度日历热力图、学习历史、每日/每周/累计时长统计。 - **专注番茄钟**:多种计时器表盘皮肤(极简圆盘、怀表、方形、自定义图片)、倒计时/正计时、专注提醒(声音/震动)。 - **个性化**:多套主题配色、专注页背景(双色混合 + 高模糊 + 随机、自定义图片)、可调文案与字体大小、自定义专注文案。 - **本地持久化**:所有数据(任务、计划、统计、设置)保存在本地,无需网络。 --- ## 🛠 技术栈 - **Flutter / Dart**:跨平台移动端开发。 - **shared_preferences**:本地键值及数据持久化。 - **file_picker**:选择本地图片(背景 / 表盘)。 - **path_provider**:应用文件目录(背景图、表盘图片缓存)。 - **audioplayers**:专注结束提示音。 - **vibration**:专注结束震动反馈。 --- ## 🚀 运行 & 构建 请确保已安装 Flutter SDK,并配置好 Android 环境。 ```bash # 获取依赖 flutter pub get # 运行 flutter run # 测试 flutter test # 代码检查(必须无 issue) flutter analyze # 构建 Release APK flutter build apk --release ``` APK 输出位置: ```text build\app\outputs\flutter-apk\app-release.apk ``` 会另复制一份为: ```text build\app\outputs\flutter-apk\WeLearn.apk ``` > Windows 开发者模式需开启,否则插件符号链接(plugin symlink)会失败。 --- ## 📁 项目结构 ```text lib/ main.dart # 应用入口、主题与全局平台初始化 models.dart # 数据模型与课程章节库 home_page.dart # 主状态及今日/计划/统计/设置页面 common_widgets.dart # 通用列表组件与对话框 focus_widgets.dart # 专注页面组件与表盘绘制 services/ backup_service.dart # 版本化 JSON 数据备份与恢复 android/ # Android 工程(applicationId: com.hxy.learn,应用名:WeLearn) app/src/main/kotlin/com/hxy/learn/ FocusTimerService.kt # 后台专注前台服务 WeLearnWidgetProvider.kt # 可交互桌面小组件 assets/ sounds/ # 专注提示音(ding / bell / chime.wav) icon/ # 应用图标 tools/ generate_icon.py # 生成应用图标(Pillow) gen_focus_sounds.py # 生成提示音 test/ widget_test.dart # 基础 Widget 测试 ``` > 说明:根目录下的 `app/`、`index.html`、`build.gradle.kts`、`settings.gradle.kts` 等为废弃的原生 WebView 原型遗留文件,可忽略;真正的 Android 工程在 `android/`。 --- ## 📜 许可证 本项目基于 **Elastic License 2.0 (ELv2)** 授权发布。 **核心条款:** - 允许个人及非商业用途:学习、修改、内部使用、开源分享。 - **禁止商业用途**:不得将本项目直接用于任何商业目的。 - 不得将本项目作为托管服务(SaaS)对外提供售卖。 - 使用或修改需保留版权声明与许可说明。 完整许可文本详见 [Elastic License 2.0](https://www.elastic.co/licensing/elastic-license)。 --- Made with ❤️ by 抖音@还下雨 · **仅供个人学习使用,禁止商用**