# 🎓 曾练专属私教 (ZengLian AI Tutor)
**国内首个专为 1-9 年级量身定制的开源 RAG AI 智能私教系统**
*覆盖人教版 1-9 年级全学科知识库 · 双模态自适应心智教学 · 闭环提分体系*
[](https://github.com/Zenglian990/AI_Tutor_Release/releases/download/v1.5.5/AI_Tutor_v1.5.5.apk)
[](https://github.com/Zenglian990/AI_Tutor_Release/releases/download/v1.0.0-apk/ZengLian_AI_Tutor_v1.0.0.ipa)
[](https://ai-tutor-release.onrender.com)
[](https://github.com/Zenglian990/AI_Tutor_Release/releases/tag/v1.5.5)
[](https://reactjs.org/)
[](https://nodejs.org/)
[](https://capacitorjs.com/)
[](https://lancedb.com/)
[](https://github.com/Zenglian990/AI_Tutor_Release)
[](https://opensource.org/licenses/MIT)
[**中文文档**](README.md) | [**English**](README_en.md) | [**🤖 Android 下载 (v1.5.5 双通道容灾·Jev决策·出厂认证版)**](https://github.com/Zenglian990/AI_Tutor_Release/releases/download/v1.5.5/AI_Tutor_v1.5.5.apk) | [**🍎 iOS 安装指南**](#-移动双端与桌面全平台支持-android--ios--pc) | [**🌐 云端体验**](https://ai-tutor-release.onrender.com)
> *“教育公平从来不是一句口号。让普通家庭的孩子，也能拥有最顶尖的专属私教。”*
---
## 📱 移动双端与桌面全平台支持 (Android / iOS / PC)
无需繁琐的本地开发环境配置，手机和电脑均可即装即用体验专为全场景优化的 **全学科智能私教**：
### 🤖 1. 安卓端 (Android 手机 / 平板)
- **📥 最新版安装包直链下载**：[AI_Tutor_v1.5.5.apk (约 10.4MB · 双通道容灾·Jev决策·出厂认证版)](https://github.com/Zenglian990/AI_Tutor_Release/releases/download/v1.5.5/AI_Tutor_v1.5.5.apk)
- **📥 稳定备用直链**：[AI_Tutor_v1.5.4.apk (约 10.4MB)](https://github.com/Zenglian990/AI_Tutor_Release/releases/download/v1.5.4/AI_Tutor_v1.5.4.apk)
- **✨ v1.5.5 重磅体验跃升 (全功能旗舰级稳固闭环)**：
- **⚡ TypeSafe Jev System One 极速决策引擎**：
- 70ms 毫秒级识别与拦截闲聊问候（0 Token 消耗）；精准意图分流与 1-9 年级心智模型自动适配，智能注入启发式名师教学策略。
- **🤖 DeepSeek V3 / R1 与 Google Gemini 2.5 闪电双通道容灾**：
- 国内极速直连免翻墙（延迟低至 340ms），国际顶尖多模态视觉解题无缝互备；控制台一键测速诊断与自动保存。
- **🔐 出厂统一安全认证与管理后台一键重置**：
- 标准官方令牌（`ait_ca1b...`）出厂即通，解决冷启动令牌失效问题；管理控制台参数实时加密持久化，新增绿色【重置标准】一键恢复出厂令牌；强化家长保护防作弊门禁与安全哈希验证。
- **💡 拍照取景器去阴影滤镜与几何辅助线灵感锁**：
- 局部积分图算法消除晚间台灯阴影，白纸黑字高对比清晰识别；初中几何题一键查看辅助线作法阶梯提示，保护学生独立推导与自主思考心流。
- **📚 39,114+ 国家权威题库与举一反三变式母题闭环**：
- 人教版全学科知识图谱与真题库无缝联动；现场即做即批，错题一键生成 A4 试卷并支持局域网网络打印机一键出卷。
*(按照规范，发布区严格保持最新的 2 个 APK 安装包)*
### 🍎 2. 苹果端 (iPhone / iPad)
- **🌟 方案 A（官方推荐·免签名免越狱·1秒添加至桌面）**：
1. 使用 iPhone / iPad 自带的 **Safari 浏览器** 打开云端地址：[https://ai-tutor-release.onrender.com](https://ai-tutor-release.onrender.com)
2. 点击 Safari 底部中央的 **【分享按钮 📤】**；
3. 下滑选择 **【添加到主屏幕】** ➔ 点击右上角 **【添加】**；
4. 手机桌面上立即生成 **【曾练专属私教】** 独立 App 图标，全屏沉浸运行，自带原生高清拍照拍题答疑与麦克风！
- **📦 方案 B（IPA 原生安装包）**：
- [下载 ZengLian_AI_Tutor_v1.0.0.ipa](https://github.com/Zenglian990/AI_Tutor_Release/releases/download/v1.0.0-apk/ZengLian_AI_Tutor_v1.0.0.ipa)
- 可使用爱思助手、AltStore、Sideloadly 或企业证书导入 iPhone 安装。
### 💻 3. 电脑桌面端 (Windows / Mac / Linux)
- 浏览器直接访问：[https://ai-tutor-release.onrender.com](https://ai-tutor-release.onrender.com)
- 支持电脑大屏护眼阅读、键盘快捷输入、A4 错题集一键打印预览（`Ctrl+P`）与局域网网络打印机一键出卷。
---
## 📸 界面全景展示 (UI Showcase)
🖥️ 1. 现代化名师导学与思维脑图
名师深度备考推导过程、思维脑图骨架自动展开、题眼与陷阱一键剖析、整页秒批
📐 2. 沉浸式演练草稿纸与几何/函数白板
支持手写演算、几何动点与抛物线沙盘、方格演算纸底纹，一键“请名师批改草稿”直击运算过程漏洞
🗺️ 3. 关卡式互动学习地图
章节探索小岛、循序渐进解锁通关、告别枯燥刷题，开启游戏化知识探险
🧭 4. 终极关卡与学期通关路线图
全学期核心副本全景呈现、通关目标、实战秘籍与几何/代数证明严谨指引
📝 5. 专属智能错题本 & 靶向变式巩固卷
艾宾浩斯复习智能推送、一键生成 A4 错题排版试卷、AI 举一反三靶向变式强化
📊 6. 家长监工与本周深度学情报告
学习数据诊断、薄弱点追踪、定制家校协同跟进建议、支持一键打印“家访便签”
🎨 7. 微信朋友圈学习成就海报
一键渲染高颜值朋友圈分享战报，集成个人专属微信二维码与打卡励志金句
---
## 🌟 核心杀手级特性 (Core Features)
「曾练专属私教」摒弃了市面上传统搜题软件“直接给答案抄袭”的应试弊端，基于大语言模型与 LanceDB 精准教材向量知识库构建了真正的**“学-练-测-辅-管”全闭环 AI 私教智能体**：
- 📸 **工业级拍照搜题与智能分题（对标小猿搜题/作业帮）**：
- **五步视觉转录锚定**：前置强制完整输出 `### 📝 【原题精确还原】`，彻底杜绝看错符号、漏看已知条件的视觉幻觉，后续考点分析、草稿纸第一步动笔支架、推导与变式母题环环相扣。
- **开图即扫与题目胶囊**：整页试卷静默后台毫秒级自动分题，顶部展现一键吸附题目标签胶囊（`[全页]`、`[第1题]`、`[第2题]`...），点击即自动平滑包围目标题目。
- **触控悬浮微调放大镜（Loupe）**：拖拽边角把手时上方实时唤出 2.2x 放大镜及绿色十字准星，手指不再挡字。
- **切片无损直通**：彻底拦截二次重绘压缩，保证高清公式与几何图细节直达大模型。
- 🎙️ **三引擎极速语音交互系统（亚秒级转写响应）**：
- **Web Speech 原生引擎**：Android Chrome / 桌面端 0 延迟边说边实时上屏。
- **VAD 智能静音检测**：停止说话 900ms 自动断句交割，流畅无感。
- **0 思考预算服务端兜底**：Gemini 2.5 Flash 0-thinking 配置，录音停止后 <1 秒完成精准转写。
- ⚡ **AI 极速双引擎（用户自主选择 · 严格执行）**：
- **DeepSeek-V3 极速版**：国内高速直连，首字响应（TTFT）低至 **0.4 秒**，问答干脆利落，体验行云流水。
- **Gemini 2.5 Flash 深度版**：原生多模态深度理解，复杂几何图形识别与大题长思维链推导更强悍。
- **顶栏一键秒切**：顶栏显式提供【⚡ 极速 / 🧠 Gemini】胶囊切换，严格执行用户所选模型，绝不擅自篡改。
- 🧠 **Jev 1~9 年级心智模型决策大脑（年级全自动智能匹配）**：
- **1-3 年级（童趣萌芽）**：生动趣味、情境背诵与具象化拆解，保护好奇心与专注习惯。
- **4-6 年级（条理与规范）**：强化计算验算、草稿纸规范演练与知识点分类收敛。
- **7-9 年级（严谨逻辑与中考攻坚）**：思维导图骨架梳理、反向追问防坑避雷、大题多步严密证明。
- **底层自适应装配**：学生选择年级后自动匹配心智认知模式，无需手动干预；本地 0ms 启发式裁决，实时捕捉挫败情绪并自适应降级引导。
- 🌊 **45ms 流式帧缓冲抗掉帧平滑渲染**：
- 前端独创基于 `requestAnimationFrame` 的 45ms 平滑渲染缓冲池，彻底解决 AI 吐字过快导致的 DOM 重绘抖动与掉帧卡顿，呈现如丝般顺滑的打字机交互体验。
- 🖨️ **A4 纸质试卷排版与 39,114+ 母题名校题库闭环**：
- 内置 39,114+ 道覆盖人教版全学科的核心母题与名校模考题库，支持一键排版导出为标准 A4 考试卷与错题靶向变式卷，无缝连接线下纸笔实战。
- 🗣️ **苏格拉底启发式交互（拒绝直接甩答案）**：
- 遇到难题绝不直接给答案，而是通过层层递进的提问引导孩子自主思考（“你觉得第一步应该先求什么？”）。
- 内置语音朗读（TTS）、演练草稿纸、几何白板、整页秒批、题眼与陷阱专项剖析。
- 🗺️ **游戏化知识图谱与关卡地图**：
- 覆盖人教版 1-9 年级全学科章节图谱，将教材知识解构成探险副本。
- 支持开启自由探索与闯关锁定，激发孩子自主通关的内生驱动力。
- 📒 **智能错题闭环与靶向变式卷**：
- **错题一键收录**：智能归类知识点盲区与失分原因。
- **靶向变式举一反三**：AI 动态生成同类变式题，确保真正搞懂本质。
- **A4 打印排版**：支持直接导出 A4 清爽试卷格式，线下练习无缝衔接。
- 📊 **家长监工看板与每周深度学情诊断**：
- 自动追踪互动频次、攻克错题数、薄弱知识分布。
- 智能生成给家长的定制跟进建议（包括亲子沟通技巧与微习惯养成建议），可打印“家访便签”。
- 📱 **全平台跨端体验与安全区深度防护**：
- **PC 网页端**：沉浸式大屏操作，多窗口分屏，适合书房学习与深度做题。
- **Android 原生端**：专为手机 9:16 竖屏优化，贴边全屏防误触，全面屏底部手势与 Home 键避让防护，随身口袋私教。
---
## 🛠️ 技术架构 (Tech Stack)
```mermaid
graph TD
UserApp[📱 Android 原生 APK / 💻 Web 浏览器] -->|45ms 流式帧缓冲| ClientUI[前端沉浸界面]
ClientUI -->|API 请求| Server(Node.js / Express 后端服务)
Server -->|本地零延迟 0ms 路由| JevEngine[🧠 Jev 1~9年级心智决策大脑]
JevEngine -->|分龄精准 Prompt / 挫败检测| ModelRouter{用户自选双引擎}
ModelRouter -->|⚡ 极速首字 0.4s| DeepSeek[DeepSeek-V3 引擎]
ModelRouter -->|🧠 深度多模态推导| Gemini[Gemini 2.5 Flash 引擎]
Server -->|教材与真题向量检索| LanceDB[(LanceDB 向量知识库 / 39,114+ 母题)]
LanceDB -->|本地高速向量入库| PythonRAG[Python RAG 多模态提取管道]
PythonRAG -->|OCR & 结构切片| Textbooks[人教版 1-9 年级教材 & 名校真题]
```
---
## 🚀 电脑端本地极速启动 (Quick Start for PC)
得益于高度自动化的启动脚本，您**不需要**手动配置复杂的 Node.js 和环境依赖。
### 1. 克隆仓库
```bash
git clone https://github.com/Zenglian990/AI_Tutor_Release.git
cd AI_Tutor_Release
```
### 2. 一键启动 (全自动构建)
- **Windows**: 双击运行 `启动AI辅导.bat`
- **Mac/Linux**: 在终端执行 `sh start.sh`
> **🪄 自动化体验**: 脚本会自动检查您的 Node.js 环境，并**全自动下载前后端依赖、打包构建前端页面**。
> 首次启动时，终端会**自动弹窗**请求输入您的 `Gemini API Key`（去 Google AI Studio 免费申请即可），然后直接启动服务！
> 系统将在 `http://localhost:3001` 自动打开主界面。
### 3. 关于知识库 (RAG 课本数据)
系统提供**极速体验**与**全量教材入库**两种灵活方式：
- **⚡ 方式一：极速体验（免配置内置 Demo 数据）**
无需安装配置 Python 环境，直接在项目根目录终端执行：
```bash
npm run seed:demo
```
该命令会向本地 LanceDB 自动注入 1-9 年级经典核心章节（人教版一年级数学/语文、三年级加减口算、七年级有理数、八年级勾股定理与声现象、九年级化学等），并完成 768 维向量对齐与全文检索索引构建，瞬间体验精准教材检索！
- **📚 方式二：全量人教版教材入库（批量 PDF 提取）**
如果您准备了 1-9 年级完整教材 PDF 文件：
1. 安装 Python 提取依赖：
```bash
pip install -r requirements.txt
```
2. 将课本 PDF 放入 `data/textbooks/` 目录下（文件名格式示例：`人教版_数学_七年级上册.pdf`）。
3. 执行多模态智能切片入库脚本：
```bash
python scripts/ingest_2_0.py
```
脚本支持 EasyOCR / Gemini Vision 对课本插图、复杂数学公式排版的智能识别与切片。
---
## 🤝 参与贡献 (Contributing)
我们非常欢迎社区成员的参与！无论您是开发者、教育工作者还是家长，都欢迎提交 Pull Request 或提出 Issue。让我们共同把这个工具打磨得更好，惠及更多普通家庭。
---
*由曾练与开源社区倾情打造 ❤️ (Built with ❤️ by Zeng Lian & the Open Source Community)*