DDDFXYqiming/dsh-layered-memory

Name: DDDFXYqiming/dsh-layered-memory
Author: DDDFXYqiming

插件Plugin 原生Native ⭐ 3 MIT 记忆与知识库Memory & Knowledge 会话与上下文Sessions & Context 提示词与技能Prompts & Skills

DeepSeek Harness 的跨会话长期记忆插件

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-layered-memory 是 DSH 跨会话长期记忆插件，按命名空间隔离，用 L1 索引注入、L2 环境事实、L3 任务经验、BM25 检索、去重、溯源归档与回滚保存已验证信息。需要跨轮保留事实、经验或重试蒸馏时使用。写入须提供 evidence，且不存时间戳、PID、临时路径等易变状态。

dsh-layered-memory is a DSH plugin for cross-session long-term memory. It uses namespace isolation, L1 index injection, L2 environment facts, L3 task experience, BM25 search, deduplication, provenance, archiving, rollback, and retry distillation. Use it when facts, workflows, or lessons must persist across turns. Every write requires evidence, and volatile state such as timestamps, PIDs, or temp paths must not be stored.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-layered-memory】【https://github.com/DDDFXYqiming/dsh-layered-memory】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:DDDFXYqiming/dsh-layered-memory

把 DDDFXYqiming/dsh-layered-memory 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

5.5 KB · 缓存于 2026-08-28 05:31:09 · 5.5 KB

简体中文 | English

dsh-layered-memory

DeepSeek Harness（DSH）跨会话长期记忆插件 —— 命名空间隔离 + L1 索引注入 + L2 环境事实 + L3 任务经验 + BM25 全文检索 + 内容级近重复去重 + 跨命名空间提升 + 重试序列蒸馏 + 溯源/归档/回滚 + 自动维护 + 渐进式工具暴露。

能力

memory:index 注入 —— ctx.systemPrompt.context 把 L1 索引实时注入每轮模型上下文，改动即时生效。

runtime skill memory —— 触发语义：何时读、何时写、何时同步索引（内容见 SKILL.md）。

工具（progressive 模式下经 memory_activate 挂载，14 个）：

工具	用途
`memory_list`	列出全部记忆（L2 facts + L3 sops + pending + 索引行数）
`memory_read`	读取指定记忆（index / fact 主题 / sop 文件名），返回溯源 meta 与 related 关联指针
`memory_search`	BM25 全文检索（含已归档条目；`all_namespaces` 跨库）——L1 被裁剪的条目也能找回
`memory_write`	写入记忆（fact/sop，evidence 必填 = 行动验证公理；可选 `related` 关联链接）
`memory_index`	重建 L1 索引自动段（保留 [RULES] 手动段）
`memory_pending`	查看重试序列蒸馏候选（同工具先失败后成功）
`memory_accept`	接受 pending 候选入正式记忆
`memory_update`	更新记忆（supersede 保留历史快照；支持 related）
`memory_archive`	归档记忆（L1 隐藏，文件保留在 archive/，可用 `memory_rollback` 恢复或 `memory_search` 检索到）
`memory_rollback`	回滚到 `.history/` 中最近快照
`memory_expand`	通过 `sessionQuery` 展开 sourceSession/sourceSeqs 原始事件
`memory_stats`	统计 L2/L3/pending/archived/大小
`memory_maintain`	内容级去重、压缩索引、统计、合并候选
`memory_promote`	跨命名空间提升（项目局部经验 → 全局 default）

安装

# 从 GitHub 安装（推荐，自带 cordis.patch.yml，贡献 id: dsh-layered-memory）
dsh plugin --profile web add github:DDDFXYqiming/dsh-layered-memory

# 本地开发时也可直接使用仓库目录
dsh plugin --profile web add <本目录>

配置

# profile cordis.patch.yml —— 裸条目覆盖 bundle 行（勿重复 insert！）
- id: dsh-layered-memory
  config:
    memoryDir: ''              # 默认 <home>/.dsh/memory
    maxIndexLines: 30
    progressive: true
    defaultNamespace: ''       # 固定默认命名空间；留空则 autoNamespace 生效
    autoNamespace: true        # 默认取 workspace 目录名 + git 分支名
    autoPending: true          # turn/end 捕获「先失败后成功」重试序列为 pending 候选
    maintainEveryTurns: 20     # 每 N 轮自动维护（计数持久化，跨会话累计）
    reflectPendingThreshold: 5 # pending 达到该值时注入整理请求
    reflectSopsThreshold: 40   # L3 SOP 达到该值时注入整合请求

memory_maintain 何时裁剪 L1：只在完整索引超过 maxIndexLines 时触发；贪心装入、每步按真实行数核算（含空层占位行），按衰减热度排序（14 天半衰 + 7 天内新建条目 recency 加分），被裁剪的记忆不会丢失——可直接 memory_search 找回。memory_write 检测到超限也会立即触发同款压缩，告警只在压缩后仍超限时出现一次。

存储布局

<home>/.dsh/memory/
├── <namespace>/                非 default 命名空间（推荐显式配置）
│   ├── memory_management_sop.md
│   ├── index.txt
│   ├── facts.md
│   ├── sops/*.md
│   ├── pending/*.md
│   ├── archive/ / .history/
│   ├── memory-meta.json
│   ├── maintenance-report.json
│   ├── turn-state.json
│   └── file_access_stats.json
└── （namespace=default 时，以上内容兼容地放在此根目录）

核心公理

行动验证：No Execution, No Memory —— memory_write 的 evidence 必填，只写成功验证过的信息
神圣不可删改：已验证事实可压缩/迁移/supersede/archive，但严禁物理丢弃
禁易变状态：时间戳/PID/临时路径不存
最小充分指针：L1 只写存在性，细节在 L2/L3 按需取

开发与测试

pnpm install
pnpm build        # node --check lib/index.js
pnpm test         # vitest（pnpm 11 可直接运行，见下）
pnpm test:smoke   # dsh --profile headless --dump-config

单元测试会 import @deepseek-ai/dsh-tools / @deepseek-ai/schemastery（DSH 内置包）。本机若有已安装的 DSH 环境，可将 node_modules/@deepseek-ai 等以 junction/链接方式指过去；.npmrc 已写 auto-install-peers=false 防 pnpm 解析私有 peer。

预检环境坑（实测踩过）：pnpm 11 的 run 前置依赖检查会尝试解析 peer 链中的 DSH 私有包（如 @deepseek-ai/dsh-type-meta，不在 npm registry）→ pnpm test 报 ERR_PNPM_FETCH_404。修复：pnpm-workspace.yaml 顶层声明 verifyDepsBeforeRun: false（pnpm 11 认可的位置；.npmrc 的 kebab 写法对 pnpm 11 无效）。仓库已配好，pnpm test 直接可用；若仍被拦截，兜底走 ./node_modules/.bin/vitest run。

命令行安装CLI Install 复制安装命令Copy Install