--- title: "配置 Mnemon 0.5.21 三层记忆并升级到 DSH 0.2" seo_title: "Mnemon 0.5.21 教程：DSH 0.2 安装、空闲审查与旧会话修复" description: "在 DeepSeek Harness（DSH）0.2.0-rc.2 固定安装 Mnemon 0.5.21，配置运行时记忆、项目档案与记忆空间，控制后台空闲审查写入，并备份迁移旧版数据与会话。" canonical: https://52dsh.com/tutorials/omdsh-dev-dsh-mnemon-install-config/ authors: ["52DSH 编辑部"] audience: [] outcomes: [] prerequisites: ["Node.js 与 pnpm","独立 web Profile","可丢弃测试工作区"] difficulty: advanced estimated_action_time: null next_steps: null published_at: 2026-08-22 updated_at: 2026-10-02 verified_on: 2026-10-02 maintenance_status: community verification_level: source_reviewed risk_level: high dsh_version: 0.2.0-rc.2 plugin_id: omdsh-dev-dsh-mnemon tutorial_kind: plugin_configuration related_plugin_url: https://52dsh.com/plugins/omdsh-dev-dsh-mnemon/ --- # 配置 Mnemon 0.5.21 三层记忆并升级到 DSH 0.2 在 DeepSeek Harness（DSH）0.2.0-rc.2 固定安装 Mnemon 0.5.21，配置运行时记忆、项目档案与记忆空间，控制后台空闲审查写入，并备份迁移旧版数据与会话。 ## 2026-10-02 更新到 Mnemon 0.5.21，适配 DSH 0.2.0-rc.2 本页安装目标更新为 `dsh-mnemon@0.5.21`，命令固定使用 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 命令安装 dsh-mnemon@0.5.21。如果先升级了 DSH，旧版插件会被启动预检停用，记忆数据不受影响，装上新版即可恢复。旧会话打不开时，用 dsh-mnemon-repair-session 只修复备份副本。作者另说明 0.5.16 是最后一个在 DSH 0.1.5-rc.1 至 0.1.7-alpha.1 上验证的版本，该版本未经本站审核。 依据：[固定证据 1](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/README.md)、[固定证据 2](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/src/host/config.ts)、[固定证据 3](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/src/host/plugin-installation.ts)、[固定证据 4](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/docs/en/guides/operations.md)。 Mnemon 0.5.21 为 DSH 提供运行时记忆、项目档案与记忆空间三层持久记忆；Starter 锁定 17 个组件包，修复大型 Native 空间读取，并让空闲审查每轮只写一层。 如果你的目标是为 DeepSeek Harness 配置本地优先长期记忆、项目档案与记忆空间，并从 DSH 0.1.x 安全升级，本教程会说明如何在 DeepSeek Harness（DSH）中准备、安装、配置、验证和回退 dsh-mnemon。本文锁定作者仓库提交 `06182f4d828e`；已复核固定提交的原始资料，未进行运行实测。 > 对应插件：[查看 dsh-mnemon 的功能、权限与兼容性说明](/plugins/omdsh-dev-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 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支： ```bash npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add dsh-mnemon@0.5.21 ``` 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 全局根目录，便于隔离测试数据和备份。 ### 固定版本安装与配置检查 证据：[固定来源](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/package.json)。将路径、账号和凭据占位符替换为测试值。 ```bash npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add dsh-mnemon@0.5.21 npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile web --dump-config ``` ### 随包默认的 mnemon 配置（节选，由 plugin add 合并，无需手写） 证据：[固定来源](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/cordis.patch.yml)。将路径、账号和凭据占位符替换为测试值。 ```yaml - 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 作用域，安装前请核对发布者。 逐项核对[固定版本配置参考](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/docs/zh-CN/reference/configuration.md)与[存储模型](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/docs/zh-CN/reference/storage-model.md)。 ## 配置验证与成功结果 先导出配置，再启动同一版本的 DSH Web： ```bash npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile web --dump-config npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web ``` 1. **确认 Profile 中有 dsh-mnemon/bundle 组件组和 mnemon 条目，remoteAccess 仍为 read-only。** ```bash npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --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。手机入口选择见[手机使用指南](/tutorials/dsh-mobile-access-guide/)。 ## 数据、权限与凭据 **数据流：**会话/项目 → 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 移除包： ```bash npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web remove dsh-mnemon ``` 1. 停止 DSH，运行 npx --yes @deepseek-ai/dsh@0.2.0-rc.2 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 小时的版本）；带版本号安装 dsh-mnemon@0.5.21，不要用 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](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/README.zh-CN.md) - [README.md](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/README.md) - [SECURITY.md](https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/SECURITY.md) 继续查看：[返回 dsh-mnemon 插件详情页](/plugins/omdsh-dev-dsh-mnemon/)，重新核对兼容性、权限、同类插件和来源状态。 ## 原始来源 - https://github.com/omdsh-dev/dsh-mnemon - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/package.json - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/cordis.patch.yml - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/docs/zh-CN/reference/configuration.md - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/docs/zh-CN/reference/storage-model.md - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/docs/zh-CN/reference/compatibility.md - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/docs/zh-CN/guides/operations.md - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/docs/zh-CN/guides/installation.md - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/docs/zh-CN/releases/v0.5.21.md - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/src/host/config.ts - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/src/host/plugin-installation.ts - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/src/host/subagent.ts - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/plugins/dsh-mnemon-provider-mnemon-native/src/driver.ts - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/bin/repair-legacy-session.mjs - https://github.com/deepseek-ai/deepseek-harness/blob/639ed015397290b3745d163aafe02ffee4aa3f84/packages/boot/app-boot/src/plugin-compatibility.ts - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/README.zh-CN.md - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/README.md - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/SECURITY.md - https://github.com/omdsh-dev/dsh-mnemon/blob/06182f4d828efb1569d2f68a2df5e0e1d1c69f89/docs/en/guides/operations.md