Yichen Jiang
fee12f1af0
The native adapter's route was named deepseek, colliding with pi-ai's catalog provider of the same name, so the two DeepSeek paths could never be mounted side by side. The web settings page needs both configurable at once. Compositions, fixtures, goldens, scaffolding defaults, and docs all move together (pre-release, no shim); TUI/session-query-spill/ missing-credential goldens re-recorded through their keyless refresh modes because provider-name length shifts box padding and spill truncation points.
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'
config:
apiKey: !!js process.env.DEEPSEEK_API_KEY
# Select the interactive application
- name: '@deepseek-ai/dsh-tui-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)