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
羽毛球分组比赛记分
小程序二维码

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

小夜