配置 Mnemon 0.5.21 三层记忆并升级到 DSH 0.2

<!-- BEGIN REVIEWED GUIDE SUPPLEMENT -->

2026-10-02 更新到 Mnemon 0.5.21，适配 DSH 0.2.0-rc.2

本页安装目标更新为 [email protected]，命令固定使用 DSH 0.2.0-rc.2。新版本声明兼容 0.2.0-rc.2；本站只做了固定版本的源码与发布包静态复核，没有安装或运行。

• 后台空闲审查默认开启：会话达到审查条件并连续空闲 30 秒后（两次至少间隔 5 分钟），子 Agent 会把不超过 24000 字符的检查点交给 DSH 已配置的模型，并自动新建项目档案或修改 USER.md、MEMORY.md（config.ts、configuration.md：idleReview.enabled 与 runtimeMemory 默认 true）。
• 插件页可以按包名安装组件：名称只要符合“可选任意 npm 作用域 + dsh-mnemon-source-* 或 dsh-mnemon-strategy-*”即可，Host 从 registry 读取 latest（预发布通道读对应 tag），只校验 bundle patch 路径和 dsh-mnemon peer，不校验发布者，随后调用 DSH CLI 写入 Profile（plugin-installation.ts；需本地或 trusted-host 管理权限）。
• 从 DSH 0.1.x 升级时，旧版 Mnemon 写入的会话可能被新版 DSH 拒绝加载，需要对备份副本运行 dsh-mnemon-repair-session（operations.md、open issue #251）；回退 DSH 时不要让旧版本打开已迁移的会话。

仍在使用 DSH 0.1.x： 本站此前记录的组合是 dsh-mnemon 0.5.5 + DSH 0.1.2-rc.1（提交 f3a7c601f2db）。0.5.21 只支持 DSH 0.1.7-rc.2 与 0.2.x，仍停留在 DSH 0.1.2-rc.1 的用户请继续使用 0.5.5，不要安装 0.5.21。准备升级时，先停止 DSH 并备份 ~/.mnemon、Profile 与完整会话目录，再按本页的 DSH 0.2.0-rc.2 命令安装 [email protected]。如果先升级了 DSH，旧版插件会被启动预检停用，记忆数据不受影响，装上新版即可恢复。旧会话打不开时，用 dsh-mnemon-repair-session 只修复备份副本。作者另说明 0.5.16 是最后一个在 DSH 0.1.5-rc.1 至 0.1.7-alpha.1 上验证的版本，该版本未经本站审核。

依据：固定证据 1 ↗（外部链接，在新标签页打开）、固定证据 2 ↗（外部链接，在新标签页打开）、固定证据 3 ↗（外部链接，在新标签页打开）、固定证据 4 ↗（外部链接，在新标签页打开）。

<!-- END REVIEWED GUIDE SUPPLEMENT -->

Mnemon 0.5.21 为 DSH 提供运行时记忆、项目档案与记忆空间三层持久记忆；Starter 锁定 17 个组件包，修复大型 Native 空间读取，并让空闲审查每轮只写一层。

如果你的目标是为 DeepSeek Harness 配置本地优先长期记忆、项目档案与记忆空间，并从 DSH 0.1.x 安全升级，本教程会说明如何在 DeepSeek Harness（DSH）中准备、安装、配置、验证和回退 dsh-mnemon。本文锁定作者仓库提交 06182f4d828e；已复核固定提交的原始资料，未进行运行实测。

对应插件：查看 dsh-mnemon 的功能、权限与兼容性说明。先确认它适合你的工作流，再执行安装。

Mnemon 0.5.21 为 DeepSeek Harness（DSH）提供三层持久记忆：每轮直接进入提示的运行时记忆、可检索的项目档案，以及可按需召回的记忆空间。它是本站首个对应 DSH 0.2.0-rc.2 的固定版本，主包锁定 17 个组件包。先备份记忆、Profile 和会话，再带版本号安装。

先确认是否适合你

