dsh-deepbrain
Bring DeepBrain (深脑) into DeepSeek Harness.
DeepBrain does not store documents — it stores judgments: conclusions distilled from
recordings of meetings, interviews and lectures, each with an evidence chain back to what was
actually said, and corroborated across separate occasions. With this plugin your DSH agent can
read those judgments, quote verbatim-verified lines under someone's name, look up a person's
historical positions, and borrow DeepBrain's analysis methods for material of its own.
Requires a DeepBrain account and API key. DeepBrain: https://shennao.zaowuyun.com
The product UI and returned content are in Chinese.
Install
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:qiuyiwu1989-star/dsh-deepbrain
Build output ships in the repository, so no dependency build scripts need to be allowed.
Restart the profile afterwards.
Then set your key (generate one under Settings → API keys; it looks like lj_live_…):
export DEEPBRAIN_API_KEY=lj_live_xxx
Prefer the environment variable over putting it in config: profile config is printed verbatim
by dsh --dump-config, so a key written there ends up in logs and screenshots.
Six tools
The server currently exposes 27 MCP tools. This plugin registers 6 — a client's job is not to
mirror the server, it is to present the right shape. Hand a model 27 tool names and its default
strategy becomes "use whichever returns the most", which means going straight for raw transcripts
and blowing up its own context.
| Tool | When to use it |
|---|
deepbrain_brief | First step when you don't know what to ask. Describe your situation; DeepBrain decides what you should know |
deepbrain_topics | Browse the index, or pull one topic's digest. Most writing and analysis stops here |
deepbrain_quotes | Quotes you can attribute — every one verified word-for-word against the transcript |
deepbrain_person | The roster, or one person's history of positions. Run it before a negotiation or a meeting |
deepbrain_ask | Ask a specific question, get a sourced answer. Slow questions are awaited automatically |
deepbrain_call | Escape hatch. Call any DeepBrain MCP tool directly, for what the five above don't cover |
Leaving tool empty on deepbrain_call lists every tool the current key is allowed to call.
Configuration
- insert:
- id: deepbrain
name: 'dsh-deepbrain'
config:
endpoint: 'https://shennao.zaowuyun.com/api/mcp' # self-hosted? change this
apiKey: '' # empty → read DEEPBRAIN_API_KEY
timeoutMs: 120000 # multi-step retrieval can take a while
passthrough: true # false = don't register deepbrain_call
Scopes
DeepBrain API keys are scoped, and the server trims the callable tool set accordingly:
brain.ask — judgments, quotes, people, method library. Most usage needs only thistranscript.read / transcript.write — fetch raw transcripts, feed new ones inbrain.propose — write judgments back (they land in an inbox and require human review)
When a scope is missing the tool tells the model plainly that retrying will not help and a
different key is needed, rather than reporting a generic failure.
What it does not do
- No caching. Every call is live. Judgments get superseded and expire; a cache would serve
stale conclusions as current ones.
- No writes unless you explicitly call a write tool through
deepbrain_call, which requires
brain.propose.
- No web UI. Host-only plugin: it contributes tools, registers no slots, ships no client bundle.
Known boundary
@deepseek-ai/dsh-tools is a real dependency here (installed with the plugin), but it declares
@deepseek-ai/cordis as its own peer. In a clean profile without auto-install-peers, cordis
will not be installed — this is upstream of this plugin and affects any third-party plugin that
uses dsh-tools.
Normally the harness supplies cordis (it is a dependency of dsh itself). If you hit
Cannot find package '@deepseek-ai/cordis', run this in the profile:
pnpm config set auto-install-peers true
This plugin deliberately does not depend on its own copy of cordis — cordis is the DI
container, and duplicating it splits Context/Service identity, which is far worse than a missing
dependency.
Development
See CONTRIBUTING.md.
MIT
