前言¶
在 DSH 裏做多 Session 協作時，常見問題是上下文只活在當前對話裏：研究 Session 裏整理過的結論，規劃 Session 打不開；關掉窗口後，模型也記不住你刻意留下的項目事實。單靠宿主自帶的短期上下文窗口，很難做跨 Session 檢索，更談不上「誰可以從誰那裏讀記憶、撤權之後還能保留什麼」這類細粒度控制。
Amadeus Memory 是社區維護的記憶類 DSH 插件，在 Mneme 能力之上提供持久化記憶、知識圖譜，以及帶方向的 Session 共享（Learn / Borrow）。下面介紹它的定位、能力與安裝要點。
這是什麼¶
- 插件名稱：Amadeus Memory（npm 包
@fg-lab/amadeus-memory，當前發行版 1.3.0） - 維護者：jeskoky-pixel
- 分類：記憶
- 內部插件 ID：
dsh-mneme（與上游 Mneme 同源演進；不要與原版 Mneme 同時加載） - 許可：MIT
- 運行時基線（文檔記載）：官方 DSH Desktop 0.2.1-rc.3 上做過隔離測試；更廣環境需自行驗證
一句話：長期記憶 + 知識圖譜 + 定向 Session 授權，數據默認落在 Profile 外配置的 memoryDir（包元數據中的默認數據路徑爲 ~/.dsh/memory）。插件基於 Mneme，鞏固與檢索等核心能力見上游歸屬說明，不當作 Amadeus 全新發明。
目錄頁：SkillHub - amadeus-memory
源碼與說明：GitHub - jeskoky-pixel/amadeus-memory
核心功能¶
記憶層次與檢索¶
- Hot Memory：默認開啓，保留近期對話上下文。
- Recent Activity / Core Memory：默認關閉，可按需開啓跨 Session 活動與人工 curated 的核心事實；Core Memory 寫入需配置
coreMemoryEnabled。 - 長期事實：支持 BM25、向量或混合檢索；向量檢索需配置 embedding 提供方。
- Mneme 側能力：自動摘要（autoSummarize）、Dream 鞏固（autoDream），可選 Sleep 處理；均依賴已配置的模型服務，不承諾離線完成。
知識圖譜與實體¶
可瀏覽共享知識圖譜、實體與別名，調整 Tag/Entity 重要性。Session 授權仍決定哪些源材料可被讀取。
Workspace 與 Session ACL¶
綁定一個 Workspace。在統一 ACL 模式下 Session 默認私有；可在 Amadeus 第五頁授予定向 Learn 或 Borrow：
- Learn：授權後產生的衍生知識在撤銷源 Session 訪問權後仍可保留；不意味着可隨意再分享。
- Borrow：持續依賴源訪問權；源權限撤銷則 Borrow 失效。
文檔示例：規劃 Session 從研究 Session Learn 選定項目上下文後撤銷源訪問——已 Learn 的授權事實可保留，未 Learn 的源內容不可再讀；若必須持續依賴原授權，選 Borrow。
Hot Memory 默認開；Recent Activity、Core Memory 及 Memory 可選 persona 默認關；Sleep 可選。使用 QQ 相關能力前須確認統一 ACL Workspace 與授權；普通 DSH Session 可不依賴 QQ。QQ 身份僅通過其可信 Host 合約接受。
模型工具（默認註冊 13 個）¶
會話中模型可調用如下工具（完整列表 16 個，部分需開關）：
| 工具 | 功能 |
|---|---|
memory_save |
寫入記憶 |
memory_search |
檢索記憶 |
memory_list |
列出記憶 |
memory_get |
讀取記憶正文 |
memory_preference_get |
查看偏好權重 |
memory_identity_lookup |
查詢身份與別名 |
memory_update |
更新記憶 |
memory_delete |
刪除記憶 |
memory_forget |
抑制記憶注入 |
memory_archive |
歸檔與恢復 |
memory_core_save |
核心記憶寫入；需 coreMemoryEnabled |
set_scope_state |
設置可逆作用域閘門 |
memory_register_document |
登記文檔指針 |
memory_organize |
主動整理；需 organizeEnabled |
memory_runtime |
查看本地運行時 |
memory_recent_activity |
查詢近期活動；需 recentActivityEnabled |
安裝與啓用¶
安裝使用官方 DSH 插件管理器加載預構建包，無需本地源碼構建；不要手抄配置進已在運行的 Profile。詳細步驟見倉庫 docs/INSTALL_V1_2.md。
首次安裝¶
- 在 DSH Desktop 打開目標 Profile 的插件管理器，選擇安裝本地預構建包；發行獲准後也可使用對應 Market / GitHub 條目。
- 選擇
fg-lab-amadeus-memory-1.3.0.tgz，或安裝@fg-lab/amadeus-memory@1.3.0；確認已安裝列表顯示新包名並打開設置頁。根目錄安裝不再需要#path:/dsh-mneme後綴。 - 在設置中核對
memoryDir與目標 Workspace；同一 Profile 只能啓用一個dsh-mneme。舊根目錄memory.db不會自動遷移收養。 - 按宿主提示重載或重啓，在設置頁檢查健康狀態。安裝失敗時不要改數據目錄；保留錯誤信息與安裝包，並恢復備份的 Profile。
發行說明：1.3.0 已發佈於 GitHub Release 與 npm；建議安裝固定版本並覈對發行 checksum。文檔註明本地預構建包已通過隔離官方 dsh plugin 安裝驗證；公開 Market 下載源與生產 QQ/NapCat 等場景以發行報告爲準。
升級、禁用與數據¶
升級前備份 DSH Profile，停止寫入，並備份 memoryDir 下 Workspace 數據庫、向量、圖譜、授權與備份。從 @amadeus/memory 或 @modusensus/dsh-mneme 切換時，須先停用並移除舊 Bundle，不可同時啓用兩個 dsh-mneme。僅回滾代碼無法逆轉數據庫遷移，需配合升級前備份。禁用停功能；卸載默認只移除代碼，用戶數據在安裝包之外。
典型用法¶
- 安裝並完成 Workspace、
memoryDir與健康檢查。 - 在 Amadeus 設置頁配置 Session ACL：對需要共享上下文的 Session 授予 Learn 或 Borrow。
- 在對話中通過
memory_save/memory_search等工具寫入與檢索；需要語義檢索時配置 embedding；需要核心事實流水線時開啓coreMemoryEnabled等開關（見 REFERENCE.md）。 - 跨 Session 協作時，按 Learn/Borrow 語義決定撤權後是否保留衍生知識；用圖譜與 provenance 預覽檢查來源。
適用場景與注意¶
適合：需要在 DSH 內做跨 Session 記憶、圖譜瀏覽、定向共享與檢索（BM25 / 向量 / 混合）的開發者或高級用戶；與 Amadeus 生態 其他組件配合時，統一 ACL 與 Workspace 綁定是前提。
務必知曉：
- 插件以當前 DSH 進程權限運行；安裝前應閱讀源碼與 MIT 許可證，並理解數據落盤位置。
autoDream、autoSummarize與默認 embedding 可能調用遠端模型服務；僅當顯式選擇本地 embedding 並安裝本地運行時，語義向量纔在本機計算。文檔承諾：不向 Amadeus 自有服務器傳送記憶正文；包內不含用戶庫、QQ Token 或模型密鑰。- SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；星標與市場條目以各站點實時數據爲準。
結尾¶
Amadeus Memory 把 Mneme 式長期記憶、檢索與鞏固接到 DSH 插件體系裏，並用 Learn/Borrow 把「跨 Session 共享」做成可撤銷、可審計的授權模型。若你要在 Harness 裏穩定沉澱事實而不是每次重講一遍，可以從固定版本 @fg-lab/amadeus-memory@1.3.0 安裝，並在升級前按文檔做 Profile 與 memoryDir 備份。
- 目錄頁：https://www.skillhub.cn/plugins/jeskoky-pixel/amadeus-memory
- GitHub：https://github.com/jeskoky-pixel/amadeus-memory
