前言¶

在 DSH 社區插件中，長期記憶可以作爲一個獨立能力接入。deepseek-harness-memory 把跨會話記憶保存在 markdown 文件中，並在會話啓動時自動注入。下面介紹它的能力、安裝方式、典型用法與注意事項。

這是什麼¶

deepseek-harness-memory 是一個 Claude Code 風格長期記憶插件（dsh 版）。它由 2303572348 維護，許可證爲 MIT，核心目標是提供跨會話持久記憶，並在會話啓動時自動注入。

插件把記憶保存在純 markdown 文件中，使用 MEMORY.md 索引和 YAML frontmatter，與 Claude Code 記憶格式 1:1 兼容。

核心能力¶

持久存儲與自動注入¶

插件支持用戶級記憶與工作區級記憶：

• 用戶級：~/.dsh/memory
• 工作區級：~/.dsh/memory/projects/<key>/

每次 prompt 組裝時，插件會把用戶級和當前工作區級記憶索引注入系統提示詞。這樣模型可以在後續會話中繼續引用之前保存的記憶。

memory 工具¶

插件提供 memory 工具，支持以下操作：

• add
• update
• delete
• list
• read
• import-claude

這些操作覆蓋了記憶的日常增刪改查，以及從 Claude Code 記憶導入。

Claude Code 記憶兼容¶

插件與 Claude Code 記憶格式兼容，並支持兩種遷移方式：

• 自動回退：讀取 ~/.claude/projects/<同key>/memory/ 與 ~/.claude/memory/。該讀取爲只讀，不改原文件。
• 正式導入：通過 import-claude 把 Claude Code 記憶導入 dsh 側。

多 checkout 記憶歸一¶

同一項目如果存在多個 checkout，路徑 key 可能不同。projectAliases 可以把多個路徑 key 映射到統一 key，使多個 checkout 使用同一份記憶。

配置覆蓋¶

插件可通過 cordis.patch.yml 覆蓋 memory 行的 config。可覆蓋的鍵包括：

• memoryRoot
• scope
• maxIndexLines
• maxIndexBytes
• maxList
• includeInPrompt
• importClaudeMemory
• projectAliases

安裝與啓用¶

常規安裝¶

先安裝 pnpm，因爲 dsh plugin 依賴它：

npm install -g pnpm

在插件目錄執行正式安裝命令：

dsh plugin --profile web add .

執行完成後，重啓 dsh web，插件生效。

無 pnpm 的兜底方式¶

如果暫不安裝 pnpm，可以把 deepseek-harness-memory 目錄複製到：

~/.dsh/profiles/node_modules/deepseek-harness-memory/

然後在 ~/.dsh/profiles/web/cordis.patch.yml 追加：

- insert:
    - id: memory
      name: 'deepseek-harness-memory'

升級與回滾¶

升級插件：

dsh plugin --profile web update deepseek-harness-memory

回滾插件：

dsh plugin --profile web remove deepseek-harness-memory

回滾後，記憶文件保留不刪。

典型用法¶

維護記憶¶

在會話中要求模型使用 memory 工具，可以執行：

• add：新增記憶
• update：更新記憶
• delete：刪除記憶
• list：列出記憶
• read：讀取記憶

導入 Claude Code 記憶¶

自動回退只讀 Claude Code 記憶時，需要依賴 importClaudeMemory 相關配置。

正式導入時，可以對模型說：

用 memory 工具 import-claude 導入記憶

也可以調用：

memory action=import-claude

配置 projectAliases¶

如果兩個 checkout 需要共用同一項目記憶，可以在配置中加入：

projectAliases:
  C--work-my-project-a: my-project
  C--work-my-project-b: my-project

經過上面的配置，兩個路徑 key 會映射到同一個 my-project。

適用場景與注意¶

這個插件適合：

• 需要在 DSH 中跨會話保留記憶的用戶。
• 已有 Claude Code 記憶，希望複用其格式或導入到 DSH 的用戶。
• 同一項目有多個 checkout，希望共用一份記憶的用戶。

使用前需要注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 記憶明文存儲，勿存密鑰/PII；README 明確絕不保存 API 密鑰/密碼。
• 無自動記憶提取；無 /memory、/toggle-memory 命令。
• lib/index.js 依賴 @deepseek-ai/dsh-tools 與 @deepseek-ai/schemastery，從 profile 的 node_modules 解析。

結尾¶

deepseek-harness-memory 提供了 DSH 側的跨會話記憶能力，並把記憶組織成 Claude Code 兼容的 markdown 結構。經過上面的安裝和配置，它可以在會話啓動時自動注入記憶索引，也可以從 Claude Code 既有記憶中回退讀取或正式導入。

目錄頁：https://www.skillhub.cn/plugins/2303572348/deepseek-harness-memory

GitHub：https://github.com/2303572348/deepseek-harness-memory