dsh-simple-memory

DSH PLUGIN记忆与知识

仓库 liu-zhengdong/dsh-simple-memory

记忆与知识 未标注验证等级 安全审查:未标注 可信度:未标注 可安装插件

把你自己维护的 Markdown 记忆目录接入 DeepSeek Harness:每轮常驻索引、正文按需读取,插件只读不改,让模型随时定位并读取你的笔记。

一句话选型结论

按资料字段整理

dsh-simple-memory 是记忆与知识类的 DSH 可安装插件,未做沙盒验证,暂无安全审查结论,列出 5 项功能,没有现成安装命令,需要按仓库 README 接入。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类记忆与知识 收录类型可安装插件 验证等级未标注验证等级 安全审查未标注
验证等级 UNKNOWN 未标注验证等级
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-11 创建于 2026-10-05
README 8.2 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-simple-memory:把 Markdown 记忆目录接进 DeepSeek Harness 的 DSH plugin

  • 每轮注入记忆索引
  • 关键词命中即时提醒
  • 正文按需读取
  • 只读不改记忆目录
  • 支持全局与项目记忆

上游标签

deepseek-harnessdsh-plugin

验证等级与安全审查

未标注验证等级
自动化流程结论,不是人工审核
验证等级未标注验证等级上游未给出验证结论,安装前请自行确认
安全审查未标注静态分析结论,未标注不代表已通过审查
仓库健康度未标注按仓库活跃度与最近更新时间给出
可信度未标注综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 安全审查还没结论,装之前先看仓库改了什么、要什么权限。
  • 没有现成安装命令,要按仓库 README 手动接入。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在记忆与知识场景里给 DSH 补能力的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-simple-memory当前 未做沙盒验证 未标注 0 未标注 无
ruflo L3 · 安装规范通过 低风险 7.4 万 未标注 无
OpenViking L3 · 安装规范通过 低风险 3.9 万 未标注 无
WeKnora L4 · 沙盒安装通过 低风险 3.3 万 未标注 有
distilly L4 · 沙盒安装通过 低风险 2.5 万 未标注 有
EverOS L4 · 沙盒安装通过 低风险 1.3 万 未标注 有

仓库档案

记忆与知识
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方liu-zhengdong仓库 dsh-simple-memory · 默认分支 main
分类记忆与知识knowledge
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言TypeScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-05 · 2026-10-11最后推送 2026-10-11
本站收录2026-10-10首次进入本站目录的时间

README 全文

8.2 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-simple-memory

把你自己维护的 Markdown 记忆目录(Obsidian 库、.memory 项目记忆)接入 DSH:
常驻一份索引(渲染出的文本不变就不重复注入),正文按需读取,插件只读不改。

从 pi-memory 移植。行为契约(frontmatter
的含义、按字节计的预算、整份来源排除、字面关键词提醒)保持不变,注入机制按 DSH 的
插件面重写。

它做什么

  • 索引注入:把记忆的根层条目放进运行时上下文——每条给名称与 frontmatter 的
    description 定位,仓库根路径只在「记忆仓库」段写一次,子文件夹只列名字。
    defaultopen: true 的记忆带全文,其余只给摘要;更深层的记忆不进默认上下文。
    渲染出的文本与上一条快照相同就什么都不做,改记忆、换工作目录或升级插件才会重发。
  • 仓库契约:每段来源开头附一段「记忆仓库」,写明这个仓库的绝对路径、什么结论值得
    写进来、写入方式与 frontmatter 各字段的作用。目录为空时同样给出,模型才知道往哪落
    第一条。这段文字不占配置,改它要改 src/memory.ts。
  • 关键词提醒:frontmatter keywords 里的字面短语命中用户输入或模型文本时,
    在本步追加一条 user 快照消息,给出路径,让模型自己用 read 读取全文。
    命中过一次的记忆在本轮不再重复提醒。
  • 写入提醒:每轮第一步追加一条 user 快照消息,提醒模型把长期成立的结论(用户
    偏好、项目约定、踩过的坑、要反复查证的事实)主动写进记忆仓库,并列出各仓库的
    绝对路径;同轮后续步不重复,proactive: false 可关。
  • 按需阅读:上层正文里的 [[路径]] 引用由模型自己判断,插件不解析、不校验。
  • 只读:不写你的记忆目录,不写配置文件;缓存只在内存里。

与 pi-memory 的差异

pi-memory dsh-simple-memory
索引注入 Pi 系统提示词尾部 DSH runtime-context 快照里的 simple-memory 段
关键词提醒 系统提示词尾部(下一轮) agent/pre-step 追加的 user 快照消息(本步生效)
配置 agent 目录下的 memory.json profile 的 cordis.patch.yml(schemastery Config)
项目记忆信任门槛 需要 Pi 信任该项目 无(与 AGENTS.md 注入同一个信任边界)
命令 /memory set、/memory clear 会写配置 只读;配置改 YAML
落盘缓存 agent 目录 cache/pi-memory/ 无(内存里按文件签名缓存)

安装

# 从 GitHub
dsh plugin --profile  add github:liu-zhengdong/dsh-simple-memory

# 本地 checkout(开发用)
dsh plugin --profile  add /abs/path/to/dsh-simple-memory

包声明了 dsh.bundle.patch,添加后包名会被追加进该 profile 的 dsh.profile.bundles。
验证层已挂上:

dsh --profile  --dump-config | grep -B2 -A6 dsh-simple-memory

> 本包未发布到 npm,add dsh-simple-memory 会失败。
> 仓库直接带 lib/ 构建产物,安装时不跑构建脚本(pnpm 会拦下 git 包的
> prepare,放行键还绑 commit hash,因此不采用那条路)。改源码后跑
> npm run build 并把 lib/ 一起提交。

配置

字段 默认 说明
directory "" 全局记忆目录,绝对路径或 ~ 开头;留空表示不使用全局来源
projectSources true 从工作目录向上到 git 根逐层发现 .memory
reminders true 按 keywords 命中用户输入或模型文本时提醒
proactive true 每轮提醒一次:把长期成立的结论主动写进记忆仓库
maxContextBytes 262144 单次注入的记忆文本上限(UTF-8 字节,1 KiB–16 MiB)

配置住在 profile 的 cordis.patch.yml 里。patch 整块替换 config,不做深合并,
所以覆盖时请写全你要的字段:

- id: simple-memory
config:
directory: ~/Obsidian/记忆
projectSources: true
reminders: true
proactive: true
maxContextBytes: 262144

改这一行会触发插件热替换,不需要重启。

桌面端设置界面

桌面版不必手改 YAML,三个入口指向同一张表单:

  • 设置 → 插件 → 记忆:一个独立标签页;
  • 插件页 → dsh-simple-memory 的配置区;
  • 插件列表里本插件那一行右侧的「配置」。

五个字段都能改,directory 旁边有「选择目录…」,点开就是系统目录选择框。保存后写进该
profile 的 cordis.patch.yml(也就是上面那段 YAML),立即生效。

为什么只有这五个字段:宿主设置服务只把 Config 里标成 volatile 的字段暴露出来,本插件
五个字段都标了。表单控件是按官方外观照抄的——官方明确禁止插件 require
@deepseek-ai/dsh-client-*(那些包随时会变),所以客户端半侧只声明 slots 与 locale
两个服务,目录选择走官方给第三方的 ctx.uiWorkspace.pickDirectory()。

> client/client.js 只在 DSH 启动时扫描一次(只认 dsh.client.platform 与
> exports["./client"]),改这个文件要重启 DSH 才生效;改记忆目录本身不用重启。

记忆文件格式

---
description: 界面字体的选择,排版相关任务开工前先看(进索引)
defaultopen: true          # 可选:整篇正文进默认上下文(超过 8 KiB 会提示拆分)
keywords:                  # 可选:字面短语,命中就提醒
- 字体
- 字体栈
---

