DSH Obsidian Sync

DSH Cordis 插件：按需搜索 Obsidian 知识库 + 幂等归档 DSH 会话（零 token 注入）

设计理念

纯模型 Tool 按需调用，不注入系统提示词。默认 token 成本 ≈ 两个 Tool 的 schema。

• 进程内 fs 服务（resolve/stat/listDir/readText/writeText），不起子进程
• 倒排索引 + 60s 增量重建（dirty 标记，跳过 .obsidian/.git）
• CJK bigram 分词 + 全文索引 + IDF 加权排序
• 按 date + shortId 幂等 upsert（标题变更不影响去重）
• 笔记写入 vault/04-Archive/，YAML frontmatter + Obsidian 原生标签
• 自动挂 DSH-会话归档-索引.md 的按日期段（双井号边界 + 同 shortId 去重）

提供的 Tool

命名约束：工具名只使用 ^[a-zA-Z0-9_-]+$ 允许的字符（下划线，不含点号）。v3.4.2 及更早版本曾用 obsidian.search 这类点号命名，会被 provider 在请求校验阶段拒绝（HTTP 400，整个会话无法对话），请勿改回。

obsidian_search

在 Obsidian 知识库中按关键词搜索相关笔记（中英文均可，自动 CJK bigram 分词）。

// 输入
{ "topic": "npm 发布 2FA", "limit": 5 }

// 输出
{
  "ok": true,
  "matches": [
    {
      "file": "04-Archive/2026-09-12-3073121a-…",
      "score": 3.72,
      "snippet": "npm 2FA 查证：TOTP 已废弃…",
      "size": 4200,
      "matchReason": "npm pub lis 2fa"
    }
  ],
  "count": 5,
  "vaultPath": "E:/dsh-workspace/obsidian-vault"
}

obsidian_sync_session

把当前 DSH 会话幂等归档到 Obsidian vault。摘要未变则跳过写盘。

可选参数 date（YYYY-MM-DD）用于指定归档日期，回填历史会话时使用；省略或格式非法时取当前 UTC 日期。该值同时决定文件名前缀、frontmatter date、正文日期与索引挂载的日期段。

// 输入
{
  "session_id": "session-76bb60db-bdde-…",
  "title": "dsh-obsidian-sync 优化与发布",
  "summary": "用户需求：… 过程要点：… 交付物：…",
  "tags": ["dsh", "obsidian", "cordis"],
  "related": ["2026-09-11-a9095879-dsh-tool-agnes工具升级与发布.md"],
  "raw_log": "C:\\Users\\dph\\.dsh\\sessions\\--E-dsh-workspace--\\session-76bb60db\\session.v3.jsonl.zstd",
  "date": "2026-09-13"
}

// 输出（首次写入）
{ "ok": true, "skipped": false, "file": "04-Archive/2026-09-13-76bb60db-…", "index": "updated" }

// 输出（摘要未变）
{ "ok": true, "skipped": true, "file": "…", "reason": "summary unchanged", "index": "unchanged" }

// 输出（失败）
{ "ok": false, "error": "writeText failed: …", "code": "WRITE_FAILED" }

安装

方式一：从 npm 安装（推荐）

dsh plugin --profile web add @dingpenghui/dsh-obsidian-sync

方式二：从本地路径安装

cd dsh-obsidian-sync
pnpm install
pnpm build
dsh plugin --profile web add .

配置

在 ~/.dsh/settings.yaml 中添加：

obsidian-sync:
  vaultPath: "E:/dsh-workspace/obsidian-vault"
  searchEnabled: true
  indexRefreshMs: 60000

所有字段均有默认值，可不配置直接挂载。

开发

pnpm install
pnpm build        # tsdown 构建 → lib/
pnpm typecheck    # tsc 类型检查

测试

node scripts/test-tokenize.mjs      # CJK bigram 分词
node scripts/test-idempotent.mjs    # 幂等 upsert
node scripts/test-index-boundary.mjs # 索引边界插入
node scripts/test-sync-session-date-idempotent.mjs # sync_session 的 date 参数与摘要幂等比较

发布

pnpm version patch
git push origin main --tags
npm publish

.npmrc 不入版本库（含 npm access token），发布前需本地配置。

许可证

MIT

作者: Dingpenghui-good
仓库: https://github.com/Dingpenghui-good/dsh-obsidian-sync