它是什么
dsh-mnemon 为 DSH host 提供一套默认三层的记忆系统：运行时上下文（偏好、工作约定、下一轮就要用到的事实）、可检索的文档（设计、调研、流程、交接），以及记忆空间——由 Provider 支撑的命名作用域，用来存放持久的事实、决策、实体与关系。三层都呈现在 DSH 侧边栏里，同一份数据也可以从对话工具和 headless profile 访问。
它的架构主张是「组合」：记忆 Source 喂给 Strategy，Core 校验 Strategy 的提案、向各 Source 索取有边界的投影，编译出一份不可变的 View，由 DSH Host 钉在执行中的那一轮上。View 既包含上下文，也包含模型下一步可用的、带作用域的路由与动作——README 明确说它不是另一个数据库，也不是前端页面。同一套公开契约同时服务内置插件与外部仓库，因此贡献者可以换掉其中一部分，而不必重建整个记忆系统。
Starter 装了什么
npm 包钉住了一组经过测试、各自独立版本化的包：3 个 Source、1 个默认 Strategy、3 个可选 Strategy 贡献与 9 个 Provider。
- Source ——
source-runtime（USER/MEMORY 投影、修订记录、本地热存储）、source-documents（Markdown、检索、修订与归档）、source-memory-spaces（持久证据，以及由 Source 持有的 Provider 子 Fiber）。三者默认启用。 - Strategy —— 默认选中
default-three-tier；auto-capture、light-context与scoped随包发布但默认关闭。README 说明这三者占据默认 Strategy 的不同槽位、可以共存、且仍然只产出一份 View——并且罕见地坦白了它们「不是」什么：捕获只是轮内引导，不是自动记录器；投影上限不是 token 记账或差量注入；作用域选择不会创建存储。 - 记忆空间的 Provider —— Mnemon Native（默认，本地）、OpenViking、Honcho、Mem0、Hindsight、Holographic、RetainDB、ByteRover、Supermemory。第三方服务在显式配置之前保持禁用；图、删除、精确写入与枚举能力因后端而异。
有一点必须先说清：Mnemon Native 需要单独安装的 mnemon CLI。 安装 npm Starter 既不会装这个二进制，也不会装任何第三方后端服务。
值得理解的行为
- 空闲自动检视使用有边界的 spawn 检查点、最少五分钟间隔、每个已加载会话 20 次尝试上限，且可独立关闭。已发布的 Agent Teams 工具冲突会在任何子 agent 启动前暂停检视；失败的运行保留已提交的收据元数据，永远不会被自动重放。
- 存储作用域——全局、工作区、集中式工作区、自定义——都是显式的。直接检索不会孵化 Mnemon 任务 agent；Agent Query、语义写入与维护可能使用你配置的模型。
- README 的「数据与信任」一节声明：运行时与文档留在本地，Native 默认本地；禁用参与不会抹除记忆，切换存储作用域不会迁移数据；已保存的 Provider 凭据留在 Host 上、不会进入 Mnemon Pack——但 Pack 仍含有私密记忆，需要保护。Source 与 Strategy 插件是受信任的进程内 JavaScript，不是沙箱代码。
运行要求
- Node 需
>=20，来自包的engines字段。（仓库自己的开发文档要求^22.19.0 || >=24.0.0与 pnpm 10.13.1——那是给改插件的人准备的，不是给装插件的人。） - Harness —— README 写明「当前开发基线是 DSH
0.1.5-rc.1（npmlatest）」。请按字面理解：这是作者开发与验证所依据的版本，不是兼容性声明——README 没有任何一节、清单也没有任何字段枚举过受支持的 harness 版本。两个 dsh peer 依赖区间（客户端 UI 与协议包的^0.1.0-rc.6 || ^0.1.1-rc.1 || ^0.1.2-alpha.1 || ^0.1.5-rc.1）暗示了更宽的意图，但 peer 区间不是测试矩阵。这个区别正是本条目 verification 为 L2 而非 L3 的原因。 - Web 客户端注入五个
@deepseek-ai/dsh-client-*包，并把react/react-dom^18.2.0声明为 peer 依赖（未标可选）。headless profile 有文档支持——dsh plugin --profile headless add dsh-mnemon——仓库里还有对应的verify:headless校验脚本。 - 十五个
dsh-mnemon-*包之外的运行依赖很小：fflate、schemastery、zod。 - 没有安装期生命周期脚本。 唯一的发布钩子
prepublishOnly在作者发版时运行，而不是在你安装时运行。 - 遥测与权限模型未见文档。数据与信任一节覆盖了数据位置，但对遥测只字未提——请按「未说明」理解，而不是按「安全」理解。
- 来自旧版 DSH、source summary 需要 notice 形态的存量会话，需要先用随包的
dsh-mnemon-repair-session做拷贝修复；README 提醒在替换任何产物之前先读它的恢复指南。
已知限制
- 它是基础设施，不是自动记忆管家：除了有边界的空闲检视之外，没有任何东西会自行捕获、裁剪或压缩；三个 Strategy 贡献按 README 自己的措辞也只是引导机制。
- 长期召回质量取决于你配置的 Provider；没有选定 Provider 时，记忆空间没有后端。各后端的图、删除、精确写入、枚举能力并不一致。
- 作者明确声明：机制测试不构成对 LLM 准确性或云端 Provider 实际一致性的承诺。
- 禁用某个 Provider 可能清空本地目录元数据；远端数据是 Provider 的事，不是插件的事。
- 模型生成的插件不会被自动安装，Mnemon 也不扫描任意已安装插件——扩展是显式的。这对信任是好事，但也意味着第三方记忆插件没有自动发现。
什么时候用它、什么时候不要用
当你想要一套可以拆开看的记忆系统时用它：今天有三个合理的默认值，明天有文档化的契约可以换掉某个 Source、Strategy 或 Provider，侧边栏 UI 与 headless 路径兼备。本地优先的默认后端在你显式接入第三方之前，把一切都留在本机。
不要指望长期记忆零配置——默认的 Native 后端仍需要外部 mnemon CLI，第三方 Provider 各自需要账号、凭据与配置。另外，如果你运行的是比 0.1.5-rc.1 更新的 harness 版本、并且需要作者验证过这个组合，要清楚目前并不存在这样的声明。
安装
dsh plugin --profile web add dsh-mnemonheadless 主机用 README 的变体：dsh plugin --profile headless add dsh-mnemon。装完后打开侧边栏的 Memory System → Status，添加一条运行时记忆，并在显式选定 Provider 后创建记忆空间。打算用默认 Native 后端的话，先跑 mnemon --version 确认 CLI 就位——插件不会自带这个二进制。