dsh-obsidian-assistant

DeepSeek Harness 插件（Cordis toolset）：操作本地 Obsidian 知识库（vault），提供搜索、读写笔记、双向链接 / 关系图谱、批量整理，并通过 Obsidian 的 "Local REST API" 社区插件调用高级能力（高速全文搜索、触发命令 / 模板）。

一套插件，双通道，统一操作同一个 vault：不依赖 Obsidian 运行也能读写（文件通道），Obsidian 在线时自动增强（REST 通道）。

---

功能一览（11 个工具）

通道 A · 文件直读写（始终可用，不依赖 Obsidian 运行）

工具	说明
obsidian_search	全文 / 标题检索，支持按 tag 过滤，返回路径 + 片段 + 标签
obsidian_read_note	读单篇笔记（frontmatter + 正文），可带 / 不带 .md 后缀
obsidian_create_note	新建笔记（可带 YAML frontmatter，拒绝覆盖已存在笔记）
obsidian_update_note	字面量替换 / 追加编辑（幂等、安全）
obsidian_list_structure	文件夹树 + 标签统计 + 孤立笔记
obsidian_backlinks	反向链接 + 出链 + tag 归属图谱
obsidian_batch	批量移动 / 重命名，自动重写全库 [[wikilink]]

通道 B · Local REST API（需 Obsidian 运行 + 安装该社区插件）

工具	说明
obsidian_rest_search	Obsidian 内部索引高速全文搜索（大库首选）
obsidian_list_commands	列出 Obsidian 命令（id + 名称）
obsidian_run_command	触发命令（Templater / Dataview 重渲染等）
obsidian_rest_query	透传任意 REST 端点（兜底 / 高级用法）

Dataview 说明：Local REST API 无原生 dataview 端点，dataview 查询需通过 obsidian_list_commands 找到 Dataview 命令 id，再用 obsidian_run_command 触发。

---

安装与注册

本插件是一个 profile bundle。完整、可操作的接入步骤见 DEPLOY.md。核心两步：

1. 把 dsh-obsidian-assistant 加进 profile 的 bundles 列表（$DSH_HOME/profiles//package.json 的 dsh.profile.bundles）；
2. 在 profile 的 cordis.patch.yml 里为它指定 vaultPath（唯一必填项，没有可移植的默认值，所以 bundle 里不预设）：