dsh-obsidian
将 DeepSeek Harness (dsh) 连接到本地 Obsidian vault：搜索、读取、写入、移动和将笔记移至回收站。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-obsidian@0.2.5Obsidian 以 dsh-obsidian 发布，当前版本为 0.2.5。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把 DeepSeek Harness（dsh）连接到本地 Obsidian vault。因为一个 Obsidian vault 本质上就是磁盘上的一堆 Markdown 文件，所以你的 dsh agent 可以直接搜索、读取、写入、移动和删除（移入回收站）笔记——不需要 MCP server，也不需要 OAuth。
中文 | English
装上 dsh-obsidian 后，你的 dsh agent 就能直接读写本地 Obsidian vault。插件会在启动时自动探测你的 vault（或读取你显式配置的路径），然后把 12 个 obsidian_* 工具挂载给 agent，覆盖搜索、读取、写入、追加、移动、删除和反链查询等日常操作。
.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.5
更新后重启 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"] | 搜索/列出时排除的目录 |
/ 的路径；输入可以使用 / 或 \\。vaultPath 可以是 Windows 本地路径或 UNC vault 根目录。.md、.MD 等大小写变体；Unix 保持大小写敏感与 .md 语义。\\r，保留 Unicode 路径和正文；ripgrep 只是可选加速器，不可用或执行失败时自动使用内置扫描。obsidian.json 位置（Windows %APPDATA%、macOS Library/Application Support、Linux .config），再尝试其他已知位置。CLI 支持 .exe/.cmd 形式，不可用时自动回退文件系统实现。| 工具 | 作用 |
|---|---|
obsidian_list | 列出 vault 里的笔记（可按子目录过滤、限制条数） |
obsidian_search | 全文检索，返回匹配行 + 上下文（大小写不敏感；Windows 识别 .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）；返回给 agent 的路径统一使用 /。
../、Unix/Windows 绝对路径或 UNC 路径）一律拒绝。obsidian_delete 只把笔记移入 vault 的 .trash/，绝不永久删除。.obsidian/ —— 搜索与列出默认排除 .obsidian/、.git/、.trash/。[[链接]]（除非任务明确要求改）。dsh）已完成对 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
.cmd 命令脚本被重复加引号的问题，路径或参数包含空格、Unicode 字符时也能正确调用。/，同时接受 \\ 输入，并拒绝盘符/UNC 绝对路径越界。.MD 等大小写扩展名。.exe/.cmd 形式的 ripgrep 与 Obsidian CLI；外部命令不可用或失败时自动回退到内置实现。dsh v0.1.2-alpha.2/alpha.3 移除 @deepseek-ai/dsh-tools 的 JsonValue 转出后，插件源码无法 typecheck/build 的兼容性问题；保留对旧版 dsh 的兼容。obsidian_tags 与内联 #标签 提取支持中文等 Unicode 字符。obsidian_backlinks / obsidian_move 按 Obsidian 规则唯一解析 [[链接]]：同名笔记不再被误判，歧义链接不再被误改。obsidian_set_property / obsidian_delete_property 编辑属性时保留原有 YAML 注释、锚点/别名与多行格式，不再整块重写。obsidian_move 链接更新改为原子写；跨文件系统移动/删除自动回退；搜索在有/无 ripgrep 时结果一致。MIT © 2026 MingZeng