# @dreamor/dsh-memvault 中文文档

规范地址：https://npmcn.com/package/%40dreamor/dsh-memvault/

版本：0\.7\.0
npm 元数据更新时间：2026-11-07T06:27:52.278Z
中文译文更新时间：2026-11-12T23:25:04.011Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dreamor/dsh-memvault
原文对照：https://npmcn.com/package/%40dreamor/dsh-memvault/?lang=original
项目主页：https://github.com/dreamor/MemVault#readme
源码仓库：https://github.com/dreamor/MemVault

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：63.5 kB，27 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@deepseek-ai/cordis ^4\.0\.0，@deepseek-ai/dsh-llm \*，@deepseek-ai/dsh-session \*，@deepseek-ai/schemastery \*，@deepseek-ai/dsh-system-prompt \*
- 首次发布：2026-09-11T05:28:21.531Z
- 最新版本发布：2026-11-07T06:27:51.997Z
- 近 30 天下载量：3134（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

DeepSeek Harness (dsh) Cordis插件:自动将MemVault记忆注入系统即时并自动取出倒转端的记忆.

## 安装

```sh
npm install @dreamor/dsh-memvault
```

也可以使用：`pnpm add @dreamor/dsh-memvault`、`yarn add @dreamor/dsh-memvault`、`bun add @dreamor/dsh-memvault`

## README

# @ 梦想/ dsh- memvault

Cordis 插件连接 [错误](https://npmcn.com/package/%40dreamor/README.md) 输入 [深搜索策略](https://github.com/deepseek-ai/deepseek-harness) (单位:千美元)`dsh`) (中文(简体) ).

这个 `dsh`/Cordis API 表面,它依赖(`ctx.systemPrompt.section()`, (中文(简体) ), `session/event` 有效载荷, `Plugin.Object` 核查结果 实际数 `deepseek-harness` 来源,不是二手文件.

## 它会做什么

-   **自动注入**: 保留 `memory://session-inject` 缓存和注册 作为系统提示部分( q)`ctx.systemPrompt.section()`),刷新过 热衷于负载和每一次 `turn/end`。不需要代理工具呼叫.
-   **自动取出**打开 : `turn/end` 与 `reason.kind === 'completed'`,电话 门韦尔的 `notify_response` 与 **两者** 转弯的助手文本和 用户自己的回合文本( e)`user/message` 活动 `source.kind === 'user'`(中文(简体) ) 自动。 传递用户自己的话语重要性——MemVault的提取器 信号词是第一人称 ("qq"/"i"),与用户自己的匹配 声明远比助手的重述更可靠.

如果你只想让原始的20个Memvault工具接触到模型(否) 自动注射/自动取出),您不需要这个软件包——dsh自己的 `@deepseek-ai/dsh-mcp-client` 以 0 代码进行相同: 每一个上游 服务器通过 `cordis.patch.yml` (单位:千美元)`transport: stdio`, (中文(简体) ), `serverName: memvault`, (中文(简体) ), `command: <path to memvault-proxy>`) (中文(简体) ).

## 安装

先决条件: `dsh` 安装(例如). `npx @deepseek-ai/dsh web`)和 `memvault-proxy` 二进制可到达 `PATH` (或点) `binaryPath` 在一个.. 参看下面的覆写部分.

构建, 然后从 repo 安装到 dsh 配置文件 `dsh-plugin/` 目录 :

```bash
cd dsh-plugin
npm install
npm run build      # tsc --strict
npx @deepseek-ai/dsh plugin --profile <profile> add "$PWD"
```

`dsh plugin add` 运行相当于 `pnpm add` 软件包 那个简介 `dsh.profile.bundles` 自动——不手工编辑 简介 `cordis.patch.yml` 默认安装需要。 插件传送 a `cordis.patch.yml` 登记一个 `memvault` 带有默认配置的条目 (单位:千美元)`mode: spawn`, (中文(简体) ), `embeddingProvider: native`(中文(简体) ).

验证配置, 然后开始 :

```bash
npx @deepseek-ai/dsh --profile <profile> --dump-config   # 组合后应只有一条 id: memvault 且字段正确
npx @deepseek-ai/dsh <profile> --port 0                  # 实际启动方式以你的 dsh 用法为准
```

启动时插件产入 `memvault-proxy` 和探测器 `http://127.0.0.1:3778/health` 直到服务器准备好。 运输、港口和 db 覆盖作为 CLI 旗被传递,所以存在 `~/.memvault/proxy.yaml` (包括 `upstreams` 财务报告和审定财务报表 `markdown_dir`)已装入,但从未重写. 改为: 确认注射实际着陆:开始真正的对话,然后解压 会话日志( e)`zstd -d ~/.dsh/sessions/.../session.jsonl.zstd`)和检查 那个 `request/header.data.header.system` 包含注入的 `[MUST]`编号 :`[REF]` 块.

### 超越配置(地方发展)

覆盖单个字段( 如点) `binaryPath` 在本地建造的 `memvault-proxy`),添加一个 **赤地覆盖补丁** 到侧写 `cordis.patch.yml` 并改写整个 `config` 块 - 覆盖替换 全文 `config`,它不合并每个字段:

```yaml
- id: memvault
  name: '@dreamor/dsh-memvault'
  config:
    mode: spawn
    db: '~/.memvault/data.db'
    port: 3778
    binaryPath: /absolute/path/to/memvault-proxy
    embeddingProvider: native
    agentId: dsh
    injectOnAssemble: true
    extractOnTurnEnd: true
```

