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

快速上手

dsh-noema

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @zseven-w/dsh-noema

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

— 源: plugins.install

关键要点

• source 参数用于选择某个工具，省略它则会运行设置中启用的所有来源。
• path 参数用于选择项目级文件的工作区根目录（默认使用会话工作区；只有在开启 Import workspace files 设置时，工作区文件才会被加载）。
• 导入通过位于 $DSH_HOME/storages/dsh-noema-imports.json 的账本去重，以文件路径 + 章节内容为键 —— 当多个工具共享同一个项目 AGENTS.md 时，每个章节只会被导入一次。force: true 会重新导入全部内容。
• 设置页提供每个来源的复选框、启动时导入开关、文件大小上限，以及一个带有上次运行摘要的 Import now 按钮。
• 宿主插件 —— 在 profile patch 中启用 Cordis HMR 条目，并将其监听根目录指向本包的 lib/ 输出目录，同时保留 link: 依赖。运行 pnpm run build 后，正在运行的 DSH 会自动重载插件入口（重载会重启 Noema 服务器子进程）—— 无需重启服务器。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件解决什么具体问题？

DSH 默认每次新会话都从零开始，这个插件让 Agent 能跨会话记住用户的事实、决策、约束和偏好，避免重复告知。

数据存在哪里？会被上传到云端吗？

记忆以 Markdown 文件保存在本地 NOEMA_ROOT（默认 ~/.agent-memory/），整个系统本地运行（local-first），不会上传用户数据。

安装后必须重启 DSH 吗？

是的。首次把插件加入 profile 需要一次 DSH 服务端重启，之后再构建即可通过 Cordis HMR 与 client SSE 热重载。

服务器进程崩溃了怎么办？

默认开启了 Keep-alive：检测到子进程退出后会在配置好的退避后自动重启，相关设置可在 Settings → Noema Memory 调整。

如何把已有 AI 工具（Claude Code、Codex、Cursor 等）的记忆迁过来？

在设置页勾选需要的来源后点 Import now，或让模型调用 noema_import。已导入片段会被 ledger 去重，重复运行不会重复入库。

必须在 Settings 里做什么才能用？

默认即可直接使用。Server command 选 bundled 走预编译二进制，或填自定义 noema-mcp 命令/路径；NOEMA_ROOT 为空时走 ~/.agent-memory。

支持哪些操作系统？

官方提供 darwin-arm64/x64、linux-arm64/x64（glibc）、win32-arm64/x64 共六个可选 npm 包覆盖对应架构。Linux musl 等其他 ABI 未提供二进制。

如何卸载？

卸载命令为 dsh plugin --profile web remove @zseven-w/dsh-noema。记忆文件留在磁盘上，需要时手动删除 ~/.agent-memory/ 与 import ledger。

— 源: plugin_wiki.faq_json

兼容性

• DSH: ^0.1.0-rc.6
• Node: >=24.11.0
• Platforms: macOS (arm64), macOS (x64), Linux (arm64, glibc), Linux (x64, glibc), Windows (arm64), Windows (x64)
• Native modules: @zseven-w/dsh-noema-darwin-arm64, @zseven-w/dsh-noema-darwin-x64, @zseven-w/dsh-noema-linux-arm64, @zseven-w/dsh-noema-linux-x64, @zseven-w/dsh-noema-win32-arm64, @zseven-w/dsh-noema-win32-x64, noema-mcp (Rust stdio 子进程)

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则