DSH Plugins Marketplace

DSH Plugins

Plugins

/

Memory & Context

/

dsh-memory-vault

d

dsh-memory-vault

Manifest valid

Recalls an Obsidian Markdown vault before each task: a per-agent prompt context is registered on agent creation and re-queried with the current task text, adding a standing profile plus the notes that

hasBundlePatch

dsh-memory-vault

把 Obsidian 长期记忆库接进 DeepSeek Harness:每个任务开始前自动检索相关记忆、注入上下文;提供写入与结构体检工具;每周由定时任务自动整理。

推荐用 Obsidian 做记忆库。 不是硬依赖——任何存放 Markdown 的文件夹都能用,但 Obsidian 的纯文本、双链和本地优先,恰好是「可长期养、可被改动、可被模型读」这三件事同时成立的少数选择。理由见下一节。

装在 Harness 侧,不装 Obsidian 插件,不修改你已有的笔记结构。

它做什么

机制实现效果
每轮注入每个 Agent 创建时挂一个 scoped systemPrompt.context,从 agent/inbox/claimed 取当前任务文本常驻核心档案 ~900 字 + 按任务检索的 3 条记忆 ~1300 字
检索中文 2/3-gram + 拉丁词;标题×6、标签×4、小标题×1.5、正文×0.5,按相对阈值截断纯本地、同步、无嵌入模型、无外部依赖
写入memory_note 工具,路径强制锁在记忆库目录内覆盖时自动把 frontmatter 的 更新日期 改成当天
体检memory_health 工具收件箱积压、过期目标、断链(扫整个 Obsidian 仓库)、重复候选、frontmatter 缺失
每周优化配合 Harness 定时任务体检 → 清收件箱 → 合并去重 → 回写索引

为什么推荐 Obsidian 做记忆库

理由具体是什么
纯文本每条记忆就是一个 .md,能 diff、能 git、能直接 cat。不锁进数据库,换工具不迁移
双链与图谱[[某条笔记]] 把「这件事和那件事有关」变成可检索的结构。记忆的真实价值在关联,不在条目本身
本地优先离线可读、无需账号、不出本机。同时有手机端与同步方案
可被模型直读目录 + frontmatter + 标题就是天然的检索字段,不需要额外的索引服务
会被你自己改记忆库的价值来自持续修剪。Obsidian 编辑器做得好的地方,正是你每周要做的清理

它也有代价:没有向量检索。这个插件靠词面匹配(中文 n-gram + 拉丁词)打分,所以目录约定和 tags 要守——写得越规整,检索越准。

安装

# 发布到 npm 后
dsh plugin add @07-dot/dsh-memory-vault

还没上 npm 时,从 GitHub 装:

git clone https://github.com/07-dot/dsh-memory-vault.git
dsh plugin add ./dsh-memory-vault

也可以克隆后,用 Harness 里 plugin_manager 的 install_bundle,target 指向这个目录(本地目录是链接安装,不是拷贝)。安装后重启或等 HMR 生效。

配置

cordis.patch.yml:

- insert:
    - id: memory-vault
      name: '@07-dot/dsh-memory-vault'
      config:
        vault: ''            # 你的 Obsidian 记忆库目录,必填;也可用环境变量 DSH_MEMORY_VAULT
        matchCount: 3        # 每次注入的检索条数
        matchBudget: 1300    # 检索结果字数上限
        coreBudget: 900      # 核心档案字数上限
        minScore: 2.5        # 相关度阈值
        staleDays: 45        # 目标多久未更新算过期

vault 留空时插件会打一条警告并停用注入,写入与体检工具会明确报错——不会静默失败。

记忆库的结构约定

插件按 frontmatter 的 类型 和固定文件名识别内容。推荐(非强制)结构:

