前言¶

在 DeepSeek Harness (DSH) 的開發或使用場景中，會話結束通常意味着上下文丟失。爲了解決這個問題，dsh-maestro-memory 插件提供了持久化跨會話記憶和待辦事項的能力。它將數據保留在 ~/.dsh/memories 中，使 AI 能夠在會話之間保持連續性。

是什麼¶

這是一個 DSH 插件，提供持久化跨會話記憶和待辦事項。它維護 ~/.dsh/memories 文件。該插件由 ddtcorex 維護。

安裝與啓用¶

在安裝前，請確保環境滿足以下要求：
- Node.js 22+
- pnpm 11+
- DSH deepseek-harness master 版本

安裝插件時，使用以下命令：

dsh plugin --profile web add github:ddtcorex/dsh-maestro-memory#<tag-or-sha>

插件包含 cordis.patch.yml 配置文件，安裝時無需重複添加。該配置文件用於定義插件的核心行爲，包括記憶目錄、快照順序以及寫入控制等參數。

核心功能¶

該插件提供以下核心功能：

• 多軌道記憶管理：支持五條記憶軌道，包括全局、用戶、項目、分支和日常記憶。
• 待辦事項管理：提供 maestro_todo 工具，用於管理跨會話的待辦事項。
• 敏感信息過濾：memory 工具會自動過濾敏感信息，避免泄露 API key、密碼等。
• 健康檢查：提供健康檢查端點，用於監控插件運行狀態。

典型用法¶

在 DSH 環境中，可以通過以下工具進行操作：

• 管理記憶軌道：使用 memory 命令在五條軌道中添加、查看或管理條目。
• 管理待辦事項：使用 maestro_todo 命令管理跨會話的待辦事項列表。
• 修復記憶數據：如果發現記憶文件損壞，可以使用 memory.repair 命令修復條目，例如拆分粘連的條目或移除重複項。
• 檢查健康狀態：訪問 /dsh-maestro-memory-health 端點查看插件的運行狀況和統計信息。

注意事項¶

使用該插件時需要注意以下幾點：

• 版本要求：確保 DSH 版本爲 deepseek-harness master，且 Node.js 和 pnpm 版本符合要求。
• 配置修改：writeGuard 配置在 apply() 時讀取，修改該配置需要重啓 DSH 進程。
• 同步邏輯：歸檔同步邏輯較爲複雜，需要在所有機器上執行一致的操作，否則可能導致數據不一致。
• 合規性：插件以當前 DSH 進程的權限運行，安裝前請檢查源碼與許可證。

短結尾¶

dsh-maestro-memory 通過文件持久化解決了 DSH 上下文丟失的問題，適合需要長期記憶和任務跟蹤的場景。更多細節可參考 GitHub 倉庫。