dsh-plugin-vault-memory

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

它解决什么问题

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

核心特性

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

你想做什么	直接说	背后
翻旧笔记	"库里有没有 Docker 相关笔记？"	全文检索（中文分词）
按条件找	"查 tools/ 下近 30 天改过的笔记"	结构化查询（目录/标签/时间）
读某篇全文	"把《Git 合并》笔记读给我"	带行号读取
意思相近的	"搜跟'Windows 命令行'相关的"	语义检索（本地模型，可选）
关联推荐	"这篇笔记跟哪些有关联？"	入链/出链/同标签/共引，带理由
保存成果	"把这段整理成笔记存进库"	自动 frontmatter + 关联建议
体检	"库里有孤儿/断链吗？"	只读巡检报告

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

右下角「📚 知识库」浮卡（四个 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     # 安装本地模型
# 在浮卡「配置」开启"语义检索"并保存

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

常见问题

现象	处理
没看到浮卡	完全重启 dsh；仍不行则清除浏览器 localStorage 对应项后刷新
检索提示"未配置 vault"	浮卡「配置」添加库路径
保存提示"同名已存在"	不覆盖是设计，换标题/目录重试
语义搜无感	首次嵌入需等待；确认 Ollama 在跑且已开启语义

文档

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

开发

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

License

MIT © moqian