能做什么

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

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

安装

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

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

   dsh-aha-tutor
   

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

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

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

离线安装 / 自建 profile

• 从 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 安装精确的新版本。新版本发布不满 24 小时时会显示「待更新」和可以更新的时间，这是 DSH 的供应链安全策略，不是失败。更新后需要完全退出并重新打开 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 或其他任何学习产品均无隶属关系。

支持作者

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

微信赞赏

支付宝