前言¶
在 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
