這是雲端跨會話記憶插件 for DeepSeek Harness：結構化條目 + 向量檢索，持久化於 S3 兼容對象存儲（AWS S3 / MinIO / R2 / 阿里雲 OSS）。
前言¶
DSH 默認情況下記憶僅存儲在本地實例中。如果你更換部署環境或機器，這些記憶將無法保留。dsh-memory-s3 通過將記憶持久化到 S3 兼容的對象存儲，實現了跨設備、跨會話的記憶共享與續寫。
核心功能¶
- S3 兼容存儲後端：支持條目 CRUD、listObjects 同步、樂觀併發以及自定義 endpoint（兼容 MinIO / R2 / OSS）。
- 結構化記憶模型 v2.1：定義了 preference、project、decision、history、moment 五類條目，支持 importance/tags/source 等元數據。
- 向量語義檢索：提供可插拔的嵌入器支持，支持餘弦 top-k 檢索以及元數據/關鍵詞混合召回。
- 本地緩存投影：支持凍結快照、只讀本地緩存、S3 異步回源以及離線降級模式。
- 寫入審批門：所有寫操作強制通過 DSH 的 approval seam，模型不可見不可改。
- 審計三鏈：記錄審批對、審計賬本和快照，可從會話日誌重建全部寫入。
- 照片/文件附件：支持給條目掛載文件，二進制對象存儲於 S3 並進行本地校驗。
- 反鏈索引（v2.1）：自動回填本地反鏈索引，支持查詢「誰引用了該條目」。
- 分層快照注入：按 Bonds → Moments → Facts 的順序注入快照，支持關聯引用標記。
安裝與啓用¶
使用官方 CLI 進行安裝，將插件添加到 Web profile：
npx @deepseek-ai/dsh plugin --profile web add https://github.com/Re-s/dsh-memory-s3.git
工具列表¶
安裝後，DSH 將暴露以下工具用於記憶管理：
memory_s3_save：保存一條記憶（過審批門）。memory_s3_search：關鍵詞檢索。memory_s3_recall：語義召回。memory_s3_list：列表/過濾。memory_s3_backlinks：查詢反鏈（無審批，讀本地索引）。memory_s3_update：更新條目（過審批門）。memory_s3_delete：刪除條目（過審批門）。memory_s3_forget：抑制自動注入而不刪除。memory_s3_attach：掛載附件（過審批門）。memory_s3_get_file：下載附件到本地（無審批，校驗）。memory_s3_detach：移除附件（過審批門）。memory_s3_sync：手動同步 S3 增量。
權限與注意¶
- 無 GUI 表單入口：插件沒有可視化配置表單，需通過
settings.yaml手動配置。在插件的 Plugin list 中可見，但在 Plugin configuration 中不可見。 - 權限要求：插件運行需要以下權限：
harness:tool,filesystem:read,filesystem:write,network:https,subprocess:none,shell:none,python:none,credentials:env。 - 版本兼容性：兼容 DSH 0.1.0-rc.6 和 0.1.2-rc.1。
- 憑據管理：S3 憑據只從環境變量讀取（
AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY），絕不落盤。
生態鏈接¶
- GitHub: https://github.com/Re-s/dsh-memory-s3
- 目錄頁: https://www.skillhub.cn/plugins/Re-s/dsh-memory-s3
