前言¶

做 DSH 插件开发的同行，多半会遇到一类需求：智能体能在会话里聊文献，但资料本身散落在 Obsidian 知识库里，阅读、批注、笔记和录音要切到别的工具。dsh-literature-hub 是维护者 3469915488-oss 发布的客户端插件，它把 Obsidian 知识库中的 PDF、DOCX、Markdown 和 HTML 放进同一个阅读界面，并在同一个窗口里提供批注、富文本笔记、伴读会话和本地 Whisper 转写。本文介绍它的定位、安装方式和典型用法。

这是什么¶

一句话定位：DSH 的本地文献库插件，以当前 dsh 进程的权限读取本地知识库，不联网、不抓取网页。它由社区维护者 3469915488-oss 维护，遵循 MIT 许可证。源码声明支持 DeepSeek Harness >=0.2.1-rc.5 <0.3.0-0，Node.js 版本要求 24 或更高。

需要说明的是，DSH 的生态理念是「一切皆插件」，社区目录是独立站点，与 DeepSeek / 幻方没有官方从属关系。本文写入的是维护者仓库中的事实。

核心功能¶

README 列出的能力和版本信息如下，均可在仓库中核对。

文件与目录管理：真实的文件夹树，支持多级目录、导入、改名、移动、当前层搜索和可恢复删除。

阅读：PDF 阅读、DOCX 结构化正文解析、中文预览；扫描版 PDF 按需调用本地 OCR。

批注：高亮、下划线、勾画、旁注和自定义标签。正文标记、批注面板和笔记引用可以互相定位。

笔记：每篇文献对应同目录下的一个 Markdown 笔记，批注引用、自由笔记和录音卡共用同一个富文本编辑器。

伴读：使用 Harness 原生的伴读对话，Agent 可以查询当前资料、本地知识库、笔记、批注、学习档案和引用信息。

学习记录：手动开启学习后，可保存知识地图、练习、错题和复习卡。

离线转写：本地 Whisper 多语转写，支持波形播放和可拖动的录音详情窗。智能总结只在点击后，把完整转写稿发送给当前 Harness 模型。

边界方面，README 明确写明文献库没有联网检索或网页抓取，原件、解析正文、批注、笔记和音频都保存在知识库中。

安装与启用¶

在 Harness 的「插件」页选择「添加插件」，输入固定发布版本，不要自己拼接安装命令：

github:3469915488-oss/dsh-literature-hub#v2.1.3

重启 Harness，在「已安装」列表中启用「文献库」。README 说明，插件关闭时依然保留知识库资料、笔记、批注、录音和会话投影。

默认知识库为 ~/Documents/Obsidian。如果使用其他 Obsidian 知识库，需要修改 ~/.dsh/profiles/desktop/cordis.patch.yml：

- id: literature-hub
  config:
    vaultPath: /绝对路径/我的-Obsidian-知识库

安装前建议先查看源码和 LICENSE、THIRD-PARTY-NOTICES.md，确认运行权限和第三方依赖的许可范围。插件以当前 dsh 进程的权限运行，能访问该进程能读到的本地文件。

典型用法¶

按照 README 的「五分钟开始」，操作顺序如下。

1. 在 Harness 的「插件」页添加并启用文献库，重启应用。
2. 打开主侧栏的「文献库」，在左侧选择已有目录或创建文件夹。
3. 点击「导入资料」，导入 PDF、DOCX、Markdown 或 HTML 文件。
4. 在正文选中文字，选择高亮、下划线、勾画、旁注，或向伴读提问。
5. 打开「笔记」编辑随记，或录制音频后点击「转写」。需要 AI 总结时，在录音详情中点击「智能总结」。

界面布局上，左侧是 Obsidian 目录和当前层检索，中间阅读原文，右侧上方固定批注栏，右侧下方是同一篇文献的笔记和录音。Harness 工作区侧栏保持原生显示，可以继续进入插件、自动化任务与会话记录。

Whisper 离线转写依赖本地部署，具体步骤见仓库的 docs/Whisper部署.md。

适用场景与注意¶

适合想在 DSH 内完成「读资料—做批注—记笔记—转写录音」闭环、并希望资料留在本地知识库的用户。它面向的是有自己 Obsidian 知识库、能接受手动配置路径和本地建模转写的开发者。

注意事项：

• 版本号、许可证和配置字段只以仓库原文为准，上面给出的是 README 中明确出现的 v2.1.3、MIT 和 vaultPath。
• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 智能总结会在点击后把完整转写稿发送给当前 Harness 模型，启用前请确认这条数据流向。
• 社区目录页与 GitHub 仓库是两个入口，本文事实来自 GitHub 仓库。

结尾¶

dsh-literature-hub 的价值在于把本地阅读和批注收进 DSH 的工作区，同时不引入联网依赖。如果你的文献已经放在 Obsidian 里，按上面的固定版本安装、配置 vaultPath，再走一遍「五分钟开始」即可验证。

目录页：https://www.skillhub.cn/plugins/3469915488-oss/dsh-literature-hub

GitHub：https://github.com/3469915488-oss/dsh-literature-hub