DeepSeek Harness 插件：dsh-vector-memory

前言¶

DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在开发智能体时，跨会话、跨重启的持久化记忆是常见需求。传统方案往往需要自建 Qdrant 等向量数据库并配置 BGE-m3 等嵌入模型，配置成本较高。dsh-vector-memory 插件将记忆核心直接内置于 DSH 生态，利用 DSH 自带的 storageDomain 提供零外部依赖的持久化存储。

插件定位¶

dsh-vector-memory 是由维护者 Bryan-cmf 提供的 DSH 插件，属于“记忆”类别。它提供一个可持久化的 Agent 记忆核心，提供 mem_save、mem_search 和 mem_health 三个核心工具，以及 vectorMemory 服务注入能力。

核心功能¶

该插件提供以下能力：

1. mem_save：保存记忆。接受参数 { content, tags?, ttlDays? }，返回持久化后的记忆 ID。
2. mem_search：检索记忆。接受参数 { query, limit? }，返回排名后的命中结果。
3. mem_health：健康检查。返回记录总数、过期记录数、域状态及 TTL 策略。
4. 服务注入：发布 vectorMemory 服务，供其他插件调用。
5. 记忆视图：客户端侧注册“記憶”视图标签（Tab 顺序 30，位于聊天/轨迹/观测右侧），实时展示当前会话的保存/检索项。

安装与启用¶

在 DSH 配置文件的 profile.bundles 中加入该插件即可。注意，此行配置会发布 vectorMemory 服务，它必须存在于宿主组合中（即进程级全局服务）。

"dsh": {
  "profile": {
    "bundles": ["@bryan-cmf/dsh-vector-memory"]
  }
}

使用方法¶

1. 插件调用：其他插件可以通过注入 vectorMemory 服务，直接调用 save、search 或 health 方法。
2. 界面展示：在客户端端侧，通过注册“記憶”视图标签（order 30），将记忆列表展示在聊天、轨迹或观测面板的右侧。

注意事项¶

1. 版本要求：DSH 版本需满足 >= 0.1.0-rc.6，且需要 tools 和 storageDomain 服务支持。
2. 合并通知：该套件已于 2026-08-17 被合并至 @bryan-cmf/dsh-insights。此 GitHub 仓库仅保留作为合并前的历史记录，后续迭代请关注 dsh-insights。
3. 服务生命周期：由于 vectorMemory 服务发布于宿主组合，它必须在进程启动时加载，而非挂载在特定 Agent 预设中（除非使用 isolate 域进行隔离）。

生态背景¶

本插件收录于社区目录，与 DeepSeek 或幻方官方无从属关系，仅供开发者参考使用。