dsh-aha-tutor
开窍 Aha Tutor: a personal AI tutor for DeepSeek Harness that builds a course around you and teaches it on a narrated handwriting whiteboard
The plugin will be installed here. Keep web if you are unsure.
npx -y @deepseek-ai/dsh plugin --profile web add github:BaronCyrus/dsh-aha-tutor#7307a6ea6d91ef9a2efb8dca4cbd04bfe6c7c794
Aha Tutor is published as dsh-aha-tutor and currently resolves to version 1.3.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.
简体中文 · English
给 DeepSeek Harness 装一位私人老师：说出你想弄懂的东西，它先了解你，再为你做一门课，在手写黑板上边写边讲。
开窍：笔记本电脑屏幕上是一块写着公式和波形的黑板，灯泡小老师在一旁发光
| 能力 | 体验 |
|---|---|
| 为你定制一门课 | 说一句想学什么，或者丢进一本教材。老师先用几道选择题了解你的基础、目标、时间和想要的课程规模，再一边写一边展示「单元 → 章 → 讲」的课程蓝图。你可以直接改，可以让老师把一讲拆开或讲深，也可以用一句话让它改（先看修改建议再应用）；开课后还能继续加讲、加单元。确认后生成实战项目和第一单元的练习，后面各讲的练习学到时再出 |
| 手写黑板课堂 | 老师一边讲（语音 + 字幕），一边用手写体在黑板上逐字写下要点、公式、示意图和图表，讲到哪句写哪句，正在讲的内容用荧光笔划出；侧栏显示课堂要点进度和讲解记录；随时暂停、回放、变速 |
| 随堂小测与自适应 | 讲到关键处会停下来考你一题，并问你「有多确定」。猜对、犹豫、自信地答错，会被区别对待；有计算的一讲会请你写出过程，写错了老师就在黑板上订正。学完一讲后，薄弱的知识点会自动加一节巩固课 |
| 举手提问、换个讲法 | 没听懂就举手，老师在黑板上专门回答你，讲完回到原来的进度；也可以让它用打比方、画图、举例、讲简单点或讲深一点的方式重讲这一步 |
| 练习、闪卡与复习 | 每讲都有练习，题目可以带示意图，简答题由 AI 批改，支持键盘作答；做完一组给出星级、掌握程度变化和下一步建议。闪卡和知识点按间隔重复安排复习，学习计划会自动给复习留出时间 |
| 资料变课程 | 支持 PDF、Word、PPT、Markdown、网页链接和图片（图片需要支持识图的模型）。讲课和速查表会引用原文页码；长文档可以一键「消化」成结构、论点和术语表 |
| 速查表、笔记、测验 | 按主题整理的可打印速查表（列数、字号、高亮可调），以及笔记、闪卡组和测验 |
| 讲解短片 + 导出视频 | 输入一个主题或网址，得到一段约两分钟的白板讲解；任何一讲都能导出成带板书动画、字幕和水印的视频，适合分享 |
| 实战项目 | 代码类项目一键生成项目文件夹和起始文件，并在 DSH 里打开一个会话，让编程 Agent 陪你做；做完回来提交，老师按评分标准逐项点评 |
| 学习计划与画像 | 按每周时间、学习日和截止日期自动排课并提示进度风险；老师会记住你的背景和薄弱点，你可以随时查看、修改或清空 |
| 对话里也能用 | 新增「开窍 · AI 私人老师」会话预设：在 DSH 对话中，老师可以上白板讲解、出互动小测、帮你建课、做速查表 |
不想先花 token？首页自带两门示例课（「简谐运动」「贝叶斯思维」），打开就能体验完整的黑板课堂。
先准备好 DeepSeek Harness 桌面版（0.2.1 及以上的 0.2.x 版本），并在 DSH 里配置好至少一个可用的模型。尚未安装 DSH，可查看 DSH 官方说明。
打开桌面应用的插件页，点击添加插件，在包名或地址中填入：
dsh-aha-tutor
安装源选择官方源，点击安装。新版本刚发布的 24 小时内，DSH 的 pnpm 会因为发布冷却期暂缓安装，这时请填入精确版本，例如 dsh-aha-tutor@1.3.0。
完全退出并重新打开 DSH 桌面应用。只刷新页面不会加载 Host 端的新插件。
左侧栏出现 「开窍 · AI 私人老师」，点开即可使用。
dsh-aha-tutor-<版本>.tgz，在包名或地址中填入它的绝对路径。dsh plugin --profile <name> add dsh-aha-tutor@<版本>。不要对 desktop profile 使用这条命令，桌面版请走插件页。想快速问一个概念、解一道题、看一张图？用首页的「讲个概念」「陪我解题」「画出来看看」，不用建课。
| 首页 | 黑板课堂 |
|---|---|
| 开窍首页：输入想学的内容并选择模式 | 黑板课堂：手写板书、示意图与字幕 |
| 随堂小测 | 导出的讲解视频 |
| 讲课中途弹出的小测，带信心选择 | 导出视频中的一帧：板书、字幕和水印 |
| 方式 | 说明 |
|---|---|
| 系统语音（默认，免费） | 使用 macOS / Windows 自带的音色，可在设置中挑选；系统没有中文音色时会给出提示 |
| 云端语音（可选） | 支持 OpenAI 兼容接口（含硅基流动等）、火山引擎（豆包语音）、MiniMax、Azure 语音。密钥保存在 DSH 的凭据库中，只在 Host 端使用，不会传给浏览器；合成过的语音会缓存在本机，重播不再计费 |
导出视频时，只有云端语音能被录进视频；用系统语音导出的视频带字幕、没有声音。黑板上的小动画在视频里以一帧静态画面出现。
默认使用你在 DSH 里设置的默认模型。在 开窍 → 设置 里，可以分别为「出课与讲课」和「批改与问答」指定模型，例如出课用更强的模型、批改用更快的模型。
插件不会自动切换到其它付费模型，也不会在后台批量消耗额度：课程结构在你确认时生成，每一讲的板书在你打开时才生成（同时预备下一讲），后面各讲的练习也在打开时才生成。使用订阅类模型时，请遵守对应服务的使用条款。
$DSH_HOME/aha-tutor/（默认 ~/.dsh/aha-tutor/，Windows 为 C:\Users\<用户名>\.dsh\aha-tutor\）。~/AhaTutor/projects/ 下，插件不会覆盖你已经改过的文件。详见 SECURITY.md。
开窍 → 设置 → 插件版本可以检查更新，并用 DSH 自带的 pnpm 安装精确的新版本，新版本刚发布也能直接装上。如果你给 DSH 的 pnpm 显式设置了发布冷却期（minimumReleaseAge），还没过冷却期的版本会显示「待更新」和可以更新的时间，这是 pnpm 的供应链安全策略，不是失败。更新后需要完全退出并重新打开 DSH。
在桌面应用的插件页可以停用或卸载插件。卸载不会删除 ~/.dsh/aha-tutor/ 里的学习数据；不再需要时可以手动删除这个文件夹。
老师没有声音？ 打开 开窍 → 设置 → 语音讲解，点试听。没有中文音色时，可在系统设置里安装中文语音，或改用云端语音。
生成失败或结果不理想？ 点重试，或在设置里为「出课与讲课」换一个更强的模型。
PDF 里读不出文字？ 扫描版 PDF 没有文字层，可以截图后以图片上传（需要支持识图的模型）。
会话里怎么用老师？ 新建会话时，在预设里选择 「开窍 · AI 私人老师」。
pnpm install --frozen-lockfile
pnpm run check
pnpm run check 会依次运行全部测试、构建 Host 与浏览器端的包，并在 .artifacts/ 下打出 tgz。本地开发时，可在 DSH 插件页填入仓库的绝对路径，以 link: 方式安装。改动 Host 代码后，需要重启 DSH 才能生效。仓库结构与约定见 AGENTS.md。
MIT © BaronCyrus。第三方组件的许可见 THIRD_PARTY_NOTICES.md。
「开窍 / Aha Tutor」是独立的开源项目，与 DeepSeek 或其他任何学习产品均无隶属关系。
开窍免费开源，赞赏全凭心意。如果它帮你弄懂了某个卡了很久的知识点，欢迎扫码支持，让小窍继续长大。
| 微信赞赏码 微信赞赏 | 支付宝收款码 支付宝 |