DSH Plugin HubDSH 插件市场

mingzeng21/dsh-obsidian

Plugin插件 Native原生 ⭐ 20 MIT Memory & Knowledge记忆与知识库

将DeepSeek Harness（dsh）连接到本地Obsidian仓库：搜索、读取、写入、移动和删除笔记。

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

dsh-obsidian is a native plugin built exclusively for DeepSeek Harness (DSH). It connects DSH agents directly to a user’s local Obsidian vault, enabling agents to interact with Markdown notes stored on the local file system. No separate MCP server or OAuth authentication is required to use this plugin, because all operations are handled directly via the local file system. It exposes 12 distinct obsidian_* tools to the DSH agent, covering common operations like searching, reading, writing, moving, deleting notes and querying backlinks.

This plugin is designed for DSH users who manage personal knowledge with Obsidian, letting agents leverage the user’s existing local knowledge base to complete tasks. On launch, the plugin automatically detects the Obsidian vault path from the system’s standard obsidian.json file, but it also supports manual configuration of a custom vault path if auto-detection fails. It includes built-in security features: deletion only moves notes to a .trash folder within the vault, blocks all path access outside the vault root, and never modifies Obsidian’s core configuration directory.

The plugin requires Node.js version 22.12.0 or newer to run, and has been verified compatible with DSH v0.1.5-alpha.1 as well as multiple older DSH releases. It is open source under the permissive MIT license, so it is free to use, modify, and distribute for any purpose. You can install, update, and remove it directly using DSH’s built-in plugin CLI command. After any installation or update, you will need to restart your DSH instance for the changes to take full effect.

dsh-obsidian 是专为 DeepSeek Harness（DSH）开发的原生插件，作用是将 DSH 代理连接到用户本地的 Obsidian 知识库仓库。它不需要额外启动 MCP 服务器，也不需要 OAuth 认证，直接通过文件系统读写 Obsidian 仓库内的 Markdown 笔记，为 DSH 代理提供 12 个 obsidian 开头的工具，覆盖搜索、读取、写入、移动、删除笔记和反链查询等常见操作。

这款插件面向同时使用 DSH 代理和 Obsidian 管理个人知识的用户，能够让 DSH 代理直接基于你的本地 Obsidian 知识库完成各类任务。启动时插件会自动探测 Obsidian 仓库路径，也支持用户手动配置指定路径，自带多重安全防护，删除笔记仅移入回收站，禁止路径越出仓库根目录，也不会触碰 Obsidian 系统目录。

该插件要求 Node.js 版本不低于 22.12.0，已经通过 DSH v0.1.5-alpha.1 及多个旧版本的兼容性验证，采用 MIT 许可证开源，可免费使用。安装可通过 DSH 官方插件命令直接完成，更新只需要重新执行安装命令，卸载也通过 DSH 插件命令操作，更新后需要重启 DSH 才能生效。

View on GitHub在 GitHub 查看

Recommended强烈推荐 Send to your DSH发给你的 DSH 安装 
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-obsidian（mingzeng21/dsh-obsidian）
仓库：https://github.com/mingzeng21/dsh-obsidian
本站详情页：https://www.yhbd.top/plugins/mingzeng21-dsh-obsidian/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 20 · 最近提交 2026-10-02 · 主语言 TypeScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 20 stars - an early-stage project星标 20，属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装 

dsh plugin --profile web add dsh-obsidian

把 mingzeng21/dsh-obsidian 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

8.0 KB · 缓存于 2026-10-02 22:09:56 · 8.0 KB

dsh-obsidian

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

Awesome DSH Plugin License: MIT Node: >=22.12.0 dsh: v0.2.0-rc.2 verified

中文 | 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.6

更新后重启 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
vaultWorkspaceOnly false 仅向工作目录位于 vault 内的 agent 提供 obsidian_* 工具；没有工作目录的 agent 不会获得工具
excludeDirs [".obsidian", ".git", ".trash"] 搜索/列出时排除的目录

路径与 Windows 兼容性

  • 工具返回的路径始终是相对于 vault 根目录、使用 / 的路径；输入可以使用 / 或 \\。
  • 工具路径参数必须是相对路径。Unix 绝对路径、Windows 盘符路径和 UNC 绝对路径都会被拒绝；配置中的 vaultPath 可以是 Windows 本地路径或 UNC vault 根目录。
  • Windows 上笔记路径按大小写不敏感处理，并识别 .md、.MD 等大小写变体；Unix 保持大小写敏感与 .md 语义。
  • 搜索会去除 CRLF 的 \\r，保留 Unicode 路径和正文；ripgrep 只是可选加速器，不可用或执行失败时自动使用内置扫描。
  • vault 自动探测优先使用当前平台的 obsidian.json 位置（Windows %APPDATA%、macOS Library/Application Support、Linux .config），再尝试其他已知位置。CLI 支持 .exe/.cmd 形式，不可用时自动回退文件系统实现。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 mingzeng21/dsh-obsidian 的 README.md。 在 GitHub 查看原文 →

Related相关推荐

← 上一个 Prev dsh-artifact 下一个 Next dsh-desktop →