@zseven-w/dsh-noema · DSH Hub

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

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

工具	作用
`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 编码工具导入记忆。

来源 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/`

设置	默认值	含义
Enable memory	on	`noema_*` 工具的总开关。
Memory guidance	on	系统提示词中教授记忆用法的部分。
Start server at boot	on	在 DSH 启动时启动，而非首次使用时才启动。
Auto-accept new memories	on	`noema_remember` 立即持久化。
Server command	`bundled`	捆绑的 `noema-mcp` 二进制文件或自定义可执行文件路径/命令。
Working directory	—	服务器的工作目录（运行 `cargo run` 时需要）。
Memory root (NOEMA_ROOT)	—	记忆的存储位置；留空 = `~/.agent-memory`。
Recall token budget	1200	`noema_recall` 的默认 `budget_tokens`。
Idle timeout (ms)	0	空闲后停止服务器；0 = 永不停止。
Keep alive	on	服务器崩溃或退出时在后台重启。
Keep-alive interval (ms)	5000	后台健康检查之间的最小间隔。
Call timeout (ms)	30000	每次工具调用的超时时间。
Restart delay (ms)	1000	停止/崩溃与下次启动之间的退避时间。

宿主插件 —— 在 profile patch 中启用 Cordis HMR 条目，并将其监听根目录指向本包的 lib/ 输出目录，同时保留 link: 依赖。运行 pnpm run build 后，正在运行的 DSH 会自动重载插件入口（重载会重启 Noema 服务器子进程）—— 无需重启服务器。
```
# ~/.dsh/profiles/
```


- **客户端包** —— `ppnpm run build:client` 会重写 `lib/client.js`；client-hmr 的 node 端会轮询每个 graph 包的 stat（默认 500ms），并通过 `/plugins/events` SSE 通道广播 `rebuilt` 帧，浏览器便可在不刷新页面的情况下热替换模块。
- **设置** —— 在 Noema Memory 设置页上所做的每项更改都会通过设置服务实时生效。

热重载唯一做不到的是加载一个从未出现在启动树中的插件：运行中的组合既不监听 profile patch 层（Web 应用未接入 `watchUserPatches`），也不暴露加载器变更 API（插件清单 RPC 是只读的）。因此，一个全新插件恰好需要重启一次服务器，之后上述循环便完全可热重载。

## 开发

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

@zseven-w/dsh-noema

安装

说明文档

为什么选择 DSH Noema

🧠 持久召回

📥 从其他工具导入

🛠️ 设置页管理

🩺 保活

🔍 智能实体抽取

⚡ 热重载

安装到 DSH

记忆工具

从其他工具导入记忆

设置

热重载

许可证