🎓 曾练专属私教 (ZengLian AI Tutor)

无需繁琐的本地开发环境配置，手机和电脑均可即装即用体验专为全场景优化的 全学科智能私教：

• 📥 最新版安装包直链下载：AI_Tutor_v1.5.5.apk (约 10.4MB · 双通道容灾·Jev决策·出厂认证版)
• 📥 稳定备用直链：AI_Tutor_v1.5.4.apk (约 10.4MB)
• ✨ 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 安装包)

• 🌟 方案 A（官方推荐·免签名免越狱·1秒添加至桌面）：
  1. 使用 iPhone / iPad 自带的 Safari 浏览器 打开云端地址：https://ai-tutor-release.onrender.com
  2. 点击 Safari 底部中央的 【分享按钮 📤】；
  3. 下滑选择 【添加到主屏幕】 ➔ 点击右上角 【添加】；
  4. 手机桌面上立即生成 【曾练专属私教】 独立 App 图标，全屏沉浸运行，自带原生高清拍照拍题答疑与麦克风！
• 📦 方案 B（IPA 原生安装包）：
  • 下载 ZengLian_AI_Tutor_v1.0.0.ipa
  • 可使用爱思助手、AltStore、Sideloadly 或企业证书导入 iPhone 安装。

• 浏览器直接访问：https://ai-tutor-release.onrender.com
• 支持电脑大屏护眼阅读、键盘快捷输入、A4 错题集一键打印预览（Ctrl+P）与局域网网络打印机一键出卷。

🖥️ 1. 现代化名师导学与思维脑图

名师深度备考推导过程、思维脑图骨架自动展开、题眼与陷阱一键剖析、整页秒批

📐 2. 沉浸式演练草稿纸与几何/函数白板

支持手写演算、几何动点与抛物线沙盘、方格演算纸底纹，一键“请名师批改草稿”直击运算过程漏洞

🗺️ 3. 关卡式互动学习地图

章节探索小岛、循序渐进解锁通关、告别枯燥刷题，开启游戏化知识探险

🧭 4. 终极关卡与学期通关路线图

全学期核心副本全景呈现、通关目标、实战秘籍与几何/代数证明严谨指引

📝 5. 专属智能错题本 & 靶向变式巩固卷

艾宾浩斯复习智能推送、一键生成 A4 错题排版试卷、AI 举一反三靶向变式强化

📊 6. 家长监工与本周深度学情报告

学习数据诊断、薄弱点追踪、定制家校协同跟进建议、支持一键打印“家访便签”

🎨 7. 微信朋友圈学习成就海报

一键渲染高颜值朋友圈分享战报，集成个人专属微信二维码与打卡励志金句

「曾练专属私教」摒弃了市面上传统搜题软件“直接给答案抄袭”的应试弊端，基于大语言模型与 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 键避让防护，随身口袋私教。

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 年级教材 & 名校真题]

得益于高度自动化的启动脚本，您不需要手动配置复杂的 Node.js 和环境依赖。

git clone https://github.com/Zenglian990/AI_Tutor_Release.git
cd AI_Tutor_Release

• Windows: 双击运行 启动AI辅导.bat
• Mac/Linux: 在终端执行 sh start.sh

🪄 自动化体验: 脚本会自动检查您的 Node.js 环境，并全自动下载前后端依赖、打包构建前端页面。 首次启动时，终端会自动弹窗请求输入您的 Gemini API Key（去 Google AI Studio 免费申请即可），然后直接启动服务！ 系统将在 http://localhost:3001 自动打开主界面。

系统提供极速体验与全量教材入库两种灵活方式：

• ⚡ 方式一：极速体验（免配置内置 Demo 数据） 无需安装配置 Python 环境，直接在项目根目录终端执行：

  npm run seed:demo

  该命令会向本地 LanceDB 自动注入 1-9 年级经典核心章节（人教版一年级数学/语文、三年级加减口算、七年级有理数、八年级勾股定理与声现象、九年级化学等），并完成 768 维向量对齐与全文检索索引构建，瞬间体验精准教材检索！

• 📚 方式二：全量人教版教材入库（批量 PDF 提取） 如果您准备了 1-9 年级完整教材 PDF 文件：

  1. 安装 Python 提取依赖：

     pip install -r requirements.txt

  2. 将课本 PDF 放入 data/textbooks/ 目录下（文件名格式示例：人教版_数学_七年级上册.pdf）。
  3. 执行多模态智能切片入库脚本：

     python scripts/ingest_2_0.py

  脚本支持 EasyOCR / Gemini Vision 对课本插图、复杂数学公式排版的智能识别与切片。

我们非常欢迎社区成员的参与！无论您是开发者、教育工作者还是家长，都欢迎提交 Pull Request 或提出 Issue。让我们共同把这个工具打磨得更好，惠及更多普通家庭。

由曾练与开源社区倾情打造 ❤️ (Built with ❤️ by Zeng Lian & the Open Source Community)