本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-mnemon

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-mnemon

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 运行时和档案是本地确定性存储；Mnemon Native 默认本地，三方 Provider 必须显式启用。
• Provider 凭据以 mode 0600 保存在 <storageRoot>/state/memory-providers.json，不会返回浏览器、智能选择 Agent 或 Mnemon Pack。
• Host 调用使用参数数组并禁用 shell，同时约束输出、超时、取消、schema、路径、锁与 revision。
• 关闭 Provider 只清理本地目录元数据，不删除远程数据；重连时从 Provider 重建，无法映射的字段才使用本地默认值。
• 切换范围不会自动迁移、合并或删除旧根目录。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装插件之后还需要做什么？必须先装 mnemon CLI 吗？

是的。Mnemon Native 是默认长期记忆引擎，插件会调用 mnemon 可执行文件；如果找不到 CLI，状态页会显示不可用，所有语义写入和读取都会失败。Homebrew、Go go install 或 Windows 官方 ZIP 均可，DSH 也可以通过 MNEMON_CLI_PATH 或 mnemon.cliPath 显式指定路径。

记忆数据存放在哪里？换电脑或卸载插件会丢吗？

数据放在 storageScope 选定的目录下：默认 global 写到 ~/.mnemon（可被 MNEMON_DATA_DIR 覆盖），workspace 写到当前会话 <cwd>/.mnemon，custom 写到 dataDir 指定的绝对路径。卸载插件、删除插件目录或切换 scope 都不会自动迁移、合并或删除旧数据；原文件保留在原路径，需要时再用「设置 → 记忆系统 → 备份迁移」的 ZIP 导出/导入搬走。

运行时记忆（USER.md / MEMORY.md）和长期记忆体（Memory Spaces）有什么差别？

运行时记忆是 DSH 每轮自动注入到提示词里的极简 Markdown（USER.md 用户偏好、MEMORY.md 项目约定），上限分别 4 KiB / 10 KiB，只适合最常用的高频信息；长期记忆体放在外部服务/数据库里，按需召回，适合跨会话、跨任务、需要带图谱或实体关系的事实。文档档案居中，保存完整设计、复盘、流程稿并支持确定性全文检索。

关闭插件或设为只读，会清空我的记忆吗？

不会。writeEnabled: false 只是禁止语义写入（新增/关联/删除/导入包），并不等价于磁盘只读——Runtime 投影初始化、文档最近访问时间更新、Mnemon 读取触发的数据库迁移仍可能发生。禁用服务也不再删除远端 Provider 数据，只清掉本地的目录映射，重新启用会从 Provider 重新发现。

九条 Provider 各自能做什么？插件会替我注入不存在的功能吗？

插件严格按 Provider 实际声明的能力暴露功能，例如 Mnemon Native 支持完整类型化图谱、关联、精确写入、软删除，OpenViking 写是异步语义提炼、Honcho/Mem0/RetainDB 没有 graph/related/link，ByteRover 不支持 forget，Holographic 是本地 JSON 事实文件。能在 WebUI 看到的按钮、能在 Agent 工具里调用的方法，都不会凭空捏造。

我可以让后台的「记住」和「召回」Agent 使用不同的模型吗？

可以。在 mnemon.taskAgentModel 下选 fixed 模式并填写 provider 和 model，AI 元信息、归档、Agent 查询、记忆蒸馏等独立任务 Agent 都将走该路由；默认 inherit 跟随 DSH 新建会话时的 Provider/Model，不影响对话 Agent。

远程 Web 页面能直接修改我的记忆吗？

默认不能。remoteAccess 是启动时才会采样的安全边界，默认 read-only：远端页面只能读取并切 Memory Space 的激活态，写入、设置、备份 RPC 仍限定为 loopback。若需要放开通路，必须在 DSH 本地配置里把 remoteAccess 改为 trusted-host（同时配置 DSH 自身的 trustedHosts），并重启 Host。

升级 dsh-mnemon 之后旧数据还在吗？

在。所有持久化数据仍在选定的 storageRoot 下。但 v0.2.8 文档明确指出，Mnemon 自身在打开数据库时可能就地运行迁移，请在升级前先做一次 Settings → 备份迁移的 ZIP 导出，并在隔离目录里验证恢复流程后再切到生产 scope。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: >=20
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则