DeepSeek Harness(简称 DSH)是 DeepSeek AI 于 2026 年 8 月开源的 Agent 运行框架,目前处于开发者预览阶段。它的核心思路是把大模型与可扩展的执行环境结合起来:模型负责理解与推理,框架负责让 Agent 真正操作本地环境、调用工具并持续执行任务。
项目基于 Cordis 插件架构,模型适配、工具、会话、沙箱、存储、主循环等能力都以插件形式存在,开发者可在配置层面直接替换或扩展。它支持接入 DeepSeek 及多家模型提供方,并提供多种运行模式。整体定位更偏向开发者工具,而非面向普通用户的成品应用。
适合什么场景
如果你需要让大模型真正读写本地文件、执行命令、拆分任务并在授权范围内持续工作,而不是只停留在对话层面,可以考虑试用这个框架。它比较适合:
想自己搭建 Agent 执行环境的开发者
需要本地可控、可扩展运行时的场景
希望对比不同模型在相同工具环境下表现的基准测试
有一定二次开发或插件扩展需求的人
目前仍是预览版,接口和插件可能还会有较大调整,不适合直接用于生产环境的关键流程。
环境要求
操作系统:Windows 10+、macOS 10.15+ 或主流 Linux(x64/arm64)
Node.js:建议 v22.19 及以上,或直接使用 v24 系列
包管理器:源码安装需要 pnpm(可用
npm install -g pnpm安装)网络:首次启动需要从 npm 拉取依赖
API Key:DeepSeek 或其他兼容提供方的密钥(可在启动后于界面中配置)
可选:Python 3.10+(使用官方 Python SDK 时)、Git
硬件要求不高,普通笔记本即可运行 Web 界面。建议单独准备一个练习目录作为工作区,避免误操作重要文件。
安装与启动
快速体验(推荐先试这个)
首次运行会下载相关包,确认后等待完成。终端会输出本地地址(默认 http://127.0.0.1:3080),用浏览器打开即可。关闭终端后服务一般会停止。

更多参考:
https://developer.aliyun.com/article/1755802?spm=a2c6h.12883283.index.119.5f1f4307lnds9z
https://wenxin.baidu.com/search/13006422030524031592?enter_type=a_61673_title