前言¶

DeepSeek Harness (DSH) 的插件生態強調模塊化與可擴展性。在開發複雜的 Agent 工作流時，Agent 需要訪問歷史任務結果以維持上下文，或存儲當前任務的結論供後續複用。如果僅依賴內存，進程重啓後數據即丟失；若引入數據庫，會增加系統的複雜度與依賴。

dsh-gitmemo 是一個爲 DSH 設計的插件，它將 Agent 的長期記憶存儲在一個本地的 .mem Git 倉庫中。通過 Git 倉庫管理記憶條目，既保證了數據的持久化與可審計性，又避免了引入額外的運行時依賴。

核心功能¶

該插件通過 Cordis 插件機制向 DSH 環境提供記憶管理能力。

• 記憶存儲：使用本地 .mem Git 倉庫進行長期記憶管理，所有操作均記錄在 Git 歷史中。
• 核心工具：提供五個核心工具方法：
  • mem_search：搜索記憶條目。
  • mem_read：讀取指定記憶條目。
  • mem_write：存儲新的任務結果。
  • mem_delete：移除過時的結論。
  • mem_replace：替換舊的結論（通過一次提交完成舊文件刪除與新文件添加）。
• 作用域限制：插件僅註冊到 root agent（即 delegationDepth === 0 的根代理），不會向子代理分發工具與規則，以保持工作流規則的整潔。
• 配置支持：支持通過 cordis.patch.yml 文件配置參數，例如設置搜索結果的數量上限。

安裝與啓用¶

在安裝前，請確保環境滿足以下依賴條件：
* DeepSeek Harness (dsh) 版本 >= 0.1.0-rc.6
* 系統已安裝 git CLI 工具

執行以下命令安裝插件：

dsh plugin --profile web add @fonlan/dsh-gitmemo

安裝完成後，必須重啓 dsh web 進程，插件纔會生效並註冊到對應的 profile 中。

配置¶

插件支持在 DSH 的配置文件中進行參數調整。默認配置通常已足夠使用，如需修改，請在 cordis.patch.yml 中添加或覆蓋配置項。

例如，調整單次搜索返回的最大條目數：

- id: dsh-gitmemo
  config:
    searchLimit: 20

適用場景與注意¶

• 適用場景：適合需要在 Agent 會話中持久化知識、記錄任務結論，並希望保持數據可追溯性的開發者。
• 注意：插件完全基於本地 Git 倉庫運行，不依賴雲端服務。由於插件運行在當前 DSH 進程的權限下，請確保對本地 .mem 目錄有讀寫權限。安裝前建議查閱源碼與許可證信息。

短結尾¶

dsh-gitmemo 通過將 Git 倉庫引入 DSH 的工作流，爲 Agent 提供了一種輕量、本地化且可審計的長期記憶方案。開發者無需手動執行記憶管理命令，插件將自動處理記憶的讀寫與更新。

查看插件目錄
查看 GitHub 倉庫