前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。为了让 Agent 在对话中具备长期记忆，并能利用本地积累的知识资产，需要将本地的 Obsidian 知识库与 DSH Agent 建立连接。dsh-plugin-vault-memory 正是为了解决这个问题而生，它把本地的 Obsidian 库变成了 DSH Agent 的长期记忆存储与工作台。
插件定位¶
dsh-plugin-vault-memory 是一个 DSH 插件，由 zhaoxuejie 维护，许可证为 MIT。
它主要解决四个问题：
1. 检索问题：Agent 能通过自然语言在库中检索笔记，并标注出处。
2. 记忆注入：新会话自动注入库状态和活跃项目。
3. 成果保存：将对话产出自动整理为笔记，包含 frontmatter 和关联建议。
4. 库维护：提供巡检功能，识别孤儿、断链等问题，需手动批准后才写入磁盘。
核心功能¶
插件通过右下角的浮卡提供交互界面，主要包含以下能力：
1. 检索能力
* 全文检索：支持中文分词，能处理自然语言提问。
* 结构化查询：支持按目录、标签、时间等维度筛选。
* 带行号读取：Agent 在引用特定内容时，可以获取精确的行号。
* 语义检索：可选功能，使用本地模型（Ollama bge-m3）进行语义向量检索，需配合语义嵌入使用。
2. 关联与推荐
* 关联推荐：支持入链、出链、同标签、共引四种推荐方式，并附带理由。
3. 会话产出保存
* 自动保存：将对话中的成果保存为笔记。
* 自动 Frontmatter：自动生成元数据。
* 关联建议：自动推荐与库内哪些笔记建立关联。
4. 库巡检
* 发现隐患：定期扫描孤儿笔记（无人引用）、断链（指向不存在的文件）、缺总览（目录页缺失）。
* 安全机制：巡检结果只建议不擅自修改。所有写入操作（包括修复断链、创建文件）都需要用户在审查界面手动批准，且写前会自动备份。
5. 浮卡界面 (GUI)
* 概览：显示库健康度、笔记数、断链数、趋势等。
* 捕获：预览并保存新笔记，支持在 Obsidian 中打开。
* 审查：逐条批准巡检建议。
* 配置：管理已连接的 Obsidian 库路径。
安装与启用¶
通过 CLI 安装到 web profile：
dsh plugin --profile web add dsh-plugin-vault-memory
安装完成后，需要完全重启 DSH（不是刷新浏览器页面），右下角才会出现「📚 知识库」浮卡。
在浮卡「配置」或 ~/.dsh/settings.yaml 中添加 Obsidian 库路径：
dsh-plugin-vault-memory:
vaults:
- path: D:\path\to\your-vault
label: main
典型用法¶
在 DSH 对话中，可以直接通过自然语言调用插件功能：
- 检索：“库里有没有 Docker 相关笔记？”
- 筛选：“查 tools/ 下近 30 天改过的笔记”
- 读取：“把《Git 合并》笔记读给我”
- 语义搜索：“搜跟’Windows 命令行’相关的”
- 关联分析：“这篇笔记跟哪些有关联？”
- 保存：“把这段整理成笔记存进库”
- 巡检：“库里有孤儿/断链吗？”
适用场景与注意事项¶
此插件适合需要将个人知识库与 AI 对话深度结合的开发者或知识工作者。
隐私与安全：
索引、检索、巡检全部在本地完成，笔记内容默认不会离开本机。
依赖项：
* 语义检索：若需使用语义检索功能，需本地运行 Ollama 并拉取 bge-m3 模型。
* 同名文件：插件设计上不覆盖同名文件，若保存提示“同名已存在”，需更换标题或目录后重试。
运维建议：
* 安装后务必完全重启 DSH 进程。
* 巡检功能建议定期查看，但修改操作需谨慎，建议先批准备份，确认无误后再正式写入。
