DeepSeek Harness (DSH) Agent 默認是無狀態的，這意味着每次會話都從零開始。在處理多輪對話或長任務時，Agent 無法直接引用之前的決策、偏好或事實。雖然社區已有 dsh-mnemon 等重型記憶方案，但對於已經部署了 Hindsight 的用戶，這層“全家桶”顯得有些累贅。
dsh-hindsight 是一個官方級插件，由 Ryu6Zero 維護。它將 DSH 直接橋接到 Hindsight REST API，爲 Agent 提供跨會話記憶能力。這是一個自包含的 Cordis 插件，不包含 dsh-mnemon 的編排層，也不捆綁存儲引擎，本質上是一個對接 Hindsight REST API 的獨立 HTTP Client。
安裝與前置要求¶
安裝前請確保環境滿足要求：Node.js 版本 >= 20，DeepSeek Harness 版本 >= 0.1.1-rc.2。
安裝到 Web profile（完整 UI）和 Headless profile（命令行任務）——兩者掛載同一套工具：
dsh plugin --profile web add dsh-hindsight
dsh plugin --profile headless add dsh-hindsight
安裝完成後，啓動相應的 profile 即可使用。
核心功能¶
/hindsight斜槓命令：提供狀態查詢、語義召回、知識圖譜遍歷、記憶列表、異步操作查看、記憶錄入與遺忘等能力。- 6 個模型工具：Agent 可以直接調用
hindsight_status、hindsight_recall、hindsight_related、hindsight_list、hindsight_remember、hindsight_forget。 - 知識圖譜遍歷：通過
hindsight_related從一條記憶出發，進行 BFS 遍歷 Hindsight 實體關係圖譜的鄰居（1-5 跳），追蹤關聯決策。 - 主動記憶引導：開啓
autoRemember後，模型會主動識別並保存可持久複用的事實（如偏好、決策、約束），並採取“不確定先問”的策略防止髒數據。 - 記憶引導注入：開啓
systemPromptSection後，模型會在首輪對話中獲取一段記憶引導的系統提示，明確知道何時該召回或保存。 - 異步操作可觀測：通過
/hindsight operations或工具查看記憶提取隊列狀態，解決“剛存完卻找不到”的困惑。 - 批量去重寫入：
hindsight_condense支持一次提交多條事實，自動跳過與近期記憶重複的內容。 - 召回緩存：相同查詢在 60 秒內會直接返回緩存結果，提升響應速度。
- 多庫只讀探索：支持通過
bank參數或@庫名前綴跨項目庫檢索（僅限讀取）。 - 熱配置：修改
endpoint、token、autoRemember等配置後即時生效，無需重啓。 - 部署診斷：當服務不可達時，
hindsight_status會返回具體診斷信息和 Docker 啓動引導。 - 獨立 Client：插件外可複用
HindsightClient進行零依賴 HTTP 交互。
配置¶
默認配置指向本地 Hindsight 服務。在 DSH 設置界面的 hindsight 命名空間中覆蓋默認值（不建議直接修改 bundle patch）：
| 字段 | 默認值 | 含義 |
|---|---|---|
endpoint |
http://localhost:8888 |
Hindsight 服務地址 |
token |
'' |
遠程服務的 Bearer Token；本地開放服務留空 |
bankId |
hermes |
記憶 bank id |
defaultRecallLimit |
10 |
每次召回上限 |
autoRemember |
true |
是否引導模型主動保存事實 |
systemPromptSection |
true |
是否向 system prompt 注入記憶引導段 |
recallCacheTtlMs |
60000 |
召回緩存 TTL（毫秒），0 表示關閉緩存 |
典型用法¶
以下是一些典型的命令示例：
/hindsight status # 查看記憶庫統計、連接狀態
/hindsight recall 記憶架構決策 # 語義召回相關記憶
/hindsight related <ID> [depth] # 查看知識圖譜鄰居
/hindsight list # 列出最近記憶
/hindsight operations [數量] # 查看異步操作隊列
/hindsight remember 記住X # 主動保存一條事實
/hindsight forget <ID> # 刪除某條記憶
在對話中，Agent 也可以直接通過模型工具“查一下記憶”或“記住這個”來自主完成上述操作。
適用場景與注意¶
- 適用場景：適合已經部署了 Hindsight 服務，希望爲 DSH Agent 添加長期記憶、知識圖譜檢索能力的開發者。
- 異步特性：Hindsight 通過自己的 LLM/consolidation 隊列異步提取記憶。剛執行
remember的事實，可能需要超過測試窗口才能在recall中出現，這是 Hindsight 自身的機制，並非插件故障。 - 範圍外功能：不包含 WebUI 工作臺、多 provider 編排、捆綁存儲、client/瀏覽器 bundle 以及提取/蒸餾子 Agent。
總結¶
dsh-hindsight 通過提供輕量級的 HTTP 客戶端和豐富的命令工具，讓 DSH Agent 能夠無縫對接 Hindsight 的向量記憶與知識圖譜能力。如果你需要爲 Agent 添加長期記憶且不想引入複雜的編排層，這是一個直接可用的選擇。
項目地址：https://github.com/Ryu6Zero/dsh-hindsight
