DSH ExpMem:为 DeepSeek Harness 增加可检查的长期记忆插件

前言

DSH 的 Session 已经可以保存当前会话的原始历史,但跨会话要复用的用户习惯、任务经验和工程洞察,还需要一种可检查、可追溯的本地存储方式。DSH ExpMem 是一个社区插件,面向 DeepSeek Harness,把长期个人记忆写入本地 JSON 文件,同时保留 DSH Session 作为逐字 Recall 层,且不复制 Session 事件。下面介绍它的定位、核心能力、安装方式和典型导入用法。

这是什么

  • 插件名:creativedswork/dsh-expmem
  • 维护者:creativedswork
  • 描述:Experience Memory for DeepSeek Harness
  • 许可证:MIT
  • 说明:不是官方 DeepSeek 项目;它属于 DSH 插件生态中的社区插件,不等同于官方应用商店。

核心功能

DSH ExpMem 主要解决“长期记忆怎么落到本地文件里,并且可以被检查、引用和恢复”的问题。已核实的能力包括:

  1. 为 DSH 提供长期个人记忆,把用户习惯、可复用任务经验和工程洞察保存到可检查的本地文件。
  2. 保留 DSH Session 作为逐字 Recall 层,且不复制 Session 事件。
  3. 提供分层记忆:
    - DSH Session JSONL 保存原始历史;
    - ExpMem 以每条记录一个 JSON 文件保存习惯、经验和洞察。
  4. 在 70% 上下文压力提示时,促使当前 Agent 保留持久知识,并可用 Recall 恢复。
  5. 检索长期记忆时,结合相关性、近期性和 Agent 分配的重要性进行排序。
  6. 支持可审计的反思:
    - 洞察记录会引用支撑它的观察或先前反思;
    - Reflection Runs 可中断后恢复。
  7. 维护信任生命周期,记录状态包括:
    - candidate
    - verified
    - disputed
    - superseded
    并保留来源、冲突和替换历史。
  8. 支持导入 Claude Code 和 Codex 的 Markdown 记忆文件,生成带来源证据的 candidate experience 记录。
  9. 本地轻量运行,不添加向量数据库、后台 worker 或第二个模型请求,也不修改 DSH Agent Loop。

安装与启用

先安装插件到 DSH 的 web profile:

dsh plugin --profile web add @creative-dswork/dsh-expmem

安装后按正常方式启动 DSH:

dsh web

安装这一步主要做两件事:

  1. 将 DSH ExpMem 加入当前 DSH 插件集合;
  2. 让 DSH 在运行中可以使用长期记忆相关的 Recall、检索、压力提示和反思机制。

典型用法

导入 Claude Code 和 Codex 的 Markdown 记忆

ExpMem 支持把 Claude Code 和 Codex 生成的 Markdown 记忆文件导入为 candidate experience 记录。建议先执行 dry-run,确认待导入内容:

pnpm dlx @creative-dswork/dsh-expmem import all --dry-run

确认无误后正式导入:

pnpm dlx @creative-dswork/dsh-expmem import all

默认导入路径为:

Claude Code:
~/.claude/projects/**/memory/*.md

Codex:
$CODEX_HOME/memories/**/*.md
或
~/.codex/memories/**/*.md

如果使用自定义目录,可以分别指定:

pnpm dlx @creative-dswork/dsh-expmem import claude --claude-dir /path/to/memory
pnpm dlx @creative-dswork/dsh-expmem import codex --codex-dir /path/to/memories

如果需要为导入的记忆附加显式项目作用域,可以使用:

pnpm dlx @creative-dswork/dsh-expmem import all --workspace /path/to/project

导入后,每个源文件会对应生成 candidate experience 记录,并保留来源证据信息。ExpMem 不会修改或删除导入的源文件。

适用场景与注意

适合使用 DSH ExpMem 的场景包括:

  1. 希望把用户习惯、任务经验和工程洞察保留为本地可检查文件。
  2. 希望 DSH Session 仍作为原始逐字历史,不被插件复制或改写。
  3. 希望从 Claude Code 或 Codex 的 Markdown 记忆中迁移可用经验。
  4. 不希望引入向量数据库、后台 worker 或额外的模型请求。

使用前注意:

  1. DSH ExpMem 不是官方 DeepSeek 项目。
  2. 许可证为 MIT。
  3. 插件会以当前 DSH 进程权限运行;安装前应检查源码和许可证。
  4. ExpMem 不修改或删除导入的源文件。
  5. 读取 0.2.x 和更早 v1 记录时会使用兼容默认值;遇到异常或未来版本文件会产生扫描警告,但不会隐藏同目录中的有效记录。

结尾

DSH ExpMem 的价值在于把长期记忆从“会话历史”中拆出来,保存为本地可检查、可引用、可恢复的记录,同时不改变 DSH Session 的原始历史定位。适合希望以轻量方式扩展 DSH 长期记忆能力的开发者。

GitHub 仓库:

https://github.com/creativedswork/dsh-expmem

目录页:

https://www.skillhub.cn/plugins/creativedswork/dsh-expmem
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye