前言¶

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 仓库