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`
安装步骤
- 01
$ dsh plugin --profile web add @restregular/dsh-memory
- 02
在 profile 目录里手动执行:`pnpm add @restregular/dsh-memory`(包自带的 `cordis.patch.yml` 会注册那唯一一条 entry)。
- 03
打开 设置页 →「记忆系统」,也可以在「设置 → 侧栏入口」里打开左侧栏入口。
- 04
需要语义检索时,在面板「服务 → 向量服务」里一键装本机 llama.cpp 后端;不装则检索保持词法。
验证接入成功
作者未说明
回滚
- pnpm remove @restregular/dsh-memory
- 再从 profile 的 patch 里删掉那条 `dsh-memory` entry。
- 卸载不会移除已配置的向量服务与记忆文件(它们在 `<storeDir>` / `<installRoot>` 里),要清掉得在卸载前用面板「服务 → 维护」操作。
03DSH 适配与能力边界
原生 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`、或在面板里装了本地后端,插件才会碰网络;否则一个请求都不发,检索只用词法。
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` 里,所以要在卸载之前用面板「服务 → 维护」清掉,插件卸掉后面板就打不开了。
07相关的 DSH 工作流
dsh-univer-office
作者 dream-num
在 DSH 内预览、创建与编辑表格、文档和幻灯片,由 Univer 驱动
clearai-dsh
作者 clearailhc
ClearAI:以本体为纲的原生 DSH 插件 —— 经证据核验的研究长成可浏览的领域本体。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 鱼的记忆:给会话一份会淡忘的长期记忆,每条都带时间。名字里的「鱼」来自 DeepSeek 的鲸鱼。
dsh-trading
作者 zhu1090093659
基于 DeepSeek Harness 的智能体原生交易终端,三栏界面聚合币圈、美股、A股与港股,内置 19+ 可热插拔连接器,默认模拟交易并需人工确认。
08数据与来源
包自带 `cordis.patch.yml`,注册**唯一一条** entry:
面板分五个标签:**服务 / 记录 / 记忆树 / 设置 / 审计**。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-18。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
