dsh-engram-session
DSH 插件 dsh-engram-session
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xiuyuan18/dsh-engram-session#739249257d58aff1c0705f640ed577c75544803cDSH 插件 dsh-engram-session
Engram Session 以 dsh-engram-session 发布，当前版本为 0.4.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Per-session Engram memory for DeepSeek Harness — a standalone bundle project reusable across profiles and presets.
This package is a bundle: its dsh.bundle.patch (cordis.patch.yml) is the composition layer that inserts the plugin row; the plugin then registers the Engram Memory Protocol as its own system-prompt section (engram:memory-protocol, order 10) at load — the deployment persona is never touched. Installing it into any profile is one command:
# from anywhere; <path> may be absolute or relative to your invoking directory
dsh plugin --profile web add /home/xiuyuaned/dsh-plugins/dsh-engram-session
dsh plugin runs pnpm add and reconciles dsh.profile.bundles — a dsh.bundle-declaring package joins the layer stack automatically. The bundle owns everything (plugin row + protocol section), so removing or disabling it leaves zero side effects (no tools, no orphaned memory instructions).
Install dependencies once (self-contained — the project carries its own node_modules):
cd /home/xiuyuaned/dsh-plugins/dsh-engram-session && pnpm install
Add the bundle to the profile (repeat per profile):
dsh plugin --profile <name> add /home/xiuyuaned/dsh-plugins/dsh-engram-session
Restart the profile's app. A preset can also list the bundle directly in its
dsh.profile.bundles plus a link: dependency in its package.json.
Removing is symmetric: dsh plugin --profile <name> remove dsh-engram-session.
Reinstall at any time with the add command — the source lives outside the
profile, so removing the bundle never deletes it.
One engram mcp stdio child per agent session, spawned with cwd = session.header.cwd (the session's workspace), with the mem_* tools registered in that agent's own scope via agent.ctx.tools.register(). Scoped registration shadows the global tool layer, so concurrent sessions each see their own memory surface under the same mcp__engram__mem_* names without collisions.
Rooting the child at the session workspace makes Engram's project auto-detection (git root / .engram/config.json) deterministic per session — the documented fix for hosts whose MCP child cannot inherit a reliable cwd (DSH web GUI, VS Code, WSL, CI). No --project pinning needed.
The model-facing tool specs are locally corrected: engram's shipped scope parameter descriptions omit global, so the plugin rewrites them (description text only — names, types, and required flags are untouched) in the registered definitions, keeping the agent's tool contract accurate without waiting for an upstream release.
| Field | Default | Description |
|---|---|---|
serverName | engram | Namespace for model-facing tool names |
binary | (auto-detected) | Engram executable; see Binary resolution |
args | ['mcp'] | Arguments for the MCP stdio server |
toolCallTimeoutMs | 60000 | Per tools/call timeout |
No machine-specific path is baked in. With binary unset, the plugin picks
the first executable it finds: PATH lookup, then ~/.local/bin/engram,
/usr/local/bin/engram, /opt/homebrew/bin/engram. If nothing is found it
logs a warning and mounts without memory tools — the protocol section is
skipped too, so agents are never told about tools that cannot exist.
Set binary in the profile config (an absolute path, or a bare command name)
to override detection. A set-but-missing value logs a warning and falls back
to detection, so profiles created by pre-0.4 bundles that pinned
/home/xiuyuaned/.local/bin/engram self-heal on other machines.
agent/created (and a scan of already-live agents at mount) → spawn + registeragent/disposed → unregister tools, close client (kills the child)dispose → same teardown for every live entryindex.js — the plugin: per-agent Engram MCP child + scoped mem_* tool registrationcordis.patch.yml — the bundle composition layer (plugin row)AGENTS.md — guidance for AI agents working on this projectpackage.json / pnpm-lock.yaml — ESM manifest and lockfileSee AGENTS.md for architecture details, conventions,
verification steps, and pitfalls. Quick checks:
node --check index.js