• 分类：知识与记忆
• 风险等级：high
• 核验证据：source_reviewed
• 兼容性边界：主包的 3 个 @deepseek-ai/dsh-* peer 与记忆空间 Source 的 dsh-client-ui-primitives peer 均为 ^0.1.7-rc.2 || ^0.2.0-rc.1，按 semver 7 includePrerelease 计算满足 0.2.0-rc.2；作者称已在 0.2.0-rc.2 与 0.1.7-rc.2 上验收，52DSH 未运行验证。DSH 0.1.2-rc.1 不满足，0.1.x 用户至少需要 0.1.7-rc.2。
• 主要权限关注：读取会话与项目文档，写入 ~/.mnemon（或所选范围）下的运行时记忆、项目档案与 Native 数据库；默认开启的空闲审查会由子 Agent 自动写入；可运行 Mnemon CLI，经 DSH CLI 安装 dsh-mnemon-source/strategy-* 包，经 pnpm、npm、Homebrew 或 go 更新插件与 CLI，并导入 ZIP；启用第三方 Provider 时查询与记忆内容会发往其服务。

如果你准备在重要工作区使用，先阅读插件详情页的权限和数据流说明；“源码已审阅”或“资料已整理”都不等于安全认证。

安装前准备

本页 DSH 命令版本： 0.2.0-rc.2。0.5.21 声明的 DSH 版本范围包含 0.2.0-rc.2，本页固定 DSH 0.2.0-rc.2。仅静态复核，未在本站运行验证。

• 记忆与会话备份：升级前停止 DSH，备份 ~/.mnemon（或 MNEMON_DATA_DIR、自定义数据目录）、web Profile 与完整会话目录；插件页 ZIP 不包含第三方连接和 DSH 会话。
• Node.js 与 pnpm：作者要求完整 Profile 使用 Node ^22.19.0 或 >=24.0.0；DSH 插件页安装需要 PATH 中能找到 pnpm。
• Provider 选择：默认记忆空间使用 Mnemon Native，需要另装 Mnemon CLI；第三方 Provider 会把查询和记忆发到其服务，启用前确认数据可以离开本机。

1. 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本，并确认 pnpm 可用。
2. 使用独立的 web Profile 和可丢弃测试工作区，不直接连接生产目录。
3. 备份当前 Profile 配置，并记录安装前的 --dump-config 输出。
4. 核对固定来源中的外部服务、账号、运行时和平台限制。
5. 需要凭据时只准备测试凭据；本页识别到的候选变量包括 MNEMON_CLI_PATH、MNEMON_DATA_DIR。

安装 dsh-mnemon

52DSH 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支：

npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]

GitHub 源码插件如果被 pnpm 拦截构建脚本，先检查终端提示的具体包和脚本。只在 web Profile 中放行确实需要的构建项，不要全局放行未知依赖。

插件专属配置

配置目标

• $DSH_HOME/profiles/web/cordis.patch.yml（mnemon 条目）：保存 storageScope、idleReview、remoteAccess 等设置；Profile patch 会整体替换该行 config，手改时保留全部现有键。
• ~/.mnemon（或 MNEMON_DATA_DIR / 自定义 dataDir）：存放 runtime/、documents/、data/、state/ 四类数据；state/memory-providers.json 以 0600 权限保存第三方连接与凭据。
• DSH Web → 插件 → 可组合记忆：选择主策略与组件、存储范围、空闲审查和 Provider，并在“备份与迁移”中导出或导入 ZIP。

环境变量

• MNEMON_CLI_PATH（可选）：Mnemon CLI 不在 DSH 进程的 PATH 中时，指定可执行文件路径；修改后重启 DSH。
• MNEMON_DATA_DIR（可选）：替换默认的 ~/.mnemon 全局根目录，便于隔离测试数据和备份。

固定版本安装与配置检查

证据：固定来源 ↗（外部链接，在新标签页打开）。将路径、账号和凭据占位符替换为测试值。

npx --yes @deepseek-ai/[email protected] plugin --profile web add [email protected]
npx --yes @deepseek-ai/[email protected] --profile web --dump-config

随包默认的 mnemon 配置（节选，由 plugin add 合并，无需手写）

证据：固定来源 ↗（外部链接，在新标签页打开）。将路径、账号和凭据占位符替换为测试值。

- id: mnemon
  name: dsh-mnemon
  config:
    lifecycleEnabled: true
    recallMode: guided
    writebackMode: guided
    idleReviewMs: 30000
    writeEnabled: true
    remoteAccess: read-only
    timeoutMs: 10000

安装后设置

