前言¶
DeepSeek Harness（DSH）的插件生态允许开发者扩展其功能。dsh-git-memory 旨在解决智能体开发中长期上下文难以管理的问题。它利用 Git 的特性，提供一种受控、可审查且可回滚的长期记忆存储方式。
插件概述¶
这是一个基于 Git 的记忆管理插件，由开发者 starfishwrx 维护，采用 MIT 许可证。
核心功能¶
该插件当前处于兼容性测试/预-alpha 阶段，主要包含以下已核实功能：
- 可安装 Bundle：提供包含
dsh.bundle清单的安装包。 - 动态上下文注册：通过
ctx.systemPrompt.context()注册稳定的动态上下文。 - 元数据观察：仅对会话或事件进行元数据级别的观察，不保留原始对话内容。
- 人类命令：提供直接命令
/memory status。 - 模型工具：提供只读模型工具
memory_status。
安装与启用¶
在安装前，请确保环境满足以下依赖要求：
- Node.js 24 或更新版本
- pnpm 11
- DeepSeek Harness
0.1.0-rc.6
安装步骤：
- 克隆仓库：
git clone https://github.com/starfishwrx/dsh-git-memory.git
cd dsh-git-memory
- 安装依赖并验证构建：
pnpm install
pnpm verify
- 将插件添加到 Web profile：
dsh plugin --profile web add .
- 导出配置（确认插件已加载）：
dsh --profile web --dump-config
使用方式¶
插件安装后，可以通过以下方式使用：
- 通过人类命令查看状态：
启动 Web profile，然后输入：
/memory status
- 通过模型工具：
模型可以直接调用只读工具memory_status。
安全与限制¶
由于当前版本为兼容性测试，存在以下限制和安全机制：
- 未存储记忆：当前发布证明 DSH 集成接口是可行的，但故意不存储用户记忆。
- 无持久化与写入：不进行对话记录持久化，不执行后台模型调用，不进行记忆写入。
- 存储路径：托管仓库位于
$DSH_HOME/git-memory，不会出现在用户的源代码仓库中。 - 文件系统限制：记忆工具不接受任意的文件系统目的地。
- 敏感数据拒绝：凭据、私钥、Cookie 和 Token 等敏感值会被硬性拒绝。
- Git 操作限制：Git 远程、推送以及托管仓库之外的写入操作默认禁用。
- 源代码状态：该包尚未发布到 npm。
结语¶
dsh-git-memory 提供了一种将 Git 的版本控制能力引入 DeepSeek Harness 长期上下文管理的思路。尽管目前处于测试阶段，且不包含实际的数据存储功能，但其设计原则（如受控记忆事务、本地化存储、审计能力）为构建安全的智能体记忆系统提供了基础。
