@dreamor/dsh-memvault

中文文档
0.7.0发布于 2026/11/07MITTypeScriptES Module构建来源已验证近 30 天下载 3134

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

中文使用文档
文档目录6 节
  1. 它会做什么
  2. 安装
  3. 超越配置(地方发展)
  4. 配置
  5. 构建
  6. 状态

@ 梦想/ dsh- memvault

Cordis 插件连接 错误 输入 深搜索策略 (单位:千美元)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/ 目录 :

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(中文(简体) ).

验证配置, 然后开始 :

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,它不合并每个字段:

- 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 块,它从不合并每个字段.

配置

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

构建

npm install
npm run build
npm test

状态

建立干净( E)tsc --strict对真实的, npm 出版 @deepseek-ai/[email protected], (中文(简体) ), @deepseek-ai/[email protected], (中文(简体) ), @deepseek-ai/[email protected],以及 @deepseek-ai/[email protected] 软件包(不模拟 -) 见 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 和一个真实的 [email protected] plugin add 编号 : --dump-config 运行; 插件保存 其通配符对等范围,因此DSH 0.1安装仍然可用.

版本与发布记录

@dreamor/dsh-memvault 共发布 22 个版本,首次发布于 2026/09/11;过去 12 个月发布了 22 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.7.0latest2026/11/076 天前
0.6.122026/11/049 天前
0.6.112026/10/3014 天前
0.6.102026/10/2915 天前
0.6.92026/10/2915 天前
0.6.82026/10/2816 天前

关于 @dreamor/dsh-memvault 的常见问题

@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 和提交记录判断。