README

DeepSeek Harness

English | 中文

DeepSeek Harness（dsh）是由 DeepSeek AI 开发的开源 agent harness（智能体框架）。

它构建于一切皆插件的架构之上，由 Cordis 驱动，其设计参见论文 _A Programming Paradigm for Spatiotemporal Composability_。

文档：https://deepseek-harness.github.io/deepseek-harness/

 开发者预览

DeepSeek Harness 处于 _开发者预览_ 阶段，正在快速迭代。未来将出现破坏兼容性的变更。

运行本项目前，请阅读安全说明。



 运行

 通过 npm 运行

安装 Node.js，然后运行：

sh
npx @deepseek-ai/dsh web


该命令默认会在 http://127.0.0.1:3080 启动 Web UI，本机启动时还会用默认浏览器打开页面。通过 SSH 启动时只打印宿主机 URL，因为本地转发地址由 SSH 客户端或编辑器持有。传入 --no-open 可仅运行服务器而不打开浏览器。详见 Web UI 指南。



 从源码运行

如需从仓库源码运行：

sh
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web


pnpm run build 会准备仓库产物。pnpm dsh web 会直接使用这些已构建产物，不会重新构建。

 社区与支持

- 通过 GitHub Discussions 提交反馈或 bug 报告。
- 为你的插件仓库添加 dsh-plugin 话题，便于被发现。
- 欢迎加入 DeepSeek Harness 企微群！扫描下方二维码填写入群问卷，小助手会定期发送入群邀请。


  
    
      入群问卷
      微信公众号
    
  
  
    
      
      
    
  


 参与贡献

参见 CONTRIBUTING.md。

 开发

请先阅读开发指南与架构文档。

pnpm run dev:web 会在一个终端里完成构建、启动，并在源码修改时重建 client bundle；make help 列出 Web 与 Desktop 对应的 Make target。完整表格见开发指南的「应用命令」一节。

面向 agent：请遵循 AGENTS.md。

 引用

bibtex
@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}},
}


 许可证

MIT

第三方依赖及其许可证见 THIRD_PARTY_NOTICES.md。

Discussions