个性化辅导助手 · 初中版
> 一个面向初中生的「私人 AI 导师」技能。上传教材/试卷/笔记 → 构建专属知识库 → 多智能体答疑、出题、做讲解、画概念图。
> 底层由一套开源（Apache-2.0）的本地个性化辅导引擎驱动，通过命令行调用；本技能让 agent 在你需要时，自动用正确的命令完成学习/备考任务。
> 完整引擎命令见 references/engine-reference.md。
技能介绍
「个性化辅导助手-初中版」把初中的九大学科装进一个随时可问的 AI 助手：
- 全科答疑：语文/数学/英语/物理/化学/生物/历史/地理/道法，遇到不会的题、不懂的概念，直接问。
- 知识点讲解：用初中生能听懂的话拆解难点，配交互式概念图。
- 习题生成：按章节/知识点/难度自动出练习题，配答案与解析。
- 教材知识库：把课本 PDF、试卷、错题本建成专属库，问答只基于你的资料，不跑偏。
- 中考备考：专题复习、错题再练、知识点卡片，循序渐进。
一、能做什么（引擎能力）
| 能力命令 | 作用 |
|---|---|
chat |
通用对话（可挂载知识库与工具） |
deep_solve |
分步深度解题，带引用与验证 |
deep_question |
按知识点/难度生成练习题 |
deep_research |
多智能体并行深度研究，产出带引用的报告 |
visualize |
把概念/算法渲染成交互式可视化页面 |
math_animator |
数学动画（需 Manim/LaTeX/ffmpeg） |
mastery_path |
知识点掌握路径与测评 |
辅助对象：知识库(KB)、会话(Sessions)、笔记本(Notebooks)、记忆(Memory)。
二、适用对象与学科范围
- 对象：初中七年级 ~ 九年级学生、初中家长陪学、初中家教/教师备课。
- 学科：语文、数学、英语、物理、化学、生物、历史、地理、道德与法治、信息技术。
- 典型场景：作业辅导、课前预习、课后复习、期中/期末复习、中考一轮/二轮复习、错题本整理。
三、安装（首次使用必做）
> 前提：Python 3.11+。完整 Web 应用额外需要 Node.js 20+（仅用 CLI 做问答/出题/研究不需要 Node）。
> 本技能提供辅助脚本 scripts/tutor_helper.py 做检测/安装/初始化，但不会在技能加载时自动执行——仅在用户明确要求"安装/初始化辅导引擎"时由 agent 显式调用。
方式 A — pip 安装（推荐）
pip install -U deeptutor # 完整应用（含 Web 前端）
# 或仅 CLI（轻量，无 Node 依赖）：
pip install -U deeptutor-cli
首次初始化（写入配置）
deeptutor init # 交互向导：端口 → LLM → 嵌入模型 → 检索 → 确认
# CLI 专用可加 --cli 跳过端口步骤；--home <path> 指定工作区
> Windows 提示：若 deeptutor 不在 PATH，可用 python -m deeptutor_cli.main <子命令> 等价调用。
> 先跑一次 python scripts/tutor_helper.py check 确认 Python 版本与是否已安装。
四、常用命令速查
> 下列命令假设 deeptutor 已在 PATH；否则替换为 python -m deeptutor_cli.main。
deeptutor chat # 交互式 REPL
deeptutor run chat "解释牛顿第三定律" --kb textbook --tool rag
deeptutor run deep_solve "解 x^2 = 4" --tool rag --kb textbook
deeptutor run deep_question "一元二次方程" --config num_questions=5
deeptutor run visualize "画出一次函数图像"
# 能力集合：chat | deep_solve | deep_question | deep_research | visualize | math_animator | mastery_path
# run 通用选项：--session | --tool/-t(可重复) | --kb(可重复) | --language/-l | --config key=value(可重复) | --format rich|json
deeptutor kb list [--format rich|json]
deeptutor kb create <name> --doc ch1.pdf --doc ch2.pdf # 从文件建库
deeptutor kb create <name> --docs-dir ./papers # 从目录建库
deeptutor kb add <name> --doc more.pdf # 增量追加
deeptutor kb search <name> "查询文本" [--mode hybrid]
deeptutor kb set-default <name>
deeptutor kb delete <name> [--force]
deeptutor session list [--limit 20] | show <id> | open <id> | rename <id> --title "..." | delete <id>
deeptutor notebook list | create <name> | show <id> | add-md <id> <file.md>
deeptutor config show
deeptutor serve [--host 0.0.0.0] [--port 8001] [--reload] # 仅启动 API 服务（后台运行）
deeptutor start [--home <path>] # 同时启动后端 + 前端（Ctrl+C 停止）
deeptutor init [--cli] [--home <path>]
五、初中典型工作流（agent 照此执行）
首次搭建
pip install -U deeptutor
deeptutor init # 交互式配置 LLM/嵌入模型（需 API Key）
用教材建库并问答
deeptutor kb create junior-math --doc 七年级数学.pdf --doc 八年级数学.pdf
deeptutor run chat "讲解全等三角形的判定" --kb junior-math --tool rag
生成章节练习题
deeptutor run deep_question "一次函数" --kb junior-math --config num_questions=8
中考专题复习（挂载知识库 + 联网）
deeptutor chat --kb junior-physics --tool rag --tool web_search
启动完整 Web 应用（本地）
deeptutor start # 后端+前端；默认 http://127.0.0.1:3782
六、辅助脚本
scripts/tutor_helper.py（跨平台 Python）提供安全的管理子命令，由 agent 在用户明确要求时显式调用：
python scripts/tutor_helper.py check # 检测 Python 版本 / 是否已安装引擎
python scripts/tutor_helper.py install # 安装引擎（pip install -U deeptutor）
python scripts/tutor_helper.py init # 运行首次配置向导
> 注意：启动服务(deeptutor start/serve)应由 agent 用 Bash 后台方式直接运行，不要在辅助脚本里阻塞。
七、触发与注意事项
- 当用户的意图落在"初中学习/备考/出题/知识库/作业辅导"任一范畴时加载本技能。
- 需要 LLM API Key（在
deeptutor init或 Web Settings → Models 中配置）。 - 知识库与配置默认存于启动目录下的
data/user/settings/，可用--home指定。 - 引擎为本地开源项目（Apache-2.0），数据默认保存在本地，注意敏感资料勿上传至不可信环境。
