How to use this reference
- Use the page search in your browser to find a term quickly.
- Read the professional definition when you need accuracy.
- Read the everyday explanation when the definition still feels abstract.
- Return to the linked guide before changing permissions, installing an extension, or publishing a package.
Model, Agent, and Harness
| Concept | Professional explanation | Everyday example |
|---|---|---|
| AI model | A statistical system that interprets input and generates text, code, or other output. It does not receive computer access by itself. | Everyday explanation: the model is the person reasoning at a desk. The desk, tools, keys, and records come from other parts of the system. |
| Agent | A running role that combines a model with instructions, context, tools, and a loop that can take several steps toward a goal. | Everyday explanation: instead of answering once, the worker can inspect, act, check the result, and continue until the assigned task is done. |
| Agent Harness | Software that coordinates the model, tools, context, permissions, sessions, and interface used for Agent work. | Everyday explanation: it is the managed workshop around the worker. It decides which tools are present, which doors are locked, and what is written in the logbook. |
| Provider | A service or adapter that makes a model available to the Harness and handles its request format and authentication method. | Everyday explanation: different electricity suppliers can power the same workshop, but each has its own account and connection rules. |
| Tool | A named capability the Agent can request, such as reading a file, editing text, running a command, or searching a source. | Everyday explanation: a tool is an item in the workshop cabinet. Having it listed does not always mean it may be used without approval. |
| Context | The information made available for the current model request, including instructions, selected history, files, and tool results. | Everyday explanation: it is the set of documents open on the desk for this decision. It is not automatically a permanent memory of everything that ever happened. |
How work is organized
| Concept | Professional explanation | Everyday example |
|---|---|---|
| Workspace | The selected project location whose files and commands form the main boundary of a task. | Everyday explanation: it is the specific room handed to the worker, not permission to enter the entire building. |
| Session | A durable record of messages, model output, tool activity, and state for one continuing line of work. | Everyday explanation: it is the project logbook that lets you return later and understand what was discussed and done. |
| Turn | The complete response cycle triggered by one admitted user input, possibly containing several model and tool steps. | Everyday explanation: one request at the service desk may require several internal actions before the final answer is ready. |
| Step | One model request and the tool calls that follow from it inside a turn. | Everyday explanation: it is one item on the worker's checklist, while the whole turn is the completed request. |
| Plugin | A loadable software unit that contributes services, events, tools, interface parts, or other behavior to the Harness. | Everyday explanation: it is an approved module added to the workshop, such as a new machine or control panel. |
| Profile | A named composition that determines which bundles, plugins, and configuration layers start together. | Everyday explanation: it is a saved workshop setup for a particular kind of job. DeepSeek Harness ships web and headless templates. |
| Skill | A reusable set of instructions and supporting resources that teaches an Agent how to carry out a bounded workflow. | Everyday explanation: it is a reviewed procedure card. It guides the worker, but it does not silently grant new computer permissions. |
| Runtime | The actual software process, dependency versions, configuration, and operating environment in which a task runs. | Everyday explanation: a recipe can be identical while the real kitchen differs. Verification must happen in the kitchen that will actually be used. |
| Diff | A structured comparison that shows how files or text differ between two states without applying either state by itself. | Everyday explanation: it is a before-and-after sheet with changed lines highlighted. Reading it does not accept the changes. |
| Hook | A configured trigger that runs a defined action before, after, or during a named event in a tool or workflow. | Everyday explanation: it is a doorbell wired to a specific response. Because the response can run code, review its source and permissions. |
| MCP | Model Context Protocol, a standard way for an Agent or Harness to connect to external tools and data through an MCP server. | Everyday explanation: it is a standard connector between the workbench and another service. A matching plug does not make the service trusted. |
| Cloud | A remote execution environment hosted outside the local computer, with its own files, credentials, network, persistence, and billing boundaries. | Everyday explanation: it is a rented workspace in another building. Check its keys, storage, costs, and cleanup rules before sending work there. |
Permissions and safety
| Concept | Professional explanation | Everyday example |
|---|---|---|
| Permission | A rule describing which action is allowed, denied, or subject to a decision at runtime. | Everyday explanation: it is the access list on a door. A sentence asking someone to be careful is not an access rule. |
| Approval | A human or policy decision requested before a particular action is allowed to continue. | Everyday explanation: the worker pauses at a locked cabinet and asks before taking the key. |
| Sandbox | A technical boundary that restricts selected effects of a process. Its exact coverage depends on the platform and configuration. | Everyday explanation: it is a fenced work area. You must still check whether the fence covers files, network access, processes, or only part of them. |
| Credential | A secret or identity token used to authenticate with a model provider, service, repository, or other protected system. | Everyday explanation: it is a key or bank card. Store it in the designated settings or secret store, never in chat text or project files. |
| Least privilege | The practice of granting only the access needed for the current task and only for as long as it is needed. | Everyday explanation: give a visitor the key to the meeting room, not a master key for the whole building. |
| Rollback | A prepared operation that restores the previously verified state after a change fails or is no longer wanted. | Everyday explanation: keep the previous working version and clear return instructions before replacing anything. |
Appearance and interface
| Concept | Professional explanation | Everyday example |
|---|---|---|
| Semantic token | A named design value whose name describes a purpose, such as background or accent, instead of a fixed color. | Everyday explanation: it is a label such as wall paint or warning light. Each theme can supply a different color for the same job. |
| Theme | A coordinated set of semantic appearance values, usually covering light and dark modes without changing the product structure. | Everyday explanation: it changes the room's paint and lighting plan while leaving the walls and furniture in place. |
| Full Skin | A DSH Themes publication class that combines semantic values with controlled imagery and generated styling under stricter evidence rules. | Everyday explanation: it changes paint, lighting, and selected decoration. It is a DSH Themes format, not an official native DeepSeek Harness format. |
| UI Extension | An extension that changes or adds an interface workflow rather than only supplying appearance values. | Everyday explanation: it adds a new control panel or working station, so its behavior and permissions matter as much as its appearance. |
| Transport | The connection that carries requests, events, and state between the Web interface and the running Harness process. | Everyday explanation: it is the delivery route between the control room and the workshop. A visible page does not prove that the route is connected. |
Packages and verification
| Concept | Professional explanation | Everyday example |
|---|---|---|
| Package | A versioned distribution unit containing code, metadata, resources, or configuration intended to be installed together. | Everyday explanation: it is a sealed product box. The name on the shelf is not enough to prove what is inside this exact box. |
| Artifact | The exact built file that is downloaded, installed, tested, or published, such as a specific package archive. | Everyday explanation: it is the physical box that arrived, not the product description in the catalog. |
| SHA-256 | A cryptographic digest used as a stable fingerprint for the complete bytes of an artifact. | Everyday explanation: matching fingerprints show that two files have the same bytes. They do not prove that the contents are safe or properly licensed. |
| Sidecar | A separate machine-readable record stored beside an artifact to describe its identity, compatibility, hashes, or evidence references. | Everyday explanation: it is the inspection card attached to the box. Both the card and the box must match. |
| Attestation | A signed or controlled record stating what was checked, in which environment, against which exact inputs, and with what result. | Everyday explanation: it is a dated inspection report. A report for another model or version cannot certify the item in front of you. |
| Certified baseline | The exact Harness version and evidence set against which an item has completed the required verification workflow. | Everyday explanation: current upstream software may be newer than the version that has finished inspection. Newer and certified are different facts. |
What to do when a term is still unclear
- 01
Find the exact term
Copy the word as written, including its product name when one is present.
- 02
Identify the layer
Ask whether it describes intelligence, organization, permissions, interface, or verification.
- 03
Check the product-specific meaning
The same word can have a narrower meaning in DeepSeek Harness, Pi, Codex, or another tool.
- 04
Pause before a risky action
If the term affects access, credentials, installation, or deletion, read the linked guide or official source before continuing.
Continue from the concept you found
Read the primary documentation
DeepSeek Harness v0.1.1-rc.2 releaseConfirm the upstream release tag and source commit used by this guide.DeepSeek Harness RC.2 READMERead the pinned product definition, developer-preview boundary, and Web UI launch path.DeepSeek Harness RC.2 architectureReview the pinned plugin, profile, bundle, tool, and session model.DeepSeek Harness RC.2 Web UI guideReview the pinned model setup, workspace selection, first task, and approval behavior.DeepSeek Harness permission presetsSee how sandbox mode and approval policy are combined and where enforcement lives.DeepSeek Harness Skills subsystemReview discovery, providers, identity, loading, and invocation boundaries.
Common questions
Before you make a change
Answers about formats, compatibility, evidence, and rollback.
What does this guide verify?
This guide covers: DeepSeek Harness rc.2 architecture and Web UI vocabulary; DSH Themes publication and appearance vocabulary; Professional definitions paired with short everyday explanations
What should I do first?
You do not need to memorize these terms. Find the word that stopped you, read the precise definition first, then use the everyday explanation to connect it to something familiar.
Which boundary matters most?
An analogy is a shortcut for understanding. It does not replace the exact product behavior, especially for permissions, sandboxing, credentials, and compatibility.
Continue learning
Continue from the verified evidence
Compare published artifacts or return to the installation documentation.