记忆库/
├── 记忆库首页.md          # 「速读区」表格会被当作核心档案
├── 01-个人档案/
│   ├── 个人概况.md        # 「基本信息」表格 → 核心档案
│   └── 偏好与习惯.md      # 「沟通偏好」「雷区」→ 核心档案
├── 02-目标与进展/目标总览.md   # 「本月聚焦」→ 核心档案
├── 03-项目与主题/项目总览.md
├── 04-收件箱.md
└── 05-模板/               # 模板目录:不参与检索、不参与查重

约定:

  • frontmatter 至少写 类型 和 更新日期(YYYY-MM-DD)。
  • 表格里写「待填」「待确认」的占位不会被注入。
  • 05-模板/ 被排除在检索与重复检测之外——模板是脚手架,不是记忆。
  • 断链检查只对记忆库内的笔记做,但会认整个 Obsidian 仓库的目标名,所以跨目录双链不会误报。

结构

  • index.js —— 插件接线:prompt context、3 个工具、生命周期清理。任何注入失败都静默降级为空串,不会拖垮会话。
  • memory-core.js —— 纯 Node 逻辑:扫描、frontmatter 解析、打分、注入文本、体检。不依赖 Harness,可单独用 node 调用测试。

两个文件都不引用 DSH 的运行时包,因此不需要 peerDependencies,也不会随宿主版本漂移而崩。

已知限制

  • 检索是词面匹配,不理解同义词;中文靠 n-gram,长句里噪声片段会命中弱相关笔记。
  • 注入块随任务变化,会削弱 prompt 缓存命中率。
  • 每个 Agent 首次组装提示词时才建索引(之后按 mtime 缓存),上千条的库需要留意首次延迟。
  • 写入工具的路径限制是前缀校验,不做符号链接解析。
  • 只处理 Windows/POSIX 本地路径;不接 Obsidian Sync、iCloud 或远程仓库的同步层——它读的是磁盘上已有的文件。

License

MIT © 2026 07-dot

Comments

Loading…

Similar plugins

dsh-inkvault

by M1r0er

Turns a local Markdown vault into two folders the user picks in Settings: a knowledge folder DSH writes notes into, and a memory folder used as the agent's long-term memory with per-turn recall and en

Memory & ContextManifest valid

★ 0

JavaScript

Oct 24, 2026

dsh plugin --profile web add dsh-inkvault

by bonerush

Project documents and long-term memory as plain Markdown in a dedicated Obsidian vault: six mem_* tools (search, read, write, log, brief, admin), one budgeted recall injection at the first step of a s

Terminal & ClientsMemory & ContextManifest valid

★ 15

MIT

JavaScript

Nov 10, 2026

dsh plugin --profile web add dsh-obsidian-mem

by 1015677515

Captures the agent's own self-reported mistakes into a categorised lesson library that is re-injected into the system prompt every turn (each captured draft is confirmed or edited by the user before i

Memory & ContextManifest valid

★ 5

MIT

JavaScript

Oct 20, 2026

dsh plugin --profile web add github:1015677515/dsh-prompt-ErrorNotes-desk

Keeps notes as local Markdown files grouped by directory under a root folder you choose, with a sidebar page, AGENTS-style rule files surfaced as writing context, and six agent tools.

Memory & ContextManifest valid

★ 0

dsh plugin --profile web add dsh-notes

by adithyanraj03

Persistent memory for dsh in the style of Hermes Agent: a memory tool keeping a user profile and the model's own notes, delivered to every chat as a logged context message, plus session_search over earlier chats behind an approval prompt.

Terminal & ClientsMemory & ContextSessions & MessagesManifest valid

★ 0

NOASSERTION

JavaScript

Oct 26, 2026

dsh plugin --profile web add dsh-memory-recall

by lucagiftzek

Obsidian-compatible Markdown notes in the DSH sidebar with search, tags, backlinks, graph, audio notes with transcription, a paint canvas, OCR (needs tesseract), client-side encryption and notes_* age

Memory & ContextManifest valid

★ 0

MIT

JavaScript

Nov 1, 2026

dsh plugin --profile web add @lucagiftzek/dsh-note-keeper