跳到正文

DeepSeek Harness

DeepSeek Harness 是插件优先的本地 agent runtime。开发者预览提供 models、tools、skills、sessions、sandboxes、storage、loops、scheduling 与 Web 界面。

npx @deepseek-ai/dsh web

0.1.x 为 MIT。开发者预览。Node.js ^22.19.0 或 >=24。Web UI 在 127.0.0.1:3080。

发布

2026 年 8 月 13 日

首次公开 preview。npm next 为 0.1.2-rc.1,发布于 2026 年 9 月 3 日。

许可证

MIT

0.1.x 包。可在 MIT 许可下查看、修改并自托管。

状态

Developer Preview

会有不兼容变更。未经安全审计。请固定你运行的版本。

运行时插件目录

用一项专注能力扩展 harness

官方 Settings 列表显示 159 行已安装项。按族筛选、按名称搜索,并在功能页打开任意一行。

9 个插件

Models

llm

模型插件,含 llm。无需改 DeepSeek Harness 源码即可更换模型。

Settings → Plugins

Tools

tools

文件编辑、shell、文件与网页搜索。Standard 模式提供完整工具面。

Standard mode

Skills

skills

智能体可加载的 skill 插件。缺失的 tool 往往是加载顺序或 Service 被拒绝。

Cordis plugins

Sessions

session

session 插件与只追加日志。Trajectory 的 resume、fork、search、replay 读同一条流。

Trajectory

Sandboxes

sandboxes

文件效果沙箱。Windows 使用 ACL restricted-token 后端。不要把提示词当成隔离。

windows-acl

Storage

storage

存储插件。0.1.2 已移除可选 SQLite session 后端;若仍需要,请从旧构建导出。

0.1.2-rc.1

Loops

loops

Agent loops 让模型在聊天框外持续工作。Code / PTC 可在一个 TypeScript 程序里组合多步 tool。

Code / PTC

Scheduling

scheduling

子代理调度写入 session 日志。Resume 与 replay 使用这些记录。

会话日志

Interface

api-gateway

本地 Web UI 在 127.0.0.1:3080,含 api-gateway。不要对外暴露该端口。

127.0.0.1:3080

DeepSeek Harness 现在意味着什么

围绕模型的本地插件优先 runtime。开发者预览。0.1.x 为 MIT。Web UI 绑定 127.0.0.1:3080。

发布通道

Developer Preview

0.1.2-rc.1 在 npm next,发布于 2026 年 9 月 3 日。会有不兼容变更。请固定版本。

安装路径

npx 或源码

Node.js ^22.19.0 或 >=24。 npx @deepseek-ai/dsh web 或克隆已发布的源码树。未指定版本的 npx 跟随 latest,不是 next。

架构

插件优先

Models、tools、skills、sessions、sandboxes、storage、loops、scheduling 和 UI 都是 Cordis 插件。在配置里组合它们。

已核实的发布

npm 与已发布源码树上的官方开发者预览。本站命令以文本显示,不是外链。

官方开发者预览

首次公开 preview 为 2026 年 8 月 13 日。npm next 是 0.1.2-rc.1。npm latest 仍是 0.1.1-rc.2(2026 年 8 月 21 日)。

MIT 许可源码

0.1.x 包。可查看、修改并自托管。早期 0.0.1-rc 使用 BSD-3-Clause。

Everything is a plugin

Cordis 负责安装并解析插件依赖。不必改 DeepSeek Harness 源码来换栈。

为什么 harness 比又一个编码演示更重要

运行时作者、运维、评测团队和预设构建者使用 dsh,因为能力在插件里,每次运行都会留下 Trajectory 记录。

工作区上下文

智能体读取你指向的 workspace。保持可丢弃。常见固定为 workspace-write 加 ask。

工具执行

Standard 模式提供文件编辑、shell、文件与网页搜索、skills、planning、goals、子代理和 workflows。

