Skip to content

Releases: tanle-mtr/ChinaStudyFree

Release list

聪聪学堂 v0.1.0 — 四端 · 四学段 免费公益 AI 学习平台（首个公开发行版）

聪聪学堂 v0.1.0 — 四端 · 四学段 免费公益 AI 学习平台（首个公开发行版） Latest
Latest

Choose a tag to compare

View all tags
@tanle-mtr tanle-mtr released this 16 Oct 14:45
v0.1.0
b28420b

聪聪学堂 v0.1.0 — 四端 · 四学段 免费公益 AI 学习平台（首个公开发行版）

把开源公益项目改造为 四端统一（Web / Windows 桌面 / 安卓 / iOS）+ 四学段（小学 / 初中 / 高中 / 大学）的免费 AI 学习平台。
MIT 许可证，永久免费、无广告、无内购、不收集隐私。

✨ 核心特性
📚 内容规模 148 本教材 · 2,820 节互动课程 · 7,946 道题
🎓 四学段 小学 1-6 · 初中 7-9 · 高中 10-12 · 大学（按学科/课程组织）
📖 多出版社 人教 / 统编 / 北师大 / 苏教 / 沪教 / 外研 / 译林 / 浙教 / 教科 / 高教社 / 清华社等 13 家，支持按科目选教材版本
🔊 免费 TTS 三级音源：DashScope（有 Key）→ 免费 EdgeTTS（零 Key，联网即可） → 静默降级；全站语音朗读
🤖 AI 能力 单元小测出题 / 知识讲解 / 课外故事生成 / 课本配图（未配 Key 时优雅降级为离线内容，不影响学习）
🎮 游戏化 经验 / 连胜护盾 / 宝石 / 装扮商店 / 每日任务 / 成就墙 / 错题本 SRS 复习
🌙 深色模式 跟随系统 / 亮 / 暗三态
💾 数据互通 存档导出 / 导入，手机电脑互通
☕ 打赏支持 完全自愿、不影响任何功能（README 与「我的主页 → 打赏支持」）

📦 下载

文件 平台 / 用途 大小
ChinaStudyFree-Setup-0.1.0-x64.exe Windows 安装版（NSIS，推荐） 59.3 MB
ChinaStudyFree-Setup-0.1.0-x64.msi Windows 安装版（MSI，企业/机房批量部署） 96.3 MB
ChinaStudyFree-Portable-0.1.0.zip Windows 便携版（解压即用，免安装） 119.8 MB
ChinaStudyFree-Android-release.apk 安卓 release（已签名，可侧载） 51.5 MB
ChinaStudyFree-Android-release.aab 安卓 App Bundle（用于上架 Google Play） 51.5 MB
ChinaStudyFree-Offline-Bundle-0.1.0.zip 校园内网 / 离线部署（跨平台，含启动脚本） 47.8 MB

源码 zip / tar.gz 由 GitHub 按 tag 自动生成。
iOS 工程、Docker 镜像与 Linux AppImage/deb：见 .github/workflows/build-installers.yml 与 README 第八节（本机缺 macOS / Docker，由 CI 产出）。
注：GitHub 会去除资产文件名中的非 ASCII 字符，故下载文件使用英文名；产品名称仍为「聪聪学堂」。

🔧 本次修订（安卓，2026-10-17）

  • 修复「主界面没有图标」：自适应启动图标原来是白底 + 白色前景（Capacitor 默认模板），在浅色桌面上完全看不见。现改为品牌绿 #58A700 底 + 白色「聪」字标（含圆角方形 / 圆形两套、5 档密度）。
  • 修复「选择学段无法确定」：首启引导页的「继续」按钮原先被底部固定导航栏盖住（同层级、DOM 靠后）导致点不到；已提升引导层叠层级，并顺带把「学段 → 教材版本 → 年级」全流程改为一律硬跳转（规避静态导出在 WebView 下的偶发软导航 404）。
  • 安卓 APK / AAB 已重新构建签名并替换（版本号仍为 0.1.0）。

🔧 本次修订（全端，2026-10-17 · 第二弹）

  • 根除静态导出下的软导航 404（整类问题）：上一轮只改了引导流程，本轮把剩余全部 next/router 软导航与 <Link> 统一改为原生 <a> / window.location.assign 硬跳转 —— 覆盖底部/侧边导航、宝石徽章、排行榜卡、继续学习卡、切换教材、课程开始弹窗、课程 runner 的全部退出/完成/失败出口、知识手册、跳级测试、错题复习、故事阅读器、商店返回等共 15 个文件。 Capacitor WebView（安卓/iOS）与 Tauri WebView 下不再有点了没反应 / 404 的入口。
  • AI 出题接口容错：generateQuiz 原先不判断 HTTP 状态直接解析 JSON，遇到代理 502 / 静态兜底页等非 JSON 响应会抛意义不明的 SyntaxError；已改为先判状态、友好报错（与语音合成接口行为对齐）。
  • 服务端类型检查零错误：为运行时依赖 ws 补最小类型声明（仅 tsc 使用，esbuild 打包擦除，运行时产物不变）。
  • 四端产物（Windows 安装/便携、安卓 APK/AAB、离线部署包）均已用最新代码重新构建替换（版本号仍为 0.1.0）。

