Noema 长期记忆 lundberg563/dsh-noema

DSH Noema

为 DeepSeek Harness 提供长期记忆 —— 由 Noema 支撑、持久且可检查的智能体记忆。
开工前先回忆 • 从 9 款智能体工具导入 • 设置页管理记忆 • 崩溃保活 • 热重载

npm: @zseven-w/dsh-noema · 已在 DSH 0.2.0-rc.2 上测试

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Français · Español · Deutsch · Português · Русский · हिन्दी · Türkçe · ไทย · Tiếng Việt · Bahasa Indonesia

Noema 记忆设置页 —— 导入来源、记忆管理与服务实时状态

为什么选 DSH Noema

DSH Noema 把 DeepSeek Harness 和 Noema 连起来。Noema 是本地优先、不用向量的记忆系统，专为编码智能体打造。接上之后，智能体能跨会话保留知识，不必每轮对话都从零开始。

🧠 持久回忆

记忆以 Markdown 文件形式存放在 NOEMA_ROOT 下（默认 ~/.agent-memory/），随时可以打开查看。会话开始时用 noema_recall 载入相关上下文；查找、浏览、审计分别交给 noema_search、noema_browse、noema_catalog 和 noema_recall_graph。

📥 从其他工具导入

noema_import 读取另外十个 AI 编程工具的记忆文件——Codex、Claude Code、opencode、Cursor、Grok、WorkBuddy、Antigravity、Trae、Qoder、Hermes——把它们拆成段落，每段存成一条持久记忆。内容键控的账本在多次运行之间、在共享文件的工具之间去重。

🛠️ 设置页管理

Noema Memory 设置页可配置服务器命令、记忆根目录、预算、空闲/调用超时和引导段落——Manage memories 卡片则直接搜索、浏览、添加、审阅和删除已存记忆。

🩺 保活

记忆服务器常驻：空闲超时默认永不触发，保活循环在 noema-mcp 子进程崩溃或退出时于后台重启它，检查间隔和重启退避均可配置。

🔍 智能实体抽取

Noema 的抽取引擎把 jieba 分词与高精度信号结合起来——英文专有名词、中日韩人名与技术术语、引号话题、重复出现——再叠加停用词和路径过滤，让 PageIndex 话题目录保持干净。

⚡ 热重载

首次启动之后，插件再也不需要重启：pnpm run build 通过 Cordis HMR 热重载宿主插件，ppnpm run build:client 通过 client-hmr SSE 通道热替换浏览器端 bundle。

安装到 DSH

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

或者，直接从源码树做本地开发：

dsh plugin --profile web add link:/path/to/dsh-noema
dsh web

link: 协议把配置档依赖软链到本仓库，因此重新构建立即可见，Cordis HMR 也能监视编译产物。

插件通过按平台拆分的可选 npm 包内置 noema-mcp 二进制。若想自己构建，在随附的 noema 子模块里运行 cargo build --release -p noema-mcp，或者把 Server command 设置指向任意一份 noema-mcp 构建。

记忆工具

面向模型的工具与 Noema MCP 接口一一对应：

| 工具 | 作用 |
| noema_recall | 按查询召回相关记忆，受 token 预算约束。 |
| noema_search | 对已存记忆做全文搜索。 |
| noema_browse | 按话题或实体浏览 PageIndex 目录。 |
| noema_catalog | 把完整记忆目录渲染成 markdown。 |
| noema_recall_graph | 沿链接和共享实体做多跳召回。 |
| noema_neighbors | 从某条记忆出发走一跳图。 |
| noema_explain | 解释某条记忆为何被召回或未被召回。 |
| noema_remember | 保存持久事实、决策、约束或偏好。 |
| noema_review_list | 列出待审阅的候选。 |
| noema_review_decide | 接受、拒绝、编辑或合并候选。 |
| noema_forget | 墓碑标记或硬删除一条记忆。 |
| noema_policy_get / noema_policy_set | 读取或更新写入策略。 |
| noema_status | 服务端与租户状态：计数、索引健康度、存储根目录。 |
| noema_import | 从其他 AI 编程工具导入记忆。 |

每个工具返回统一信封 { ok, tool, text }，其中 text 携带完整的服务端输出。

从其他工具导入记忆

