前言¶
DeepSeek Harness（DSH）裏換工作區或新開一輪會話後，模型默認只能依賴當前上下文。偏好、項目進度、技術棧約定和上一段對話裏的結論，往往要用戶重複說明，或靠手工粘貼筆記。社區裏也有讓主模型每 N 輪停下來寫「記憶卡」的做法，會打斷主對話、重複消耗 Token，還容易把最近幾句流水賬當成「記憶」。
下面介紹 dsh-supermemory（維護者 fish9988，分類：記憶）。它是 DSH 的跨會話長期記憶插件，底層由 Supermemory 提供存儲與檢索；實現爲純 JavaScript，無額外子進程依賴，並自帶可視化記憶庫管理頁。DSH 生態主張「一切皆插件」；插件目錄站點 skillhub.cn 爲社區獨立收錄，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
dsh-supermemory 在 DSH 中爲各模型提供跨會話、跨工作區的長期記憶：按需語義召回、後臺自動從對話中提煉事實、寫入前雙層去重，以及左側欄內的配置與瀏覽界面。使用前需配置 Supermemory API Key（Supermemory 免費賬戶每月提供 5 美元 API 額度，按月重置；README 中說明日常高強度使用一個月量級消耗約 1 美元，具體以官方計費爲準）。
當前 package 版本爲 0.1.4，許可證 MIT。
核心功能¶
按需語義召回¶
在 agent/pre-step 階段，用本輪用戶提問做向量語義檢索，並與歷史對話切片混合檢索。README 說明僅對主 Agent 生效，子代理（Subagent）不召回、不寫入，避免污染主會話記憶。
爲省 Token 並儘量保持 KV Cache，插件會過濾「好的 / 繼續 / 謝謝 / 你好」等短寒暄，不對無意義短句發起檢索；用戶畫像中的永久核心條目（static）在每個會話首輪召回時注入一次，同會話內已注入條目會去重。
後臺自動蒸餾¶
用戶停止對話 90 秒（可調）後，後臺用配置的模型從增量對話中提煉 add / update / delete 類事實，無需主模型每輪手工整理。若退出前未完成整理，下次啓動會補齊。這與 README 中「Mem0 式」無感整理描述一致。
雙層去重¶
寫入前先進行中文字符二元組（Bigram）比對，再按 Supermemory 向量相似度比對（閾值 0.83）。同一事實換說法儘量不重複入庫；新說法更具體時（例如截止日期變更）可原地更新舊記憶。
中文與時間檢索¶
自動爲條目附加中英雙語釋義（| EN: …，展示時剝離）；帶「最近 / 上週」等時間詞的查詢會走「原句 + 剝離時間詞」雙路並行檢索併合並，緩解純 CJK 檢索與時間詞導致結果被空濾的問題。
可視化記憶管理頁¶
集成在 DSH 左側欄 「插件 → Supermemory 長期記憶」：在線保存 API Key（寫入 DSH 憑據庫）、瀏覽 / 搜索 / 增刪改記憶、查看用戶畫像、「試一試」預覽召回、查看最近活動與耗時。
模型工具與自然語言控制¶
配置完成後，日常以自動召回與後臺整理爲主。模型還可通過三個工具主動操作：
memory_save：例如要求記住截止日期或技術棧偏好；memory_search：針對歷史事實做精確檢索；memory_forget：查 ID 後軟刪除指定記憶。
召回結果在軌跡（Trajectory）中以摺疊塊形式展示，例如 Supermemory：召回畫像 X 條、記憶 Y 條，不擠佔主聊天區排版。
安裝與啓用¶
安裝前建議閱讀 GitHub 倉庫 源碼與 LICENSE。插件以當前 DSH 進程權限運行，API Key 與對話片段會發往 Supermemory 雲服務，請自行評估隱私與合規需求。
圖形界面（推薦）¶
- 打開 DSH 左側欄 「插件 (Plugins)」 → 右上角 「添加插件 (Add plugin)」。
- 在輸入框粘貼以下任一地址並安裝：
github:fish9988/dsh-supermemory
或 Release 壓縮包：
https://github.com/fish9988/dsh-supermemory/releases/download/v0.1.4/dsh-supermemory-0.1.4.tgz
命令行¶
桌面端（desktop profile）：
dsh plugin --profile desktop add github:fish9988/dsh-supermemory
網頁端（web profile）：
dsh plugin --profile web add github:fish9988/dsh-supermemory
API Key¶
- 在 Supermemory 控制台 註冊並創建 API Key（格式以
sm_開頭）。 - 在 DSH 「插件 → Supermemory 長期記憶」 頂部粘貼 Key，點擊 「保存 Key」。
- 狀態欄顯示已連接即表示驗證通過。Key 保存在 DSH 憑據服務（
SUPERMEMORY_API_KEY），README 說明不會寫入普通配置文件或日誌。
典型用法與設置要點¶
配置 Key 後，發送有實質內容的新消息時會按設置自動召回；停止對話滿靜默間隔後會自動整理。若需省 Supermemory 額度，可在設置中關閉 「保存對話原文」（captureConversations），僅保留提煉後的單句記憶與畫像；README 稱此舉可顯著降低以 superrag 切片上傳爲主的消耗。
常用配置項（默認值見 README 表格）包括：
| 方向 | 配置項 | 說明摘要 |
|---|---|---|
| 召回 | autoRecall |
有意義新消息時自動檢索並注入 |
| 召回 | recallProfile / recallChunks |
是否附帶靜態畫像、歷史會話片段 |
| 召回 | recallLimit / recallThreshold |
默認 6 條 / 60% 相關度門檻 |
| 整理 | captureConversations |
輪次結束後防抖上傳對話片段 |
| 整理 | modelExtraction |
靜默後用模型提煉事實 |
| 整理 | extractProvider / extractModel |
指定後臺提煉模型 |
| 範圍 | scope |
global 或按工作區 workspace |
| 隱私 | excludeWorkspaces |
匹配路徑的工作區不召回、不上傳、不整理 |
上傳、提取、工具保存及注入上下文前，README 說明會對 sk-、sm_、ghp_ 等敏感模式做脫敏；召回內容包在 <supermemory> 參考塊內並做注入邊界防護。網絡或額度異常時採用 fail-open，主對話仍可繼續。
適用場景與注意¶
適合需要 跨會話記住偏好與項目事實、又不想每輪手工維護記憶卡的 DSH 用戶。依賴 Supermemory 在線服務，需自行保管 API Key 並關注額度與數據出境策略。
不適合希望在完全離線、零第三方雲存儲下運行的場景；也不應在未審閱源碼的情況下 blindly 安裝到處理高度敏感代碼或憑據的環境。
鏈接¶
- 社區目錄頁：https://www.skillhub.cn/plugins/fish9988/dsh-supermemory
- 源碼與完整說明：https://github.com/fish9988/dsh-supermemory
