dsh-fount-memory

dsh-fount-memory

參考 Fount 角色的長短期記憶設計，為 DeepSeek Harness 提供持久記憶。已針對 DSH 0.1.7-rc.2 的插件與 format v4 訊息介面開發。

記憶在原本的對話中運作：模型請求前帶入符合條件的記憶，正常回覆完成後保存對話片段。插件不建立反思或 dream 輪次，不呼叫 agent.followup()、agent.steer()，也不在空閒時恢復會話。儲存與檢索都在本機進行，不額外呼叫模型。

長期記憶以名稱管理。再次使用相同名稱會更新現有內容，舊版與來源上下文留在修訂歷史；刪除時連歷史一起刪除。觸發條件支援任一關鍵詞、全部關鍵詞與指定月日。例如：

{
  "name": "使用者生日",
  "content": "使用者生日為 7 月 17 日。",
  "trigger": { "any": ["生日", "birthday"], "onDates": ["07-17"] }
}

短期記憶保存已完成對話的最近十則文字訊息，保留 user／assistant 身份、會話 ID、輪次與記錄時間。檢索結合詞彙、使用者最後一句話、明確提到的年份／月份，以及時間衰減；命中的片段會增加分數。預設取三條，並略過同一會話 20 分鐘內的片段，避免重複當前上下文。這些參數都可設定。單則訊息沒有字數截斷或背景刪除期限；自動帶入數量是提示選取量，不影響工具搜尋所有記錄。

提供四個模型工具：fount_memory_remember、fount_memory_search、fount_memory_context、fount_memory_forget。需要記下經確認的事實時用 remember；更正同一事項時沿用名稱；要查來源與舊版時用 context；使用者要求遺忘主題時先用 search 檢查範圍，再用 forget 的 kind: all 同時刪除命名記憶、歷史版本與包含該字串的對話片段。DSH 原始會話日誌仍由 DSH 自行管理。工具不替使用者猜測事實。短期片段只記錄已完成且有真人輸入與助手文字的輪次；中止、失敗、子代理輪次不自動封存。

安裝

在 DSH 主機環境安裝至所需 profile，例如 web：

dsh plugin --profile web add github:win10ogod/dsh-fount-memory
dsh --profile web --dump-config

dsh plugin 會安裝套件並把 bundle 加進 profile；--dump-config 應顯示 fount-memory 條目。重新啟動已在執行的 DSH 後使用。插件預設按工作區分開 SQLite 資料庫，位置為 $DSH_HOME/storages/fount-memory；DSH_HOME 未設定時使用使用者家目錄下的 .dsh/storages/fount-memory。

配置示例：

- id: fount-memory
  name: dsh-fount-memory
  config:
    namespace: default
    scope: workspace
    recallCount: 3
    relevanceThreshold: 5
    sameSessionCooldownMinutes: 20

scope: global 可讓同一個 namespace 跨工作區共用資料。dataDir 可指定資料庫目錄。停用插件不刪除資料庫；要刪除特定記憶，用 fount_memory_forget。

此實作參考了 理華角色包 的命名長期記憶、修訂追溯、短期片段與相關性回憶。Fount 的任意 JavaScript 觸發器在此改為結構化條件，以便在 DSH 插件中驗證與管理；這不是 Fount 原角色記憶資料的直接匯入。對話片段目前記錄文字內容，非文字附件仍留在 DSH 原始會話中。

執行 npm run check 會檢查語法並測試資料庫重啟、修訂刪除、時間線索與第二輪訊息來源。