前言¶

DSH 插件生態強調「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。對於需要在多個會話中保留項目約定、用戶偏好和階段性結論的場景，只依賴當前上下文並不方便。dsh-memory-palace 是一個 DeepSeek Harness 插件，把 WorkBuddy 的文件式記憶系統移植進 DeepSeek Harness，爲 Harness 提供跨會話持久化、人類可直接編輯的 Markdown 記憶。

下面介紹它的能力、安裝方式、典型用法，以及使用前需要注意的事項。

這是什麼¶

dsh-memory-palace 由 lovezi0 維護，許可證爲 MIT。

它把記憶存放在 Markdown 文件中：

• MEMORY.md：長期記憶文件。
• YYYY-MM-DD.md：每日日誌文件。

它支持用戶級和工作區級兩層記憶，也支持在已有 .workbuddy/memory 或 .codebuddy/memory 的項目中直接讀寫這些目錄，橋接 WorkBuddy / CodeBuddy 記憶。

核心功能¶

Markdown 記憶文件¶

記憶全部存儲在 Markdown 文件中，可以用編輯器直接修改。

常見文件包括：

• MEMORY.md
• YYYY-MM-DD.md

雙層記憶¶

插件支持兩層記憶：

• 用戶級記憶：默認路徑爲 ~/.deepseek-harness/MEMORY.md。
• 工作區級記憶：默認路徑爲 <cwd>/.deepseek-harness/memory/。

用戶級記憶適合保存跨項目個人偏好，工作區級記憶適合保存當前項目的約定和上下文。

每輪讀取與寫入¶

每輪對話會讀取：

• 用戶級 MEMORY.md
• 工作區 MEMORY.md
• 今日日誌 YYYY-MM-DD.md

並將相關內容注入 system prompt。

每輪結束會監聽 session/event 的 turn/end，經防閒聊閘門後，異步把輕量條目追加到當日日誌 YYYY-MM-DD.md。

日誌遷移¶

超過保留天數（默認 30 天）的每日日誌會自動遷移進 MEMORY.md，然後刪除原日誌。

WorkBuddy / CodeBuddy 橋接¶

當項目已存在以下目錄之一時，插件會直接讀寫這些目錄：

.workbuddy/memory
.codebuddy/memory

這樣可以複用已有的 WorkBuddy / CodeBuddy 記憶目錄，避免重複維護。

記憶工具¶

插件提供以下工具：

• memory_note：把約定或偏好寫入當前項目全部目標 MEMORY.md。
• memory_note_user：把跨項目偏好寫入 ~/.deepseek-harness/MEMORY.md。
• memory_read：一次性讀取用戶級和項目級記憶、今日日誌與最近 3 份歷史日誌。
• memory_delete：按內容刪除記憶條目，需要兩階段確認，刪除動作經 harness 原生確認彈窗硬閘門。

上述工具內置去重，防止重複追加。

hybrid 模式¶

hybrid 模式自 v1.6.0 起引入，支持記憶子代理寫今日工作日誌，並保留日誌作爲證據層。

該模式提供以下章節化工具：

• memory_write
• memory_update_section
• memory_reorganize

用於章節化寫入、替換和重整記憶內容。

在 hybrid 模式下，日誌永不過期，作爲證據層保留。

主動記憶¶

在主動記憶路徑（插件模式）下，插件可以引導 agent 在以下場景主動落檔：

• 修復
• 驗證
• 里程碑
• 偏好

智能模式¶

智能模式（LLM 智能會話摘要）可將會話新增對話增量提煉成摘要，並寫入每日日誌與 MEMORY.md。

圖形化設置¶

DSH 設置中內置「記憶」面板，路徑爲：

DSH 設置 →「記憶」

所有配置均可圖形化調整。

項目說明還提到，配置項（基礎 / 自動記錄 / 開發 三張卡片的字段、默認值與說明）已整理至 CONFIG.md。

手動蒸餾¶

