前言¶
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 主要解决“长期记忆怎么落到本地文件里,并且可以被检查、引用和恢复”的问题。已核实的能力包括:
- 为 DSH 提供长期个人记忆,把用户习惯、可复用任务经验和工程洞察保存到可检查的本地文件。
- 保留 DSH Session 作为逐字 Recall 层,且不复制 Session 事件。
- 提供分层记忆:
- DSH Session JSONL 保存原始历史;
- ExpMem 以每条记录一个 JSON 文件保存习惯、经验和洞察。 - 在 70% 上下文压力提示时,促使当前 Agent 保留持久知识,并可用 Recall 恢复。
- 检索长期记忆时,结合相关性、近期性和 Agent 分配的重要性进行排序。
- 支持可审计的反思:
- 洞察记录会引用支撑它的观察或先前反思;
- Reflection Runs 可中断后恢复。 - 维护信任生命周期,记录状态包括:
-candidate
-verified
-disputed
-superseded
并保留来源、冲突和替换历史。 - 支持导入 Claude Code 和 Codex 的 Markdown 记忆文件,生成带来源证据的
candidateexperience 记录。 - 本地轻量运行,不添加向量数据库、后台 worker 或第二个模型请求,也不修改 DSH Agent Loop。
安装与启用¶
先安装插件到 DSH 的 web profile:
dsh plugin --profile web add @creative-dswork/dsh-expmem
安装后按正常方式启动 DSH:
dsh web
安装这一步主要做两件事:
- 将 DSH ExpMem 加入当前 DSH 插件集合;
- 让 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 的场景包括:
- 希望把用户习惯、任务经验和工程洞察保留为本地可检查文件。
- 希望 DSH Session 仍作为原始逐字历史,不被插件复制或改写。
- 希望从 Claude Code 或 Codex 的 Markdown 记忆中迁移可用经验。
- 不希望引入向量数据库、后台 worker 或额外的模型请求。
使用前注意:
- DSH ExpMem 不是官方 DeepSeek 项目。
- 许可证为 MIT。
- 插件会以当前 DSH 进程权限运行;安装前应检查源码和许可证。
- ExpMem 不修改或删除导入的源文件。
- 读取
0.2.x和更早 v1 记录时会使用兼容默认值;遇到异常或未来版本文件会产生扫描警告,但不会隐藏同目录中的有效记录。
结尾¶
DSH ExpMem 的价值在于把长期记忆从“会话历史”中拆出来,保存为本地可检查、可引用、可恢复的记录,同时不改变 DSH Session 的原始历史定位。适合希望以轻量方式扩展 DSH 长期记忆能力的开发者。
GitHub 仓库:
https://github.com/creativedswork/dsh-expmem
目录页:
https://www.skillhub.cn/plugins/creativedswork/dsh-expmem