正文……
  • 只有 .md 会被收录;点开头的文件、符号链接跳过。
  • 每层来源只扫根目录的直接子项,子文件夹作为入口列出(示例见 examples/vault/)。
  • 上面这些规则以「记忆仓库」那段文字随索引一起注入,模型据此决定往哪写、怎么写;
    插件自己不写盘。
  • 解析失败、frontmatter 超限、来源超预算都会出现在 /memory 的输出里,不会静默截断。

上限

项 值
单次注入文本 256 KiB(可配 1 KiB–16 MiB)
单篇 frontmatter 64 KiB
单篇 defaultopen 全文 8 KiB(照常注入,但提示拆分)
关键词索引 16 MiB / 100,000 条

超预算的整份来源会被排除并在 /memory 里给出原因,而不是截断正文。

命令

命令 作用
/memory 目录、来源数、注入 KiB、索引篇数、未注入来源与提醒
/memory preview 本轮的注入文本(索引)与未注入来源
/memory help 用法

命令只在有命令面的宿主里可用(headless 没有)。它是只读的——改配置请用桌面端设置界面,
或直接改 YAML。

开发

pnpm install
npm run check     # tsc --noEmit
npm test          # node --test(101 个用例,含假宿主、客户端接线与 volatile 配置契约测试)
npm run build     # tsc -p tsconfig.build.json → lib/

本地联调:dsh plugin --profile add .,然后用
dsh headless --json "……" 或桌面端发一条消息;调试日志用
DSH_SIMPLE_MEMORY_DEBUG=1 打开。

已知限制

  • 只读、无写回:插件不替你整理记忆,也不从对话里自动提取。
  • 字面匹配,不是语义检索:keywords 是大小写不敏感的英文子串匹配,
    中文按原样匹配;不做正则、不做向量检索。
  • [[路径]] 不解析:是否读取由模型决定。
  • 注入文本会改写 {{:DSH 组装期会对 {{name}} 做变量插值,未注册的变量名会让
    整轮请求报错,所以索引文本里的 {{ 会被拆成 {<零宽空格>{(提醒消息不需要,
    它不走插值)。
  • 不 import @deepseek-ai/* 类型:官方包只随 DSH 分发,npm 上的版本与宿主不一致;
    插件用自己的最小结构化类型对接宿主。
  • 客户端半侧也不 import 官方客户端包:client/client.js 只用 react 和 slots/
    locale/configForms/uiWorkspace 四个服务,控件按 --dsw-* 主题变量照抄。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
dsh-simple-memory 怎么安装?

本站没有抓到该条目的安装命令,请到仓库主页确认安装方式;这类条目多数是生态应用或尚未发布安装包的项目。

dsh-simple-memory 的验证等级是什么意思?

未标注验证等级。上游未给出验证结论,安装前请自行确认

dsh-simple-memory 安全吗?

未标注。

dsh-simple-memory 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-simple-memory 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-simple-memory 有哪些功能?

每轮注入记忆索引、关键词命中即时提醒、正文按需读取、只读不改记忆目录、支持全局与项目记忆。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

1 条
不同作者的仓库分开列,请确认你要装的是哪一个
记忆与知识
按星标排序,可作替代方案

ruflo

ruflo

L3 · 安装规范通过 7.4 万 星

OpenViking

OpenViking

面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`vik

L3 · 安装规范通过 3.9 万 星

WeKnora

WeKnora

把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己

L4 · 沙盒安装通过 3.3 万 星

distilly

distilly

Distilly — Distill how they think into reusable Skills for any Agent o

L4 · 沙盒安装通过 2.5 万 星

EverOS

EverOS

L4 · 沙盒安装通过 1.3 万 星

MemOS

MemOS

L4 · 沙盒安装通过 1.2 万 星

liu-zhengdong 的其它插件

2 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。