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 或幻方官方無從屬關係，僅供開發者參考使用。