zhaoxuejie/dsh-plugin-vault-memory ↗★ 0
dsh-plugin-vault-memory
将本地 Obsidian 知识库接入为代理的长期记忆与检索工作台。 适合使用 Obsidian 并希望代理检索与记录笔记的用户,需配置库路径。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:zhaoxuejie/dsh-plugin-vault-memory说明文档
阅读完整 README ↗配置 vault(两种方式安装后都需要)
在插件设置页添加,或直接编辑 ~/.dsh/settings.yaml:
dsh-plugin-vault-memory:
vaults:
- path: D:\path\to\your-vault # 你的 Obsidian 库绝对路径
label: main # 可选:给库起个名字
重启 dsh 后,浏览器右下角出现「📚 知识库」胶囊即安装成功。
在浮卡「配置」开启"语义检索"并保存
开启后新笔记自动嵌入,即可使用"搜意思不搜字"的语义/混合检索(不可用时自动回退关键词检索)。
## 常见问题
| 现象 | 处理 |
| --- | --- |
| 没看到浮卡 | 完全重启 dsh;仍不行则清除浏览器 localStorage 对应项后刷新 |
| 检索提示"未配置 vault" | 浮卡「配置」添加库路径 |
| 保存提示"同名已存在" | 不覆盖是设计,换标题/目录重试 |
| 语义搜无感 | 首次嵌入需等待;确认 Ollama 在跑且已开启语义 |
## 文档
- [使用教程(新手从这里开始)](https://github.com/zhaoxuejie/dsh-plugin-vault-memory/blob/master/docs/usage-guide.md)
- [设计与开发文档](https://github.com/zhaoxuejie/dsh-plugin-vault-memory/blob/master/DESIGN.md)
## 开发
```bash
pnpm install # link 安装模式必需
npm test # 84 项单元测试
License
MIT © moqian