會話標題欄提供「記憶」按鈕，支持手動蒸餾：

• 蒸餾會話
• 蒸餾項目記憶

安裝與啓用¶

前置要求：已安裝 DeepSeek Harness 及其 CLI，且 dsh 命令可用。

資料提供了多種安裝方式，可按環境選擇。

直接通過 GitHub 安裝¶

這條命令會直接把倉庫加入指定 profile：

dsh plugin --profile web add github:lovezi0/dsh-memory-palace

如果希望鎖定版本，可以使用：

dsh plugin --profile web add github:lovezi0/dsh-memory-palace#v1.6.2-alpha.4

clone 後本地安裝¶

適合開發或修改源碼的場景：

git clone https://github.com/lovezi0/dsh-memory-palace.git

進入目錄並構建：

cd dsh-memory-palace
npm install
npm run build

隨後裝入 profile：

dsh plugin --profile web add .

通過 npm 安裝¶

可以直接由 dsh 從 npm 拉取並裝入：

dsh plugin --profile web add dsh-memory-palace

也可以先手動用 npm 安裝，再裝入：

npm install dsh-memory-palace --registry=https://registry.npmmirror.com/
dsh plugin --profile web add dsh-memory-palace

卸載¶

dsh plugin --profile web remove dsh-memory-palace

典型用法¶

下面列出資料中可復現的讀取和寫入路徑。

讀取¶

每輪對話讀取以下文件，並注入 system prompt：

用戶級 MEMORY.md
工作區 MEMORY.md
今日日誌 YYYY-MM-DD.md

寫入¶

監聽 session/event 的 turn/end，經防閒聊閘門後，異步追加輕量條目到：

YYYY-MM-DD.md

工具調用¶

• memory_note：把約定或偏好寫入當前項目全部目標 MEMORY.md。
• memory_note_user：把跨項目偏好寫入 ~/.deepseek-harness/MEMORY.md。
• memory_read：一次性讀取用戶級和項目級記憶、今日日誌與最近 3 份歷史日誌。
• memory_delete：按內容刪除記憶條目，需兩階段確認。

設置¶

進入：

DSH 設置 →「記憶」

可在這裏圖形化調整相關配置。

版本與依賴¶

package.json 中 version 爲：

1.6.2-alpha.4

peerDependencies 指定了以下依賴版本：

@deepseek-ai/dsh-settings ^0.1.2-alpha.2
@deepseek-ai/dsh-tools ^0.1.2-alpha.2

項目說明還提到：

mian分支已適配 deepseek harness 0.1.2-alpha.2+
舊版本已切換分支歸檔，見 dsh-v0.1.x

該插件是標準 npm 插件包，經 dsh plugin 裝入 profile，cordis.patch.yml 聲明 bundle patch。

適用場景與注意¶

這個插件適合以下場景：

• 需要跨會話保留項目約定或個人偏好。
• 希望記憶文件人類可讀、可直接編輯。
• 項目中已有 WorkBuddy / CodeBuddy 記憶目錄，希望複用。
• 希望用 DSH 設置面板圖形化調整記憶相關配置。
• 需要在 agent 修復、驗證、里程碑、偏好等場景主動落檔。

使用前需要注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• memory_delete 需要兩階段確認，刪除動作會經 harness 原生確認彈窗硬閘門。
• hybrid 模式下日誌永不過期，作爲證據層保留。
• 項目說明中寫有參考 dsh-better-sidebar 與 dsh-sideband，但本插件實現爲各自機制的簡化落地，不含其完整功能。

結尾¶

dsh-memory-palace 的價值在於把 DSH 的記憶落到 Markdown 文件中：跨會話可保留，本地可直接編輯，也兼容 WorkBuddy / CodeBuddy 的目錄結構。如果你需要在 DeepSeek Harness 中建立一套可檢查、可修改、可遷移的記憶層，可以按上面步驟安裝並啓用。

項目倉庫：

https://github.com/lovezi0/dsh-memory-palace