跳至正文
DeepSeek Harness 中文教程 · 开发者预览核验于 2026-08-15

从第一次启动,到插件化运行时

一条按学习顺序组织的中文路径:运行 dsh、理解 Agent Loop、发现可信 Plugin,再亲手扩展它。

$ npx @deepseek-ai/dsh web
16
核心教程
1805
收录 Plugin
20
本站精选
15
Plugin 分类
什么是 DeepSeek Harness

不是新模型,是让模型干活的运行时

DeepSeek Harness(命令名 dsh)是 DeepSeek AI 开源的 Agent Harness:它把工作区、工具、权限、会话、模型适配器和界面组织起来,让模型能够完成多步骤任务。目前处于开发者预览阶段。

快速开始

十分钟,跑通第一次任务

先得到一次真实反馈,再逐层打开运行时。每一步都有预期结果和失败分支。

1

准备运行环境

安装 Node.js 22 或更高版本,准备一个 DeepSeek API Key 或兼容端点。

node --version # v22+
2

一条命令启动

无需全局安装,直接启动 Web UI,按向导完成模型配置。

npx @deepseek-ai/dsh web
3

完成第一个任务

在浏览器中打开 Web UI,创建工作区,让 Agent 跑通第一次多步骤任务。

http://127.0.0.1:3080
101 学习路径

不是文档迷宫,是一条路线

16 篇按顺序组织的核心教程,每篇标注难度、时长、核验日期和一手来源。

查看全部教程 →
BEGINNER · 15 分钟 01

DeepSeek Harness 是什么?

从模型、Agent 到 Harness,先建立一张不会混淆的概念地图。

STEP 1 阅读 →
BEGINNER · 22 分钟 03

配置模型与兼容端点

理解 Provider、API Key 和自定义 OpenAI-compatible Endpoint 的边界。

STEP 3 阅读 →
BEGINNER · 25 分钟 04

工作区、会话与权限确认

理解 Agent 能看到什么、哪些操作需要批准,以及如何建立安全试用边界。

STEP 4 阅读 →
INTERMEDIATE · 28 分钟 06

Profiles 与 Bundles

理解 dsh 启动时如何一层层组合插件树,以及 web 与 headless 的区别。

STEP 6 阅读 →
BEGINNER · 28 分钟 07

安装与启动问题排查

从 Node、端口、网络、模型配置到工作区权限,按最短路径定位问题。

STEP 7 阅读 →
INTERMEDIATE · 30 分钟 08

安全安装第三方 Plugin

用来源、权限、版本和回滚四道检查,降低把第三方代码加入 Agent Runtime 的风险。

STEP 8 阅读 →
INTERMEDIATE · 32 分钟 10

建立反馈闭环与独立复核

让测试、日志、静态检查和审阅者成为 Agent 的外部证据,而不是依赖自我确认。

STEP 10 阅读 →
INTERMEDIATE · 35 分钟 12

用 Skills 构建项目记忆

把可复用流程按需加载,而不是把整本团队手册塞进每次系统提示。

STEP 12 阅读 →
ADVANCED · 55 分钟 16

实作:第一个 Cordis 工具插件

从 apply(ctx) 到工具注册、配置校验、事件观察和卸载验证,走完一条最小插件链路。

STEP 16 阅读 →
Plugin 雷达

找到能力之前,先看清它要什么权限

目录状态与本站编辑状态分开显示;经过复核的精选条目会补充权限面和安全提示。绿色标签不是永久安全认证,原始仓库永远是最终核验入口。

打开完整雷达 →
PLG-001 来源目录已核验

dsh-vision-toolkit

Anionex

让纯文本模型更好地做视觉任务的DeepSeek Harness插件:带意图的图片问答、长截图 OCR、UI 还原等|DeepSeek Harness-native integration for agent-vision-toolkit: image Q&A, long-screenshot OCR, UI restoration, grounding, pixel diff, Artifacts, and Web UI.

技能与智能体 TypeScript ★ 283
PLG-002 来源目录已核验

dsh_workflow

icetomoyo

把Claude Code的UltraCode模式带给DSH,把 DSH 的一次性多 Agent 调度,升级为可生成、可保存、可治理、可观察、可恢复的 Workflow 层

技能与智能体 TypeScript ★ 52
PLG-003 来源目录已核验

dsh-visualize

Nagi-ovo

DSH 对话内生成式 UI 插件:模型把交互式 HTML 卡片直接画进会话流——visualize 工具 + 配套 skill + 沙箱渲染卡,带流式预览、组件浮入动画与鲸鱼蓝主题跟随

技能与智能体 TypeScript ★ 67
PLG-004 来源目录已核验

DSH-better-sidebar

omdsh-dev

一个侧边栏的完整工作台,支持三方拓展注册新Tab页面,内置文件渲染编辑/终端/Git/子代理

其他 Plugin TypeScript ★ 590
PLG-005 来源目录已核验

dsh-security-audit

omdsh-dev

DSH 本机安全审计插件:配置/插件来源/会话/网络暴露面,只读脱敏风险报告

安全与策略 TypeScript ★ 9
PLG-006 来源目录已核验

plugin-template

omdsh-dev

基于原turtle ui官方仓库创建的plugin模板仓库

开发工具 JavaScript ★ 5

⚠️ 安装第三方 Plugin 前,先读安全安装指南:确认包名与仓库一致、检查权限声明、优先选择来源已核验的项目。

核心概念

概念先对齐,讨论才开始

六个贯穿全站的关键词。读教程卡住时,先回到这里。

Plugin

挂载到运行时、提供界面/工具/适配能力的扩展单元。

Cordis

驱动 DeepSeek Harness 的底层插件框架。

Agent Loop

模型生成 → 调用工具 → 观察结果 → 继续下一步的循环。

Session

一次任务的会话上下文,包含消息、事件与状态记录。

Tool 与权限

模型可调用的能力及其边界,每次调用都可审计。

Profile / Bundle

一组预组合的插件与配置,一键切换运行形态。

最新动态

把变化记录下来

架构观察、Plugin 方法和版本更新,不混进基础教程路径。

全部博客 →
开发者预览

命令会过期,核验记录不应该消失

所有核心教程都标注最后核验日期、适用版本和一手来源。发现内容过期时,你知道去哪里核对。