DeepSeek Harness

DeepSeek Harness（DSH）是DeepSeek官方推出的免费智能体运行框架，采用"推理+执行"的分工架构——大模型负责复杂推理，框架专注任务落地。开发者可借助DSH快速搭建具备自主行动能力的AI应用，让智能体从对话走向实操。整个应用流程高效简洁，大幅降低开发门槛，为构建能实际执行各类任务的AI系统提供全新思路与坚实基础。

怎么安装

一键使用

npx @deepseek-ai/dsh web

源码安装

git clone https://github.com/deepseek-ai/deepseek-harness

DeepSeek Harness怎么使用

1.下载安装DeepSeek Harness，之后打开，选择对应方式；

2.之后进入主页，按照个人需求选择模式，如【标准模式】；

3.之后进入设置页面，自行配置各项参数，将其保存；

4.即可正式调用DeepSeek Harness模型，开始构建和运行。

DeepSeek Harness介绍

DeepSeek 官方开源的 agent harness，一条命令在本机跑起图形界面。模型可换，能力全部由插件组成，MIT 许可。

本站其他指南讲的是把第三方 Agent 接到 DeepSeek。DeepSeek Harness 属于另一类：它是 DeepSeek 自己的 Agent 运行时，2026 年 8 月 13 日随 V4-Pro 一同开源，两天内 GitHub star 超过 10 万。

本指南由 deepseekagent.io 维护，内容基于 0.1.0-rc.6 实测，数据统计到 2026 年 8 月 15 日。

Agent = Model + Harness

官方对 harness 的定位：

模型是 Agent 的灵魂；harness 让它读懂环境、使用工具、把任务真正跑完。

模型只输出文字，它自己打不开文件、跑不了命令，也记不住上一轮对话。harness 是模型外面那一层：工作区、工具、权限、会话记忆，以及驱动任务继续执行的循环。

Claude Code、Codex 也是 harness，但它们是成品。dsh 的区别在于模型适配、工具注册表、会话日志乃至 agent 循环本身都是可替换的插件，文档称之为「没有需要打补丁的特权内核」。

DeepSeek Harness特色

DeepSeek Harness是一款Agent运行时框架，旨在补足大模型的能力短板。

它让AI真正具备操作能力，突破传统模型仅输出文字的局限。

框架采用推理与执行分离的架构设计，模型仅负责推理输出。

执行能力完全由插件灵活组合而成，实现轻量便捷的使用方式。

DeepSeek Harness亮点

DSH采用MIT协议开源，支持自由使用、修改与分发。

这一协议极大降低了二次开发的门槛，便于开发者快速接入。

开源模式促进了生态共建，吸引更多贡献者参与框架完善。

开放的许可策略为商业化应用和技术创新提供了坚实基础。

DeepSeek Harness常见问题

1.启动报错提示 Node 版本不对？

dsh要求 ^22.19 || >=24。Node 23 这类奇数版本不在支持范围内，且已停止维护，安装 Node 24 即可。

2.3080 端口被占用怎么办？

web 后面的参数会交给 Web 应用，用 npx @deepseek-ai/dsh web --port 8080 换端口。

3.能让局域网里的同事访问吗？

不能。CLI 会拒绝 --host 0.0.0.0 并报用法错误，它被设计成只服务本机。

4.输入框是灰色的，无法输入？

还没选工作区，点 Choose workspace 添加并选中目录。如果模型下拉显示 Select model，说明默认模型指向了已删除的供应商，重新选一个即可。

5.报 MISSING_CREDENTIAL 或 UNKNOWN_MODEL？

前者是没存 Key（去 Models 页面填，或设置好被引用的环境变量）；后者是选了没配置的模型，去自定义供应商里把模型 ID 补上。

6.配置和会话存在哪？

都在 ~/.dsh：profiles/ 是 profile 目录，.credentials.yaml 存密钥，settings.yaml 存设置，cordis.patch.yml 是你自己的补丁层。

7.Windows 能用吗？

Web UI 可以跑，但持久终端（PTY）依赖 POSIX 环境，官方打包的自带运行时也只发 Linux 和 macOS。Windows 上部分能力受限。

8.现在能用在正式项目上吗？

建议谨慎。它是开发者预览，README 明确警告会有破坏兼容的变更；会话格式不提供兼容承诺，升级后旧的会话记录可能无法读取。适合评估和内部试验，不适合作为唯一的生产工具。

9.我能给它提 PR 吗？

暂时不接收外部 PR。官方建议在 GitHub Discussions 反馈，或者自己写插件，并给仓库打上 dsh-plugin 标签便于被检索。官方也说明：主仓库里的包并不比社区的包更重要。