识字兔

一、软件简介

「识字兔」是一款面向小学生的汉字识字 + 英语单词双科学习与自评练习系统：识字词科目覆盖一至六年级 12 个册别，背单词科目同样提供 12 个年级册别，帮助孩子"识字词 · 背单词，双科轻松学"。

系统内置 管理员 / 普通用户账号体系与管理后台，支持素材包批量导入、拼音自动补全、网站参数配置；采用 PHP + SQLite 轻量架构，无需安装 MySQL，上传即可使用。

二、核心功能

1. 双科目学习（识字词 / 背单词）

2. 遮罩式自评答题

每种类型对应一种"卡片遮罩"：遮住的部分先自己回想，点 👁 即可显示核对。

3. 两种练习模式

• 📖 顺序练习：按录入顺序逐条学习，温故知新；
• 🎲 随机练习：随机抽条，强化记忆、检测掌握程度。

4. 科学的分级分类

• 识字词、背单词各含 12 个年级册别（一年级上册 ~ 六年级下册），互不串科；
• 可选择某个册别练习，也可选择「🌐 全部汉字 / 全部单词」混合练习；
• 首页直观展示每个科目、每个册别下各类型（A/B/C 或 A/B/D）的条目数。

5. 即时反馈与学习统计

• 练习中实时记录得分 / 已练数量，答对 / 答错一键判定；
• 练习结束后弹出成绩单：答对数、共练数、正确率；
• 自动整理本次错字 / 错词清单，可随时回顾、重点复习。

6. 中英双语语音朗读 🔊

• 借助浏览器语音合成（TTS）：识字词按中文朗读，背单词按英文（en-US）朗读；
• 写字 / 单词听写等模式可点 🔊 或按 R 键朗读；
• 听写类模式自动进入新卡片即朗读，模拟真实听写场景。

7. 贴心交互细节

• 自评模式支持"👁 看答案"，可用 空格 快速显隐；
• 常用键盘快捷键（见下文速查表）；
• 朗读按钮弹跳反馈、答题切换闪卡动画。

8. 批量导入 + 智能拼音补全

• 识字词支持整段粘贴批量导入（每行一条，表头行与 **…** 注释行自动跳过）；
• 背单词支持单词 / 词组导入，可只贴单词清单，音标释义后补；
• 缺拼音的汉字行自动补全：内置约 2500 常用字拼音字典，覆盖小学识字表；
• 提供「🔄 自动补全拼音」预览功能（AJAX 实时处理）；
• 自动去重：同一内容 + 同一科目 + 同一册别 + 同一类型不重复导入。

9. 素材包一键导入

• 安装向导自动扫描素材包目录 yzw/daoru/识汉字、yzw/daoru/背单词，按"四位文件名称"智能识别 科目 · 年级 · 学期 · 类型，勾选即导；
• 素材缺失时自动回退到同名远程数据源，联网即可完成开箱导入；
• 后台「导入字词」页可随时补充导入、单独清空某一科目数据。

10. 账号体系与角色权限

• 首页提供「用户登录 / 管理登录」双入口，账号密码分门户校验；
• 后台可一键开启 / 关闭开放用户注册，并对普通用户做启用 / 停用 / 删除 / 重置密码管理；
• 管理员通过「管理资料」维护自己，普通用户登录后可在「用户资料」自助修改昵称、姓名、手机、公司并修改密码。

11. 管理后台

12. 数据安全与平滑升级

• SQLite 数据库存放于 includes/sql/，安装锁放于 runtime/，均不在 Web 根目录内，外网不可直接访问；
• 旧版本数据自动迁移：补列、旧中文类型名自动转字母类型、历史库自动归入识字词科目；
• 建库、备份只需拷贝数据库文件，单机数据零依赖。

三、运行环境

四、安装与部署

方式一：网页安装向导（推荐）

1. 将程序上传到服务器站点目录（或放入本地 PHP 环境根目录）；
2. 浏览器访问 install.php；
3. 第一步 · 系统基础安装：自动新建数据库 → 建表 → 导入默认网站设置 → 创建默认管理员与普通用户账号；
4. 第二步 · 选择导入数据：向导自动扫描素材包目录（yzw/daoru/识汉字、yzw/daoru/背单词）列出可勾选项；素材缺失时自动回退同名远程数据源，按「科目 · 册别」分组实时进度条逐项导入；
5. 一个都不勾选也能完成基础安装，数据可稍后在后台「导入字词」页补充；
6. 安装完成后进入首页即可开始练习。

素材文件命名规则（四位文件名称）：

