English · 简体中文 · 日本語 · 한국어 · Español
The agent-first, multilingual field guide to understanding, running, debugging, and extending DeepSeek Harness.
If this handbook saves you time, star the repository and watch releases. That signal helps more Agent builders find source-backed DeepSeek Harness guidance.
Check the rc.6 field status · Route a failure in 30 seconds · Get started in five minutes · Contribute
Live operator site: Browse the visual field guides · Subscribe to new guides
DeepSeek Harness is more than a model wrapper. It is a composable agent runtime that connects model providers, tools, approval, sandboxing, durable sessions, subagents, and user interfaces through a plugin graph. This independent handbook explains those systems from the perspective of people building and operating agents.
The project is maintained by SandBase. It is not an official DeepSeek AI project.
Important
DeepSeek Harness is in developer preview and may introduce compatibility-breaking changes. Pages in this handbook name their verification date and link to primary sources. Pin the revision you deploy.
| I want to… | Start here |
|---|---|
| Check current rc.6 boundaries and safer next actions | DeepSeek Harness rc.6 Field Status |
| Capture the package and source revision that actually ran | DeepSeek Harness Version Evidence |
| Find the first broken runtime boundary | Interactive Failure Router |
| Keep the essential commands and checks in one tab | DeepSeek Harness cheat sheet |
| Choose the right official runnable example | Official examples map |
| Understand what DeepSeek Harness actually is | DeepSeek Harness explained |
| Run the Web UI safely | Five-minute quickstart |
| Use it from Python | Python SDK quickstart |
| Run one task in automation or CI | Headless Agent guide |
| Configure DeepSeek or another provider | Model provider guide |
| Fix a context-window or token-budget error | Context window exceeded guide |
| Connect external MCP tools | MCP integration guide |
| Add reusable Agent instructions | Skills guide |
| Delegate work to child Agents | Subagents guide |
| Understand the runtime | The agent-runtime mental model |
| Understand one complete turn | Agent Loop and Session Events |
| Choose between Session persistence and long-term memory | Sessions are not long-term memory |
| Understand approval, guards, and tool effects | Tool execution pipeline |
| Build an Agent rather than a loose collection of tools | Agent design map |
| Research a repository without publishing changes | Repository Research Agent recipe |
| Run or debug DeepSeek Harness on Windows | Windows compatibility guide |
| Recover a profile after a plugin change | Plugin install and recovery guide |
Diagnose an ERR_HTTP2_INVALID_SESSION crash |
HTTP/2 provider-transport troubleshooting |
Fix an empty remote Web UI or crypto.randomUUID error |
Remote Web secure-context guide |
| Fix persistent Bash on NixOS or minimal Linux | PTY shell-path guide |
| Protect or recover a session log | Live session log durability |
| Fix a failing installation or run | Troubleshooting index |
| Track upstream changes | Updates and breaking changes |
flowchart LR
U[User goal] --> A[Agent contract]
A --> C[Profile + Bundles + Patches]
C --> G[Cordis plugin graph]
G --> L[Agent Loop]
L --> M[Model provider]
L --> T[Tools + policy + approval + sandbox]
L --> S[Durable Session events]
S --> L
S --> H[Web, headless, SDK, clients]
An agent is not just a prompt. A useful Agent has a task boundary, allowed effects, completion condition, model route, tool surface, permission policy, session strategy, failure behavior, and an operator-visible result. DeepSeek Harness supplies the runtime vocabulary for assembling those responsibilities without forcing every product into one fixed loop or interface.
- Agent-first: concepts are organized around building, running, and debugging Agents.
- Source-backed: version-sensitive claims link to official documentation or source.
- Operational: every tutorial includes success evidence, failure branches, and safety boundaries.
- Visual: architecture pages prioritize diagrams over walls of text.
- Living: updates, breaking changes, and troubleshooting pages follow upstream development.
- Multilingual by design: translations declare their canonical source revision and review status.
Every item below is available now. Planned coverage lives in the public roadmap.
- What is DeepSeek Harness?
- Five-minute Web UI quickstart
- Python SDK quickstart
- Headless Agent and CI
- Configure model providers
- The agent-runtime mental model
- Agent Loop and Session Events
- Sessions are not long-term memory
- Tool execution pipeline
- Designing an Agent
- Skills: discovery, precedence, and invocation
- Subagents: providers, delegation, and continuation
- Choose the right upstream example
- Headless CLI task runner
- Python SDK and JSON-RPC runtime
- ACP automation server
- MCP memory overlays
- Self-modifying Cordis composition
- Session-local schedules
- DeepSeek Harness rc.6 Field Status
- DeepSeek Harness Version Evidence
- Interactive Failure Router
- DeepSeek Harness cheat sheet
- Troubleshooting index
- MCP server not connecting
ERR_HTTP2_INVALID_SESSIONprovider-transport crashes- Sandbox denial versus sandbox unavailable
- Windows compatibility and troubleshooting
- Plugin installation and known-good recovery
- Remote Web UI, HTTPS, and
crypto.randomUUID - PTY shell path on NixOS and minimal Linux
- Protect and recover live session logs
- Fix context window exceeded errors
- Updates and breaking changes
docs/<locale>/
getting-started/ installation and first runs
architecture/ runtime and lifecycle explanations
agent-patterns/ design decisions for real agents
recipes/ reproducible agent builds
troubleshooting/ symptom-driven diagnostic pages
ecosystem/ plugins, tools, skills, and comparisons
updates/ upstream change coverage
scripts/ content and translation verification
content-manifest.json canonical revision and locale status
DeepSeek Harness remains the subject of every technical page. SandBase maintains the handbook and may provide a restrained link to related Agent, model, Skill, or MCP discovery resources. A mention is never presented as an official DeepSeek recommendation, a compatibility guarantee, or a security endorsement.
Corrections, reproducible examples, diagrams, troubleshooting cases, upstream change notes, and fluent translation reviews are welcome. Read CONTRIBUTING.md and run npm run check before submitting a pull request.
New here? Choose a scoped task from the public roadmap, or open a documentation request. Reproducible evidence is more valuable than a large patch.
- DeepSeek Harness official repository
- Official architecture documentation
- Official Agent lifecycle
- Official capability seams
- Official tool execution pipeline
- Official user guides
Apache-2.0. See LICENSE.