前言¶
在 DSH 里做长期学习或面试复习时，常见做法是依赖会话上下文或通用记忆插件。上下文会随窗口截断而丢失；纯记忆类插件往往缺少「每条结论对应哪份材料、哪一页」的结构化出处，模型也容易在库外内容上装成已掌握。dsh-study-mode 把 agent 预设「学习模式」和侧边栏「学习知识库」面板打在一个 npm 包里：回答时先查本地主题库，命中标出处，库里没有则标「未验证」，需要查证才联网并标日期。维护者为 waspqj，在 DSH 插件生态中归类为「记忆」；源码与发布以 GitHub 仓库 waspqj/dsh-study-mode 与 npm 包 dsh-study-mode 为准（MIT 许可，package.json 当前版本 0.3.26）。
这是什么¶
一句话：学习模式（study-mode）agent 预设 + 侧边栏知识库面板——把知识沉淀进按主题划分的本地库，提问时检索优先，查到了标出处，查不到标未验证。
一个包包含两样东西：
| 组件 | 作用 |
|---|---|
| agent 预设「学习模式」 | 新建会话时选用；回答顺序为主题库 → 全局主题 → 模型知识（标未验证）→ 按需联网（标日期） |
| 侧边栏「学习知识库」面板 | 书本图标：按主题浏览、搜索、互链、归档 / 恢复 / 删除 / 手动新增、AI 校验补充 |
与「功能清单更长」的同类方案相比，README 强调三条取舍：查不到不装作知道；每条卡片带结构化出处（文件 / 网页 / 用户口述 + 页码等）；卡片正文可用 [[另一张卡的标题]] 互链，形成「链接 / 被引用」关系网。检索为本地 BM25，不调模型、不联网、不上传内容；不做向量库、不依赖 Python 模型。
核心功能¶
回答与标记¶
选用「学习模式」预设后，模型会自行查库。回答中常见三种标记：
| 标记 | 含义 |
|---|---|
[主题:名称] |
命中知识库，有出处可查原文 |
[模型知识·未验证] |
库里没有对应条目，使用模型知识 |
[网络:日期] |
经联网查证 |
命中卡片时，对话下方可展示卡片摘要、出处与核实状态，以及「相关知识点」等已建链邻居。卡片上提供「AI 校验补充」「编辑」「问一下」等动作。
入库与补全¶
- 需要入库时对模型说「把这条记下来」——先预览卡片，点「确认写入 N 条」批量落盘；也可展开单张逐条确认。
- 库里缺条目时，对话下方会出现补全提议，可勾选、改主题，同意后出预览再确认写入。
- 侧边栏面板支持手动新增、全库搜索、按主题浏览；未核实条目需点两次「核实」（第一次上膛，第二次才生效），批量核实同样二次确认。
面板与互链¶
左侧为主题列表（各主题可有独立颜色），右侧按出处分组展示卡片，组内可按页码排序；组头可「连成一组」形成链式视图，右上角可切「平铺」。面板顶部可单独指定插件用于 AI 校验、检索重排的模型。
知识库默认路径：
~/.dsh/learn/
├── settings.json
└── topics/<主题>/kb.jsonl
可通过环境变量 DSH_LEARN_ROOT 改根目录；条目为 JSONL，便于 grep 或自行脚本处理。插件只写该目录，README 说明不与其它记忆 / 知识库插件冲突；预设仅在主动选择「学习模式」的会话中生效。
安装与启用¶
命令行安装（资料原文）：
dsh plugin --profile web add dsh-study-mode
也可在 DSH「插件」页 →「添加插件」→「安装第三方插件」，填写 npm 包名 dsh-study-mode，或 GitHub / Gitee 的 git+https://… 地址、tarball、本地目录等（Gitee 须带 git+ 前缀）。国内可在安装源选择 npmmirror 等镜像。装完后需重启 DSH。勿与开发副本同时安装同一 id 的包。
装完建议核对四点：插件页中 dsh-study-mode 已启用；新建会话预设列表有「学习模式」；侧边栏有书本图标；面板左侧主题、右侧条目、顶部搜索框正常。
典型用法¶
- 新建会话，选择「学习模式」预设，直接提具体问题（例如「间隙锁是什么」）——不必先说「查一下知识库」，避免多余工具往返。
- 要把对话结论入库，说「把这条记下来」，预览后确认写入。
- 接受或调整模型提出的补库提议，预览后写入。
- 点侧边栏书本图标维护库：搜索、归档、互链、核实、AI 校验补充。
问法上，README 建议：具体问题不限定领域；范围性问题可带领域（如「MySQL 8.0 的常考点」）；数字与参数以卡片原文为准；同一问题 10 分钟内重复问会走检索缓存。学习模式比普通模式多检索相关往返，token 主要花在工具往返而非 BM25 本身。
适用场景与注意¶
适合：需要把课件、笔记、口述要点沉淀成本地主题库，并在对话中优先引用、明确区分「库内已核实 / 未验证 / 联网查证」的学习与复习场景。
注意：
- 插件在 DSH 进程权限下运行，安装前应阅读源码与 MIT 许可证，确认行为边界（不后台抓文件、不默认联网抓取、不上传库内容）。
- 库默认在本机
~/.dsh/learn，换机器不自动同步，需自行备份或设置DSH_LEARN_ROOT。 - 社区目录页 skillhub.cn/plugins/waspqj/dsh-study-mode 与 dsh-plugin.org 为生态收录入口，与 DeepSeek / 幻方无官方从属关系；DSH 理念是「一切皆插件」。
自定义 agent 人设与检索协议可编辑包内 cordis.patch.yml 中 preset-study → config.plugins → persona → config.prefix，改完重启 DSH；可用 npm run check 做接线自检。
结尾¶
dsh-study-mode 用「检索优先 + 出处 + 未验证标注 + 本地 JSONL 主题库」把学习对话和可维护的知识卡片绑在一起。进一步了解可查看插件目录页与 GitHub README：
- 目录页：https://www.skillhub.cn/plugins/waspqj/dsh-study-mode
- GitHub：https://github.com/waspqj/dsh-study-mode
