简体中文 | English

dsh-layered-memory

给 DeepSeek Harness（DSH）装一层跨会话记忆。

DSH 的会话一结束，上下文就清空了。下次回到同一个项目，环境是怎么配的、上次那个报错最后怎么绕过去的，都得重新讲一遍。这个插件把这些信息写成文件留在磁盘上，之后的会话按需取回。

记忆分三层，索引、环境事实、任务经验。工具说明里的 L1、L2、L3 指的就是这三层。

用起来是什么样

装好之后直接对 Agent 说。

这个项目的构建命令是 ```pnpm build && pnpm test~~，测试要跑四十秒，记住。

它会把这条写进记忆库。第二天新开一个会话，你只说一句"帮我跑一遍测试"，命令它已经知道，不用重新交代。

反过来也一样。忘了某个服务的启动参数，让它去记忆里找，比翻聊天记录快。

安装

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

装好之后 <home>/.dsh/memory 下会自动建好目录和模板文件。

用法

读写记忆的时机由 Agent 判断，插件提供了一个 memory skill 和 14 个工具。progressive 模式下这些工具先不出现，Agent 调用一次 memory_activate 之后才会挂上。

工具	用途
memory_list	列出全部记忆（L2 facts + L3 sops + pending + L1 字符数/预算）
memory_read	读取指定记忆（index / fact 主题 / sop 文件名），返回溯源 meta 与 related 关联指针
memory_search	BM25 全文检索（含已归档条目；all_namespaces 跨库）
memory_write	写入记忆（fact/sop，evidence 必填；撞名自动快照旧版本；拒密钥明文）
memory_index	重建 L1 索引自动段（保留 [RULES] 手动段）
memory_pending	查看重试序列蒸馏候选（同工具先失败后成功）
memory_accept	接受 pending 候选入正式记忆
memory_update	更新记忆（supersede 保留历史快照）
memory_archive	归档记忆（从 L1 与 memory_read 隐藏，文件原地不搬，检索仍可命中）
memory_rollback	回滚到 .history/ 中最近快照
memory_expand	展开 sourceSession/sourceSeqs 对应的原始事件
memory_stats	统计 L2/L3/pending/archived 与占用
memory_maintain	去重、索引核对、统计、合并候选、冷条目复核
memory_promote	跨命名空间提升（项目局部经验升为全局）

配置

# profile cordis.patch.yml 里的裸条目，覆盖 bundle 行，不要重复 insert
- id: dsh-layered-memory
  config:
    memoryDir: ''              # 默认 <home>/.dsh/memory
    l1MaxChars: 12288         # L1 索引的字符预算，超预算只告警，不隐藏条目
    progressive: true
    defaultNamespace: ''       # 固定默认命名空间，留空则由 autoNamespace 决定
    autoNamespace: true        # 默认取 workspace 目录名加 git 分支名，家目录归 default
    autoPending: false         # 默认关闭：候选绝大多数是工具用法噪声，长期无人消费
    maintainEveryTurns: 20     # 每 N 轮自动维护一次，计数跨会话累计
    reflectionEnabled: true    # 反思提醒总开关，false 只停主动投递
    reflectPendingThreshold: 5 # 仅 autoPending 开启时生效，0 表示关闭该判据
    reflectSopsThreshold: 40   # 活跃 L3 SOP 达到该值时报整理提醒，0 表示关闭该判据
    reflectCooldownTurns: 10   # 两次反思注入之间的最小轮数
    nearDupeThreshold: 0.85    # 近重复去重的词元集合 Jaccard 阈值
    mergeCandidateThreshold: 0.45 # 合并候选报告阈值
    minTokensForFuzzy: 12      # 低于该词元数的内容只走精确 hash 去重
    heatHalfLifeDays: 14       # 访问热度半衰期（天）
    recencyWindowDays: 7       # 新条目无访问时的 recency 保护窗口（天）
    coldReviewDays: 90         # 冷条目复核窗口，默认 90 天
    namespaceCacheTtlMs: 60000 # autoNamespace 的 git 分支探测缓存 TTL（毫秒）

存储

记忆就是一堆 markdown 文件，没有数据库。默认放在 <home>/.dsh/memory。

<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
│   └── reflection-state.json
└── namespace 为 default 时，以上内容兼容地放在此根目录

可以直接备份、进版本库或手改。写入侧会拒绝疑似密钥的明文。

更多

• 设计与调度原理
• 开发与测试
• 更新历史

许可

MIT