IntelliTutor 专属
这些是我们面向 K12、中文阅读和个人学习闭环额外做出来的产品层。
- 个人掌握度图谱
- 聊天掌握度候选与未更新原因
- 复测/讲解/变式题入口
- 中文整本书阅读路径
- 几何模型 HTML 动画库
- 数学动画生产链路修复
当前版本 v1.0.0
IntelliTutor 功能说明
IntelliTutor 基于 DeepTutor 做了产品化改造：从“开源学习助手框架”变成面向学生、老师和家庭试用的学习工作台。这里记录已经上线、已经接入和仍在评估的真实功能状态。
当前可见功能状态
用户现在能直接看到或使用的能力
只列已经进入页面、组件或运行链路的能力；每项都标出入口，方便试用时按路径检查。
用户与数据隔离
知识库 / RAG / 图谱 / 测评 / 计划 / 报告 / 设置
DeepTutor v1.3.8 的隔离补丁已选择性合入；普通用户只能访问自己的资料与任务，管理员能力单独收口。
查看设置权限
个人掌握度图谱
聊天回答卡片 / Knowledge Graph / 学习计划
聊天判断掌握度变化后会显示更新卡片，并可跳到个人图谱查看知识点百分比、薄弱点和后续练习；已用高中数学个人图谱完成线上写入验证。
打开个人图谱
数学动画
Math Animator / 资源预览
生产环境 Manim 依赖与预览鉴权已修复；默认优先返回 low-quality 静态分镜图，课堂演示更快看到结果。
进入 Math Animator
Math Asset Lab
数学目录 / HTML / Manim 资产
七上到九下六册已进入目录级工作台；不存教材原文，每章都有自研交互草图和可能用到的素材。
打开数学资产库
Space / Book
Space hub / Books / Book page chat
Space 已整合 Books、聊天历史、笔记、题库、Skills、Memory；Book 页面支持围绕当前页继续问答并绑定会话。
打开 Space
Knowledge Base / Rebuild
Knowledge 详情头部 / Index versions / Re-index
索引版本数量、embedding mismatch、needs reindex 和 Re-index 快捷按钮已出现在知识库详情主路径。
管理知识库
Chat 模型选择
聊天输入区 ModelSelector
下一条消息可直接指定 LLM profile/model，选择会进入 unified turn payload 和 session preferences。
打开聊天
功能来源矩阵
先分清：哪些是我们做的，哪些来自 DeepTutor
对外介绍时按这四类讲：DeepTutor 是开源底座，IntelliTutor 是 K12 学习产品层；上游更新只做选择性合并，不整仓覆盖。
基于 DeepTutor 底座
这些来自开源 DeepTutor 的通用学习助手基础能力，我们保留并继续接入。
- RAG 与知识库
- 基础 Chat/Deep Solve
- Book / Space / Agents
- 多模型 provider
- reasoning/thinking 展示框架
- 工具调用与附件能力
已合并上游增强
这些不是我们原创，但已被选择性合入 IntelliTutor，并放进我们的主路径。
- v1.3.8 用户隔离与 RAG 授权
- KB 索引版本与 Re-index
- Chat 模型选择器
- Book page chat
- Space hub
- v1.3.9/v1.3.10 稳定性修复
正在打磨
这些是 IntelliTutor 的下一阶段重点，已有入口或雏形，但不会包装成完全自动化。
- 长期学习记忆
- 掌握度自动推荐下一步
- 教师/管理员学情后台
- 更稳定的周报模板
- 更多公开演示素材
- 附件与视觉能力深度合并
产品路线图
我们多了什么、做到什么、计划什么
这里按真实交付状态分层展示，避免把正在打磨的能力说成已经完全自动化。
已上线
- 个人掌握度图谱：聊天后可展示掌握度更新卡片，并跳到个人图谱查看知识点百分比、薄弱点和练习建议。
- 对话驱动掌握度候选：回答下方展示本轮识别到的知识点、匹配分数、图谱来源和复测/讲解入口。
- 数学动画：Math Animator 预览鉴权和生产依赖已修复，默认优先返回 low-quality 静态分镜图。
- 数学资产库：Math Asset Lab 已按七上到九下组织北师大版 demo 目录索引，并为每章提供交互草图、HTML、Manim、讲解页和素材提示。
- 中文阅读：已保留 Book page chat，并可围绕红楼梦、骆驼祥子等阅读图谱做章节和人物关系问答。
- 知识库 Re-index 与模型选择：索引状态、embedding mismatch、Re-index 快捷入口和聊天模型选择已进入主路径。
打磨中
- 学习报告 / 家长报告：已有个人化隔离与报告入口，仍在补齐更稳定的指标口径、样例数据和家长可读表达。
- 学习路径：Guide、Graph、Quiz、掌握度卡片已经串起入口，仍在减少跳转割裂感，让下一步练习更自然。
- 中文阅读：人物关系、主题线索、章节结构已经可做图谱化表达，仍需更多教材和整本书样例沉淀。
- 掌握度更新：候选知识点、未更新原因、复测入口已可见，后续继续降低误判和空更新带来的挫败感。
下一步计划
- 把学习报告与家长报告做成更清楚的周报模板，区分学习进度、薄弱点、建议练习和阅读表现。
- 把学习路径从“入口串联”推进到“按掌握度自动推荐下一步”，但先保留人工确认，避免过度自动化。
- 继续选择性评估 DeepTutor 附件、视觉、多模型和 Agent 更新，只合并对 IntelliTutor 学习体验有帮助的修复。
- 补充更多公开演示素材，让未登录访客也能看懂个人图谱、中文阅读和数学动画的真实差异。
IntelliTutor 产品增强
这些才是用户能感受到的差异化体验
DeepTutor 提供底层学习助手能力；IntelliTutor 的重点是把这些能力落到 K12 学生的个人掌握度、中文阅读和持续学习路径上。
个人掌握度图谱
同一套课程知识点会叠加每个学生自己的掌握百分比、薄弱点和学习状态，不再只是静态知识点网络。
看个人图谱
对话驱动掌握度候选
学生聊题、追问、复测后，系统会展示本轮识别到的候选知识点、匹配证据和可能的掌握度变化，先让判断过程可见。
去聊天验证
中文阅读教学增强
围绕《红楼梦》《骆驼祥子》等课外书做导读、人物关系、章节结构和页面问答，而不是只做通用文件问答。
打开阅读页
书页级阅读问答
Book 页面可以围绕当前页继续追问，并把书页、会话和学习资料串起来，适合边读边讲。
试书页问答
薄弱点到学习路径
把资料、对话、测评、薄弱点和下一步练习串成学习路径，目标是让学生知道下一题为什么要做。
生成学习路径
K12 数学可视化
把 Manim 数学动画、静态分镜和解题过程放到深度解题链路里，优先服务课堂演示和题目讲透。
试数学动画
七到九年级数学资产库
Math Asset Lab 按七上到九下整理北师大版 demo 目录，并为每章提供交互草图、HTML、Manim、讲解页和素材提示。
打开资产库
DeepTutor 同步功能状态
这些不是整仓同步清单，而是已经在 IntelliTutor 主路径中可见或已纳入运行链路的 selected fixes；同步方式继续保持选择性合并，不覆盖品牌、登录、图谱和中文阅读改造。
| 上游来源 | 同步能力 | 当前状态 | 用户可见位置 |
|---|---|---|---|
| DeepTutor v1.3.10 | Markdown 引用保护、大上下文配置、视觉模型兼容、NVIDIA NIM/TutorBot provider 识别 | selected fixes | 聊天渲染、模型配置和 TutorBot 兼容性更稳；不是整版合并 |
| DeepTutor v1.3.9 | 用户消息换行保留、thinking/reasoning 关闭参数兼容、多 provider 请求稳定性 | selected fixes | 粘贴题目和结构化提示更不容易变形，部分模型接口拒绝请求减少 |
| DeepTutor v1.3.8 | 多用户隔离、RAG 授权、设置脱敏 | 已选择性合入 | 普通用户资料隔离，管理员后台与全局配置分权 |
| DeepTutor v1.3.7 | KB 索引版本、重建索引、embedding mismatch | 已接入主路径 | 知识库详情页直接看到索引状态并可 Re-index |
| DeepTutor v1.3.6 | Chat composer 模型选择器 | 已接入 | 同一对话中可按下一条消息切换模型 |
| DeepTutor v1.3.4 | Book page chat | 已保留并绑定书页 | 阅读页右侧可围绕当前页继续问答 |
| DeepTutor v1.3.3 | Space hub 个人资料中心 | 已同步 | Books、Notebooks、Question Bank、Skills、Memory 进入 Space |
DeepTutor 有什么 / IntelliTutor 有什么 / 效果怎样
这张表按严格口径写：没有就写“-”，没落地也写“-”；只有已经存在或已经接入主路径的能力才写说明。
| 能力维度 | DeepTutor 已有 | IntelliTutor 已有 | 实际效果 |
|---|---|---|---|
| 统一学习工作台 | Chat、Deep Solve、Quiz、Research、Math Animator、Visualize 共用同一线程。 | 按 K12 使用路径重排入口与中文说明。 | 学生不用在多个工具之间跳来跳去；老师演示时路径更短。 |
| 用户 / 数据隔离 | v1.3.8 强化多用户隔离、认证边界和 RAG 授权。 | 已选择性合入：知识库、设置、任务日志、图谱掌握度、测评、计划和报告按当前用户隔离。 | 学生之间看不到彼此资料和进度；管理员能力与普通用户能力分开。 |
| v1.3.9 / v1.3.10 稳定性修复 | 聊天换行、thinking 参数、Markdown 引用、大上下文、视觉模型和 TutorBot provider 兼容。 | 已选择性同步关键稳定性 patch。 | 粘贴题目更稳、渲染误伤更少、模型配置兼容性更好。 |
| 知识库 / RAG | 索引版本历史、重建索引 UI、embedding mismatch 检测、RAG 授权。 | 保留索引版本/重建索引页签，并把索引版本数量、embedding mismatch、Re-index 快捷按钮放到详情头部。 | 打开知识库就能看到当前索引状态，换 embedding 后可以直接重建。 |
| Chat 模型选择 | v1.3.6 在 Chat composer 支持按消息切换 LLM profile/model。 | 聊天输入区已接入 ModelSelector，并写入 unified turn payload 和 session preferences。 | 同一段对话里可以临时切 DeepSeek、GLM、Gemini 或默认模型。 |
| Reasoning / Thinking 展示 | 支持 reasoning/thinking block 展示和 DeepSeek thinking 控制。 | 保留 <think>/<thinking> 解析和可折叠“模型思考”卡片。 | 学生能看到推理模型正在思考，但默认折叠，避免整屏都是模型草稿。 |
| 基础知识图谱 | 有基础知识图谱与学习节点能力。 | 保留基础图谱，并增加树形导航、小地图、聚焦、导出、全屏等图谱 UX。 | 知识点结构更容易浏览和演示。 |
| 个人掌握度图谱 | - | 聊天过程可展示候选知识点、掌握度变化、未更新原因和复测入口；报告与计划会读取个人状态。 | 同一份课程图谱能逐步变成个人学习地图，但掌握度判断仍以可见证据和复测来校准。 |
| 中文整本书阅读路径 | - | 红楼梦、骆驼祥子等阅读图谱用于人物关系、章节结构和主题追问。 | 阅读教学不只停在文件问答，可以围绕人物、章节和主题组织学习。 |
| Book page chat | v1.3.4 加入 Book page chat，可围绕当前书页继续问答。 | 已保留 page chat 侧栏，并把当前页与对应聊天 session 绑定。 | 读到哪一页就能从哪一页开始问，聊天历史能跟书页关联。 |
| 数学动画 | Math Animator 支持生成数学动画/图片。 | 线上修复 Manim/libffi 依赖，默认降级为 low-quality 静态分镜图。 | 从“十分钟没反应”变成优先快速返回可见图片；课堂上更稳。 |
| 数学 HTML / Manim 资产库 | - | Math Asset Lab 已按七上到九下规划目录、知识点、HTML、Manim、讲解页和素材提示；每章都有交互草图，已有勾股面积、三角形全等、圆周角等正式模型。 | 学生问到相关概念时，可以从回答下方进入模型演示；老师也能按分册查看可用草图和正式模型。 |
| 附件与预览深度增强 | v1.2.3-v1.2.5 强化 PDF/Office/图片/SVG/代码附件、预览和下载。 | - | - |
| 用户系统 | v1.3.8 补强用户隔离能力。 | 注册登录、邀请码、管理员后台、禁用/启用、重置密码、非管理员设置脱敏。 | 可以小规模给学生/老师试用，同时避免普通用户看到运行密钥或改全局配置。 |
| TutorBot | Personal TutorBots 是核心能力，近期也清理了 channel 依赖。 | 保留 TutorBot，并修正创建失败提示、入口和部署环境体验。 | 可以继续做不同学科/不同人格的学习助手。 |
| Space / Notebook / Skills / Memory | v1.3.3 完善 Space hub，把聊天历史、Books、Notebooks、Question Bank、Skills、Memory 串成个人资料中心。 | 已接入 Space hub、Books 页面与 Chat Space menu；聊天里可以引用书籍、历史、笔记、题库、Skills、Memory。 | 学习资料不再散在各处，写 prompt 时也能从 Space 里挑资料。 |
| 学习路径 / Guide | - | Guide 入口已接入图谱、聊天和复测路径。 | 学生能从薄弱点跳到下一步学习建议，但推荐策略仍在打磨。 |
| 学习报告 / 家长报告 | - | Reports 页面已有示例周报、指标卡、Markdown 下载和图谱/聊天入口。 | 能初步把学习进度和薄弱点讲给学生或家长看；正式周报口径仍在打磨。 |
| 教师/管理员学情后台 | - | - | 还没做成正式后台，不应对外宣称已具备。 |
项目更新日志
DeepTutor 上游更新
v1.3.102026.5.11
IntelliTutor 仅选择性同步关键稳定性修复：Markdown 引用保护、大上下文配置、视觉模型兼容和 TutorBot provider 识别；不是整版合并。
v1.3.92026.5.10
IntelliTutor 仅选择性同步用户消息换行保留、thinking/reasoning 关闭参数兼容和多 provider 请求稳定性修复；不是整版合并。
v1.3.82026.5.8
重点强化多用户隔离、认证边界、知识库/RAG 授权、非管理员设置脱敏与隔离测试。本次 IntelliTutor 已按模块选择性合入，不做整仓覆盖。
v1.3.72026.5.7
知识库索引版本历史、重建索引 UI、embedding mismatch 诊断、DeepSeek thinking/reasoning 控制，是本轮最值得产品化合并的有感能力。
v1.3.62026.5.4
Chat 模型选择器进入输入区，并把选择传入 unified runtime，支持按消息切换具体模型。
v1.3.42026.5.3
Book page chat 进入阅读页，可将当前书页与一个聊天 session 绑定，围绕页面内容继续问答。
v1.3.32026.5.2
Space hub 整合 Books、Chat History、Notebooks、Question Bank、Skills、Memory，提供统一个人资料中心。
v1.3.02026.4.27
版本化知识库索引、重建索引流程、Knowledge 管理工作区重做、原始文件预览、索引版本状态、embedding 维度自动发现、SiliconFlow/Aliyun/OpenAI SDK adapters、reasoning-stream 和视觉附件鲁棒性、Space hub、TutorBot/channel 依赖清理、Matrix extra、Windows 启动/调试修复。
v1.2.52026.4.25
持久化聊天附件、右侧文件预览抽屉、代码附件覆盖扩展、附件感知 Deep Solve/Question/Research/Visualize、TutorBot 保存到 Notebook、Markdown 导出、Setup Tour 诊断、滚动/上传选择器修复。
v1.2.42026.4.25
文本/代码/SVG 聊天附件、一键 Setup Tour、uv pip 和 Windows npm 修复、Markdown 聊天导出、紧凑 Knowledge Base UI、主题/popover polish、release/version hardening。
v1.2.32026.4.24
PDF/DOCX/XLSX/PPTX 附件、reasoning thinking-block 展示、embedding send_dimensions 三态开关、LLM provider core refactor、Soul 模板编辑器、Co-Writer 保存到 Notebook、知识库拖拽上传与删除韧性。
v1.2.22026.4.22
用户自定义 Skills、聊天输入性能重构、response_format 自动 fallback、LAN 远程访问修复、sidebar version badge、Deep Solve 图片附件、TutorBot WebSocket auto-start、Book Library UI、visualization 全屏。
IntelliTutor 本项目更新
个人图谱恢复与线上写入验证2026.5.11
恢复管理员账号的红楼梦、骆驼祥子、高中数学三个个人图谱；隐藏内部 seed 知识库；并在线验证聊天能把“判别式与根系关系”“代数与方程”的掌握度写入高中数学图谱。
公开首页与功能说明2026.5.10
新增公开首页，功能说明页移出登录工作区；访客能先看清 IntelliTutor 的真实能力，已登录用户从首页可直接进入学习工作台，受保护页面登录后会回到原路径。
Space Books + KB Re-index2026.5.8
Space hub 新增 Books 页面，知识库详情头部新增索引版本数量、embedding mismatch/needs reindex 提示与 Re-index 快捷按钮，让 v1.3.3/v1.3.7 的可见能力真正出现在主路径上。
有体感功能合并准备2026.5.8
已建立 codex/import-deeptutor-visible-features 分支并拉取 DeepTutor 官方 tags；第一轮优先核对 Knowledge Base 索引版本/重建索引 UI、Chat 模型选择器、DeepSeek thinking 展示、Book page chat、Space hub 的真实可见路径。
IntelliTutor 2026.5.82026.5.8
完成 DeepTutor v1.3.8 隔离更新的选择性合入：知识库接口登录校验、全局 KB 管理员权限、任务日志 owner 校验、设置密钥脱敏、聊天掌握度与图谱/测评/计划/报告个人化隔离，并完成线上部署校验。
IntelliTutor 2026.4.272026.4.27
上线管理员用户管理雏形：用户列表、禁用/启用、管理员切换、重置密码；管理员默认为 pigouwu。
Math Animator 修复2026.4.27
生产环境安装 Manim 依赖，修复 conda libffi 冲突；后端错误不再伪装成 completed 空回复；默认改为 image/low 静态分镜优先。
知识图谱拆分2026.4.27
把旧混合图谱拆成红楼梦阅读图谱、骆驼祥子阅读图谱、高中数学人教A版知识图谱，并修复 SVG 字体颜色和节点居中飞走问题。
功能页升级2026.4.27
新增 IntelliTutor vs DeepTutor 对比表，说明双方能力、我们的增强和实际效果；加入上游/本项目更新日志 tabs。
Phase 0-3 能力增强2026.4.18-20
完成内容分析、学习计划、苏格拉底对话、测评、闪卡、音频陪伴、内容管理、知识图谱入口等多项课堂化能力。
同步策略：IntelliTutor 已选择性同步到 DeepTutor v1.3.10 的关键修复，其中 v1.3.9/v1.3.10 只纳入 selected fixes。后续仍按 dry-run / diff / build / smoke test 的链路评估上游能力，避免整仓覆盖成原版 DeepTutor。
深度解题
面向数学/理科题的多步推理链路，支持图片题、规划、解答、复盘。
专属
知识图谱
把知识点、章节、阅读材料结构化，帮助学生看见知识之间的关系。
专属
数学资产库
七上到九下每章都有交互草图、素材提示和正式模型入口。
专属
课外书学习
可把课外书、阅读材料、讲义纳入学习资料，再用于总结、问答和图谱化。
辅导机器人
创建不同学科/人格的 TutorBot，用于指定场景的陪伴式学习。
共写与笔记
支持写作辅助、读书笔记、学习记录和内容整理。
专属
记忆与个性化
围绕学习过程沉淀上下文，让后续辅导更贴近个人情况。
课外书如何进入知识图谱？
- 进入 Book 或 Knowledge 页面，上传/整理课外书材料。
- 确认材料已进入知识库后，打开 Knowledge Graph。
- 输入“为这本书生成知识图谱/人物关系/章节结构”，即可生成图谱化视图。