诺玛记忆 joant09/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 Memory 设置页 —— 导入来源、记忆管理、服务器实时状态

为什么选 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 | 开启 | noema_* 工具的总开关。 |
| 记忆引导 | 开 | 系统提示词章节，教模型怎么用记忆。 |
| 开机启动服务器 | 开 | DSH 启动时就拉起，而不是等到第一次使用。 |
| 自动接受新记忆 | 开 | noema_remember 立即持久化。 |
| 服务器命令 | bundled | 用内置的 noema-mcp 二进制，或自定义可执行文件路径/命令。 |
| 工作目录 | — | 服务器的 cwd（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 的 node 半边每隔一段时间轮询每个 graph bundle 的状态（默认 500ms），通过 /plugins/events SSE 通道广播一帧 rebuilt，浏览器随即热替换模块，无需刷新页面。
- 设置 —— 在 Noema Memory 设置页做的每次改动，都通过 settings 服务实时生效。

热重载唯一做不到的事，是加载一个从未出现在启动树里的插件：正在运行的组合既不会监听配置档补丁层（web 应用没有接 watchUserPatches），也不暴露 loader 变更 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