dsh-opencontext
将 DSH 代理连接到 OpenContext，以提供持久记忆和检索增强上下文的 DeepSeek Harness 插件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-opencontext@0.3.2Opencontext 以 dsh-opencontext 发布，当前版本为 0.3.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness plugin that gives any DSH agent durable memory +
retrieval-augmented context by plugging into
@melandlabs/opencontext.
dsh-opencontext^22.19.0 || >=24.0.0oc_*opencontext/oc doctor# Install directly from npm
dsh plugin --profile web add dsh-opencontext
# Confirm it's mounted
dsh --profile web --dump-config | grep dsh-opencontext
# ... should contain `id: dsh-opencontext`
# Start DSH web and verify
dsh web
# Visit http://127.0.0.1:3080/plugins and confirm dsh-opencontext shows "Enabled"
# 1. Clone the repo and navigate to the plugin directory
cd /path/to/opencontext/plugins/dsh-opencontext
# 2. Build the plugin (emits lib/)
pnpm install
pnpm build
# 3. Register it with your DSH
dsh plugin --profile web add /path/to/opencontext/plugins/dsh-opencontext
# 4. Confirm it's mounted
dsh --profile web --dump-config | grep dsh-opencontext
# ... should contain `id: dsh-opencontext`
# 5. Start DSH web and verify
dsh web
# Visit http://127.0.0.1:3080/plugins and confirm dsh-opencontext shows "Enabled"
| Tool | Purpose |
|---|---|
oc_search | Search long-term memory (unified across memory + insights + knowledge). |
oc_remember | Persist one durable memory when the user explicitly asks. |
oc_memory_list | List recent memory entries in the current scope. |
oc_memory_get | Read one or more entries by id. |
oc_memory_revise | Soft-deprecate an entry and store a successor. |
oc_memory_retire | Soft-deprecate an entry. |
oc_prepare_context | Manually build a bounded <opencontext_evidence> block. |
oc_capture_source | Capture an arbitrary content source for later retrieval. |
| Tool | Purpose |
|---|---|
oc_session_summary | Generate and store a session summary at natural breakpoints. |
oc_task_outcome | Record task outcomes, decisions, and achievements. |
oc_recent_summaries | List recent session summaries and task outcomes. |
| Tool | Purpose |
|---|---|
oc_insights_search | Search structured insights (decisions, preferences, outcomes). |
oc_insight_capture | Capture a structured insight from conversation. |
| Tool | Purpose |
|---|---|
oc_knowledge_search | RAG search over uploaded documents. |
oc_document_upload | Upload documents to the knowledge base. |
oc_document_list | List all documents in the knowledge base. |
All tools return { ok: true, value } on success and
{ ok: false, error: { code, message } } on failure — they never throw to
the model.
Every agent/pre-step event runs a recall waterfall:
backend.search({ query, limit: maxRecallItems, ... }) with a
requestTimeoutMs-bounded timeout.<opencontext_evidence> block, byte-capped
to maxBytes (default 8000).A second agent/pre-step listener runs after recall and writes each
user message into the memory store under sourceType: "user_input".
Gated by config.capturePrompts (default true; set
OPENCONTEXT_DSH_CAPTURE_PROMPTS=0 to disable). Fire-and-forget by
default so the turn is not blocked; opt into flushOnCapture: true if
you need strict ordering.
When autoSummarize is enabled, a turn/end listener:
turn-summary memorycaptureToolOutcomes is enabledWhen captureToolResults is enabled, a tool/result listener captures
tool call results as tool-interaction memories, creating a searchable
log of all tool interactions.
opencontextLoaded at plugin-apply time. Primes the model on the recall / capture
contract, the trust model, and all available oc_* tools.
/oc doctorPrints a JSON status payload:
{
"ok": true,
"plugin": "dsh-opencontext",
"backend": "lib",
"scope": "local:9cd22c419df9",
"db": "/Users/you/.opencontext/memory/store.db",
"probe": { "ok": true, "mode": "lib", "details": "db=/Users/you/.opencontext/memory/store.db" },
"recentCount": 0,
"features": ["insights", "knowledge", "prompt-capture"]
}
Resolved in this order (highest first):
cordis.patch.yml row under id: dsh-opencontextOPENCONTEXT_DSH_* environment variablesConfigSchema| Field | Type | Default | Env var |
|---|---|---|---|
baseUrl | string | http://127.0.0.1:8000 | OPENCONTEXT_DSH_BASE_URL |
authorization | string | "" | OPENCONTEXT_DSH_AUTHORIZATION |
scopeId | string | "" (auto) | OPENCONTEXT_DSH_SCOPE_ID |
timeoutMs | number | 4000 | OPENCONTEXT_DSH_TIMEOUT_MS |
requestTimeoutMs | number | 1000 | OPENCONTEXT_DSH_REQUEST_TIMEOUT |
maxBytes | number | 8000 | OPENCONTEXT_DSH_MAX_BYTES |
capturePrompts | bool | true | OPENCONTEXT_DSH_CAPTURE_PROMPTS (1/0) |
flushOnCapture | bool | false | OPENCONTEXT_DSH_FLUSH_ON_CAPTURE (1/0) |
maxRecallItems | number | 8 | OPENCONTEXT_DSH_MAX_RECALL_ITEMS |
autoSummarize | bool | false | OPENCONTEXT_DSH_AUTO_SUMMARIZE (1/0) |
captureToolResults | bool | false | OPENCONTEXT_DSH_CAPTURE_TOOL_RESULTS (1/0) |
enableInsights | bool | true | OPENCONTEXT_DSH_ENABLE_INSIGHTS (1/0) |
enableKnowledge | bool | true | (/) |
Presence-only switch:
OPENCONTEXT_DSH_HTTP_URL — flip to HTTP mode (any non-empty value).The <opencontext_evidence> block surfaced by the recall waterfall is
host-supplied context, not instructions. It is explicitly framed as
untrusted historical evidence; if it ever contradicts the user, the
user wins. The block is never placed in the system-prompt role — it is
appended as a plugin-sourced user message, so the model can ignore it
without breaking the system contract.
pnpm install
pnpm typecheck
pnpm test # 59 unit tests
pnpm build # tsc → lib/
┌──────────────────────────────────────────────────────────────────────────┐
│ DSH Agent │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ agent/pre-step pipeline │ │
│ │ ┌───────────────────────────┐ ┌───────────────────────────┐ │ │
│ │ │ Recall │ │ Capture │ │ │
│ │ │ (search history) │ │ (store user input) │ │ │
│ │ └───────────────────────────┘ └───────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ v │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ turn/end & tool/result listeners │ │
│ │ ┌───────────────────────────┐ ┌───────────────────────────┐ │ │
│ │ │ Session Summ. │ │ Tool Capture │ │ │
│ │ │ (session summary) │ │ (tool output capture) │ │ │
│ │ └───────────────────────────┘ └───────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ v │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ dsh-opencontext plugin (16 tools) │ │
│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
│ │ │ Core │ │ Summary │ │ Insights │ │ Knowledge │ │ │
│ │ │ (8) │ │ (3) │ │ (2) │ │ (3) │ │ │
│ │ └───────────┘ └───────────┘ └───────────┘ └───────────┘ │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ v │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ OpenContext Backend │ │
│ │ ┌───────────────────────────┐ ┌───────────────────────────┐ │ │
│ │ │ Lib Mode │ │ HTTP Mode │ │ │
│ │ │ (in-process) │ │ (daemon) │ │ │
│ │ └───────────────────────────┘ └───────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────────┘
Apache-2.0. See LICENSE.
OPENCONTEXT_DSH_ENABLE_KNOWLEDGE10