# ssxstudy

**Repository Path**: classlong2112/ssxstudy

## Basic Information

- **Project Name**: ssxstudy
- **Description**: 一个提供给小学生的学习平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-30
- **Last Updated**: 2026-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小公主学习工作台

一个面向小学低年级女生的「清新可爱」风格学习工作台。提供两种使用方式：

1. **PWA（网页 App）**：手机浏览器打开后可「添加到主屏幕」，当作 App 使用，每次打开自动获取最新版本。
2. **安卓原生 App（APK）**：一个真正的独立安装包，装在手机上即为桌面图标，不依赖网页打开；工作空间运行时加载在线最新版，休眠时自动回退到内置离线副本。

## 包含的模块
- 📖 语文：拼音、识字、二年级上册古诗词、单元生字词
- 📚 阅读：好词、好句、绘本故事、阅读文章
- 🔤 英语：单词、跟读（语音合成 TTS）
- 🧮 数学：9×9 乘除法、口算练习
- 🧩 思维：逻辑小游戏
- 🏅 打卡 / 运动 / 奖励

## 文件说明
| 文件 | 作用 |
|------|------|
| `index.html` | 主程序（单文件应用） |
| `curriculum-g2.js` | 二年级语文/数学课程数据 |
| `manifest.json` | PWA 应用清单 |
| `sw.js` | Service Worker（网络优先，保证每次打开都是最新） |
| `icon-192.png` / `icon-512.png` | 桌面图标 |
| `ssxstudy.apk` | 安卓原生安装包（已签名，可直接安装） |
| `android-app/` | APK 工程（源码 + 构建脚本 `build_apk.sh`） |

## 本地预览
```bash
# 在项目目录执行
python3 -m http.server 8000
# 浏览器打开 http://localhost:8000
```
> 注意：Service Worker / PWA 安装需要 http(s) 环境，直接双击 `index.html`（file://）只能看界面，无法安装到桌面。

## 安装到手机（安卓原生 App）

最简单的方式：用**手机浏览器**打开本工作台 → 进入「👩 家长后台管理」→ 点击「⬇️ 下载安卓安装包」→ 下载完成后点安装包 → 允许「未知来源」安装即可。

手动方式：把 `ssxstudy.apk` 传到手机，用文件管理器打开安装。

> 安装步骤：① 下载 .apk；② 点通知栏安装包（或在「文件管理」找到它）；③ 若提示「禁止安装未知应用」，点「设置」→ 打开「允许来自此来源的应用」；④ 点「安装」。装好后桌面出现「小公主学习工作台」图标。

> 说明：APK 内的 WebView 会优先加载在线最新版（需工作空间运行），工作空间休眠时自动回退到内置离线副本，因此它是一个真正可独立使用的 App。

## 重新构建 APK
```bash
cd android-app
bash build_apk.sh        # 产物：android-app/小公主学习工作台.apk
cp "android-app/小公主学习工作台.apk" ssxstudy.apk
```
构建依赖 `/opt/android-sdk`（cmdline-tools、platforms;android-34、build-tools 34.0.0）。

## 关于 Gitee Pages
> Gitee Pages 已于 2024-05 下线，无法再用于静态托管。本仓库仍作为**代码与安装包备份**使用；如需永久网址，可改用 Cloudflare Pages / Vercel / 腾讯云 Static Web App 等托管 `index.html` 等静态文件。