At a glance

What it does

Give a DeepSeek Harness agent file-based access to a local Obsidian vault.

Code-evidenced contributions

What it adds to DSH

Model ToolsObsidian vault tools

Adds 12 tools for finding, reading, writing, moving, trashing, and managing Markdown notes in a local Obsidian vault.

Mechanism evidence ↗

Before you choose it

This DSH bundle mounts 12 obsidian_* tools for Markdown note search, reads, writes, appends, moves, backlink lookup, frontmatter edits, tags, and trash-based deletion. It uses the vault filesystem directly, without an MCP server or OAuth.

Best for

DeepSeek Harness users who want an agent to organize or update notes in a local Obsidian vault.

Common tasks

Search a vault and read matching Markdown notes.
Create, append to, rename, or move notes while updating wikilinks.
Review backlinks, tags, and YAML frontmatter properties.
Move unwanted notes to the vault’s reversible .trash directory.

Permissions and data

Works directly with files in the selected local Obsidian vault.

Permissions

Read vault Markdown notes and their frontmatter.
Create, overwrite, append, move, and rename notes.
Move notes into the vault’s .trash directory.
Optionally use the Obsidian CLI for property changes when enabled and available.

Data handling

Vault paths are resolved from an explicit vaultPath or auto-detected from obsidian.json.
Tool paths are constrained to the vault root.
Search and listing exclude .obsidian, .git, and .trash by default.

External services

No MCP server or OAuth is required.
The Obsidian CLI is optional for property operations.

Credentials

No credentials are described in the supplied evidence.

Limitations

Requires DeepSeek Harness and Node.js 22.12.0 or later.
Runtime installation and vault access were not executed in the supplied evidence.
The package’s npm registry contents were not audited.
By default, only Markdown files are searched.

What DSHub checked

The pinned source has verified DSH bundle structure.
The manifest declares Node.js >=22.12.0 and DSH peer dependencies.
The README states author compatibility verification across dsh v0.1.0-rc.8 through v0.1.5-alpha.1.

What DSHub did not check

Installation, runtime behavior, and filesystem effects were not independently executed.
The npm tarball contents were not audited.

Pinned install

Install dsh-obsidian

This plugin bundle does not have a DSH Plugin install action. Use its source documentation for the delivery method.

Visit the source project ↗

Maintainer source

Project README

View at commit 265d6d6 ↗

Maintainer-authored contentCaptured from README.md on Sep 9, 2026. The text and repository-relative media are fixed to commit 265d6d65f950 with content hash 59e8fef9360b; provider-hosted badges may update independently. README commands are upstream documentation; the DSHub copy action above is the verified, version-pinned install.

dsh-obsidian

把 DeepSeek Harness（dsh）连接到本地 Obsidian vault。因为一个 Obsidian vault 本质上就是磁盘上的一堆 Markdown 文件，所以你的 dsh agent 可以直接搜索、读取、写入、移动和删除（移入回收站）笔记——不需要 MCP server，也不需要 OAuth。

中文 | English

它能帮你做什么

装上 dsh-obsidian 后，你的 dsh agent 就能直接读写本地 Obsidian vault。插件会在启动时自动探测你的 vault（或读取你显式配置的路径），然后把 12 个 obsidian_* 工具挂载给 agent，覆盖搜索、读取、写入、追加、移动、删除和反链查询等日常操作。

特性

零依赖服务器 —— 直接读写 vault 文件系统，无需 Local REST API 社区插件，也无需常驻 MCP server。
默认安全 —— 删除只把笔记移入 .trash/（可逆）、路径无法越出 vault 根目录、绝不触碰 .obsidian/。

工作原理

dsh agent 调用 obsidian_* 工具
   │
   ▼
VaultAccess 接口
   └─ FsAccess —— node:fs + 自研 frontmatter/wikilink 解析（默认，纯文件系统）

启动时插件按「显式 vaultPath 优先，否则从 obsidian.json 自动探测」解析 vault 根目录；useCli 开启且检测到 CLI 时，property:set/property:remove 委托给 CLI，其余操作始终走 FsAccess，任何 CLI 失败都会静默回退到 FsAccess。

安装

dsh plugin --profile web add dsh-obsidian

把 web 换成你运行 agent 所用的 profile（web、headless、tui 等）。

更新

重跑 add 即会拉取最新版（latest）：

dsh plugin --profile web add dsh-obsidian

或锁定具体版本：

dsh plugin --profile web add dsh-obsidian@0.2.3

更新后重启 harness（dsh web）或刷新 Web UI；用 dsh plugin --profile web list 确认版本。

卸载

dsh plugin --profile web remove dsh-obsidian

配置

