返回目录

dsh-memory

精选清单收录维护状态: 活跃

restregular/dsh-memory

DSH 记忆系统 (Memory System): local-first memory — JSONL + local embeddings, five tools, auto recall, hard rules, visual panel.

前往 GitHub项目主页
$ dsh plugin --profile web add @restregular/dsh-memory

21

星标

2

Fork

JavaScript

语言

MIT

许可证

2026-10-10

创建于

2026-11-20

最近推送

MIT 许可的 TypeScript DSH 宿主插件:记忆以本机 JSONL 落盘,双通道检索(词法 + 本机 llama-server 向量)自动降级,每轮召回、硬性规则、规则代码脚本与五标签面板齐全,不配向量服务也能用、不发网络请求。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-18

许可证

MIT

01它能帮你完成什么?

  • 让新的 DSH 会话接得上以前的结论

    记忆以 JSONL 落在本机;新会话第一步注入项目 / global 摘要,之后每轮按问题召回,只给印象,需要细节时用 `memory_get` 取全文

    在 DeepSeek Harness 里长期做同一个项目、反复重推同一批结论的开发者

  • 把团队约定与流程变成每轮都在的硬性规则

    `kind: rule` 进系统提示常驻段(行首带 8 位 id,注入摘要);`kind: procedure` 进流程目录(按工作区与触发词命中);规则还可以附带脚本,在保存前拒绝、保存后观察、注入前改写或丢弃

    希望硬性规则与 SOP 被真正执行、而不是每个会话重新交代一遍的团队

  • 人工核对、检索、备份与审计记忆系统的行为

    「服务 / 记录 / 记忆树 / 设置 / 审计」五个标签页,记录页带语义检索开关与作用域用途 / 别名编辑,导出是纯文本 JSON(不含向量)

    想自己确认存了什么、召回了什么,并把数据带走的用户

02如何接入 DeepSeek Harness?

前置条件

  • Node.js 22.13 及以上 —— README 的 Node.js 徽章写的是 ≥22.13
  • 一个要装进去的 DSH profile:桌面端 `~/.dsh/profiles/desktop` 或 Web 端 `~/.dsh/profiles/web`

安装步骤

  1. 01

    $ dsh plugin --profile web add @restregular/dsh-memory

  2. 02

    在 profile 目录里手动执行:`pnpm add @restregular/dsh-memory`(包自带的 `cordis.patch.yml` 会注册那唯一一条 entry)。

  3. 03

    打开 设置页 →「记忆系统」,也可以在「设置 → 侧栏入口」里打开左侧栏入口。

  4. 04

    需要语义检索时,在面板「服务 → 向量服务」里一键装本机 llama.cpp 后端;不装则检索保持词法。

验证接入成功

作者未说明

回滚

  • pnpm remove @restregular/dsh-memory
  • 再从 profile 的 patch 里删掉那条 `dsh-memory` entry。
  • 卸载不会移除已配置的向量服务与记忆文件(它们在 `<storeDir>` / `<installRoot>` 里),要清掉得在卸载前用面板「服务 → 维护」操作。

03DSH 适配与能力边界

DSH 适配原生运行时

原生 DSH 宿主插件:profile 里的 `cordis.patch.yml` 只注册一条 entry,提供 `memory` 服务、八个 `memory_*` 工具、`agent/pre-step` 注入链路和 `/memory/api` 面板;客户端半边在设置页挂出「记忆系统」。

  • 八个模型工具

    要保存的内容、查询语句、作用域名、记录 id→`memory_search` 只回印象(8 位 id / 作用域 / 类型 / 标签 / 摘要),`memory_get` 按 `fields` 取正文与元数据;另有作用域目录、屏蔽与规则代码管理

    往 `storeDir` 下的 JSONL 写入记录把返回过的条目记进会话去重状态
  • 双通道检索(词法 + 本机向量)

    一句查询→按相关度排序的记忆;向量通道可用时带排序分,不可用时自动退化为词法结果

    配了端点时调用本机 llama-server 的 `/v1/embeddings`为每个作用域文件写一份 `.vec` 向量边车
  • 自动召回与注入

    本轮用户问题、会话第一步、工具失败与带标签的行为→注入的摘要、每条记忆的印象、常驻规则段与流程目录

    往系统提示与对话上下文里插入记忆摘要在 `<cwd>/.dsh/dsh-memory/sessions/` 写会话去重状态
  • 会话级记忆权限与范围外审批

    作用域勾选、可读 / 可写标记、限制等级(绝对 / 普通 / 无限制)→工具只能读写被授权的范围;范围外命中默认只回作用域清单,确认后弹审批卡,逐条勾选放行

    把本会话的可见范围与授权写进 `<storeDir>/visibility/<session>.json` 和 `<storeDir>/grants/<session>.json`审批等待期间在该会话侧边栏行显示待审批标记
  • 规则代码(hook 脚本)

    一段 JS 脚本,并且带上一个 `hookPhase` 字段,取值可以是 `before-save`、`after-save` 或 `before-inject`→保存前直接拒绝并把理由回给模型、保存后只观察,或注入前改写正文 / 丢弃整条

    代码存在 `<storeDir>/hooks.json`,不进检索在 node:vm 沙箱里同步运行,无 require / process / 网络,120ms 超时

