Yichen Jiang
d57463c2fb
The step and the Models page both asked one question of a join that describes every provider: is deepseek-official's credential stored? A user who configured some other route was taken over on every blank session, and the DeepSeek setup card opened over them on every visit to Models with a Cancel that could not close it — while clearing the add card's draft, because it shared the row-editor close handler. providerUsable(row) now answers what both surfaces need: the route is registered and whatever credential its profile names is stored. Readiness (renamed onboardingReadiness) ends on any usable row, needsSetup takes the same fact, and each card kind owns its own close handler. Fixes #2325
DeepSeek Harness
English | 中文
DeepSeek Harness (dsh) is an open-source coding agent built on the DeepSeek Harness SDK.
It uses an architecture where everything is a plugin.
Internal testing notice
DeepSeek Harness is under internal testing. Features and interfaces may change.
The internal build uploads all Session Logs by default to help diagnose reported problems. Set DSH_TELEMETRY_DISABLED=1 to disable telemetry. Send feedback through the internal WeChat group.
Run
Install Node.js ^22.19 or >= 24 and pnpm 11, then run the published package:
npx @deepseek-ai/dsh web
The command initializes the Web profile and prints the Web UI URL, which is http://127.0.0.1:3080 by default. Open it, add a DeepSeek API key under Settings → Models, then start a session. The invoking directory is the default workspace; try Summarize this repository and identify its main packages.
Continue with the Web UI guide.
Run from source
To run a repository checkout instead:
git clone https://github.com/deepseek-harness/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm dsh web
The last command builds the repository and opens the same Web UI path.
Profiles and plugins
A profile is an ordered list of plugin bundles. The shipped web profile powers dsh web. Manage a profile with dsh plugin --profile <name> <pnpm args>, which forwards the remaining arguments to pnpm in that profile's directory:
npx -p @deepseek-ai/dsh dsh plugin --profile web add <package>
npx -p @deepseek-ai/dsh dsh plugin --profile web remove <package>
add, remove, update, why, and other pnpm commands work unchanged. The command initializes a missing profile before changing its packages and updates its bundle list from installed packages that declare dsh.bundle. See the CLI reference for the exact behavior.
The CLI reference covers headless execution and custom profiles. The Python SDK and examples cover programmatic and custom compositions.
Community
Follow DeepSeek Harness on Twitter for project updates.
Development
Start with the development guide and read the architecture before changing packages.
For agents, follow AGENTS.md.
License
Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.
Contributing
Read CONTRIBUTING.md before contributing to this repository.