在 DeepSeek Harness（DSH）的插件生态中，Agent 的记忆管理是核心痛点。上下文窗口有限，会话之间往往缺乏有效的状态持久化与检索机制。dsh-memory-manager 是一个面向 AI Agent 的统一记忆管理层插件，由 xiaoshi7915 维护。它旨在解决 Agent 在对话过程中信息丢失、无法跨会话检索以及长期记忆难以维护的问题。

核心功能

该插件提供了从短期缓存到长期沉淀的完整记忆管理能力。

  1. 记忆分层与存储
    - 短程滑动窗口记忆：限制每会话的消息条数或 Token 上限，超出部分自动截断或生成摘要。
    - 长程向量记忆：使用 SQLite 元数据配合自定义向量索引，支持本地存储。
    - 分层能力：支持 L0 原始对话、L1 原子记忆、L2 场景、L3 画像等多层级结构。

  2. 检索与摘要
    - 语义/混合检索：融合向量（余弦）与关键词（词项重叠），支持降级模式。
    - 智能摘要：支持本地抽取式摘要，可选 LLM 增强。

  3. 生命周期与安全
    - 生命周期管理：支持 TTL 过期、重要性评分、存储上限清理（LRU 策略）。
    - 安全存储：默认使用 AES-256-GCM 加密存储，支持 scrypt 派生密钥。

  4. 会话与共享
    - 多会话隔离：默认仅本会话可见。
    - 全局记忆共享：支持跨会话共享记忆，可整体开关。

  5. 其他能力
    - 可视化 Web 管理界面：支持记忆浏览、语义搜索、导入导出与设置。
    - 导入导出：支持 JSON 全量备份或 JSONL 仅记忆导出。
    - 三态嵌入源：支持关闭（纯关键词）、远程 API、本地 ONNX 推理三种模式。
    - 会话记忆档位：支持 auto/chat/work/off 档位配置。

安装与启用

安装前请确保环境满足要求：Node.js >= 22.5。

dsh plugin add xiaoshi7915/dsh-memory-manager

安装完成后，可通过以下方式访问或验证：

  • 访问 GUI：http://127.0.0.1:4599/
  • 健康检查：http://127.0.0.1:3080/api/memory/healthz（取决于 DSH 运行端口）

典型用法

独立演示模式：若不依赖 DSH 主程序，可直接运行该插件提供的服务：

# 安装依赖
npm install

# 启动演示服务器
npm run serve

启动后，打开浏览器访问 http://127.0.0.1:4599/ 即可使用 Web 管理界面。该界面支持记忆浏览、语义搜索、导入导出及配置修改。

配置与调试：
- 插件默认开箱即用，采用“哈希+关键词”降级模式。
- 数据默认存储在 ~/.dsh/memory-manager/，可通过环境变量 DSH_MEMORY_DIR 覆盖。
- 插件内置 8 个 Agent 工具（mm_*），可直接在 DSH 中调用。

注意事项

  1. 运行环境：需要 Node.js >= 22.5，利用了内置的 node:sqlite 与 crypto 模块。
  2. 数据安全：插件本地优先、零云依赖，数据存储在本地。
  3. 加载机制：更新插件代码后，必须重启 DSH 才能加载新代码。
  4. 默认行为：未配置真实嵌入模型时，默认使用哈希向量与关键词混合检索，阈值会自动适配。

总结

dsh-memory-manager 提供了一套从短期缓存到长期向量记忆、从语义检索到加密存储的完整解决方案。它通过可视化管理界面降低了 Agent 记忆管理的复杂度，适合需要长期记忆与跨会话检索能力的 DSH 用户。