mingzeng21/dsh-obsidian

README 摘要

dsh-obsidian 把 DeepSeek Harness（ dsh ）连接到本地 Obsidian vault。因为一个 Obsidian vault 本质上就是磁盘上的一堆 Markdown 文件，所以你的 dsh agent 可以直接搜索、读取、写入、移动和删除（移入回收站）笔记—— 不需要 MCP server，也不需要 OAuth 。 中文 English 它能帮你做什么 装上 dsh-obsidian 后，你的 dsh agent 就能直接读写本地 Obsidian vault。插件会在启动时自动探测你的 vault（或读取你显式配置的路径），然后把 9 个 obsidian 工具挂载给 agent，覆盖搜索、读取、写入、追加、移动、删除和反链查询等日常操作。 特性 - 零依赖服务器 —— 直接读写 vault 文件系统，无需 Local REST API 社区插件，也无需常驻 MCP server。 - 可选 Obsidian 原生能力 —— 当 obsidian CLI 可用时，反链查询与移动会自动委托给它（移动时同步更新 [[链接]] ）；否则全部回退到纯文件系统实现。 - 默认安全 —— 删除只把笔记移入 .trash/ （可逆）、路径无法越出 vault 根目录、绝不触碰 .obsidian/ 。 工作原理 启动时插件按「显式 vaultPath 优先，否则从 obsidian.json 自动探测」解析 vault 根目录； useCli 开启且检测到 CLI 时启用 CliAccess ，任何 CLI 失败都会静默回退到 FsAccess 。 安装 把 web 换成你运行 agent 所用的 profile（ web 、 headless 、 tui 等）。 卸载 配置 键 默认值 说明 vaultPath （自动探测） vault 的绝对路径；留空则按平台从 obsidian.json 自动探测当前打开的 vault useCli true obsidian CLI 可用时，反链/移动委托给它 excludeDirs [".obsidian", ".git", ".trash"] 搜索/列出时排除的目录 工具 工具 作用 obsidian list 列出 vault 里的笔记（可按子目录过滤、限制条数） obsidian search 全文检索，返回匹配行 + 上下文（大小写不敏感、只搜 .md ） obsidian read 读取一篇笔记（正文 + 解析后的 frontmatter） obsidian frontmatter 只读笔记的 YAML 属性 obsidian backlinks 找出链接到某篇笔记的笔记（ [[wikilink]] ） obsidian write 新建或覆盖一篇笔记（父目录不存在时自动创建） ob…

分类