dsh-mnemon

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

• 记忆与会话备份（必需）：升级前停止 DSH，备份 ~/.mnemon（或 MNEMON_DATA_DIR、自定义数据目录）、web Profile 与完整会话目录；插件页 ZIP 不包含第三方连接和 DSH 会话。
• DSH 版本组合（必需）：0.5.21 的 DSH peer 为 ^0.1.7-rc.2 || ^0.2.0-rc.1，本页固定 DSH 0.2.0-rc.2。仍在 DSH 0.1.2-rc.1 的用户不能安装此版本，见旧版说明。52DSH 未在 rc.2 上运行验证。
• Node.js 与 pnpm（必需）：作者要求完整 Profile 使用 Node ^22.19.0 或 >=24.0.0；DSH 插件页安装需要 PATH 中能找到 pnpm。
• Provider 选择（必需）：默认记忆空间使用 Mnemon Native，需要另装 Mnemon CLI；第三方 Provider 会把查询和记忆发到其服务，启用前确认数据可以离开本机。

本页命令固定使用 DSH 0.2.0-rc.2，与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录；新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。

下面的命令使用本站核验的 DSH 基线，并锁定插件版本或 Git commit，避免默认分支变化导致安装内容漂移。本站已核对安装目标，但尚未在你的系统和 Profile 中实际执行。

安装到

web Profile

DSH 基线

0.2.0-rc.2

安装来源

npm 预构建包（锁定版本）

固定目标

[email protected]

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

• DSH 版本组合来源 1 ↗（外部链接，在新标签页打开）
• DSH 版本组合来源 2 ↗（外部链接，在新标签页打开）

1. 01
   检查 Node.js 与 pnpm

   DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上，并且 pnpm 必须已在 PATH 中。先运行：

   环境检查复制命令

   node --version && pnpm --version

2. 02
   安装到 Web Profile

   这条命令会把插件加入 web Profile，并在插件声明 DSH Bundle 时自动加入配置层。

   npm 预构建包（锁定版本）复制命令

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

3. 03
   确认 Bundle 已进入配置

   安装成功后先导出组合配置，不启动 Agent。输出中应能找到包名 dsh-mnemon或对应 Bundle 层。

   检查配置复制命令

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

4. 04
   启动并完成最小验证

   启动 Web Profile 后，只测试一个与插件功能直接相关的最小任务，并检查日志、文件、网络和凭据访问是否符合预期。

   启动 DSH Web复制命令

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

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

$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。

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

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

pnpm exec dsh-mnemon-repair-session --input /backup/session.jsonl.zstd
pnpm exec dsh-mnemon-repair-session --input /backup/session.jsonl.zstd --output /backup/repaired-session.jsonl.zstd

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

1. 01
   确认 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. 02
   写入一条不含敏感内容的测试运行时记忆，新建会话查看快照，再删除该条目。

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

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

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

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

读取会话与项目文档，写入 ~/.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 已配置的模型处理。

请注意：“源码已审阅”说明本站检查到的证据范围，不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。

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 并重启。