dsh-plugin-vault-memory

让 DeepSeek Harness agent 学会翻你的 Obsidian 库、用你的笔记、把成果存回你的库——你的笔记从此是活的资产。

它解决什么问题

• 📥 笔记存了 = 白存？ Agent 能真正检索你的笔记：问它"我之前研究过 X 的什么结论"，它翻遍全库给你答案，并标注出处文件，不编造。
• 🤝 每次对话都要重新介绍自己？ 新会话开头自动注入"记忆快照"（库状态、活跃项目、近期笔记），AI 直接进入正题。
• 💾 聊完就忘、成果散在对话里？ 一键把会话产出存成笔记：自动 frontmatter、归类打标签、推荐与库内哪些笔记关联。
• 🧹 笔记库越用越乱？ 定期巡检：孤儿笔记、断链、缺总览逐条列出并给理由，你批准它才动手，写前自动备份可回滚。

核心特性

Agent 工具集（对话里直接用自然语言触发）

规则：引用必带笔记路径，找不到就明说没有——绝不编造。

右下角「📚 知识库」浮卡（四个 Tab）

• 概览 — 各库健康：笔记数 / 断链 / 待审 / 趋势 / 语义状态
• 捕获 — 预览 → 保存 → 在 Obsidian 打开
• 审查 — 巡检建议逐条批准/忽略（孤儿可勾选关联对象、断链可下拉修复目标）；批准前自动备份
• 配置 — 在线增删库、开关，保存即生效

巡检管家

• 每日定时巡检（默认 03:00，可改），生成带理由的建议清单：孤儿（没人引用的笔记）、断链（指向不存在的链接）、缺总览（目录攒够了没目录页）
• 只建议，不擅改：每条建议你批准才写盘，写前自动备份可回滚
• 忽略后同类建议 30 天内不再打扰（可配），过期再提醒防漏报
• 可选高级规则（需语义嵌入）：语义相近未互链 / 疑似重复 / 过期复审

隐私优先

• 索引、检索、巡检全部本机完成，笔记内容默认不出电脑
• 语义检索用本地 Ollama（bge-m3），也可切换兼容云端端点

安装

方式一：npm 安装（推荐）

# 安装到 web profile（装完需完全重启 dsh，不是刷新页面）
dsh plugin --profile web add dsh-plugin-vault-memory

方式二：本地源码（开发 / 自用）

git clone https://github.com/zhaoxuejie/dsh-plugin-vault-memory.git
dsh plugin --profile web add <仓库路径>
pnpm install   # link 安装模式必需

配置 vault（两种方式安装后都需要）

在插件设置页添加，或直接编辑 ~/.dsh/settings.yaml：

dsh-plugin-vault-memory:
  vaults:
    - path: D:\path\to\your-vault   # 你的 Obsidian 库绝对路径
      label: main                    # 可选：给库起个名字

重启 dsh 后，浏览器右下角出现「📚 知识库」胶囊即安装成功。

可选：语义检索

ollama pull bge-m3     # 安装本地模型
# 在浮卡「配置」开启"语义检索"并保存

开启后新笔记自动嵌入，即可使用"搜意思不搜字"的语义/混合检索（不可用时自动回退关键词检索）。

常见问题

文档

• 使用教程（新手从这里开始）
• 设计与开发文档

开发

pnpm install   # link 安装模式必需
npm test       # 84 项单元测试

License

MIT © moqian