1. 在插件页点击“立即启用”，或重启 DSH 并刷新浏览器；在“记忆系统 → 状态”核对主包为 0.5.21，组件版本与 Starter 锁定组合一致。
2. 从 0.5.5 升级时保持原 storageScope，确认状态页显示的读写根仍是原来的 ~/.mnemon，再决定是否切换范围。
3. 如不希望后台自动写入，在分层策略页关闭空闲审查或其中的“写入运行时记忆”。
4. 保持 remoteAccess: read-only；只有已具备可靠访问控制时，才按作者运维文档改为 trusted-host 并重启。

存储位置与备份

默认 storageScope: global，数据写在 ~/.mnemon（或 MNEMON_DATA_DIR）。从 0.5.5 升级后，先在“记忆系统 → 状态”确认读写根仍是原目录，再考虑切换到 workspace 或 workspaces；切换范围不会搬移、合并或删除旧数据。

后台空闲审查

idleReview.enabled 与 idleReview.runtimeMemory 默认开启：会话空闲后，子 Agent 会读取有界检查点，自动新建项目档案或修改 USER.md、MEMORY.md，每轮只写其中一层。不希望自动写入时，在分层策略页关闭空闲审查，或关闭其中的“写入运行时记忆”。

远程管理与组件安装

remoteAccess 默认 read-only，远程页面只能读取和小范围激活；本机浏览器和桌面版窗口走本地通道，可直接管理。插件页可以按包名安装 dsh-mnemon-source-* 或 dsh-mnemon-strategy-* 组件，名称规则也接受任意 npm 作用域，安装前请核对发布者。

逐项核对固定版本配置参考 ↗（外部链接，在新标签页打开）与存储模型 ↗（外部链接，在新标签页打开）。

配置验证与成功结果

先导出配置，再启动同一版本的 DSH Web：

npx --yes @deepseek-ai/[email protected] --profile web --dump-config
npx --yes @deepseek-ai/[email protected] web

1. 确认 Profile 中有 dsh-mnemon/bundle 组件组和 mnemon 条目，remoteAccess 仍为 read-only。

   npx --yes @deepseek-ai/[email protected] --profile web --dump-config
   

   期望结果：配置树出现 mnemon-bundle 与 mnemon 行，终端没有 peer 不兼容或 waiting for service 提示。

2. 写入一条不含敏感内容的测试运行时记忆，新建会话查看快照，再删除该条目。

   期望结果：新会话能看到测试条目；删除后 MEMORY.md 和下一轮快照中都不再出现。

3. 在记忆空间页打开一个 Mnemon Native 空间的内容列表与图谱。

   期望结果：列表与图谱可以加载；失败时错误会写明是超时、输出超限还是找不到 Mnemon CLI。

第一次使用

• 保存“测试项目代号是 BLUE-42”到运行时记忆，新建会话询问代号，再删除并确认不再出现。
• 把一份测试设计说明存为项目档案，再用标题关键词检索它。

先用测试记忆走一遍

写入一条不含敏感内容的运行时记忆，新建会话确认它出现在快照中，再删除。随后在记忆空间页创建或激活一个 Mnemon Native 空间，检查内容列表和图谱能否加载。0.5.21 把整库读取上限从 2 MiB 提高到 128 MiB，大约上千条记忆的空间不再因此失败。

容量满时，运行时记忆归档只写入支持精确写入和安全删除的已激活空间；失败时保留现有热记忆，并报告目标空间与条目 id。手机入口选择见手机使用指南。

数据、权限与凭据

**数据流：**会话/项目 → Runtime、Documents、Memory Spaces 三个 Source 与策略 → 本地 ~/.mnemon 或第三方 Provider（mem0、Honcho、Supermemory、RetainDB 等）→ DSH 每轮提示与召回；空闲审查把不超过 24000 字符的检查点交给 DSH 已配置的模型；版本检查访问 npm registry；远程页面经 DSH API Gateway，管理操作另需 remoteAccess: trusted-host。

**权限关注：*读取会话与项目文档，写入 ~/.mnemon（或所选范围）下的运行时记忆、项目档案与 Native 数据库；默认开启的空闲审查会由子 Agent 自动写入；可运行 Mnemon CLI，经 DSH CLI 安装 dsh-mnemon-source/strategy- 包，经 pnpm、npm、Homebrew 或 go 更新插件与 CLI，并导入 ZIP；启用第三方 Provider 时查询与记忆内容会发往其服务。

