前言¶
DeepSeek Harness (DSH) 的插件生态允许开发者将特定的功能模块化。对于需要管理项目文档和长期记忆的场景，目前的做法往往是依赖临时的上下文或者自定义的数据库。如果有一个插件能够将项目的文档和长期记忆以纯 Markdown 格式存储在一个专用的 Obsidian vault 中，就可以在不运行 DSH 的情况下直接查看和管理这些数据，同时利用 Obsidian 的搜索和视图能力。
插件介绍¶
dsh-obsidian-mem 是 DeepSeek Harness 的一个 host 插件，由 bonerrush 维护。它属于记忆类别。
它的核心价值在于：保持项目文档和长期记忆为纯 Markdown 格式，存储在一个专用的 Obsidian vault 中。
核心功能¶
- 持久化存储：将项目文档和长期记忆作为纯 Markdown 保留在专用的 Obsidian vault 中。
- 项目绑定：为一个仓库创建稳定的
projectId。 - 目录结构：将项目文档写入专用的 vault 目录。
- 工具集：提供 six 个
mem_*工具。 - 搜索索引：使用
node:sqlite构建搜索索引。 - 自动蒸馏：自动对已完成的对话轮次进行总结。
安装与配置¶
在安装前，请确保环境满足以下要求：
* DeepSeek Harness: >=0.1.5-rc.2 或 >=0.1.7-rc.2
* Node.js: >=22.22.2
插件代码每个进程只加载一次，因此安装后需要重启 DSH。
1. 安装插件¶
使用官方命令安装：
dsh plugin --profile memcheck add github:bonerush/dsh-obsidian-mem
2. 验证安装¶
安装后，检查配置中是否包含该插件：
dsh --profile memcheck --dump-config | grep -n obsidian-mem
如果输出中包含 obsidian-mem 的配置行，说明安装成功。
3. 配置 Vault¶
选择一个本地磁盘目录作为专属 vault 目录（默认为 ~/Documents/dsh-memory），并在 Obsidian 中打开该目录。
4. 重启进程¶
必须重启 DSH（例如 dsh web），插件代码才会重新加载并生效。
使用与示例¶
安装并重启后，可以通过以下方式使用：
- 查看项目列表：
mem_admin(action="projects")
- 启动会话：在任何 Git 仓库中启动会话，直接提问或使用工具。
注意事项¶
- Honest limits：在启用自动写入前，请阅读插件文档中的 Honest limits，了解它的拒绝策略。
- 数据非详尽：插件较新，目前写入的内容不是详尽的，所有变更记录在
CHANGELOG.md中。 - 本地存储：Vault 必须是本地的。
- 独立目录：不要将 vault 指向你已经维护的个人 vault，插件会创建项目目录。
- 权限与源码：插件代码运行在 DSH 进程的权限下，安装前请检查源码和许可证。
结语¶
dsh-obsidian-mem 通过将 DSH 的记忆能力转化为标准的 Obsidian vault，解决了项目文档与长期记忆的持久化问题。它利用纯 Markdown 和 SQLite 提供了结构化的存储方案，适合需要在 DSH 和 Obsidian 之间无缝协作的场景。
