前言¶
在 DeepSeek Harness（DSH）里接模型、跑 Agent，解决的是「能问、能写、能改代码」；真要系统学一门主题，常见做法仍是自己拆教材、记笔记，或把长对话当课堂——结构松散，也很难边讲边可视化推导。社区维护者 BaronCyrus 开源的客户端插件 开窍（dsh-aha-tutor） 把路径收成：先了解你的基础与目标，生成可编辑的课程蓝图，再在带语音与字幕的手写黑板上逐讲推进，并配套小测、练习与复习。下面介绍它是什么、能做什么，以及如何安装与上手。
这是什么¶
开窍 · AI 私人老师（npm 包名 dsh-aha-tutor）是面向 DSH 桌面版的客户端插件，分类为「客户端」。一句话定位：给 DeepSeek Harness 装一位私人老师——说出想弄懂的内容（或附上教材），插件先了解你，再定制「单元 → 章 → 讲」的课程，在手写黑板上边写边讲。
- 维护者：BaronCyrus
- 仓库：github.com/BaronCyrus/dsh-aha-tutor
- 社区目录：skillhub.cn/plugins/BaronCyrus/dsh-aha-tutor
- 许可证：MIT（README 与 package.json 一致）
- 当前 README 旁注的 npm 版本示例：
dsh-aha-tutor@1.5.0（以你安装时插件页或 npm 为准）
插件与 DeepSeek 或其他学习产品无隶属关系；DSH 生态强调「一切皆插件」，SkillHub 目录为社区站点，并非官方应用商店。
核心功能¶
以下能力均来自项目 README 中的说明。
定制课程与资料导入¶
说一句想学什么，或丢进教材；老师可先联网查主题，再用选择题了解基础、目标、时间和课程规模，边写边展示课程蓝图。蓝图可直接改、拆讲、加深，或用一句话提出修改建议后再应用。确认后可生成实战项目和第一单元练习，后续各讲练习在学到时再出。
资料支持 PDF、Word、PPT、Markdown、网页链接和图片（图片需支持识图的模型）；讲课与速查表可引用原文页码，长文档可「消化」成结构、论点和术语表。
手写黑板课堂¶
语音讲解配合字幕；要点、公式、示意图与图表以手写体逐字落在黑板上，当前句用荧光笔标出。整讲板书在可拖动、缩放的画布上，镜头跟随讲解；侧栏有要点进度与讲解记录。支持暂停、回放、变速。
随堂测、提问与自适应¶
关键处停顿出题，并询问「有多确定」；猜对、犹豫、自信答错会区别对待。含计算的一讲可要求写出过程，错误时在黑板上订正。学完一讲后，薄弱知识点可自动加巩固课。可举手提问（打字或 DSH 本机语音输入），或在黑板上换讲法（打比方、画图、举例、深浅调整）。
练习、闪卡、计划与导出¶
每讲有练习（可带示意图，简答题由 AI 批改）；闪卡与知识点按间隔重复安排复习，学习计划会预留复习时间。可按主题生成可打印速查表，以及笔记、闪卡组与测验。
输入主题或网址可生成约两分钟的白板讲解短片；单讲可导出带板书动画、字幕与水印的视频，板书可导出 PDF（一页一张，手写字体与公式）或逐页 PNG。
实战项目与 DSH 对话¶
代码类实战项目可一键生成项目目录与起始文件，在 DSH 中打开会话由编程 Agent 陪同完成，提交后按评分标准点评。插件还提供会话预设「开窍 · AI 私人老师」，在普通对话里也能上白板讲解、互动小测、建课或做速查表。
首页自带示例课「简谐运动」「贝叶斯思维」，无需先建课即可体验完整黑板课堂。首页还支持「讲个概念」「陪我解题」「画出来看看」等快捷入口。
模型与语音¶
默认使用 DSH 中配置的默认模型；在 开窍 → 设置 可为「出课与讲课」与「批改与问答」分别指定模型。README 写明：课程结构在确认时生成，每一讲板书在打开该讲时生成（并预备下一讲），练习也在打开时生成，不会在后台批量消耗额度。
语音默认使用 macOS / Windows 系统 TTS（免费）；可选云端语音（OpenAI 兼容接口、火山引擎、MiniMax、Azure 等），密钥存于 DSH 凭据库、仅在 Host 端使用。导出视频时仅云端语音可录入；系统语音导出为带字幕、无配音的视频。
安装与启用¶
前提：DeepSeek Harness 桌面版 0.2.1 及以上的 0.2.x，且在 DSH 中已配置至少一个可用模型。未安装 DSH 可参考 DSH 官方说明。
- 打开桌面应用 插件 页，点击 添加插件，在 包名或地址 填入：
dsh-aha-tutor
安装源选 官方源，点击 安装。若新版本发布未满 24 小时，DSH 的 pnpm 可能因发布冷却暂缓安装，可填精确版本，例如：
dsh-aha-tutor@1.5.0
-
完全退出并重新打开 DSH（仅刷新页面不会加载 Host 端新插件）。
-
左侧栏出现 开窍 · AI 私人老师，点开即可使用。
离线安装：可从 GitHub Releases 下载 dsh-aha-tutor-<版本>.tgz，在包名或地址填该文件的绝对路径。自建 profile 可用 dsh plugin --profile <name> add dsh-aha-tutor@<版本>；不要对 desktop profile 使用该命令，桌面版请走插件页。
更新：在 开窍 → 设置 → 插件版本 检查更新；更新后同样需要完全退出并重启 DSH。在插件页可停用或卸载；卸载不会删除本机学习数据目录。
典型用法¶
README「三分钟上手」流程可直接复现：
- 说出目标：在首页输入例如「三周内搞懂线性代数里的特征值」，或附上讲义，点 开始。
- 回答问题：选择基础、目的与节奏，点 生成课程蓝图；不满意可手改或写一句如「多加一些编程练习」。
- 确认开课：点 确认，生成整门课，在课程页点 继续学习，老师在黑板上开讲。
在 DSH 里用老师：新建会话时，预设选择 开窍 · AI 私人老师。
数据存放与隐私¶
课程、进度、资料、画像与学习计划保存在本机：
$DSH_HOME/aha-tutor/
默认 ~/.dsh/aha-tutor/（Windows 为 C:\Users\<用户名>\.dsh\aha-tutor\）。实战项目目录在 ~/AhaTutor/projects/，插件不会覆盖你已修改的文件。发给模型的内容为完成任务所需的片段（问题、课程结构、相关资料、简短学习画像）。网页导入仅抓取公开地址，不访问本机或局域网地址。详见仓库 SECURITY.md。
适用场景与注意¶
适合希望在 DSH 本机环境里系统学习某一主题、需要可视化板书与节奏控制（暂停、回放、变速）的用户；也适合把 PDF / 讲义转成结构化课程，或需要闪卡、计划与导出视频/PDF 的学习者。开发者可在仓库执行 pnpm install --frozen-lockfile 与 pnpm run check 做本地校验；Host 代码改动后需重启 DSH。
安装任何 DSH 插件前，建议自行查看源码与 MIT 许可证，并理解插件以当前 DSH 进程权限运行。开窍依赖你配置的模型与可选云端语音密钥，使用订阅类模型时请遵守对应服务条款。
结尾¶
开窍把「定制课表 + 黑板讲课 + 测练复习」收进 DSH 客户端插件，数据默认留在本机。想进一步了解细节可看仓库 使用指南（中文）。
