Tianyi Cui
3dfb16008d
Code already treats $DSH_HOME/.env as ordinary launch environment and stores managed credentials in .credentials.yaml, but public docs still described the old store, old precedence, removed literal adapter keys, and the deleted TUI. That directed users to the wrong file and overstated the supported configuration surface. Update the existing English and Chinese owners in place, document inherited > managed > project > user credential resolution, and record the loadLayeredEnv export. Regenerate only pairing records and the source-line catalog; add no new section or site route.
1.7 KiB
1.7 KiB
Introduction
English | 中文
DeepSeek Harness is a plugin-based agent development framework built on the Cordis microkernel. Its central idea is simple: everything is a plugin.
What it is
Harness implements every capability an AI agent needs—including LLM calls, tool execution, session management, and subtask delegation—as a composable plugin. A cordis.yml file declares which plugins to load and how to configure them, assembling a complete agent.
# Select the LLM backend
- name: '@deepseek-ai/dsh-llm-deepseek'
# Select the one-shot application
- id: cli-agent
name: '@deepseek-ai/dsh-cli-demo'
config:
provider: deepseek-official
model: deepseek-v4-flash
workspaceContext: false
Who it is for
Application users
To run an existing agent application, such as a coding assistant or conversational agent:
- Copy an example template.
- Add an API key.
- Run it.
No code is required. See the quick start.
Plugin developers
To add a custom tool, a new LLM adapter, or another execution backend, write a plugin. Harness provides explicit extension interfaces and a type-safe development experience. See development.
Core features
- Configuration only —
cordis.ymlselects the capability set; changing a model or adding a tool is a configuration edit. - Hot replacement (HMR) — edit plugin code during development without restarting the process.
Technology
- Runtime: Node.js ^22.19 or >= 24
- Language: TypeScript (ESM)
- Framework: Cordis
- Package manager: pnpm workspaces (the repository pins pnpm 11)