**数据存储：**默认全局保存在 ~/.mnemon（或 MNEMON_DATA_DIR）：runtime/ 存 memories.json 及 USER.md、MEMORY.md，documents/ 存索引与 active、archived Markdown，data/ 存 Mnemon Native 的 mnemon.db，state/memory-providers.json 存第三方连接与凭据。第三方 Provider 会把记忆写到其服务端；空闲审查的检查点会交给 DSH 已配置的模型处理。

真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。

卸载、回退与清理

停止 DSH 后，从同一个 Profile 移除包：

npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-mnemon

1. 停止 DSH，运行 npx --yes @deepseek-ai/[email protected] plugin --profile web remove dsh-mnemon，重启后用 --dump-config 确认 mnemon 条目消失；卸载不会删除 ~/.mnemon。
2. 只想暂停时，在 Profile patch 中为 - id: mnemon 设置 disabled: true 并重启，不卸载包也不删除数据。
3. 确认不再需要后再手动删除测试数据根；第三方 Provider 的远端记忆需在其服务端另行删除并撤销 API Key；Mnemon CLI 需单独卸载。
4. 回退到 0.5.5 只适用于 DSH 0.1.2-rc.1：在独立的旧版 Profile 中恢复升级前的 Profile、会话与 ~/.mnemon 备份，不要让旧版 DSH 打开已迁移的会话。

升级 DSH 0.2 后历史会话打不开

如果报错 source summary requires notice form，原因是旧版 Mnemon 写入的会话元数据被新版 DSH 的格式校验拒绝。停止 DSH，备份完整会话目录，只对备份副本运行 dsh-mnemon-repair-session 预览，并先在一次性 Profile 中验证修复副本；工具不会改写原会话，遇到无法证明的形状会拒绝输出。

安装后提示不兼容或组件一直 pending

不兼容提示通常表示装到了 0.5.19 之前的版本，需要带版本号重新安装，不要用 allow-version 放行旧版。更新后出现 ERR_PACKAGE_PATH_NOT_EXPORTED 或 waiting for service: mnemonStarterReady 时，完全退出 DSH 再重新启动。

常见问题

DSH 0.2 安装或启动时提示 dsh-mnemon 不兼容

装到了 0.5.19 之前的版本（pnpm 会跳过发布不足 24 小时的版本）；带版本号安装 [email protected]，不要用 allow-version 放行旧版。

更新后提示 ERR_PACKAGE_PATH_NOT_EXPORTED 或 waiting for service: mnemonStarterReady

正在运行的 DSH 仍持有旧版组件组；完全退出 DSH 再重新启动，不要关闭组件组或删除分组配置。

历史会话报 source summary requires notice form

旧版 Mnemon 写入的会话元数据被新版 DSH 拒绝；停止 DSH 并备份会话目录，只对备份副本运行 dsh-mnemon-repair-session，先在一次性 Profile 验证修复副本。

Native 空间列表、图谱或容量归档失败

确认已是 0.5.21（整库读取上限 128 MiB）；按错误原因处理，CLI 超时可调大 timeoutMs，找不到 CLI 时设置 MNEMON_CLI_PATH。

远程页面能读取但不能保存设置

这是默认的 read-only 管理限制，浏览器登录本身不授予管理权限；确需远程管理时保留完整配置行改为 trusted-host 并重启。

安装成功但页面或命令没有出现

先运行 --dump-config 确认 Bundle 已进入 web Profile，再重启 DSH Web 并硬刷新浏览器。不要通过反复扩大权限来解决加载问题。

插件运行后没有得到预期结果

把问题缩小到本页的最小验证任务，检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文，并核对当前安装目标是否仍对应本页固定提交。

作者固定资料中未识别到独立故障章节。遇到插件特有错误时，应先停止 DSH、保留日志并回退插件。

固定来源证据

以下资料是本文配置结论的依据：

• README.zh-CN.md ↗（外部链接，在新标签页打开）
• README.md ↗（外部链接，在新标签页打开）
• SECURITY.md ↗（外部链接，在新标签页打开）

继续查看：返回 dsh-mnemon 插件详情页，重新核对兼容性、权限、同类插件和来源状态。