• 第 1 位 分类：1＝识汉字、2＝识单词；
• 第 2 位 年级：1~6；第 3 位 学期：1 上册、2 下册；
• 第 4 位 类型：A / B / C / D，如 121A.txt＝识字词·二年级·上册·A，261D.txt＝背单词·六年级·上册·D；
• 兼容旧三位命名（如 11B＝识字词一上 B，由所在文件夹判定科目）。

方式二：PHP 内置服务器快速体验

cd public
php -S 0.0.0.0:8080

然后访问 http://localhost:8080/install.php 完成安装。

五、使用指南

1. 登录系统：首页选择「用户登录」（普通用户）或「管理登录」（管理员）；管理员可在后台开启/关闭自助注册；
2. 选择科目：普通用户登录后选择「识字词 📖」或「背单词 🔤」，页面直接展示各类型条目数；
3. 选择册别：在"一年级上册 ~ 六年级下册"12 个册别（或全部汉字 / 全部单词）中选择练习范围，卡片上可看到该册别 A/B/C（或 A/B/D）各有多少条；
4. 选模式：点击「📖 顺序」或「🎲 随机」；
5. 选类型：在弹出的面板中选择 认识 / 听写 / 组词（识字词）或 认识 / 听写 / 释义（背单词）；
6. 开始答题：对照卡片作答，点击 ✔ 答对 / ✖ 答错进入下一个，点 👁 看答案核对，或点击「完成」结算成绩；
7. 回顾错字：结束后弹出成绩单（答对数 / 共练数 / 正确率），点击「查看错字」重温本次错误内容；
8. 管理数据：管理员登录后台完成 字词查询 / 批量导入 / 用户管理 / 网站设置。

键盘快捷键速查

六、导入数据格式说明

识字词（识汉字，每行一条）：

你|nǐ|8|亻|你们|你好
好|hǎo|6|女|好人|很好
我

• 标准格式：汉字|拼音|笔画|偏旁|组词1|组词2；兼容 汉字|拼音|释义 与纯汉字清单（空白分隔可拆行导入）；
• 未填拼音的行导入时自动查内嵌字典补全（约 2500 常用字）；表头行与 **…** 注释行自动跳过。

背单词（识单词，每行一条）：

book|bʊk|书
apple|ˈæpl|苹果
good morning

• 标准格式：单词|音标|释义；也允许整行只贴单词（词组可含空格），音标 / 释义后补。

七、目录结构

├── includes/              公共函数与数据库连接
│   ├── functions.php      科目/类型/遮罩定义、导入解析、拼音字典、取字与建表迁移
│   ├── db.php             SQLite 连接（数据文件位于 includes/sql/，旧库自动迁移）
│   ├── auth.php           会话 / 登录门户 / 退出 / 角色校验
│   └── sql/               SQLite 数据文件目录（外网不可直接访问）
├── public/                对外访问目录（Web 根目录指向此处更安全）
│   ├── index.php          首页：登录引导 / 选科目 / 选册别 / 类型选择
│   ├── practice.php       练习页（顺序/随机 × 科目×类型）
│   ├── install.php        两步安装向导（素材勾选 + 分步导入进度条）
│   ├── admin/             管理后台（首页统计、字词查询、批量导入、用户、资料、设置）
│   │   └── inc/           后台公共外壳（鉴权引导 / 页头 / 页脚）
│   ├── user/              用户端（登录 / 注册 / 退出 / 用户资料等）
│   │   └── inc/           用户页公共外壳
│   └── static/            样式与脚本
│       ├── css/style.css  前台样式
│       ├── css/admin.css  管理后台样式
│       └── js/practice.js 练习页逻辑
├── runtime/               运行数据（安装锁 install.lock 等，不可外网访问）
└── yzw/                   素材包（daoru）、版本备份（baks）、文档（docs）

八、技术要点

• 零依赖单机数据：SQLite 文件数据库，建库、备份只需拷贝文件；
• 双科目数据模型：subject 字段隔离识字词 / 背单词，各持独立 12 个册别与类型集合（cn：A/B/C，en：A/B/D）；
• 旧库自动升级：建表时自动检测缺失列并 ALTER TABLE 补齐，旧中文类型名（识字表/写字表/词语表）自动迁移为字母类型，历史汉字自动归入识字词科目；
• 拼音自动补全：内嵌常用字拼音字典（紧凑字符串 + 首次解析缓存），导入前可批量预览；
• 素材包 + 远程回退：安装与日常导入均可按"四位文件名称"智能识别科目/册别/类型，本地素材缺失自动走远程数据源；
• 纯原生实现：前端为原生 JavaScript，未引入任何第三方库，页面轻快。