键	默认值	说明
`vaultPath`	（自动探测）	vault 的绝对路径；留空则按平台从 `obsidian.json` 自动探测当前打开的 vault
`useCli`	`false`	可用时把 `property:set`/`property:remove` 委托给 `obsidian` CLI
`excludeDirs`	`[".obsidian", ".git", ".trash"]`	搜索/列出时排除的目录

工具

工具	作用
`obsidian_list`	列出 vault 里的笔记（可按子目录过滤、限制条数）
`obsidian_search`	全文检索，返回匹配行 + 上下文（大小写不敏感、只搜 `.md`）
`obsidian_read`	读取一篇笔记（正文 + 解析后的 frontmatter）
`obsidian_frontmatter`	只读笔记的 YAML 属性
`obsidian_backlinks`	找出链接到某篇笔记的笔记（`[[wikilink]]`）
`obsidian_write`	新建或覆盖一篇笔记（父目录不存在时自动创建）
`obsidian_append`	向笔记末尾追加内容
`obsidian_move`	移动/重命名笔记（纯文件系统同步更新 `[[链接]]`）
`obsidian_delete`	把笔记移入 `.trash/`（可逆，绝不永久删除）
`obsidian_set_property`	设置或更新笔记的单个 frontmatter 属性（YAML）
`obsidian_delete_property`	删除笔记的某个 frontmatter 属性
`obsidian_tags`	列出 vault 中所有标签及使用次数

所有工具的路径参数都相对于 vault 根目录（例如 Folder/Note.md）。

安全性

路径越界防护 —— 所有路径参数都会解析并校验必须落在 vault 根目录内，越界（../ 或绝对路径逃逸）一律拒绝。
删除可逆 —— obsidian_delete 只把笔记移入 vault 的 .trash/，绝不永久删除。
不碰 .obsidian/ —— 搜索与列出默认排除 .obsidian/、.git/、.trash/。
保护 frontmatter 与 wikilink —— 读取/写入不会破坏 YAML 属性和 [[链接]]（除非任务明确要求改）。

环境要求

DeepSeek Harness（dsh）
Node.js ≥ 22.12.0

已完成对 dsh v0.1.5-alpha.1 的兼容验证（含 v0.1.3-alpha.2、v0.1.3-alpha.1、v0.1.2-rc.1、v0.1.2-alpha.5、v0.1.2-alpha.4、v0.1.2-alpha.3、v0.1.2-alpha.2、v0.1.2-alpha.1、v0.1.1-rc.2 与 v0.1.0-rc.8）。

开发

npm install
npm run build      # tsdown → lib/
npm run typecheck  # tsc --noEmit
npm test           # vitest

更新日志

0.2.3

修复 dsh v0.1.2-alpha.2/alpha.3 移除 @deepseek-ai/dsh-tools 的 JsonValue 转出后，插件源码无法 typecheck/build 的兼容性问题；保留对旧版 dsh 的兼容。

0.2.2

obsidian_tags 与内联 #标签 提取支持中文等 Unicode 字符。
obsidian_backlinks / obsidian_move 按 Obsidian 规则唯一解析 [[链接]]：同名笔记不再被误判，歧义链接不再被误改。
obsidian_set_property / obsidian_delete_property 编辑属性时保留原有 YAML 注释、锚点/别名与多行格式，不再整块重写。
稳定性：obsidian_move 链接更新改为原子写；跨文件系统移动/删除自动回退；搜索在有/无 ripgrep 时结果一致。

许可证

Operate deliberately

Install and manage

Prerequisites and target Profile

Target： Web Profile, Headless Profile, Tui Profile

Delivery： Dsh Bundle Git — mingzeng21/dsh-obsidian#265d6d65f9508d691e177b6a19b3dd4f887c8eb8。

Verify, update, and remove

Show lifecycle commands

Verify

dsh plugin --profile web list

Compatibility and access

DSH plugin; requires Node.js 22.12.0 or later： Verified by the author for dsh v0.1.0-rc.8 through v0.1.5-alpha.1。

Review compatibility evidence ↗

Risk facts

Filesystem Access

Can read and modify notes in the configured local vault

Evidence ↗

Reversible Deletion

Delete operations move notes to the vault’s .trash directory rather than permanently deleting them

Evidence ↗

Evidence and editorial reviewManifest, Bundle patch, distribution and freshness

Immutable evidence

Review status and source activity

AI reviewed

MIT-licensed DSH plugin bundle with a pinned Git source and documented local-vault capabilities.

AI reviewed Sep 10, 2026, 11:36 AM UTC。GitHub facts last checked Sep 10, 2026, 11:36 AM UTC。

No material source change has been recorded since this evidence baseline.

Next step

Follow the Plugin installation workflow →

Subscribe to material changes for dsh-obsidian →