README.md

Understand the runtime layer that turns a model into a working agent.

Start reading · Continuous reader · Download PDF · Official sources

See the ideas before the implementation details

DeepSeek Harness is more than a model wrapper. It composes the model adapter, tool registry, session log, agent loop, permissions, and product entry points as replaceable runtime capabilities. This handbook turns those relationships into a visual learning path instead of duplicating the official documentation as another wall of text.

Choose a chapter

01 · The Missing Layer Around the Model 8 pages	02 · Your First Safe Harness Task 10 pages
03 · Everything Is a Plugin 11 pages	04 · Capability Seams 9 pages
05 · Memory Is an Event Log 9 pages	06 · Inside the Agent Loop 12 pages
07 · Profiles, Presets, and Permissions 11 pages	08 · Subagents and Portable Execution Worlds 11 pages
09 · Introspection, Runtime Extensions, and Compaction 11 pages	10 · From Demo to Production 11 pages

Pick a reading path

If you want to...	Read
Understand why a model is not yet an agent	Chapters 1–2
Build plugins and replace runtime capabilities	Chapters 3–4, then 9
Design memory, execution, and governance	Chapters 5–8
Move from a demo toward production	Chapter 10

Source-locked by design

The reference PDFs that inspired the presentation were used only to study visual storytelling. Technical content comes from the official DeepSeek Harness repository at one immutable commit.

• Chapter-by-chapter official source map
• Locked upstream commit
• Asset and edition manifest
• Independence, accuracy, and third-party notices

Source drift should produce a new handbook edition, not a silent rewrite of this one.

Formats

Format	Use	Distribution
WebP	Fast GitHub reading	Versioned in this repository
PDF	Complete offline handbook with chapter bookmarks	GitHub Releases
PNG	Original-resolution master pages	Maintained outside Git history

The 103 GitHub reading images total about 16 MiB. The PDF is kept out of Git history so clones stay small.

Corrections and contributions

Found a technical, text, source, or visual problem? Open a correction issue and include the chapter, page, proposed correction, exact locked upstream source, and verification date. See CONTRIBUTING.md.

This project welcomes precise corrections and source-drift reports. It does not accept third-party characters, logos, or visual assets without a compatible license.

License and acknowledgements

Original handbook text and visual material owned by this project are licensed under CC BY-SA 4.0. Third-party names, trademarks, and referenced visual elements are excluded from that grant; see DISCLAIMER.md.

DeepSeek Harness is maintained by DeepSeek and released under its own MIT license. README design methodology was informed by beautify-github-readme.

_{Maintained by BeatAPI · beatapi.io — async AI video APIs for music videos and product ads.}