dsh-obsidian: A Single Obsidian Plugin for DeepSeek Harness

Introduction¶

The philosophy of DeepSeek Harness (DSH) is “everything is a plugin”. dsh-obsidian is a single DeepSeek Harness plugin that turns Obsidian into a “self-organizing AI second brain”. It merges the two upstream plugins dsh-plugin-wiki-skills and dsh-plugin-wiki-tools, aiming to solve the issues that upstream plugins frequently break APIs due to rapid iteration of the DSH framework, and that split plugins are not user-friendly for individual users. This plugin provides unified version management and a clear v2.x upgrade path.

Core Features¶

The plugin provides capabilities by registering on ctx.tools and ctx.skills.

Tools¶

Tool Name	Purpose
`wiki_query`	BM25 retrieval, returning fragments and a link graph; quick mode returns hot + index
`wiki_write`	Single-page write, including type routing, frontmatter completion, index/log bookkeeping, and source-hash deduplication
`wiki_lint`	Health check: detects duplicates, dead links, orphan pages, missing frontmatter, empty sections, and invalid index/hot
`wiki_scaffold`	Initializes the LLM Wiki directory structure (dry-run by default)
`wiki_rename`	Renames pages (including machine page protection)
`wiki_list`	Lists all page titles

Skills¶

Skill Name	Purpose
`wiki`	Vault scaffolding and routing
`wiki-ingest`	Captures sources into the vault
`wiki-query`	Answers questions from the vault with citations
`wiki-lint`	Health check workflow
`save`	Archives conversation insights
`think`	10-principle reasoning loop
`obsidian-markdown`	Obsidian Flavored Markdown support
`obsidian-bases`	Bases support
`defuddle`	Context deduplication
`obsidian-cli`	CLI integration

Installation and Configuration¶

Prerequisites¶

DSH 0.x or newer (must include the dsh plugin CLI).
Node.js version ≥ 22.19.
An existing Obsidian vault on disk.

Installation Steps¶

Run the installation command in the terminal:

    dsh plugin --profile web add @qiqiangvae/dsh-obsidian

Edit your DSH profile configuration file (for example ~/.dsh/profiles/web/cordis.patch.yml), and add the following content:

    - id: dsh-obsidian
      config:
        vaultPath: /absolute/path/to/your/obsidian/vault
        # 可选配置：
        # typeFolders: { domain: "wiki/areas" }
        # maxQueryResults: 10

Restart the DSH service:

    dsh web

(Optional) Initialize the directory structure for a new vault:

    # 在 DSH CLI 中运行
    wiki_scaffold 工具，参数 { template: "default", apply: true }

Locking the Version¶

If you need to lock a specific version:

dsh plugin --profile web add @qiqiangvae/dsh-obsidian@0.1.0

Technical Details¶

Dependencies and License¶

Dependencies: @deepseek-ai/cordis, @deepseek-ai/dsh-tools, @deepseek-ai/schemastery.
License: MIT.
Scoped Package Name: The non-scoped dsh-obsidian has already been used by another unrelated vault file-system plugin, so this package uses @qiqiangvae/dsh-obsidian as the unique identifier.

Development¶

The plugin is developed with TypeScript. During development, run pnpm run build to compile src/ into lib/, then in DSH run dsh plugin --profile web add link:$(pwd) for local debugging.

Notes¶

Permissions: The plugin runs with the permissions of the current DSH process. Ensure that the configured vaultPath is accessible to the process.
Ecosystem: The plugin belongs to the DeepSeek Harness ecosystem and has no official affiliation with DeepSeek / Huanfang.
Source Review: Before installing any plugin, it is recommended to read the source code and ATTRIBUTION.md to confirm license compatibility and feature boundaries.