前言¶

在 DeepSeek Harness (DSH) 中，讓模型直接處理長期記憶、日誌記錄或數據庫權限會引入複雜性。dsh-hypatia 通過將 Hypatia 知識圖譜集成到 DSH 插件系統中來解決這個問題。它運行 Hypatia CLI 作爲主機進程，讓模型專注於記憶提案，而將數據庫編排、權限和重試處理交給插件本身。

插件定位¶

dsh-hypatia 是一個記憶類插件。由用戶 tkliuxing 維護。它爲 DSH 提供長期記憶，由 Hypatia 知識圖譜支持。插件在主機代碼中運行 Hypatia，模型僅負責提出值得記住的內容。

核心功能¶

該插件提供以下能力：

1. 同一請求內召回：在固定的時間和大小預算內，檢索並附加相關的項目記憶。
2. 精確項目範圍：記憶歸屬於單一項目，基於標準工作區路徑推導；跨項目泄漏由主機側賬本防止，而非依賴內容標籤。
3. 已驗證寫入：每次寫入都會被讀回並比較，僅在確認成功後才記爲已存儲。
4. 兩階段遺忘：刪除前顯示確切條目，誠實報告清理狀態。
5. 無需 Bash：記憶在只讀和寫入會話中工作，因爲插件從不要求模型執行 shell 命令。
6. 知識圖譜查詢技能：提供查詢知識圖譜的能力。
7. 自動對話記憶橋接：自動處理對話與記憶之間的橋接。

安裝與依賴¶

在安裝之前，請確保系統滿足以下條件：

• Hypatia CLI：必須在 PATH 中。插件依賴 hypatia 0.1.4 CLI 合約。
• Node.js：版本 22.5 或更高（控制賬本使用 node:sqlite）。

安裝命令如下：

dsh plugin --profile web add @tkliuxing/dsh-hypatia

配置說明¶

安裝後，配置通常在 cordis 行中進行。以下是關鍵配置項：

• memory.preset：記憶預設選項，包括 disabled、read-only-recall、standard（默認）和 full。
• memory.authorization：內存授權獨立於 DSH 文件沙箱。
• recall：控制召回行爲，包括啓用開關、截止時間、最大結果數等。
• ingest：控制摘要攝入。
• reconcile：控制調和操作。

使用示例¶

插件提供了以下工具供代理使用：

• 記憶存儲：
  • “remember: this project forbids eval”
• 記憶檢索：
  • “what do we know about the retry policy?”
• 記憶遺忘：
  • “forget what you know about the old API”（先預覽，再確認刪除）
• 狀態檢查：
  • “did that actually save?”
  • “settle whatever is still unverified”
• 知識圖譜管理：通過 hypatia 技能直接驅動 CLI 進行管理，需要 danger-full-access 權限。

限制與注意事項¶

• 單進程限制：同一時間只能有一個進程運行。併發調用會因文件鎖而失敗。
• 版本要求：必須使用兼容 0.1.4 合約的 Hypatia CLI。
• 許可證：MIT 許可證。

生態與資源¶

DeepSeek Harness 的插件生態強調“一切皆插件”。該插件遵循社區目錄規範，不隸屬於 DeepSeek 官方。

• GitHub 倉庫：https://github.com/tkliuxing/dsh-hypatia
• 社區目錄：https://www.skillhub.cn/plugins/tkliuxing/dsh-hypatia