ObservingTheSea / ObservingTheSea.github.io

# ChinaStudyFree · 小学全科 AI 学习平台
> **一个免费、开源、纯公益的小学全科学习平台**
>
> 我们相信：**每一个中国孩子，无论身处北上广深，还是大山深处的乡村小学，都应该拥有一样好的学习资源。**
>
> 让孩子在玩中学，让 AI 方便你我他。 ❤️
---
## 🌱 项目愿景
中国的教育资源分布不均是一个长期存在的问题。一线城市的孩子可以购买数百元一套的教辅、上价格高昂的补习班；而偏远地区的孩子，往往连一本配套练习册都难以获得。
**ChinaStudyFree** 希望借助 AI 的力量，改变这件事：
- 📚 **覆盖小学全科**：语文、数学、英语、科学
- 🆓 **永久免费**：不收费、不卖课、不做广告、不收集隐私
- 🤖 **AI 原创题目**：基于人教版/统编版教材知识体系，由 AI 生成单元小测与知识点全解
- 🔊 **全站语音**：题目、选项、知识讲解均配有 TTS 语音朗读
- 📖 **课文听读**：语文/英语课文逐句跟读，配合课本原页展示
- 📚 **课外故事**：AI 生成 284 篇分级读物 + 阅读理解题 + 配图，巩固课内知识
- 🎮 **在玩中学**：题目形式生动、即时反馈，让孩子在闯关和互动中建立对知识的兴趣
- 🌏 **服务每一个孩子**：从一年级到六年级，只要有一台能上网的设备，就能用
---
## 📸 功能预览
### Web 端
 年级选择 
 学科总览 
 学习路径 
 单元答题 
 课文听读 
 课外故事 
 错题回顾 
 个人中心 
### iOS 端
 学习路径 
 答题反馈 
 商店 
 我的 
 课文听读 
 错题本 
 每日任务 · 周报 
 深色模式 
> 全部 12 张界面截图与说明见 `docs/ios-ux-gallery.html`（本地打开即可，支持点击放大）。
---
## ✨ 主要特性
| 功能 | 说明 |
|------|------|
| **单元小测** | 跟着课本章节走，学完一课就能练 |
| **知识点全解** | 每个知识点配有清晰讲解、核心概念、公式与易错点 |
| **课文听读** | 语文/英语课文逐句朗读，支持跟读练习，展示课本原页 |
| **课外故事** | 每单元 2 篇 AI 分级故事 + 阅读理解题 + 儿童插画配图 |
| **全站 TTS** | 题目、选项、讲解、故事文本均可点击朗读（Opus 格式，71,500+ 音频） |
| **学习进度** | 自动保存每课完成情况与正确率，故事阅读支持星星评级 |
| **连击系统** | 连续答对触发连击动画与语音激励 |
**覆盖学科与版本：**
| 学科 | 版本 | 年级 | 课外故事 |
|------|------|------|----------|
| 数学 | 人教版 | 一至六年级 | — |
| 语文 | 统编版 | 一至六年级 | 188 篇 |
| 英语 | 人教版 PEP | 三至六年级 | 96 篇 |
| 科学 | 教科版 | 一至六年级 | — |
---
## 🚀 快速开始
### 1. 克隆仓库
 [code] 
### 2. 下载资源文件
音频、配图、课本原页和题库数据体积较大，通过 GitHub Release 分发，不包含在 Git 仓库中。
 [code] 
这会自动下载并解压以下文件：
| 文件 | 内容 | 大小 | 解压到 |
|------|------|------|--------|
| `audio.tar.gz` | 71,502 个 TTS 音频 (Opus) | ~870 MB | `apps/web/public/audio/` |
| `story-images.zip` | 284 张 AI 故事配图 | ~368 MB | `apps/web/public/story-images/` |
| `textbook-pages.zip` | 1,577 张课本原页 (JPG) | ~192 MB | `apps/web/public/textbook-pages/` |
| `data.zip` | 前端构建数据 (JSON) | ~4.3 MB | `apps/web/public/data/` |
| `data-source.zip` | passages + stories 源 JSON | ~811 KB | `data/` |
### 3. 运行 Web 端
 [code] 
访问 http://localhost:3000 即可。
### 4. 运行 iOS 端
需要 macOS + Xcode 16+ + XcodeGen：
 [code] 
在 Xcode 里选 iPhone / iPad 模拟器，Cmd+R 即可运行。App 内置一本数学书（一年级上册 + 第一节课的 TTS 音频）作为离线种子，无需网络就能体验完整流程。
**iOS 端特点：**
- SwiftUI 原生（非 React Native），支持 iPhone + iPad（iPad 自动分栏布局）
- 域逻辑（SRS / 判分 / 成就 / 宝箱 / 吉祥物）从 `packages/core` 逐文件对译为 Swift
- 音频：Opus 预转码为 AAC m4a，`AVAudioPlayer` 播放，无第三方解码依赖
- 数据按书从 GitHub Release 按需下载（首启不需要下完全部 44 本的 ~843MB）
- 38 个单元测试 + 11 个 UI 测试（答题闭环、退出确认、标签导航、装扮购买、每日任务）
**统一设计系统（`DesignSystem/`）**
全端共用一套令牌，没有任何页面掉回原生系统控件：
| 令牌 | 内容 |
|------|------|
| `DuoColors` | 品牌色 + 语义色（`bg` / `surface` / `border` / `ink`…），**浅色为主、深色为可选**，同一份代码自动适配 |
| `DuoFont` | 圆体字号角色（display / title / heading / body / caption…），根部统一 `.fontDesign(.rounded)` |
| `DuoLayout` | `Space` / `Radius` / `Motion` 三组令牌，全局共用一套动效曲线 |
| `DuoButtonStyle`·`DuoCardStyle` | 标志性的立体「下沿」按压质感 |
**学习体验**
- 路径即首页：当前节点呼吸动效 + 真实单元进度环，点击弹出开始气泡
- 答错回炉重练：进度条只在答对时前进，且必定走满；错题自动进入 SRS 错题本
- 爱心耗尽拦截、退出二次确认、答错震屏与抖卡、每次点选都有触感与音效
- 结算页连胜与每日达标庆祝；错题复习不扣爱心且奖励经验值
- 课文/故事支持「朗读全文」逐句高亮跟随，读完奖励经验值
- 吉祥物「聪聪」（熊猫）以 SwiftUI Canvas 绘制，含呼吸、眨眼与情绪反应
**装扮系统（earn →