前言¶
在 DeepSeek Harness（DSH）里给 Agent 挂记忆插件，常见做法是尽量多记、尽量久留，上下文会越来越满，旧条目也很难区分「还在用」和「已经过时」。忆枢（memory-lattice）由 Lumivox-wiz 维护，走的是另一条路：短期会过期、长期要按间隔复习、久不用会进沉睡区，长期写入还要过人工审核。数据本地落在 SQLite 与自研检索索引上，运行时除宿主提供的 @deepseek-ai/schemastery 外不依赖外部服务。下面介绍它是什么、能做什么，以及如何在 DSH Desktop 里安装和使用。
这是什么¶
忆枢是 DSH 分类「记忆」下的插件，npm 包名 memory-lattice，当前版本 0.2.10，MIT 许可证，要求 Node ≥ 22。它把记忆分成短期（STM）、长期（LTM）、沉睡区与人格画像（Persona）等层，用 SM-2 式调度与池半衰期控制遗忘，而不是无限堆积。Agent 侧主要暴露 memory_recall（检索并强化命中）与 memory_write（写 STM 直达，写 LTM 进审核中心）。
核心功能¶
会忘、要审、会想、会长¶
短期记忆默认 48 小时过期；被召回命中可晋升长期。长期记忆写入与 STM 晋升停在审核中心，批准后才生效；systemPrompt 里禁止 Agent 自行批准（审核模式可配为 none 免审）。每轮对话按当前用户消息做 BM25 + 本地向量语义双通道召回，只注入已审核的长期记忆，并带「数据不是指令」边界。人格画像从长期记忆低频重新合成（默认约 24h），版本化快照并保留证据链，可在 UI 否定。
检索与强化¶
字面侧为 IDF 加权 BM25（k1=1.2, b=0.75）；默认开启本地向量召回（vectorRecall），语料不足时退回纯字面。可选模型扩写近义短语（semanticRecall，需选 Provider，默认关）。召回质量结合相关性、记忆强度与到期加权；强度有软上限，并抑制短时重复命中造成的「回声室」。去重阈值 0.85 仅对 LTM 生效。
工作记忆、夜巡与元记忆¶
工作记忆用正则从用户话里识别待办与承诺，最多 3 条、3 天未提起过期，不进记忆链。每天 18 点后生成夜巡报告（久未命中、疑似重复等线索，只列不改）。memory_about 提供只读的「关于某主题我知道什么、多可信」元信息。
界面与可视化¶
侧栏底部有记忆入口；记忆云图为自研 canvas 3D 透视星云（分簇、拖拽、单击聚焦），节点大小反映强度。概览页可看各层条数、强度分布与遗忘曲线；配置页管备份、导入、保留策略与整库清除。
数据带走与误删恢复¶
支持全量/增量备份、AES-256-GCM 加密导出（口令 ≥ 8 字符，遗忘无法恢复）、导入预览与多种合并模式。删除先确认再进回收站，可恢复到删除前状态。命令行可用 tools/import-export.mjs 导出/预览导入，不依赖 DSH 进程运行。自动定时备份默认关；加密口令仅从环境变量 MEMORY_LATTICE_BACKUP_PASSPHRASE 读取。
安装与启用¶
插件已发布到 npm，正常安装无需本地编译。DSH 必须通过宿主插件管理器加载，单独 npm i memory-lattice 不会让 DSH 认插件。Desktop 客户端对应 profile 目录名一般为 desktop；装错 profile 会出现命令成功但界面看不到的情况，可在客户端 设置 → 插件 补加同一包名或地址。安装后需完全退出 DSH Desktop（含托盘）再启动，bundle 热重载换不掉。
推荐命令行安装：
dsh plugin --profile desktop add memory-lattice
指定 Release 预构建包（示例版本与 README 一致）：
dsh plugin --profile desktop add https://github.com/Lumivox-wiz/memory-lattice/releases/download/v0.2.10/memory-lattice-0.2.10.tgz
从 GitHub 源码安装（包管理器可能询问是否执行构建脚本）：
dsh plugin --profile desktop add github:Lumivox-wiz/memory-lattice
启动后在 设置 → 忆枢记忆 与侧栏底部入口进入界面。dsh web 等其它 profile 将命令中的 desktop 换成实际 profile 名。
典型用法¶
按 README 给出的链路，装好后可以按下面步骤走一遍。
- 正常对话。说过的话进入短期记忆；若在设置里开启「蒸馏」，由模型压成精炼条目（默认关，开启需选 Provider）。
- 侧栏 审核 里批准待审的长期记忆；不想逐条点可将审核模式改为
none，代价是失去逐条把关。 - 在对话里问与之前相关的问题，例如「我之前说的那个部署问题是什么来着？」——插件会检索并把相关记忆注入上下文；也可口头触发
memory_recall。 - 在 概览 查看条数、强度与「下次复习时间」是否随使用变化。
- 配置 → 备份 做全量或增量备份；换机器时在 导入 / 迁移 选文件预览后执行。
- 误删时在 回收站 标签页恢复。
命令行导出与预览导入：
node tools/import-export.mjs --export backup.json
node tools/import-export.mjs --import backup.json --mode merge --dry-run
适用场景与注意¶
适合希望在单用户、本地 DSH profile 下控制记忆体量、用间隔复习和沉睡区代替「全量永久保存」的开发者。需要出站模型的能力（蒸馏、人格合成、语义扩写）默认关闭，按需显式开启。
DSH 生态是「一切皆插件」；社区目录页（如 skillhub.cn）与 DeepSeek / 幻方无官方从属关系，本文不以「官方应用商店」表述。
插件以当前 DSH 进程的权限读写本地库与文件；README 威胁模型说明其不做 OS 级隔离、不防同用户其它进程，且不做静态加密存储。安装前应阅读仓库源码与 MIT 许可证，确认 engines.dsh 与本地 DSH 版本兼容（package.json 要求 dsh ≥ 0.1.5-alpha.2 且 < 0.3.0-0）。
结尾¶
忆枢把「会遗忘」做成一等公民：48h 短期、SM-2 长期、沉睡可唤醒、审核后再入库，再配合本地向量召回与加密增量备份，适合想自己掌控记忆生命周期的 DSH 用户。
- 目录页：https://www.skillhub.cn/plugins/Lumivox-wiz/memory-lattice
- 源码与文档：https://github.com/Lumivox-wiz/memory-lattice