Trajectory

只追加 session 日志:提示、推理、tool 调用、子代理调度。Resume、fork、search、replay。

四种模式

Standard、Code / PTC、Minimal、Creator。一个 runtime。完整表格在功能页。

描述你想构建的内容

编码智能体 harness 如何工作

DeepSeek Harness 让模型留在环境里:workspace、tools、session 日志,以及可重组的插件。

01

把智能体落到 workspace

把 dsh 指向可丢弃的 workspace。插件在模型提出修改前加载模型、tools 和 session 状态。

02

规划、调用 tools、编辑

Standard 模式会搜索、读取、打补丁并运行 shell。Code / PTC 可在一个 TypeScript 程序里组合多步 tool。

03

对照 session 日志核验

Trajectory 记录提示、推理、tool 调用与结果。Resume、fork、search、replay 使用同一条流。

04

把下一项能力做成插件

Creator 模式检查实时 runtime,并在写入 Profile 之前把 Cordis 插件加载到内存。

这次发布为何重要

0.1.2-rc.1 仍是开发者预览。有用的是可读的插件 runtime:可固定、可检查、可自托管。

智能体需要 harness

模型卡片不是 runtime。插件覆盖 tools、sessions、sandboxes 和本地 Web UI。

长循环需要日志

Trajectory 保存只追加记录。这样才能恢复一轮并看到确切的 tool 载荷。

掌握 harness 就掌握整栈

在配置里替换 model、tool 或 sandbox 插件。你自己审查安装的内容。

接下来注意什么

预览稳定性

Pin @deepseek-ai/[email protected]。未指定版本的 npx 跟随 latest(0.1.1-rc.2),不是 next。

本地界面

Web UI 在 127.0.0.1:3080。3080 常被 Hyper-V、WSL2 或 Docker 占用。

插件契约

README 写明稳定版之前契约可能变动。社区 topic 标签只是发现,不是背书。

本指南使用的来源

本站上的官方发布材料。命令与仓库路径以文本显示。

源码树

deepseek-ai/deepseek-harness

已发布仓库路径。本页以文本显示 clone。

npm

@deepseek-ai/dsh

CLI 包。latest 0.1.1-rc.2。next 0.1.2-rc.1。shasum 在下载页。

功能

运行时地图

Cordis 插件、Trajectory、四种模式与沙箱策略。

指南

排错

Windows ACL、3080 端口、pnpm 加载顺序与升级后标题。

信任

信任与安全

法律使用政策。不是安全审计。你自己审查加载的插件。

人们在问的 DeepSeek Harness 问题

DeepSeek Harness 收费吗?+

不收费。开发者预览是 MIT。你可以阅读、修改并自行托管。早期 0.0.1-rc 为 BSD-3-Clause;当前 0.1.x 为 MIT。

能在 Windows 11 上运行 DeepSeek Harness 吗?+

可以,需要 Node.js ^22.19.0 或 >=24.0.0。Windows 沙箱使用 ACL restricted-token。已知问题包括 C:\Windows\Temp 锁死、BUILTIN\Administrators 拥有的 workspace,以及被 Hyper-V、WSL2 或 Docker 占用的 3080 端口。

DeepSeek Harness 本身是模型吗?+

不是。它是模型外围的 runtime:tools、sessions、sandboxes、storage、loops、scheduling 和 Web UI 的插件。模型 ID 与 API 价格单独提供。

扫描器为何标记 dsh?+

dsh 是 npm CLI,不是 Windows 安装包。启发式扫描器有时会标记会拉起 shell 的 Node 进程。请核对该固定版本公布的 shasum,0.1.2-rc.1 为 fef213043313affc36ca2226d2637ad483b5e3f6。

打开完整常见问题

获取预览版

下载 DeepSeek Harness

通过 Node.js 支持 Windows 10/11、macOS 和 Linux。包 URL 按钮在下载页。

下载 Windows 版

下载