前言¶
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