前言¶
在 DeepSeek Harness (DSH) 的智能体开发中，如何持久化状态、在会话间保持上下文一致性，以及如何安全地管理敏感信息，是开发者经常需要面对的问题。传统的方案往往缺乏统一的存储域管理和细粒度的作用域控制。
dsh-hermes-memory 旨在为 DSH 提供一套原生的、持久化的内存解决方案。它不依赖外部复杂的向量库，而是利用 DSH 自身的存储域和会话查询服务，提供一套从写入、检索到清理的完整工具链。
插件简介¶
dsh-hermes-memory 是一个由 lcthe 维护的 DSH 插件，属于「记忆」类别。
它专注于解决智能体在长期运行中的记忆管理问题。其核心价值在于提供一种安全的、基于作用域的持久化存储机制，支持在会话开始时自动注入上下文，并具备完善的幂等性和安全性扫描能力。
核心能力¶
该插件提供了一组明确的工具和配置项，用于管理不同维度的记忆。
基础记忆操作¶
插件提供了一组基础工具，用于对记忆进行增删改查。
memory_save：保存记忆条目。memory_search：检索记忆条目。memory_replace：替换现有记忆。memory_remove：移除记忆条目。
这些操作覆盖了从全局到项目级的多种作用域。
作用域与持久化¶
支持细粒度的作用域划分，确保记忆的隔离性。
- 作用域类型：支持 Global（全局）、User（用户）、Project（项目）和 Failure（失败）记忆。
- 存储机制：利用 DSH 的
storage-domain进行持久化，并内置 Schema 验证，保证数据结构的一致性。 - 会话注入 (V3 Scope)：支持可选的 V3 会话启动注入。每次新会话开始时，系统会注入一条有界的引用上下文消息，帮助智能体快速进入状态。
安全与清理¶
安全性是记忆插件的重要考量。
- 安全扫描：在写入前进行 Secret（密钥）和 Prompt Injection（提示注入）扫描，防止敏感信息泄露或恶意注入。
- 过期清理：支持基于
lastReferencedAt或updatedAt的过期清理策略。失败记忆有独立的保留天数，其他记忆有通用的保留天数。 - 幂等性：通过来源证明和内容去重机制，确保多次相同操作不会产生重复记录。
管理与监控工具¶
除了基础的增删改查，还提供了管理工具用于查看系统状态。
memory_list：列出当前作用域、分类和工作区下的有界记录。memory_stats：报告各作用域下的记录数量和字符使用量。memory_pin/memory_pins/memory_unpin：用于管理“Standing Context”（常驻上下文），即固定不变的参考信息。
自动捕获与来源¶
插件具备从实际交互中自动捕获规则的能力。
- 事件捕获：基于
user/message事件进行规则捕获，例如记录项目规范、用户偏好或修正记录。 - 来源追踪：捕获的记录带有
source: 'session'的证明来源，包含 Session ID 和事件序列号。
安装与依赖¶
插件以 npm 包形式存在，目前版本为 0.3.0。
由于未提供明确的 install_command，通常需要通过 DSH 的插件管理机制或直接安装 npm 包来集成。安装前需确保满足以下 Peer Dependencies（对等依赖）：
{
"@deepseek-ai/cordis": "~4.0.4",
"@deepseek-ai/dsh-agent": ">=0.2.0-rc.1 <0.3.0",
"@deepseek-ai/dsh-client-locale": ">=0.2.0-rc.1 <0.3.0",
"@deepseek-ai/dsh-client-ui-renderer": ">=0.2.0-rc.1 <0.3.0",
"@deepseek-ai/dsh-client-ui-settings": ">=0.2.0-rc.1 <0.3.0",
"@deepseek-ai/dsh-client-ui-slots": ">=0.2.0-rc.1 <0.3.0",
"@deepseek-ai/dsh-llm": ">=0.2.0-rc.1 <0.3.0",
"@deepseek-ai/dsh-session": ">=0.2.0-rc.1 <0.3.0",
"@deepseek-ai/dsh-session-query": ">=0.2.0-rc.1 <0.3.0",
"@deepseek-ai/dsh-settings": ">=0.2.0-rc.1 <0.3.0"
}
适用场景与边界¶
适用场景：
* 需要在不同会话间保持上下文的智能体开发。
* 需要对记忆数据进行分类管理（如按项目、按用户）。
* 需要自动记录用户偏好或项目修正的场景。
注意与边界：
* 无 UI：目前没有计划开发独立的记忆管理 UI，所有操作通过 CLI 工具或编程接口完成。
* 不替代 UI：该插件不会替换 DSH 的聊天 UI 或会话 Shell。
* 功能延迟：向量检索、自定义会话数据库访问等功能目前处于 Deferred 状态，暂未实现。
* 资产版权：插件不复制 Pi 的运行时代码、命令、TUI、品牌或视觉资产，仅复用通用的工程化设计思想。
总结¶
dsh-hermes-memory 为 DSH 插件生态提供了一套扎实的基础设施，通过原生的存储域和会话查询服务，解决了智能体记忆持久化与安全检索的核心痛点。对于需要构建长期记忆能力的开发者来说，这是一个值得关注的工具。
