前言¶
在 DeepSeek Harness（DSH）里做学习或复习时，常见情况是讲义、笔记、题库分散在不同文件里；直接问模型又容易得到「看起来合理、却和你手头资料不一致」的回答。社区插件 dsh-notebook（仓库 Rebebberd/dsh-notebook）把每个主题做成一个封闭知识箱：问答与出题只依据你导入的内容，并标注出处；数据落在本机 $DSH_HOME/storages/notebook/，默认不出网。目录站 skillhub.cn 将其归类为「记忆」；仓库 README 自述为学习工具向插件，目标宿主为 DSH Web 预览版。
下面介绍它解决什么问题、四个分区各自做什么、如何安装，以及使用时的限制与权限边界。
这是什么¶
dsh-notebook 由维护者 Rebebberd 发布，当前版本 0.2.3（MIT 许可证）。一句话定位：导入 Markdown / 纯文本 / PDF，在同一界面里按资料提问、按资料出题、记笔记，回答引用箱内片段；笔记与错题可批量导出 Markdown（含 Obsidian 友好用法）。插件通过宿主 webServer 注册 /notebook 前缀路由，客户端为 Web profile 注入的 React 界面，侧边栏出现「学习区」入口。
核心功能：四个分区¶
仓库 README 用一张表概括能力，经核对后如下。
| 分区 | 能做什么 |
|---|---|
| 资料 | 导入 Markdown / 纯文本 / PDF，支持多文件与整个文件夹；右侧查看原文并跳转定位；导入时自动生成一句话「资料画像」 |
| 问答 | 按「资料画像 + 命中片段」回答并标注 [资料名#片段]；命中不足时自动扩大范围并提示；选中任意文字可按「就这段提问」 |
| 笔记 | 自动分区记录，可编辑、打标签；批量导出 Markdown（知识点 / 练习题 / 错题本 / 问答 / 合并） |
| 做题 | 按题型、难度、范围出题，逐题生成逐题保存，关掉不丢；作答前不给答案，答错才给改法与参考答案；错题自动进错题本 |
出题或答题时若勾选「联网参考」，才会调用 DSH 提供的 Web 搜索能力；默认仍是不出网。模型使用你在 DSH 里配置的模型，四个分区可切换，插件不内置、不转发 API Key。
安装与启用¶
推荐通过 DSH CLI 从 GitHub 安装。将 --profile web 换成你实际使用的 profile 名（例如 desktop）即可。
dsh plugin --profile web add github:Rebebberd/dsh-notebook
安装后重启 profile，侧边栏应出现「学习区」图标。仓库根目录即插件包（package.json 已声明 dsh.bundle.patch），无需额外构建参数。
在「添加插件」对话框里应粘贴完整仓库地址 https://github.com/Rebebberd/dsh-notebook。不要只填 npm 包名 dsh-notebook——该名在 npm 上被占位包占用，装到的不是本插件。
Windows 用户可从 Releases 下载 NoteBook-<version>-Setup.exe，安装程序会定位 ~/.dsh 并写入 profile。
已验证环境包括 DSH desktop 0.2.0-rc.2（Node 24 / pnpm 11），要求 dsh.client.platform = web，Node >=20。源码为 ESM，安装后直接可加载，无 postinstall 脚本。
典型用法（可复现流程）¶
README 未给出单独的配置文件示例，用法围绕「学习区」工作流展开，可按下面顺序操作。
- 新建或打开一个学习区，在 资料 分区导入讲义、笔记或 PDF（可多文件或整文件夹）。
- 在资料右侧查看原文；需要时选中一段文字，用「就这段提问」进入 问答，核对回答中的
[资料名#片段]是否与原文一致。 - 在 笔记 分区编辑、打标签；需要归档时用批量导出，选择知识点、练习题、错题本、问答或合并等导出类型。
- 在 做题 分区按题型、难度、范围出题，逐题作答；错题会自动进入错题本，可再通过笔记导出到 Obsidian 等工具。
删除某个学习区会连同其资料、笔记、错题一并删除，且不可恢复，操作前请自行备份 $DSH_HOME/storages/notebook/ 下需要保留的内容。
权限、数据与已知限制¶
权限与外部依赖（上架说明，与 README 一致）：
- 文件：只读取你主动导入的文件，不做目录扫描；写入仅在
$DSH_HOME/storages/notebook/。 - 网络：默认不出网；仅在你勾选「联网参考」时使用 DSH Web 搜索。
- 模型与凭据：用 DSH 已配置模型；插件不保存 API Key。
- 命令：不执行系统命令，不加载远程代码。
已知限制：
- PDF 需带文字层；扫描件需 OCR 或粘贴文本。
- PDF 提取依赖 FlateDecode；LZW 等其它压缩方式不支持；加密 PDF 无法导入。
- 单份资料过长会切分为片段，问答时只把检索到的片段送入模型。
插件以当前 DSH 进程权限运行；安装前建议在 GitHub 查看源码与 MIT LICENSE。DSH 生态强调「一切皆插件」；skillhub.cn 为社区目录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-notebook 适合把分散资料收进本机封闭箱、又要答案可溯源、还要在同一套界面里练题和记笔记的场景。更多信息见目录页 https://www.skillhub.cn/plugins/Rebebberd/dsh-notebook 与仓库 https://github.com/Rebebberd/dsh-notebook。
