Introduction¶

For developers working on DSH plugins, a common requirement is likely encountered: while Agents can discuss literature within the session, the source materials are scattered across an Obsidian knowledge base, forcing users to switch between tools for reading, annotating, taking notes, and recording. dsh-literature-hub is a client plugin released by maintainer 3469915488-oss. It brings PDFs, DOCXs, Markdown files, and HTMLs from the Obsidian knowledge base into a unified reading interface, offering annotations, rich-text notes, companion sessions, and local Whisper transcription within the same window. This article introduces its positioning, installation method, and typical usage.

What is it¶

One-sentence positioning: A local literature hub plugin for DSH. It reads the local knowledge base using the permissions of the current dsh process, operates without internet access, and does not scrape web pages. It is maintained by the community maintainer 3469915488-oss and follows the MIT license. The source code states support for DeepSeek Harness >=0.2.1-rc.5 <0.3.0-0, with a Node.js version requirement of 24 or higher.

It should be noted that DSH’s ecosystem philosophy is “everything is a plugin,” and the community directory is an independent site with no official affiliation to DeepSeek/Huafang. The facts presented here are taken from the maintainer’s repository.

Core Features¶

The capabilities and version information listed in the README are as follows, all of which can be verified in the repository.

• File & Directory Management: A real folder tree that supports multi-level directories, import, rename, move, current-layer search, and recoverable delete.
• Reading: PDF reading, DOCX structured body parsing, Chinese preview; scan-type PDFs invoke local OCR on demand.
• Annotation: Highlights, underlines, sketches, side notes, and custom tags. Body markings, the annotation panel, and note references can locate each other.
• Notes: Each document corresponds to a Markdown note in the same directory; annotation references, free notes, and audio cards share the same rich-text editor.
• Companion: Uses Harness’s native companion dialogue; the Agent can query current materials, the local knowledge base, notes, annotations, learning profiles, and citation information.
• Learning Records: After manually starting learning, knowledge maps, exercises, wrong questions, and review cards can be saved.
• Offline Transcription: Local Whisper multi-language transcription, supports waveform playback and a draggable recording details window. The smart summary only sends the full transcript to the current Harness model after clicking.

Regarding boundaries, the README explicitly states that the library has no internet search or web scraping; originals, parsed bodies, annotations, notes, and audio are all saved in the knowledge base.

Installation and Enablement¶

In Harness’s “Plugins” page, select “Add Plugin” and enter the fixed release version; do not construct the installation command yourself:

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

Restart Harness and enable “Library” in the “Installed” list. The README notes that when the plugin is closed, knowledge base materials, notes, annotations, recordings, and session projections are still retained.

The default knowledge base is ~/Documents/Obsidian. If using a different Obsidian knowledge base, you need to modify ~/.dsh/profiles/desktop/cordis.patch.yml:

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

Before installation, it is recommended to review the source code, LICENSE, and THIRD-PARTY-NOTICES.md to confirm runtime permissions and the scope of third-party dependency licenses. The plugin runs with the permissions of the current dsh process and can access local files that the process can read.

Typical Usage¶

Following the “Five Minute Start” in the README, the operation sequence is as follows.

1. Add and enable “Library” in Harness’s “Plugins” page, then restart the app.
2. Open “Library” in the main sidebar, select an existing directory or create a folder on the left.
3. Click “Import Materials” to import PDF, DOCX, Markdown, or HTML files.
4. Select text in the body, choose highlight, underline, sketch, side note, or ask the companion.
5. Open “Notes” to edit quick notes, or after recording audio click “Transcribe”. When AI summary is needed, click “Smart Summary” in the recording details.

Regarding the interface layout: the left side shows the Obsidian directory and current-layer search, the middle displays the original text, and the top right is a fixed annotation bar while the bottom right shows the notes and recording for the same document. The Harness workspace sidebar retains its native display, allowing continued access to plugins, automation tasks, and session logs.

Whisper offline transcription relies on local deployment; see the repository’s docs/Whisper部署.md for specific steps.

Use Cases and Notes¶

It is suitable for users who want to complete the “read materials — annotate — take notes — transcribe recordings” loop within DSH and prefer materials to remain in the local knowledge base. It is aimed at developers who have their own Obsidian knowledge base and are willing to accept manual path configuration and local model transcription.

Notes:

• Version numbers, licenses, and configuration fields are authoritative only according to the original text in the repository; the versions and fields given above (e.g., v2.1.3, MIT, vaultPath) are those explicitly mentioned in the README.
• The plugin runs with the permissions of the current dsh process; source code and licenses should be checked before installation.
• The smart summary sends the full transcript to the current Harness model upon clicking; please confirm this data flow before enabling it.
• The community directory page and the GitHub repository are two separate entry points; the facts presented here are derived from the GitHub repository.

Conclusion¶

The value of dsh-literature-hub lies in bringing local reading and annotation into the DSH workspace without introducing internet dependencies. If your literature is already in Obsidian, install it using the fixed version above, configure vaultPath, and go through the “Five Minute Start” process to verify.

Directory: https://www.skillhub.cn/plugins/3469915488-oss/dsh-literature-hub

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