DeepSeek Harness (dsh)

DeepSeek Harness (dsh) 是深度求索（DeepSeek AI）的开源智能体框架。智能体 = 模型 + 框架，其中的每一项能力都是可替换的插件。

123

2026/08/14

什么是 DeepSeek Harness？

DeepSeek Harness（dsh）是 DeepSeek AI 的开源智能体 harness：它为模型提供工作区、工具注册表、沙箱与审批策略、仅追加的会话日志，以及一个持续推动工作前进的循环。它面向希望拥有自己智能体运行时的团队、在 dsh-plugin 主题下发布能力的插件作者，以及任何需要通过配置替换模型适配器、沙箱或存储后端的人。它的独特之处在于，每一项能力——模型、工具、技能、会话、沙箱、存储、循环、调度和 UI——都是挂载在 Cordis 内核上的插件，因此你通过添加插件来扩展 dsh，而不是给核心打补丁。

主要特性

一切皆插件: 模型适配器、工具注册表、会话日志、智能体循环和浏览器 UI 都是插件，因此任何部分都可以通过配置替换，无需给特权核心打补丁。
底层是 Cordis 内核: Cordis 负责挂载、卸载和重新连接插件，并跟踪它们的依赖关系；当插件卸载时，其注册项会自动解除。
补丁层组合: 运行中的实例是一棵由有序层组合而成的插件树——bundle 补丁、profile 自身的补丁文件、机器级补丁和命令行覆盖——其中后面的层按行覆盖前面的层。
一个核心上的四种智能体预设: Standard 提供完整工具集，Code 通过 Code Mode SDK 暴露工具，Minimal 只保留持久化 bash 和 str_replace_editor，Creator 则增加运行时检查和预设编写指导。
仅追加的会话日志: 系统提示、推理、工具调用与结果、子智能体调度和上下文注入都会被记录，恢复、分叉、搜索和重放都基于这一单一事件流进行。
沙箱与权限模式: 针对派生进程的文件效果限制提供 read-only、workspace-write 和 danger-full-access 模式，覆盖 Linux、macOS 和 Windows 后端。
可替换的模型提供商: DeepSeek、Anthropic 和 OpenAI 等目录提供商，以及自定义 OpenAI 兼容端点，都通过同一适配器接口接入。

如何使用 DeepSeek Harness

安装 Node.js 22.19 或更高版本，或 24 及以上版本。
运行 npx @deepseek-ai/dsh web。该命令会启动 Web UI，默认在 http://127.0.0.1:3080 提供服务。如果使用源码检出，则需要克隆仓库，并在仓库根目录运行 pnpm install、pnpm run build 和 pnpm dsh web。
打开 Settings，然后打开 Models，添加模型密钥并保存。模型路由会立即变得可用，无需重启。
选择一个工作区目录，因为在选择之前，会话编辑器会一直不可用。
检查和扩展运行时：dsh web --dump-config 会打印你的机器启动时组合出的插件树，而 dsh plugin 会通过将 pnpm 命令转发到 profile 目录，把树外插件安装到 profile 中。

使用场景

希望拥有自己的智能体运行时，而不是使用封闭运行时的团队。
在 GitHub 的 dsh-plugin 主题下构建和发布能力的插件作者。
需要在多次运行之间保持稳定、最小工具面的模型评估——Minimal 模式将智能体限制为持久化 bash 和文件编辑器。
在自有 UI 背后嵌入可检查智能体循环的内部平台，因为浏览器客户端、HTTP 服务器和客户端模块都以 bundle 形式提供。
任何需要通过配置而非代码来替换模型适配器、沙箱或存储后端的人，或者只需一次替换就能将文件系统和子进程指向远程沙箱的人。

定价

官方网站没有列出 DeepSeek Harness 的定价或付费计划；该项目以 MIT 许可证发布，并处于开发者预览阶段，因此请查看官方网站了解当前详情。

常见问题

DeepSeek Harness 与 Python 的 deepseek-harness 包是同一个项目吗？

不是。有两个互不相关的项目都使用 DeepSeek Harness 这个名称。DeepSeek AI 的官方项目使用 TypeScript，运行在 Node.js 上，并通过 npx @deepseek-ai/dsh web 安装；而社区项目是一个 Python 客户端库，用于 DeepSeek V4-Pro 和 V4-Flash API，通过 pip 安装。它们有不同的作者、源码树、语言和版本线，彼此都不是对方的分支或继任者。

运行 DeepSeek Harness 需要安装什么？

DeepSeek Harness 需要 Node.js 22.19 或更高版本，或 24 及以上版本。运行已发布的 CLI 不需要其他东西；而从源码检出构建还需要启用 Corepack 的 pnpm 11.7.0 和 Git 2.26 或更高版本。必须至少配置一个模型提供商。

DeepSeek Harness 可以使用哪些模型提供商？

它接受 DeepSeek API 密钥、Anthropic 或 OpenAI 等目录提供商，或自定义 OpenAI 兼容端点。Bedrock、Vertex、Azure 和 Codex 需要它们原生的凭据，而不是 API 密钥字段。DeepSeek Harness 不附带任何权重，只会调用你配置的提供商。

DeepSeek Harness 中的四种模式是什么？

Standard 模式是完整的编码智能体，具备文件编辑、shell、文件和网页搜索、技能、规划、目标、子智能体和工作流。Code 模式添加 Code Mode SDK，使模型可以将多步操作组合成一个 TypeScript 程序；Minimal 模式为基准测试只保留持久化 bash 和 str_replace_editor；Creator 模式在 Standard 的基础上增加运行时检查和预设编写指导。