🔧 本次修订（安卓 · 第三弹：根治「选完学段没有下一步按钮」，2026-10-17）

用户在真机复现：选完学段（如「初中」）后，屏幕底部看不到「继续」按钮。真机截图定位到叠加根因，均已修复并覆盖同类问题：

  • 根因 1（主因）—— flex-1 高度在安卓 WebView 里算错：引导页用 fixed inset-0 flex flex-col + 子区 flex-1 … overflow-y-auto 撑布局，而 flex 子项默认 min-height:auto 不会收缩，内容比短屏（手机竖屏）高时会把底部按钮条挤出视口；桌面/宽窗口内容放得下所以看不出。已改为「按钮条独立 fixed bottom-0 z-50」的稳妥结构（与课程答题反馈面板同一模式），内容区自身滚动，按钮条永远贴底可见。
  • 根因 2 —— 「继续」按钮的 opacity 渐入动画：选中后按钮以 initial opacity:0 入场，安卓 WebView 下可能不完成动画而让按钮「隐身」。已改为选中即直接渲染可见按钮（不再依赖入场动画）。
  • 顺带加固 —— 安卓系统导航条遮挡 fixed bottom:0 底栏（安全区）：给所有底部固定操作栏补 padding-bottom: env(safe-area-inset-bottom) —— 覆盖学段/年级引导「继续」、课程答题反馈面板（含报错弹层）、错题复习 runner「继续」、课文阅读器、故事阅读器底部操作栏。手势 / 三键导航机型下这些按钮不再被系统条吞掉。
  • 已核对：教材版本选择页（/stage/{stage}/versions）本就是文档流布局、无此问题；onboarding 流程（学段 → 教材版本 → 年级）现已端到端可用。
  • 四端产物均已用最新代码重新构建并替换（版本号仍为 0.1.0）。

🔧 本次修订（全端 · 第四弹：根治安卓首页白屏卡死，2026-10-17）

用户在真机复现：过完学段引导后，首页白屏、只剩底部导航栏、怎么点都没反应（在线 4G 环境）。

根因：Service Worker 与 Capacitor 原生壳不兼容 + APK 更新后旧缓存残留。原生 App 的资源本就随 APK 本地打包，SW 只会拦截页面导航与静态 chunk 请求；安卓 WebView 的资源加载器对「被 SW 拦截的导航请求」处理异常，导致首页跳往 /grade/… 的硬导航被挂住 → 白屏卡死。且安卓跨版本更新会保留 WebView 存储，旧 APK 注册的 SW 与旧缓存被新包继承，进一步放大问题（旧包里用户卡在学段引导、从未触发过该跳转，所以之前没暴露）。

修复：原生端（Capacitor / Tauri）不再注册 Service Worker，并在启动时立即注销遗留 SW、清空所有缓存；Web 端（真实域名 / 离线包 LAN IP）仍正常注册，保留离线能力。启动脚本按 location 协议/主机自动判定（https://localhost = Capacitor、tauri.localhost = Tauri、capacitor: / file: 亦判为原生）。

验证：用无头 Chromium 以 https://localhost 复现原生路径 —— SW 不再注册/接管（controller=0、regs=0），学段引导、/grade/、/book/ 跳转与完整 onboarding 流程全部正常、零报错。

四端产物均已用最新代码重新构建并替换（版本号仍为 0.1.0）。

🔧 本次修订（安卓 · 第五弹：WebView 交互加固，2026-10-18）

