dsh-memory

DSH PLUGIN记忆与知识

仓库 JOJO-Adam/dsh-memory

记忆与知识 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH 三层记忆中枢:全局/项目/人格记忆,本地优先零出站。

一句话选型结论

按资料字段整理

dsh-memory 是记忆与知识类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

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

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add @jojonadam/dsh-memory@0.5.5
  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 查看包信息

能做什么

记忆与知识
字段来自项目仓库与公开索引,中文说明由本站标注

适用场景

记忆

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

选择建议

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

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

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

不太适合

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

同类对比

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

仓库档案

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

README 全文

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

dsh-memory · JOJO&Adam

DSH 的三层记忆中枢,一个包装齐:

层 解决什么 落点
L1 全局 跨项目、跨会话的画像与偏好 ~/.dsh/memory/(与 AGENTS.md 协议一致)
L2 项目 单项目防漂移:阶段、决策、约束别丢 项目内 AGENTS.md + .dsh/memory/
L3 人格 角色的持久人格与抗压缩记忆 可选,接 Stemem MCP

本地优先、零出站。不替代 DSH 原生记忆,只做路由、体检和接线。

v0.2–v0.5:原生工具 + hooks + 子代理 brief + 指标 + L3→L2

v0.2 起,插件除了提供 memory-hub 技能,还向 DSH 注册模型可直接调用的工具(v0.2 四个,v0.4 加 metrics,v0.5 加 distill):

工具 作用 关键约束
memory_read 读项目 / 全局记忆文件 路径围栏;默认 MEMORY.md
memory_search 按关键词搜记忆,返回 path:line:text 只读;默认最多 50 条
memory_write 追加一条原子记忆 source 必填;拒绝明文凭据;拒绝越界;索引超预算拒绝
memory_health 体检:预算 / 凭据 / 重复 / 缺来源 只读;不自动改
memory_metrics 存储指标 + hook 计数 只读;不输出密钥值
memory_distill 旧 L3 日志机械归档到 L2 topics 不删除 L3;apply=true 才写;非语义摘要

工具优先,hook 兜底:正常写入走 memory_write,在落盘前完成路径、来源、凭据、预算校验;v0.3 再用 Cordis hooks 兜住 Bash 等旁路。

同时注册一个很短的 system prompt 段(jojo-adam-memory-tools),只说明「何时用工具、写入门槛」,不重复注入 MEMORY.md 正文。

v0.3:三个 Cordis hooks

hook 事件 做什么
路由提示 tools/post-execute read/write/edit 后按 .dsh/memory/routes.tsv 的 glob 追加「该读哪几条」;同 agent 同文件去重。晚于读取,是读后提示,不是读前拦截。
Bash 守卫 tools/post-execute + agent/created agent/created 预建记忆快照;Bash 后比对 mtime/size,变更文件跑凭据 + MEMORY.md 行数预算;不阻断执行。
会话摘要 session/event + agent/turn-stopping 收 user/message / assistant/message,在 turn 结束时写当日 .dsh/memory/.md;dsh-memory-digest 块原地替换,保留手写内容。

没有 settings.json hooks;全部是 Cordis 事件监听。hook 异常 fail-open,不阻断工具/轮次。

v0.4:子代理 brief + 记忆指标

  • 子代理 brief:agent/created 检测 session.header.origin === 'subagent' / delegationDepth / options.subagentDepth;命中后给子代理注入一个只读 system prompt 段,含项目 + 全局 MEMORY.md(各截断 2000 字符,落盘前脱敏)。主理人不注入,避免双份。
  • 记忆指标:memory_metrics 工具输出文件数 / 字节 / 索引行 / 条目 / 凭据文件 / 缺来源 / topics / dailies,以及进程内 hook 计数(route / bash / digest / subagent)。只读,无密钥值。

v0.5:L3→L2 机械归档

memory_distill 先 apply=false 预览:扫早于 days(默认 30)的 YYYY-MM-DD.md,抽出 - [ 条目,最多 limit 条(默认 200)。apply=true 时写入 topics/distilled-YYYY-MM.md,用 dsh-memory-distill 独占行标记块,重复 apply 原地替换;不删除 L3。

它只做机械归档,不做语义摘要。真正的「把旧日志提炼成一条教训」仍由 agent 用 memory_write 写,避免把复制说成蒸馏。

路由表是可选的,放在 .dsh/memory/routes.tsv:

触发  glob    路径  摘要
测试路由    *.md    MEMORY.md   读 MEMORY
交付包 *.zip   .workbuddy/memory/topics/交付.md  包型 / 版本 / 归档

没有表就静默,不报错。

安装

方式一:从本地目录(开发)

dsh plugin --profile desktop add link:/absolute/path/to/dsh-memory

方式二:从 npm

dsh plugin --profile web add @jojonadam/dsh-memory        # Web 版
dsh plugin --profile desktop add @jojonadam/dsh-memory    # 桌面版

方式三:只用技能(不装包)

cp -r skills/memory-hub ~/.dsh/skills/

装好后在会话里说「做一次记忆体检」或「帮我建项目记忆」,agent 会按 memory-hub 技能路由;涉及读写时会优先用四个工具。

验证

node test/provider.test.mjs
node test/tools.test.mjs
node test/hooks.test.mjs
python3 skills/memory-hub/scripts/mem_health_scan.py --path ~/.dsh/memory/MEMORY.md

工具测试用临时 HOME / 临时项目,不会写真实 ~/.dsh/memory。

包含

lib/index.js                         bundle 入口(skill provider + tools + prompt)
lib/memory/core.js                   路径 / 预算 / 脱敏 / 读写 / 搜索 / 体检(纯函数)
lib/memory/tools.js                  六个 model-facing 工具定义
lib/memory/hooks.js                  Cordis hooks:路由提示 / Bash 守卫 / 会话摘要 / 子代理 brief
lib/memory/metrics.js                进程内 hook 计数
skills/memory-hub/SKILL.md           主技能
skills/memory-hub/references/        L1/L2/L3 细则 + Stemem 调用范式
skills/memory-hub/scripts/           健康扫描 / 项目骨架生成(零依赖 Python)
test/provider.test.mjs               技能 provider 冒烟
test/tools.test.mjs                  工具 / 围栏 / 预算 / 凭据测试
test/hooks.test.mjs                  路由 / Bash 守卫 / digest 幂等测试

边界

  • 不收集 PII,不外发数据。
  • 人格是计算模拟,不是真实情感。
  • 凭据只进钥匙串,记忆只存指针。
  • v0.5 含 Bash 守卫、route hint、会话 digest、子代理 brief、只读指标、L3→L2 机械归档;不含 LLM 语义蒸馏、跨进程状态、记忆质量评分。
  • 路由提示是读后的;DSH 的 tools/pre-execute 是决策口,不提供读前 additionalContext。
  • 插件依赖 DSH 的 skills / tools / systemPrompt 三个服务;缺任意一个不会加载。

品牌

JOJO & Adam ·

License

MIT(Stemem 运行时 MIT;其底层人格引擎 NeshamaEngine 为 JOJO/Neshama 自有 IP,依原项目许可)。

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add @jojonadam/dsh-memory@0.5.5` 即可。

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

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-memory 安全吗?

低风险。

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

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

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

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

这条记录的数据可靠吗?

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

同名或近似条目

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

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 万 星

JOJO-Adam 的其它插件

6 个

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