| 来源 id | 全局文件 | 工作区文件 |
| codex | ~/.codex/AGENTS.md + Codex 记忆流水线：~/.codex/memories/MEMORY.md、memory_summary.md、rollout_summaries/.md、extensions/ad_hoc/notes/.md（跳过 raw_memories.md —— 它是未经整理的原始流） | AGENTS.md、AGENTS.local.md |
| claude-code | ~/.claude/CLAUDE.md、~/.claude/CLAUDE.local.md、~/.claude/MEMORY.md | CLAUDE.md、CLAUDE.local.md、MEMORY.md |
| opencode | ~/.config/opencode/AGENTS.md | AGENTS.md |
| cursor | ~/.cursor/rules/.mdc、~/.cursorrules | .cursor/rules/.mdc、.cursorrules |
| grok | ~/.grok/AGENTS.md + Grok 跨会话记忆：~/.grok/memory/MEMORY.md、各项目的 MEMORY.md，以及 sessions/.md 摘要 | AGENTS.md |
| workbuddy | ~/.codebuddy/CODEBUDDY.md（WorkBuddy 记忆文件）、~/.workbuddy/AGENTS.md、~/.workbuddy/memory.md、~/.config/workbuddy/AGENTS.md、~/Library/Application Support/WorkBuddy/AGENTS.md | AGENTS.md、CODEBUDDY.md |
| antigravity | ~/.antigravity/AGENTS.md、~/.config/antigravity/AGENTS.md、~/Library/Application Support/Antigravity/AGENTS.md（尽力而为；目前还没有文档化的全局记忆存储） | AGENTS.md、AGENTS.local.md |
| trae | ~/.trae/AGENTS.md、~/.trae/memory/、~/.trae/rules/（外加 ~/.trae-cn 下的对应变体） | AGENTS.md、.trae/rules/ |
| qoder | ~/.qoder-cn/AGENTS.md、~/.qoder-cn/rules/、自动记忆根目录 ~/.qoder-cn/memory/ 与 ~/.qoder-cn/projects//memory/（外加 ~/.qoder 下的对应变体） | AGENTS.md、AGENTS.local.md、.qoder/rules/ |
| hermes | ~/.hermes/memories/（MEMORY.md + USER.md）以及全局 ~/.hermes/SOUL.md | .hermes.md、HERMES.md、AGENTS.md、CLAUDE.md |

- source 参数选定一个工具；省略则运行设置中启用的所有来源。
- path 参数选定工作区根目录，用于项目级文件（默认取会话工作区；只有打开「导入工作区文件」设置时才会加载工作区文件）。
- 导入通过 $DSH_HOME/storages/dsh-noema-imports.json 的账本去重，键为文件路径 + 段落内容 —— 多个工具共用同一个项目 AGENTS.md 时，每个段落只导入一次。force: true 会重新导入全部内容。
- 设置页提供各来源的复选框、启动时导入开关、文件大小上限，以及一个「立即导入」按钮，附带上次运行摘要。

设置

打开 Settings → Noema Memory：

| 设置项 | 默认值 | 含义 |
| Enable memory | on | noema_* 工具的总开关。 |
| 记忆引导 | 开 | 系统提示词中的一节，教模型怎么用记忆。 |
| 启动时拉起服务器 | 开 | DSH 启动时就拉起，不用等到第一次使用。 |
| 自动接受新记忆 | 开 | noema_remember 立即写入。 |
| 服务器命令 | bundled | 用内置的 noema-mcp 二进制，或自定义可执行文件路径/命令。 |
| 工作目录 | — | 服务器的工作目录（cargo run 需要）。 |
| 记忆根目录（NOEMA_ROOT） | — | 记忆存放位置；留空 = ~/.agent-memory。 |
| 召回 token 预算 | 1200 | noema_recall 的默认 budget_tokens。 |
| 空闲超时（ms） | 0 | 空闲后停掉服务器；0 = 不停。 |
| 保持存活 | 开 | 服务器崩溃或退出时，在后台重启。 |
| 保活间隔（ms） | 5000 | 后台健康检查之间的最小间隔。 |
| 调用超时（ms） | 30000 | 每次工具调用的时限。 |
| 重启延迟（ms） | 1000 | 停止/崩溃到下次启动之间的退避时间。 |

状态卡片显示服务器健康状况，并提供重启/停止操作；导入区管理九个记忆来源。

热重载

插件只要加载过一次，DSH 的 HMR 机制就完全可用：

- 宿主插件 —— 在配置档补丁里启用 Cordis HMR 条目，把监听根目录指向本包的 lib/ 输出，并保留 link: 依赖。运行 pnpm run build，正在运行的 DSH 会自动重载插件入口（Noema 服务器子进程随重载一起重启）—— 不用重启服务器。

~/.dsh/profiles/<profile>/cordis.patch.yml
- id: hmr
disabled: false
config:
root:
- /path/to/dsh-noema/lib

- 客户端 bundle —— ppnpm run build:client 重写 lib/client.js；client-hmr 节点的另一半会轮询每个 graph bundle 的状态（默认 500ms），通过 /plugins/events SSE 通道广播一帧 rebuilt，浏览器随即热替换模块，无需刷新页面。
- 设置 —— 在 Noema Memory 设置页做的任何改动，都通过设置服务实时生效。

热重载唯一做不到的，是加载一个从未出现在启动树里的插件：运行中的组合既不会监听配置档补丁层（Web 应用没有接 watchUserPatches），也不提供加载器变更 API（插件清单 RPC 是只读的）。所以新插件必须重启一次服务器，之后上面的循环就完全热了。

开发

pnpm install
pnpm run build # host tsc + client tsdown bundle
pnpm test # build + node --test tests/

e2e 测试在 noema/target/debug/noema-mcp 存在时针对它运行（否则跳过）。

生态

- DSH Android —— 在对话里跑一台实时 Android 模拟器或 USB 设备，全程通过 adb 驱动
- DSH Crew —— 从 Claude Code / Codex 向 DSH 智能体派活
- DSH iOS — 在对话里直接操作 iOS 模拟器和 USB 连接的 iPhone
- DSH OpenPencil — 在对话里查看和编辑 .op 设计文档

许可证

MIT