针对安卓 WebView 的已知交互坑做系统性加固（前端改动，重出安卓包即可生效；对 iOS / Web 端同样更安全）：

  • 动态视口高度：原来全站 min-h-screen 用的是 100vh，在安卓 Chrome / iOS Safari 里会把被系统导航条、地址栏遮挡的区域也算进去，导致满屏容器底部内容被切掉或不可达。现加 @supports (height:100dvh){ .min-h-screen{ min-height:100dvh } } 自动升级到动态视口高度（老内核自动回落 100vh，不回归）；桌面侧栏同步改用 100dvh。
  • 去掉点按延迟 / 双击缩放：给所有按钮、链接、可点击元素加 touch-action: manipulation，消除安卓 300ms 点按延迟与误触双击缩放（不影响双指缩放），点哪响哪。
  • 禁止下拉刷新 / 橡皮筋：html, body 加 overscroll-behavior-y: none，避免安卓 WebView 页面级 overscroll 与下拉刷新干扰应用内滚动。
  • 防横屏字体放大：html 加 -webkit-text-size-adjust:100%，避免安卓横屏时浏览器自动放大字体把布局撑乱。
  • 修输入框聚焦整页缩放（真缺陷）：安卓 WebView 聚焦 <16px 的输入框会整页缩放——AI 出题页 4 个输入框、教材中心搜索框原本字号偏小。已统一把表单控件抬到 16px，并给这些输入框显式 text-base。
  • 修悬浮「开始复习」按钮与底栏重叠：错题本页的悬浮「开始复习」条原来固定在 bottom-20，在带安全区的机型上会压到底部导航栏；现改为 calc(3.5rem + 安全区 + 0.75rem)，永远在底栏上方。
  • 注：当前仍保持默认 viewport-fit（系统栏由 WebView 预留），各安全区内边距暂为空操作但不影响；刻意未开 viewport-fit=cover，否则顶部一堆置顶头部会被状态栏遮挡。

四端产物均已用最新代码重新构建并替换（版本号仍为 0.1.0）。

🔐 SHA256 校验和

70eee097ec2ae709b8c79111cf29d9be68fb43e09478ef33df5390a6b97e813b  ChinaStudyFree-Setup-0.1.0-x64.exe
237752fd00498441f86ba7eb17093dc04b7a17306e924f35ff9229ba248bd83f  ChinaStudyFree-Setup-0.1.0-x64.msi
5ac80748b5b4987751bb479efe55c8fdd587d18c1a4f638698bac782202058b7  ChinaStudyFree-Portable-0.1.0.zip
4b90adb37fb0b33130c076c66090ed322824350776425bc3f6dc9ee29e23d989  ChinaStudyFree-Android-release.apk
621538164e879d526fbc51701258f01e614f4fe367dbecb608edf8a972f2a66b  ChinaStudyFree-Android-release.aab
05f6000c23b2b0bf851170079b0c476a0562fc0e3fe49d36a28a8dda5894627b  ChinaStudyFree-Offline-Bundle-0.1.0.zip

🚀 快速开始

Windows 安装版：双击 exe → 按向导安装 → 启动「聪聪学堂」。无需任何配置即可开始学习；语音朗读默认走免费 EdgeTTS（需联网）。

Windows 便携版：解压 zip → 双击 启动聪聪学堂.bat。

安卓：侧载 APK（设置里允许未知来源）。

离线部署包（校园内网）：解压 → 运行 start.sh（Linux/macOS）或 start.ps1（Windows）→ 全校设备浏览器访问 http://该机IP:8787。

想要更高级音质 / 完全离线语音：把包里的 .env.example 改名为 .env，填入 DASHSCOPE_API_KEY 后重启；预生成音频见 README「重新生成预生成音频」。

🛠️ 技术栈

  • Web：Next.js 15 静态导出 · React · Tailwind · Zustand · framer-motion
  • 桌面：Tauri v2（内嵌 Node AI 服务 + 系统托盘，× 最小化到托盘）
  • 移动：Capacitor 6（安卓 / iOS 共用同一套 Web 源码）
  • 服务端：Node + Express，esbuild 打包为自包含单文件（零 node_modules 依赖）
  • TTS：DashScope CosyVoice / 微软 EdgeTTS（完整移植 Sec-MS-GEC v2 令牌算法，零 Key 免费兜底）
  • 数据管线：148 本教材互动课程由仓库内脚本生成（npm run gen:content，增量 + 覆盖写），npm run validate:quizzes 全量校验题目质量

📜 许可证与致谢

MIT（见 LICENSE）。

  • 前端改编基于 ChinaStudyFree
  • 教材结构数据来自 TapXWorld/ChinaTextbook（开源教材库，仅供学习使用；题目均为 AI 原创，不搬运教材原题）
  • 免费语音兜底基于 edge-tts（MIT）的方案，使用微软 Edge 朗读公共服务，请遵守微软服务条款

💌 写在最后

我们相信：每一个中国孩子，无论身处北上广深，还是大山深处的乡村小学，都应该拥有一样好的学习资源。

如果认同这个理念，欢迎 ⭐ Star，也欢迎把它转发给任何一位你认识的老师和家长。

让每一个中国孩子，都能在玩中学。

Assets 8
Loading