04适合谁?何时不该用?

适合

  • 在 DeepSeek Harness 里长期做同一个项目、反复重推同一批结论的开发者
  • 希望硬性规则与 SOP 被真正执行、而不是每个会话重新交代一遍的团队
  • 想自己确认存了什么、召回了什么,并把数据带走的用户

不适合

  • 记忆数据只在本机,JSONL 不加密,导出文件也是明文,store 目录需要你自己保护;向量端点默认走 loopback。

05兼容性、维护与安全提示

  • 记忆数据只在本机,JSONL 不加密,导出文件也是明文,store 目录需要你自己保护;向量端点默认走 loopback。
  • 审计数据默认只在内存:总量 2000 条、每会话 200 条,超出时优先保留 digest / rules / delivery / error 等关键通道,重启后记录丢失。
  • 同内容去重仍只在进程内判断,两个进程同时写完全相同的内容理论上会落两条;跨进程安全靠的是每个作用域一把写锁。
  • 只有写了 `endpoint`、配了 `spawn`、或在面板里装了本地后端,插件才会碰网络;否则一个请求都不发,检索只用词法。
2026-10-102026-11-12作者未说明

MIT · README 分支 main · 无 tagged release,最后推送 2026-11-12

06常见问题

没有向量模型,dsh-memory 还能用吗?

能用。README 写的是没有向量服务时检索自动退化为词法(IDF + 中文 bigram),不产生任何网络请求。要语义检索时在面板「服务 → 向量服务」一键装本机 llama-server 后端,内置清单已经为每个模型配好 `dims` 与 `pooling`。

记忆数据存在哪里?

存在 `storeDir` 下,默认是相对启动目录的 `.dsh-memory`,README 建议显式配一个绝对路径。记录是明文 JSONL 加 `.vec` 向量边车,作用域用途等元数据在 `scope-meta/`,面板设置写进 `settings.json`。

怎么装进 DSH 的 profile?

执行 `dsh plugin --profile web add @restregular/dsh-memory`,或者手动把包加进 profile 依赖;两种方式都靠包自带的 `cordis.patch.yml` 注册那唯一一条 entry。README 解释了宿主只允许一个包名、一个解析源,所以面板与服务端在同一个包里。

新会话没召回我的记忆,先查什么?

先确认 `inject.recall` / 自动召回开着,当前作用域在召回范围内(标签触发的自动召回只含 global + 当前会话 + 当前工作区),再确认标签真的命中。面板顶部的「审计」标签页能看到每次注入的候选、过滤、预算与投递状态。

怎么卸载?会连记忆一起删掉吗?

执行 `pnpm remove @restregular/dsh-memory`,再从 profile 的 patch 里删掉那条 entry。卸载不会移除已配置的向量服务和记忆文件——它们在 `storeDir` 与 `installRoot` 里,所以要在卸载之前用面板「服务 → 维护」清掉,插件卸掉后面板就打不开了。

08数据与来源

  • 作者声明github.comabda402c0b9a…

    包自带 `cordis.patch.yml`,注册**唯一一条** entry:

  • 作者声明github.comabda402c0b9a…

    面板分五个标签:**服务 / 记录 / 记忆树 / 设置 / 审计**。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-18。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。