DeepSeek 官方开源 Agent 运行框架

用 DeepSeek Harness 构建和扩展 Agent

了解 DeepSeek Harness(DSH)的工作方式,启动官方开发者预览版,并查找适合实际 Agent 工作流的插件、工具和基础设施。

开发者预览版 MIT 开源 Everything is a Plugin

Model + Harness = Agent

DeepSeek Harness 是什么?

DeepSeek Harness,简称 DSH,是 DeepSeek AI 开源的 Agent 运行框架。它位于模型之外,负责连接模型服务、工具、技能、会话、工作区、存储、权限和用户界面,让 Agent 能够连续完成多步骤任务,而不是只返回一次回答。

DSH 的核心理念是“Everything is a Plugin”。它基于 Cordis 构建,将主要能力暴露为可替换、可组合的服务,适合需要研究、扩展或自托管 Agent 工作流的开发者。当前版本仍处于 Developer Preview 阶段,API 和插件接口可能出现不兼容更新。

01

插件优先的运行时

模型、工具、技能、存储、会话、调度和界面都可以通过插件进行组合。

02

可追踪的会话

Agent 的执行过程会保存为结构化会话状态,方便继续运行、排查问题和审计。

03

多种工作方式

可通过 Web UI、CLI 和 SDK 路径完成交互式任务、自动化流程和产品集成。

04

本地控制

框架可在本地运行,并由用户选择工作区以及模型、工具和权限边界。

精选 DSH 资源

建议先查看官方资料,再使用社区发现入口。第三方资源均会单独标注,安装前应检查源码、权限和维护情况。

DSH 官方

DeepSeek Harness

DeepSeek Harness 开发者预览版的官方介绍与入口。

打开资源
GH 官方

deepseek-ai/deepseek-harness

官方 MIT 开源仓库,包含源码、示例、贡献记录与发布文件。

打开资源
npm 官方

@deepseek-ai/dsh

用于启动本地 Web UI 的官方 @deepseek-ai/dsh npm 包。

打开资源
UI 官方

DSH Web UI Guide

官方入门说明,包括配置模型、选择工作区和执行第一个任务。

打开资源
DOC 官方

DSH Architecture

介绍 Cordis、插件、服务、会话状态和 Agent Loop 的技术文档。

打开资源
CO 独立社区

Cordis

DSH 底层使用的时空可组合框架及插件服务模型。

打开资源
PLG 独立社区

dsh-plugin on GitHub

GitHub 上带有 dsh-plugin 标签的项目入口;使用前需检查维护者和代码质量。

打开资源
DIR 独立社区

DeepSeek Code Directory

按类别整理 DSH 插件、工具与基础设施的独立社区目录。

打开资源

Agent 背后的基础设施

模型只是 Agent 的一个组成部分。可靠的 DSH 环境还需要明确的运行、数据和安全边界。

LAYER 1

模型与服务商

配置 DeepSeek 或兼容服务商、访问凭证、模型路由和上下文策略。

LAYER 2

工具与集成

在明确权限下连接文件、Shell、浏览器、API 和 MCP 类服务。

LAYER 3

会话与存储

保存上下文、事件和工作区状态,支持恢复任务、审计和调试。

LAYER 4

沙箱与治理

限制文件和命令访问,对高风险操作要求确认,并避免在提示词中暴露密钥。

在本地启动 DSH

安装 Node.js 后运行官方包,再打开命令输出的地址。Web UI 默认在 127.0.0.1:3080 提供服务。

npx @deepseek-ai/dsh web

开发者预览提示:后续可能出现不兼容更新。用于生产环境前,请固定版本,并在隔离工作区测试插件。

我们如何筛选和评估资源

插件只有在来源和行为可核查时才值得接入。在把扩展连接到 Agent 工作区之前,建议逐项检查以下信息。

  • 源码仓库、开源许可证和维护者身份清晰
  • 近期仍有维护,并且发布记录容易理解
  • 明确说明所需权限、网络访问和数据处理方式
  • 与当前 DSH Developer Preview 版本兼容
  • 提供可复现的安装步骤,并能安全卸载或停用

DeepSeek Harness 常见问题

解答用户关于 DSH 安装、插件和使用场景的常见问题。

DeepSeek Harness 是什么?

DeepSeek Harness 是 DeepSeek AI 开源的 Agent 运行框架,为模型补充工具、会话、工作区、存储、权限和界面等运行能力,用于执行多步骤 Agent 任务。

DeepSeek Harness 已经正式发布了吗?

已经发布。DeepSeek 提供了官方产品页、源码仓库和 npm 包,但目前仍标注为 Developer Preview,并非稳定的生产版本。

如何安装 DeepSeek Harness?

安装 Node.js 后运行 npx @deepseek-ai/dsh web,即可启动本地 Web UI。也可以克隆官方仓库,从源码安装和开发。

DSH 插件是什么?

插件负责提供模型、工具、技能、存储、调度、界面和外部集成等独立能力。DSH 采用插件优先架构,因此这些模块可以按需要组合或替换。

社区插件可以安全使用吗?

第三方插件应按可执行代码对待。安装前需要检查源码、许可证、权限、网络行为、维护状态和版本兼容性,并优先在隔离工作区测试。

探索 DeepSeek Harness 生态

先从官方运行时和文档开始,再按实际工作流选择需要的插件、工具和基础设施。