Tianyi Cui
b49deaa8ee
SubagentRun.id previously promised uniqueness only within one parent, but the unified manager indexes every external activation by that id in one runtime-wide resident map. Publication also checks the live Agent and Session registries. Two compliant-looking provider results could therefore collide even when they belonged to different parents. Document the existing shared Session id namespace across all parents, providers, and local Sessions. Update the package reference, bilingual type-equivalent declaration, and the current upgrade guide so custom providers know to replace parent-local counters with fresh execution ids. The shipped ACP, DSH SDK, Codex, and Claude Code providers already mint UUIDs; no runtime mapping or additional retained identity state is needed. Add a cross-parent collision test through startActivation. It proves that publication rejects the duplicate, disposes only the new external handle, leaves the second parent catalog empty, and preserves the first catalog entry and execution result through normal cleanup. Validation: all seven external-lifecycle tests pass, as do scoped bilingual pairing, verify-upgrade-guides, doc-sync, and full lint. Cordis catalog and inspection-catalog regeneration produces no tracked artifact changes.
DeepSeek Harness
English | 中文
DeepSeek Harness (dsh) is an open-source agent harness developed by DeepSeek AI.
It is built on an everything-is-a-plugin architecture and powered by Cordis, whose design is described in A Programming Paradigm for Spatiotemporal Composability.
Documentation: https://deepseek-harness.github.io/deepseek-harness/
Developer preview
DeepSeek Harness is in developer preview and iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.
Review the safety notice before running the project.
Run
Run from npm
Install Node.js, then run:
npx @deepseek-ai/dsh web
The command starts the Web UI at http://127.0.0.1:3080 by default and opens it in the default browser for a local launch. An SSH launch only prints the host URL because the SSH client or editor owns the local forwarded address. Pass --no-open to run the server without opening a browser. See Web UI guide.
Run from source
To run from a repository checkout:
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
pnpm run build prepares the repository artifacts. pnpm dsh web uses those built artifacts without rebuilding.
Community and support
- Submit feedback or bug reports through GitHub Discussions.
- Add the
dsh-plugintopic to your plugin repository for discoverability. - Join DeepSeek Harness Discord community.
Contributing
See CONTRIBUTING.md.
Development
Start with the development guide and architecture documentation.
pnpm run dev:web builds, serves, and rebuilds client bundles on source edits in one terminal, and make help lists the matching Make targets for Web and Desktop; the guide's application commands section owns the full table.
For agents, follow AGENTS.md.
Citation
@misc{deepseek-harness2026,
title={DeepSeek Harness: Everything is a Plugin},
author={DeepSeek-AI},
year={2026},
publisher={GitHub},
howpublished={\url{https://github.com/deepseek-ai/deepseek-harness}},
}
License
Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.