Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

fix(dsh-plugin): drop the plugin group from the bundle patch (#5390)

t0saki3e02c6ac2984
diff --git a/docs/en/agent-integrations/16-capability-reference.md b/docs/en/agent-integrations/16-capability-reference.md
index a3b8cbbd0..382be00fd 100644
--- a/docs/en/agent-integrations/16-capability-reference.md
+++ b/docs/en/agent-integrations/16-capability-reference.md
@@ -176,7 +176,7 @@ Core modules at a glance (detailed further in the per-dimension sections):
| zcode | Config-driven (merged into `~/.zcode/cli/config.json`, forcing `hooks.enabled=true`) | One-line `--harness zcode` | `zc-<sess_…>` | env + ovcli.conf `plugin.zcode` | ❌ |
| kimicode | Native Kimi Code plugin (`kimi.plugin.json`, managed copy + `installed.json`) | One-line `--harness kimicode` | `kc-<session_id>` | env + ovcli.conf `plugin.kimicode` + workspace files | ❌ |
| opencode | npm plugin `@openviking/opencode-plugin` (its config hook dynamically injects the MCP entry) | One-line `--harness opencode` (uses npm registration with a proxy snapshot fallback) / manual npm / from source | `oc-<id>`; subagents use `oc-<parent>__subagent-<child>` | env + ovcli.conf `plugin.opencode` | ✅ |
-| dsh | In-process Cordis plugin (`cordis.patch.yml` plugin group) | Unified installer (asks for the profile, default `web`), or `dsh plugin --profile web add @openviking/dsh-memory-plugin` | `dsh-<session.id as-is>`; each subagent is assigned its own session | env + ovcli.conf `plugin.dsh` + the cordis patch config, which is the lowest behavior layer (credentials still come from the patch first) | ❌ |
+| dsh | In-process Cordis plugin (`cordis.patch.yml` entry) | Unified installer (asks for the profile, default `web`), or `dsh plugin --profile web add @openviking/dsh-memory-plugin` | `dsh-<session.id as-is>`; each subagent is assigned its own session | env + ovcli.conf `plugin.dsh` + the cordis patch config, which is the lowest behavior layer (credentials still come from the patch first) | ❌ |
| pi | Native pi extension (loaded from a directory, with TypeScript transpiled on the fly via jiti) | One-line `--harness pi` (copied into the auto-discovery directory, no `pi install` needed) | `pi-<piSessionId>` | env + ovcli.conf `plugin.pi` (credential fields are resolved via the shared credential chain) | ✅ |
| openclaw | context-engine plugin (`ownsCompaction:true`) + 15 tools + 5 slash + 4 hooks + HTTP routes | ClawHub: run `openclaw plugins install clawhub:@openviking/openclaw-plugin` alongside `openclaw openviking setup` / npm installer / TOS offline bundle | A UUID is lowercased as-is, otherwise `sha256(sessionKey)`; `memory_store` temporary sessions use `memory-store-<ts>-<rand>` | `plugins.entries.openviking.config` in `openclaw.json` (strictly validated: unknown keys or invalid values force the plugin into setup-only mode) + a few env vars | ✅ `openclaw openviking setup` (interactive/non-interactive + key role probing + version compatibility check) |
| hermes | Hermes bundled MemoryProvider (ships with Hermes; no plugin installation required) | Run `hermes memory setup openviking` (interactive curses wizard), or manually run `config set memory.provider openviking` + `.env` | Hermes generates `%Y%m%d_%H%M%S_<hex6>`; the plugin uses it verbatim | `.env` (`OPENVIKING_*`) or linked ovcli.conf (`use_ovcli_config` mode clears the 5 corresponding variables from .env) + config.yaml | ✅ (multi-level menu) |
diff --git a/docs/en/agent-integrations/17-dsh.md b/docs/en/agent-integrations/17-dsh.md
index 98d38b121..0eab3e868 100644
--- a/docs/en/agent-integrations/17-dsh.md
+++ b/docs/en/agent-integrations/17-dsh.md
@@ -41,7 +41,7 @@ After using it for a while, start a new conversation and ask about something you
dsh --profile web --dump-config
```
- The output should contain an `openviking-memory` plugin group.
+ The output should contain an `openviking-memory-runtime` entry.
> Don't have `ovcli.conf` yet? See the [Deployment Guide → CLI](../guides/03-deployment.md#cli).
>
@@ -83,20 +83,12 @@ Credentials resolve from `OPENVIKING_*` environment variables, then `~/.openviki
Behavior knobs live in the profile's Cordis patch entry:
```yaml
-- insert:
- - id: openviking-memory
- name: '@deepseek-ai/cordis-plugin-group'
- group: true
- isolate:
- openvikingMemory: true
- config:
- - id: openviking-memory-runtime
- name: '@openviking/dsh-memory-plugin'
- config:
- recallTokenBudget: 2000
- scoreThreshold: 0.35
- captureToolResults: false
- commitTokenThreshold: 20000
+- id: openviking-memory-runtime
+ config:
+ recallTokenBudget: 2000
+ scoreThreshold: 0.35
+ captureToolResults: false
+ commitTokenThreshold: 20000
```
`syncTurns: false`, in that same block, makes the integration read-only: it still injects your profile and recalls memories, but sends nothing back — no captured turns, no commits, and no replay of writes an earlier session queued, which stay on the queue until a session that still writes drains them.
@@ -113,7 +105,7 @@ Credentials given in the patch win over the environment. Behavior knobs resolve
| Issue | What to check |
|-------|---------------|
-| Nothing injected, no OpenViking tools | `dsh --profile web --dump-config` should list `openviking-memory`; re-run the installer or `dsh plugin --profile web add …` |
+| Nothing injected, no OpenViking tools | `dsh --profile web --dump-config` should list `openviking-memory-runtime`; re-run the installer or `dsh plugin --profile web add …` |
| Installed into the wrong profile | The installer defaults to `web`; re-run it with `--dsh-profile <name>` |
| `ERESOLVE` during install | The `@deepseek-ai/dsh-*` prerelease tags drift apart; install `@deepseek-ai/[email protected]` exactly |
| Install says the package is "not in the npm registry" | pnpm refuses releases younger than 24 hours by default (`minimumReleaseAge`). Wait it out, or add the exact version to `minimumReleaseAgeExclude` in the profile's `pnpm-workspace.yaml` |
diff --git a/docs/zh/agent-integrations/16-capability-reference.md b/docs/zh/agent-integrations/16-capability-reference.md
index f281ed52b..0a2806bdf 100644
--- a/docs/zh/agent-integrations/16-capability-reference.md
+++ b/docs/zh/agent-integrations/16-capability-reference.md
@@ -178,7 +178,7 @@ per-harness 章节(档案卡)只写差异;所有共享事实均在本章
| zcode | 配置驱动(合并进 `~/.zcode/cli/config.json`,并强制 `hooks.enabled=true`) | 一键 `--harness zcode` | `zc-<sess_…>` | env + ovcli.conf `plugin.zcode` | ❌ |
| kimicode | Kimi Code 原生插件(`kimi.plugin.json`,managed copy + `installed.json`) | 一键 `--harness kimicode` | `kc-<session_id>` | env + ovcli.conf `plugin.kimicode` + workspace 文件 | ❌ |
| opencode | npm 插件 `@openviking/opencode-plugin`(config hook 自注入 MCP 条目) | 一键 `--harness opencode`(npm 注册 + 代理快照兜底)/ 手动 npm / 源码 | `oc-<id>`;subagent 格式为 `oc-<parent>__subagent-<child>` | env + ovcli.conf `plugin.opencode` | ✅ |
-| dsh | Cordis 同进程插件(`cordis.patch.yml` plugin group) | 统一安装器(会询问 profile,默认 `web`),或执行 `dsh plugin --profile web add @openviking/dsh-memory-plugin` | `dsh-<session.id 原样>`;subagent 各自独立会话 | env + ovcli.conf `plugin.dsh` + cordis patch config(行为旋钮的最低层;凭据仍以 patch 优先) | ❌ |
+| dsh | Cordis 同进程插件(`cordis.patch.yml` 条目) | 统一安装器(会询问 profile,默认 `web`),或执行 `dsh plugin --profile web add @openviking/dsh-memory-plugin` | `dsh-<session.id 原样>`;subagent 各自独立会话 | env + ovcli.conf `plugin.dsh` + cordis patch config(行为旋钮的最低层;凭据仍以 patch 优先) | ❌ |
| pi | pi 原生扩展(目录装载,jiti 直译 TS) | 一键 `--harness pi`(复制到自动发现目录,无需 `pi install`) | `pi-<piSessionId>` | env + ovcli.conf `plugin.pi`(凭据字段由凭据链统一解析) | ✅ |
| openclaw | context-engine 插件(`ownsCompaction:true`)+ 15 工具 + 5 slash + 4 hook + HTTP 路由 | ClawHub 执行 `openclaw plugins install clawhub:@openviking/openclaw-plugin` 搭配 `openclaw openviking setup` / npm 安装器 / TOS 离线包 | UUID 原样小写,否则 `sha256(sessionKey)`;`memory_store` 临时会话 `memory-store-<ts>-<rand>` | `openclaw.json` 的 `plugins.entries.openviking.config`(严格校验:存在未知键/非法值时插件进入 setup-only 模式)+ 少量 env | ✅ `openclaw openviking setup`(交互/非交互 + key 角色探测 + 版本兼容检查) |
| hermes | Hermes bundled MemoryProvider(随 Hermes 发布,无需装插件) | 执行 `hermes memory setup openviking`(curses 向导)或手动 `config set memory.provider openviking` + `.env` | 由 Hermes 生成 `%Y%m%d_%H%M%S_<hex6>`,插件原样使用 | `.env`(`OPENVIKING_*`)或 ovcli.conf 联动(`use_ovcli_config` 模式会清空 .env 里的 5 个对应变量)+ config.yaml | ✅(多层菜单) |
diff --git a/docs/zh/agent-integrations/17-dsh.md b/docs/zh/agent-integrations/17-dsh.md
index 330e54627..d13c218db 100644
--- a/docs/zh/agent-integrations/17-dsh.md
+++ b/docs/zh/agent-integrations/17-dsh.md
@@ -41,7 +41,7 @@ bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shar
dsh --profile web --dump-config
```
- 输出里应该能看到 `openviking-memory` 插件组。
+ 输出里应该能看到 `openviking-memory-runtime` 条目。
> 还没有 `ovcli.conf`?见[部署指南 → CLI](../guides/03-deployment.md#cli)。
>
@@ -83,20 +83,12 @@ bash <(curl -fsSL https://ovrelease.tos-cn-beijing.volces.com/memory-plugin-shar
行为参数写在 profile 的 Cordis patch 条目里:
```yaml
-- insert:
- - id: openviking-memory
- name: '@deepseek-ai/cordis-plugin-group'
- group: true
- isolate:
- openvikingMemory: true
- config:
- - id: openviking-memory-runtime
- name: '@openviking/dsh-memory-plugin'
- config:
- recallTokenBudget: 2000
- scoreThreshold: 0.35
- captureToolResults: false
- commitTokenThreshold: 20000
+- id: openviking-memory-runtime
+ config:
+ recallTokenBudget: 2000
+ scoreThreshold: 0.35
+ captureToolResults: false
+ commitTokenThreshold: 20000
```
同一个 `config` 块里的 `syncTurns: false` 让该集成变成只读:画像注入和记忆召回照常,但什么都不再写回——不捕获对话、不 commit,也不重放此前会话排入队列的写入,那些写入会一直留在队列里,直到某个仍在写入的会话把它们排空。
@@ -113,7 +105,7 @@ patch 中写的凭证优先于环境变量。行为旋钮按优先级从高到
| 现象 | 排查方向 |
|------|----------|
-| 没有注入,也没有 OpenViking 工具 | `dsh --profile web --dump-config` 里应能看到 `openviking-memory`;重新运行安装器或 `dsh plugin --profile web add …` |
+| 没有注入,也没有 OpenViking 工具 | `dsh --profile web --dump-config` 里应能看到 `openviking-memory-runtime`;重新运行安装器或 `dsh plugin --profile web add …` |
| 装到了错误的 profile | 安装器默认 `web`;用 `--dsh-profile <name>` 重新运行 |
| 安装时报 `ERESOLVE` | `@deepseek-ai/dsh-*` 各包预发布 tag 不同步;请精确安装 `@deepseek-ai/[email protected]` |
| 安装时报包「不在 npm registry 中」 | pnpm 默认拒绝发布不满 24 小时的版本(`minimumReleaseAge`)。等一等,或把该精确版本加进 profile 的 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude` |
diff --git a/examples/dsh-memory-plugin/README.md b/examples/dsh-memory-plugin/README.md
index ac2ffe65b..9743d41e6 100644
--- a/examples/dsh-memory-plugin/README.md
+++ b/examples/dsh-memory-plugin/README.md
@@ -21,7 +21,7 @@ Or add the package to a profile directly:
```bash
dsh plugin --profile web add @openviking/dsh-memory-plugin
-dsh --profile web --dump-config # should list the openviking-memory group
+dsh --profile web --dump-config # should list openviking-memory-runtime
```
`dsh plugin` forwards to pnpm inside the profile directory, so the bundle has to
@@ -176,26 +176,18 @@ Common environment variables:
| `OPENVIKING_WORKSPACE_PEER` | Derive a peer from each DSH session workspace's git identity by default; `0` sends no peer |
| `OPENVIKING_RECALL_PEER_SCOPE` | `all` for cross-workspace recall or `actor` for isolation |
-The patch can also carry plugin config:
+The profile's `cordis.patch.yml` can also carry plugin config:
```yaml
-- insert:
- - id: openviking-memory
- name: '@deepseek-ai/cordis-plugin-group'
- group: true
- isolate:
- openvikingMemory: true
- config:
- - id: openviking-memory-runtime
- name: '@openviking/dsh-memory-plugin'
- config:
- endpoint: http://127.0.0.1:1933
- recallMaxTokens: 2000
- scoreThreshold: 0.35
- captureToolResults: false
- skipSubagentSessions: true
- commitTokenThreshold: 20000
- mcpToolCallTimeoutMs: 60000
+- id: openviking-memory-runtime
+ config:
+ endpoint: http://127.0.0.1:1933
+ recallMaxTokens: 2000
+ scoreThreshold: 0.35
+ captureToolResults: false
+ skipSubagentSessions: true
+ commitTokenThreshold: 20000
+ mcpToolCallTimeoutMs: 60000
```
Recall normally uses `POST /api/v1/search/search` with `mode: "context"`.
diff --git a/examples/dsh-memory-plugin/bundle.test.mjs b/examples/dsh-memory-plugin/bundle.test.mjs
index 16e932e6f..8e97f9406 100644
--- a/examples/dsh-memory-plugin/bundle.test.mjs
+++ b/examples/dsh-memory-plugin/bundle.test.mjs
@@ -10,7 +10,7 @@ const PLUGIN_DIR = dirname(fileURLToPath(import.meta.url));
const FORBIDDEN_IDENTIFIER = ["tra", "ex"].join("");
const FORBIDDEN_PATTERN = new RegExp(FORBIDDEN_IDENTIFIER, "i");
-test("bundle uses neutral DSH naming, bounded peers, and an isolated service", async () => {
+test("bundle uses neutral DSH naming and bounded peers", async () => {
const manifest = JSON.parse(await readFile(
new URL("./package.json", import.meta.url),
"utf8",
@@ -38,9 +38,11 @@ test("bundle uses neutral DSH naming, bounded peers, and an isolated service", a
);
}
assert.equal(manifest.dsh.bundle.patch, "./cordis.patch.yml");
- assert.match(patch, /name: '@deepseek-ai\/cordis-plugin-group'/);
- assert.match(patch, /openvikingMemory: true/);
- assert.match(patch, /name: '@openviking\/dsh-memory-plugin'/);
+ assert.doesNotMatch(patch, /group:/);
+ assert.match(
+ patch,
+ /- id: openviking-memory-runtime\n\s+name: '@openviking\/dsh-memory-plugin'/,
+ );
assert.doesNotMatch(JSON.stringify(manifest), FORBIDDEN_PATTERN);
assert.doesNotMatch(patch, FORBIDDEN_PATTERN);
});
diff --git a/examples/dsh-memory-plugin/config.mjs b/examples/dsh-memory-plugin/config.mjs
index 0af9ea766..c5b473d30 100644
--- a/examples/dsh-memory-plugin/config.mjs
+++ b/examples/dsh-memory-plugin/config.mjs
@@ -1,7 +1,7 @@
import { buildPluginConfig } from "./shared/plugin-config.mjs";
import { loadCredentialFiles } from "./shared/credentials.mjs";
-export const PLUGIN_VERSION = "0.5.7";
+export const PLUGIN_VERSION = "0.5.8";
/**
* Namespace for the bridged OpenViking MCP tools. DSH publishes every MCP tool
diff --git a/examples/dsh-memory-plugin/cordis.patch.yml b/examples/dsh-memory-plugin/cordis.patch.yml
index b5d5a8f48..7ee924015 100644
--- a/examples/dsh-memory-plugin/cordis.patch.yml
+++ b/examples/dsh-memory-plugin/cordis.patch.yml
@@ -1,9 +1,3 @@
- insert:
- - id: openviking-memory
- name: '@deepseek-ai/cordis-plugin-group'
- group: true
- isolate:
- openvikingMemory: true
- config:
- - id: openviking-memory-runtime
- name: '@openviking/dsh-memory-plugin'
+ - id: openviking-memory-runtime
+ name: '@openviking/dsh-memory-plugin'
diff --git a/examples/dsh-memory-plugin/package-lock.json b/examples/dsh-memory-plugin/package-lock.json
index 9029a8337..e699f283c 100644
--- a/examples/dsh-memory-plugin/package-lock.json
+++ b/examples/dsh-memory-plugin/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@openviking/dsh-memory-plugin",
- "version": "0.5.7",
+ "version": "0.5.8",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@openviking/dsh-memory-plugin",
- "version": "0.5.7",
+ "version": "0.5.8",
"license": "Apache-2.0",
"devDependencies": {
"@deepseek-ai/dsh-llm": "0.1.0-rc.6",
diff --git a/examples/dsh-memory-plugin/package.json b/examples/dsh-memory-plugin/package.json
index dfbda604b..befba8197 100644
--- a/examples/dsh-memory-plugin/package.json
+++ b/examples/dsh-memory-plugin/package.json
@@ -1,6 +1,6 @@
{
"name": "@openviking/dsh-memory-plugin",
- "version": "0.5.7",
+ "version": "0.5.8",
"description": "OpenViking memory and context bundle for DeepSeek Harness",
"icon": "./icon.svg",
"type": "module",
diff --git a/examples/memory-plugin-shared/install.sh b/examples/memory-plugin-shared/install.sh
index 2ef904766..45c995852 100644
--- a/examples/memory-plugin-shared/install.sh
+++ b/examples/memory-plugin-shared/install.sh
@@ -2758,10 +2758,10 @@ EOF
warn "dsh: $DSH_PACKAGE $(t 'not found in profile' '未在 profile 中找到') $dsh_profile"
ok=0
fi
- if dsh --profile "$dsh_profile" --dump-config 2>/dev/null | grep -q 'openviking-memory'; then
- info "dsh: $(t 'plugin group composed into the profile' '插件组已合入 profile')"
+ if dsh --profile "$dsh_profile" --dump-config 2>/dev/null | grep -q 'openviking-memory-runtime'; then
+ info "dsh: $(t 'plugin composed into the profile' '插件已合入 profile')"
else
- warn "dsh: $(t 'plugin group not present in the composed profile' '合成后的 profile 中没有插件组')"
+ warn "dsh: $(t 'plugin not present in the composed profile' '合成后的 profile 中没有该插件')"
ok=0
fi
fi