开窍 · AI 私人老师

简体中文 · English

给 DeepSeek Harness 装一位私人老师：说出你想弄懂的东西，它先了解你，再为你做一门课，在手写黑板上边写边讲。

能做什么 · 安装 · 三分钟上手 · 界面预览 · 使用指南 · 隐私 · 常见问题 · 支持作者

能做什么

| 能力 | 体验 | | --- | --- | | 为你定制一门课 | 说一句想学什么，或者丢进一本教材。老师可以先联网查一查这个主题，再用几道选择题了解你的基础、目标、时间和想要的课程规模，再一边写一边展示「单元 → 章 → 讲」的课程蓝图。你可以直接改，可以让老师把一讲拆开或讲深，也可以用一句话让它改（先看修改建议再应用）；开课后还能继续加讲、加单元。确认后生成实战项目和第一单元的练习，后面各讲的练习学到时再出 | | 手写黑板课堂 | 老师一边讲（语音 + 字幕），一边用手写体在黑板上逐字写下要点、公式、示意图和图表，讲到哪句写哪句，正在讲的内容用荧光笔划出；由公式画的曲线按公式逐点算出，带参数的还能拖动滑块看它怎么变；整讲的板书排在一张能拖动、缩放的画布上，镜头跟着老师走；侧栏显示课堂要点进度和讲解记录；随时暂停、回放、变速 | | 随堂小测与自适应 | 讲到关键处会停下来考你一题，并问你「有多确定」。猜对、犹豫、自信地答错，会被区别对待；有计算的一讲会请你写出过程，写错了老师就在黑板上订正。学完一讲后，薄弱的知识点会自动加一节巩固课 | | 举手提问、换个讲法 | 没听懂就举手，老师在黑板上专门回答你，讲完回到原来的进度；问题可以打字，也可以直接说出来（用 DSH 的语音输入在本机识别）；也可以让它用打比方、画图、举例、讲简单点或讲深一点的方式重讲这一步。觉得讲错了就点「这一步不对？」：老师先仔细核对，真错了就在黑板上更正，并把这一讲改好；没错就讲清为什么 | | 练习、闪卡与复习 | 每讲都有练习，题目可以带示意图，简答题由 AI 批改，支持键盘作答；觉得题目或判分有问题就点「这题有问题？」，老师先仔细核对，题错了就改好、重新判分（以前答过的也一起重判）并修正掌握度；做完一组给出星级、掌握程度变化和下一步建议。闪卡和知识点按间隔重复安排复习，学习计划会自动给复习留出时间 | | 资料变课程 | 支持 PDF、Word、PPT、Markdown、网页链接和图片（图片需要支持识图的模型）。讲课和速查表会引用原文页码；长文档可以一键「消化」成结构、论点和术语表 | | 速查表、笔记、测验 | 按主题整理的可打印速查表（列数、字号、高亮可调），以及笔记、闪卡组和测验 | | 讲解短片 + 导出 | 输入一个主题或网址，得到一段约两分钟的白板讲解；任何一讲都能导出成带板书动画、字幕和水印的视频，也能把板书导出成 PDF（一页一张板书，带手写字体和公式）或每页一张的 PNG 图片 | | 实战项目 | 代码类项目一键生成项目文件夹和起始文件，并在 DSH 里打开一个会话，让编程 Agent 陪你做；做完回来提交，老师按评分标准逐项点评 | | 学习计划与画像 | 按每周时间、学习日和截止日期自动排课并提示进度风险；月历里学完自动打勾，也能手动勾选，计划随之重排；老师会记住你的背景和薄弱点，你可以随时查看、修改或清空 | | 对话里也能用 | 新增「开窍 · AI 私人老师」会话预设：在 DSH 对话中，老师可以上白板讲解、出互动小测、帮你建课、做速查表 |

不想先花 token？首页自带两门示例课（「简谐运动」「贝叶斯思维」），打开就能体验完整的黑板课堂。

安装

先准备好 DeepSeek Harness 桌面版（0.2.1 及以上的 0.2.x 版本），并在 DSH 里配置好至少一个可用的模型。尚未安装 DSH，可查看 DSH 官方说明。

1. 打开桌面应用的插件页，点击添加插件，在包名或地址中填入：

   dsh-aha-tutor

   安装源选择官方源，点击安装。新版本刚发布的 24 小时内，DSH 的 pnpm 会因为发布冷却期暂缓安装，这时请填入精确版本，例如 [email protected]。

2. 完全退出并重新打开 DSH 桌面应用。只刷新页面不会加载 Host 端的新插件。

3. 左侧栏出现 「开窍 · AI 私人老师」，点开即可使用。

• 从 GitHub Releases 下载 dsh-aha-tutor-<版本>.tgz，在包名或地址中填入它的绝对路径。
• 自建 profile 可以用 dsh plugin --profile <name> add dsh-aha-tutor@<版本>。不要对 desktop profile 使用这条命令，桌面版请走插件页。

三分钟上手

1. 说出目标：在首页输入「三周内搞懂线性代数里的特征值」，或附上一份讲义，点开始。
2. 回答几个问题：选一选你的基础、目的和节奏，点生成课程蓝图。不满意就直接改，或者写一句「多加一些编程练习」。
3. 确认开课：点确认，生成整门课，然后在课程页点继续学习，老师就会在黑板上开讲。

想快速问一个概念、解一道题、看一张图？用首页的「讲个概念」「陪我解题」「画出来看看」，不用建课。

界面预览

| 首页 | 黑板课堂 | | --- | --- | | | | | 随堂小测 | 导出的讲解视频 | | | |

语音

| 方式 | 说明 | | --- | --- | | 系统语音（默认，免费） | 使用 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 或其他任何学习产品均无隶属关系。

支持作者

开窍免费开源，赞赏全凭心意。如果它帮你弄懂了某个卡了很久的知识点，欢迎扫码支持，让小窍继续长大。