这个 `cordis.patch.yml` 此插件船将其条目包入 `insert:` 因为 该条目不存在于任何更早的层. 一个赤裸的 `- id:` 补丁是一个 _覆盖_ 这需要 id 已经存在,错误用 `patch: entry "memvault" not found` 否则——必须有一个覆盖补丁 重写整个 `config` 块,它从不合并每个字段.

## 配置

| 外地 | 默认 | 含义 |
| --- | --- | --- |
| `mode` | `spawn` | `spawn` 管理 a `memvault-proxy` 儿童过程; `attach` 连接到 `url`。 。 。 . |
| `db` | `~/.memvault/data.db` | 使用时 `mode: spawn`。 。 。 . |
| `port` | `3778` | 使用时 `mode: spawn`。 。 。 . |
| `url` | `''` | 使用时 `mode: attach`,比如说. `http://127.0.0.1:3778/mcp`。 。 。 . |
| `binaryPath` | `''` (从 `PATH`(中文(简体) ) | 使用时 `mode: spawn`。 。 。 . |
| `embeddingProvider` | `native` | 使用时 `mode: spawn` 强制作为 `MEMVAULT_EMBEDDING_PROVIDER` 在孩子的巢穴, 所以它不能不小心继承 dsh 自己的 `OPENAI_API_KEY`。 。 。 . |
| `agentId` | `dsh` | 每通电话都向MemVault报告. |
| `injectOnAssemble` | `true` | 切换自动注射. |
| `extractOnTurnEnd` | `true` | 切换自動取取取. |
| `inferOutcomeOnSessionEnd` | `false` | 自动调用 `infer_outcome` 届会结束时(`session/disposed`记录任务结果/方案 `bench` 和经验教训反射——镜像 Claude/Codex 插件 `MEMVAULT_HOOK_OUTCOME` no. |

## 构建

```bash
npm install
npm run build
npm test
```

## 状态

建立干净( E)`tsc --strict`对真实的, npm 出版 `@deepseek-ai/cordis@4.0.5`, (中文(简体) ), `@deepseek-ai/dsh-system-prompt@0.2.0-rc.2`, (中文(简体) ), `@deepseek-ai/dsh-session@0.2.0-rc.2`,以及 `@deepseek-ai/dsh-llm@0.2.0-rc.2` 软件包(不模拟 -) 见 `src/index.smoke.test.ts`,将插件挂载在真实 `Context` 与真实 `SystemPrompt` a. 服务与主张 `ctx.systemPrompt.assemble()` 实际包含被注入部分).

**完全经核实的结束 以对抗真实的 `dsh` 安装** (单位:千美元)`npx @deepseek-ai/dsh web`页:1 找到四个真正的错误并固定在 核查过程:

1.  `cordis.patch.yml` 插入 vs 覆盖补丁语义( 赤色) `id` 补丁 要求id已经存在).
2.  `memvault-proxy` 继承出错 `OPENAI_API_KEY` 从dsh的自己 进程 env,加一个 stale (pre-`native`\-嵌入)本地二进制.
3.  急切的注射缓存在 `apply()` 时间竞速 `memvault-proxy`自己的启动( n)`fetch failed`) (中文(简体) ).
4.  `mcp-client.ts` 永久缓存 a _失败_ 连接尝试.. `connected ??= (...)` 在第一个电话上被记起 以后的每一次通话 都会不停地回击 永远地回击 甚至从不重试 代理上来了.

四个都修好了,真正的对话回合的会话记录 (单位:千美元)`~/.dsh/sessions/.../session.jsonl.zstd`,减压与 `zstd -d`显示 实际数 `request/header.data.header.system` 包含 MemVault 文本 已注射 `[MUST]`编号 :`[REF]` 记忆和直接 `notify_response` 调用 反对运行 `memvault-proxy` 将 MemVault 的内存数从 8 移动到 10(新偏好/事实记忆实际被保存到Inbox).

后续回合延长 `notify_response` 并提取用户的 自己的转弯文本 — MemVault 的提取器 信号词是第一人称,所以用户自己的语句("qq标签") 匹配比助手重述要可靠得多 ("q") 选项卡”曾经被默默拒绝;信号词列表也被扩展 带有第二/第三人称镜像。 对正运行进行校验 `memvault-proxy`记忆计数从10到13 三种情景, 与 `source:user`编号 :`source:assistant` 在结果上标记.

DSH 0.2 兼容性也被检查过 `@deepseek-ai/dsh-*@0.2.0-rc.2` 和一个真实的 `dsh@0.2.0-rc.2` `plugin add` 编号 : `--dump-config` 运行; 插件保存 其通配符对等范围,因此DSH 0.1安装仍然可用.

## 常见问题

### @dreamor/dsh-memvault 是什么？

DeepSeek Harness \(dsh\) Cordis插件:自动将MemVault记忆注入系统即时并自动取出倒转端的记忆\.

### 如何安装 @dreamor/dsh-memvault？

在项目目录运行 npm install @dreamor/dsh-memvault，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（^4\.0\.0）、@deepseek-ai/dsh-llm（\*）、@deepseek-ai/dsh-session（\*）、@deepseek-ai/schemastery（\*）、@deepseek-ai/dsh-system-prompt（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @dreamor/dsh-memvault 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @dreamor/dsh-memvault 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @dreamor/dsh-memvault 可以商用吗？

@dreamor/dsh-memvault 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dreamor/dsh-memvault 的下载量有多少？

根据 npm 官方下载统计，@dreamor/dsh-memvault 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,134 次，日均约 104 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dreamor/dsh-memvault 还在维护吗？

最新版本 0\.7\.0 发布于 2026/11/07（6 天前）；至今共发布 22 个版本，其中过去 12 个月发布了 22 个；首次发布于 2026/09/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。