deepseek-harness README

The project's README from github.com/deepseek-ai/deepseek-harness. As one markdown file: README.md.

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

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

MIT

Third-party dependencies and their licenses are disclosed in THIRD_PARTY_NOTICES.md.

deepseek-harness (deepseek-ai/deepseek-harness)

Searching Database…

253.1K ·GitHub
Deepseek-harness
这是什么？DeepSeek Harness（dsh）是 DeepSeek AI 推出的开源智能体运行框架，完全基于“一切皆插件”的架构构建，并由 Cordis 可组合性引擎驱动。
它是我要在代码里调用的框架，还是可以直接运行的独立程序？它是一个可直接运行的程序：启动 dsh 后会在本地开启一个带有 Web UI 的服务器。其中的一切，包括界面本身，都是运行在 Cordis 引擎之上、可以替换的插件。
我该如何让它跑起来？安装 Node.js，然后从 npm 运行 dsh；它会启动服务器，并自动在浏览器中打开 Web UI。若要从源代码检出版本运行，请改用 pnpm run build，然后执行 pnpm dsh web。
试用之前需要先安装什么？只需要 Node.js（22.19.0 及以上或 24.0.0 及以上版本）。如果是从代码仓库检出后构建，还需要 pnpm 来先编译产物。
现在是否稳定到可以基于它开发？还不行。它明确处于开发者预览阶段，正在快速迭代，维护者提醒之后会有破坏兼容性的变更，因此运行前请先阅读安全须知。
这个项目主要面向谁？面向扩展 DeepSeek 框架的插件作者和智能体开发者。项目甚至建议插件维护者为自己的仓库添加标签，以便被发现。
Cordis 是什么？Cordis 是驱动 dsh 插件架构的可组合性引擎，其设计记录在论文“A Programming Paradigm for Spatiotemporal Composability”中。
如果通过 SSH 运行，行为会有所不同吗？会的。在 SSH 会话中，它只会打印主机 URL，而不会打开浏览器，因为转发的本地地址由 SSH 客户端或编辑器管理。你也可以在任何机器上传入 --no-open 来跳过浏览器启动。
除了 Web UI 之外还有别的吗？构建脚本中，除了 build:web 之外还有一个单独的 build:desktop 目标，这说明在开发基于浏览器的 Web UI 的同时，也在开发桌面客户端。
为什么要给仓库加上 dsh-plugin 标签？这是 DeepSeek Harness 使用的约定，方便插件作者让其社区插件被其他 dsh 用户发现。
What are similar projects?dsh-router-standard, oh-dsh, dsh-plugin-bridge, dsh-lowtide, cocode, awesome-deepseek-harness, acryl, awesome-deepseek-harness
Which topics is it in?cordis, plugins, agent-harness, architecture, ai-tools, autonomous-agents, dsh, harness, dsh-plugin, deepseek-harness, deepseek, plugin
Creator
deepseek-ai
Size
285.8 MB
Stars
253.1K
Updated
CommitOct 17
Age
2mo
Commits · 90 Days