# DeepSeek开源智能体框架

> DeepSeek Harness把Web界面、工具、会话、子智能体与SDK放进“一切皆插件”的架构，但开发者预览阶段仍会出现破坏性变更。

_Source: DeepSeek AI · 2026-08-13 · 7 min read · Verified against primary sources_

Canonical: https://iyu.app/zh/e/deepseek-harness-open-source-agent-framework

## 60 秒版本

DeepSeek Harness是一套MIT许可、插件优先的智能体运行框架，支持Web、无头和Python三种入口。

**要点**

- 模型适配器、工具、会话、提示词组装乃至Agent循环都由Cordis插件构成。
- Web界面支持工作区编辑、命令执行、委派、计划和受审批控制的操作。
- 无头Profile处理一次性任务，Python SDK则可嵌入带内置运行时的调用。
- 模型可使用DeepSeek、目录提供商或自定义OpenAI兼容端点。
- 项目仍是开发者预览，官方明确不承诺当前兼容性。

**结论.** 它是值得实验的完整开放智能体平台，但在接口稳定前必须固定版本并隔离工作区。

## 全文

**DeepSeek这次开源的不是新模型，而是模型外面的智能体运行框架。**DeepSeek Harness，命令名为`dsh`，把Web界面、模型适配器、工具、持久会话、审批、子智能体与SDK组合在一起；它最核心的选择，是连Agent循环本身都能作为插件替换。

> **⚑ Caveat:** 官方明确将Harness标为开发者预览，并说明未来会有破坏兼容性的变化。当前发布仍是候选版本，生产使用前应固定版本并单独验证升级。


### 核心设计 — 一切皆插件

Harness由Cordis插件框架驱动。模型提供商、提示词组装、工具执行、会话日志和默认循环都向共享上下文注册服务与事件。运行时通过Profile按顺序叠加Bundle和用户覆盖，因此替换单项能力时不必重写整套系统。

- **模型层:** 支持DeepSeek，以及Anthropic、OpenAI等目录提供商、云原生认证路线和自定义OpenAI兼容端点。
- **智能体层:** 负责提示词组装、模型请求循环、工具调用、审批、计划和委派。
- **状态层:** 追加式会话事件用于持久化、回放、恢复和生成记录。
- **扩展层:** 插件可加入模型、工具、命令、后台任务、沙箱策略和界面组件。


### 三个入口 — 浏览器、无头与Python

官方最短启动方式是`npx @deepseek-ai/dsh web`，默认在`127.0.0.1:3080`启动本地Web界面。用户配置模型、选择工作区后即可创建会话。同一套基础还可以无服务器执行一次性任务，或通过Python SDK嵌入其他程序。

- **3种** — Web界面、无头命令与Python SDK入口
- **3080** — 官方文档中的Web界面默认本地端口
- **MIT** — 项目采用的开源许可证


### 能力范围 — 完整的编码智能体表面

Web指南显示，智能体能在选定工作区读取和编辑文件、执行命令、委派工作并维护计划。基础Bundle还包括持久化、凭据、遥测、文件与Shell策略、任务、技能、Web工具和子智能体提供商。具体会话能使用什么，由Profile和插件组合决定。

- **Web界面：**交互式工作区、会话历史、模型设置与审批提示。
- **无头模式：**为单个任务创建持久会话，并把最终回答输出到标准输出。
- **Python SDK：**通过上下文管理运行时，可复用会话ID并调用JSON-RPC示例。
- **自定义组合：**检查实际插件树，并通过Profile补丁覆盖配置项。


### 运行边界 — 预览软件需要隔离

源码工具链要求较新的Node.js与pnpm，Python SDK则要求Python 3.10或更高版本及官方列出的Linux或Apple Silicon环境。更重要的是，工具可以改文件、执行Shell。Python指南中的最小组合使用`danger-full-access`，并明确建议放在一次性检出目录或容器中。

> **i** iyu在发布主机上试跑npm入口时，依赖解析持续超过两分钟，测试停止前3080端口尚未就绪。这不否定官方命令，但说明实际安装速度和软件源条件需要在目标环境中单独验证。


### 采用建议 — 现在适合谁尝试

Harness最适合研究智能体架构、开发自定义工具或模型提供商，以及希望用同一运行时覆盖Web、无头与嵌入式执行的开发者。需要长期会话兼容或冻结插件接口的团队，应继续等待，或先用自己的适配层隔离预览版本。

> 这次发布的重要性，在于DeepSeek公开了一套智能体操作系统，而不只是聊天接口包装。

实际行动很明确：先在一次性项目中测试，固定具体候选版本，检查权限和插件组合，并把每次升级当作迁移。架构已经足够透明和有野心，兼容承诺则还没有准备好。


## Primary sources

- [DeepSeek Harness official repository](https://github.com/deepseek-ai/deepseek-harness)
- [Official architecture documentation](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.md)
- [Official Web UI guide](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/index.md)
- [Official Python SDK guide](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/python-sdk.md)

---
_Published by iyu (https://iyu.app) — the day's AI news, checked against primary sources and rewritten in plain language. Free to quote with attribution and a link to the canonical URL._