DeepSeek Harness 运行模式入门

DeepSeek Harness 提供标准、PTC、极简、创作者四种运行模式。

标准模式（Standard），大部分默认使用这个就行。
PTC 模式（Programmatic Tool Calling，程序化工具调用）用于 TypeScript 工具编排。
极简模式（Minimal）用于精简工具或基准测试。
创作者模式（Creator）用于运行时探索和插件创作。

这四种模式不是从初级到高级的四个等级，而是四种用途：标准模式用来干活，PTC 模式用来编排复杂工作，极简模式用来测量模型，创作者模式用来改造 Harness 本身。

一句话选型：绝大多数人的日常任务用 标准模式 就足够了。

想给 Harness 加功能、定制界面的时候，再切换到 创作者模式。

为什么会有运行模式？

理解模式的本质，需要先回到 DeepSeek Harness 的核心设计理念。

DeepSeek Harness（简称 dsh）是 DeepSeek 在 2026 年 8 月开源的 AI 智能体框架，核心理念是一切皆插件（Everything is a Plugin）。

模型接入、工具、技能、会话、沙箱，甚至界面，都是插件。

这些插件由开源插件运行时 Cordis 统一负责加载、卸载和管理依赖。

既然一切都是插件，模式的本质就很好理解：

模式 = 一组预先搭配好的默认插件。

切换模式，换的是插件组合，底层的 DeepSeek 模型并没有变聪明或变笨。

这也是为什么官方强调：选哪个模式，取决于你想做什么事，而不是哪个模式更厉害。

四种模式一览

先通过一张总表建立整体印象，再逐个深入了解。

模式	它是什么	适合场景
标准模式Standard	完整的日常智能体：文件编辑、Shell、联网搜索、子智能体、计划模式、工作流	写代码、做研究、整理文件、做文档和幻灯片，默认首选
PTC 模式PTC	包含标准模式的全部能力，工具被收拢为一个 `run_code` 工具，模型用一段 TypeScript 程序组合多步操作	多步骤、需要编程式编排的复杂任务
极简模式Minimal	只保留两个工具：持久化 bash 和 `str_replace_editor` 文件编辑器	评测模型、复现问题，尽量少让 Harness 帮忙
创作者模式Creator	继承标准模式的全部能力，并增加运行时检查、内存中试验插件、预设创作指引	开发插件、定制自己的智能体

四种模式的能力关系如下图所示：标准模式是基座，PTC 模式和创作者模式在它之上做加法，极简模式则是刻意做减法。

一个好记的口诀，对应四种模式的动词：

做事标准模式

编排PTC 模式

测量极简模式

改造创作者模式

标准模式

如果你只是想给 DeepSeek 一个任务、让它完成，就用标准模式。

它是功能最完整的日常模式，官方快速入门也从这里开始。

能力	说明
文件读写与编辑	读取、修改项目中的文件
执行终端命令	运行 Shell 命令，执行前会弹出确认提示
联网搜索	检索外部资料辅助完成任务
子智能体	把子任务委派给独立的子智能体处理
计划模式	先制定计划、确认后再动手执行

新手建议：第一次使用时，先在一个测试文件夹里让它做一个只读任务，例如官方快速入门推荐的总结这个仓库并找出主要的包。确认它读对了工作区、确认弹窗正常出现之后，再放手让它改东西。

PTC 模式

PTC 模式保留了标准模式的所有能力，区别只在调用工具的方式。

PTC 的全称是 Programmatic Tool Calling（程序化工具调用），背后的观察是：模型写代码，比逐个吐工具调用更擅长。

对比项	普通模式（如标准模式）	PTC 模式
调用方式	调一个工具、看结果、再调下一个	模型写一段 TypeScript 程序，一次性串起多个工具调用
上下文占用	每一步的中间结果都进入对话	只有程序的返回值和日志重新进入对话
擅长任务	目标明确、步骤不多的日常任务	批量重构、数据流水线等步骤多、逻辑固定的任务

PTC 模式下的工具调用是这样运作的：

切换到 PTC 模式后，模型界面上只剩一个 run_code 工具，其余工具以生成的 SDK 形式出现在编程语言里。

模型写一段异步 TypeScript 程序，用 await tools.工具名(参数) 的形式调用工具，整段程序一次提交。

程序运行在会话沙箱策略之下的独立托管进程里，子调用仍走统一的工具流水线，审批与钩子照常生效。

独立只读调用可以并行重叠，默认上限 10 路；会改动状态的操作按提交顺序单独执行。

程序长什么样？下面是一个形状示意，实际工具名以会话中生成的 SDK 为准：

实例

// PTC 程序示意：通过 run_code 一次提交，在沙箱进程中执行
const readme = await tools.read_file({ path: "runoob-demo/README.md" }); // 只读调用，可与下一行并行
const intro = await tools.web_search({ query: "RUNOOB 入门教程" }); // 与上一行互不依赖

// 只把必要的结果返回给模型，中间过程不占用上下文
return {
brand: "RUNOOB",
introCount: intro.results.length,
readmeHead: readme.text.slice(0, 120),
};

可以把 PTC 模式理解为：把多轮工具调用，合并成一段模型自己写的小程序来执行。

对初学者来说，知道它存在就行。等标准模式用熟了，遇到真正需要编程式编排的任务时再尝试。

极简模式

极简模式常被误解，值得单独澄清一次。

常见误解	实际情况
它是给低配电脑用的轻量版	它是刻意收窄的环境，只保留持久化 bash 和 `str_replace_editor` 两个工具
环境越全效果越好	Harness 帮得越少，越能看到模型本身的真实表现，结果可复现、可公平比较
日常干活也适合用它	DeepSeek 自己的代码智能体基准测试使用极简模式；高效完成工作请用标准模式

它的价值在评测和排查：当你在分辨是模型问题还是环境问题时，极简模式提供了一个接近裸模型的对照环境。

创作者模式

前三种模式的工作对象是你的任务，创作者模式的工作对象是 Harness 本身。

它解决什么问题

官方的说法是：在创作者模式下，你可以在 Harness 内部开发和扩展 Harness。

你不需要懂插件开发，只要说一句我想在界面里加一个某某功能，智能体就会把这个功能做出来，并在当前会话里直接用上。

四项核心能力

创作者模式的新增能力可以概括为四项，覆盖了从调研到固化的完整链路。

能力	做什么	帮你解决什么
检查运行时（inspect）	查看当前加载了哪些插件、有哪些服务和依赖	写插件前先摸清能往哪里接
内存中试验插件	新插件先在当前会话的内存里加载测试	不改框架源码、不用重启，试错成本极低
自然语言生成插件	你描述需求，智能体查阅技能文档、检查接口、写代码并加载	不会编程也能做定制
组合成新模式	把试验成功的插件组合固化成可复用的自定义预设	相当于创造出你自己的第五种模式

与标准模式的关系

创作者模式继承标准模式的全部功能，所以它依然可以做日常任务。

区别只是它多出了改造 Harness 的工具和指引。

场景	选择
日常干活	标准模式
想加功能、想定制	创作者模式

一次典型的工作流

官方首页演示的是这样一个过程：你输入帮我写一个番茄钟插件，智能体依次完成下图的动作。

你可以把它理解成一个循环：需求 → 调研运行时 → 写插件 → 试跑 → 你反馈 → 再改。

官方演示中，智能体会先加载 cordis-plugin-development 技能并阅读文档，再检查运行时里适合做悬浮窗的界面层提供者，然后编写插件、在当前会话中加载，你立刻就能在界面里看到番茄钟。

第一次使用创作者模式

下面从零开始，完整走一遍创作者模式的首次体验流程。

启动

如果说过客户端可以直接打开，如果使用 web 端，在终端执行下面的命令，启动 Harness 的 Web 界面：

npx @deepseek-ai/dsh web

启动成功后，在浏览器打开 http://127.0.0.1:3080，通常会自动打开：

$ npx @deepseek-ai/dsh web
ready - http://127.0.0.1:3080

选择模型与工作区

我们直接使用客户端默认的模型，点击 设置工作区，选择你的测试文件夹，例如 ~/runoob-harness-demo。

先在标准模式下热身

先不要急着切创作者模式，运行一个只读任务确认环境正常：

请读取当前工作区的 README.md，概括项目用途。
这次只读取，不创建、修改或删除文件。
请说明实际读取了哪个文件。

切换到创作者模式

在会话界面选择创作者模式（Creator Mode）选项。

从最简单的需求开始：

帮我写一个番茄钟插件，悬浮在应用右下角，默认 25 分钟。

过一会，这个功能就创建完成了：

不满意就继续说：颜色换成深色、结束时弹提示、按钮太小。

写好创作者模式提示词

一个好提示词通常包含四件事：位置 + 功能 + 外观 + 约束。

帮我添加一个插件：
- 位置：右下角悬浮窗（也可选左侧栏、右侧栏）
- 功能：番茄钟，默认 25 分钟，结束后播放提示音
- 外观：深色卡片、圆角、体积小巧，不遮挡正文内容
- 约束：标题不要和窗口控制按钮重叠；不要引入额外依赖

除了结构完整，下面四个技巧来自官方演示的实测经验：

技巧	做法	实例
先做最小可用版本	第一轮只要核心功能，再逐轮加功能	先要一个能倒计时的番茄钟，再加提示音、统计
约束要写进提示词	明确不要做什么、要避开什么	官方 3D 演示特别要求面板标题不要和 macOS 窗口按钮重叠
出问题时描述现象	说清你看到的行为，而不是下结论	点击没反应、面板被遮住，比说你写错了有用
让 AI 参照现有风格	指定一个已有的视觉参照物	官方海报设计案例沿用了 Harness 官网的背景和字体

演示案例

接下来大家可以尝试使用创造者模式制作以下项目：

难度	案例	要点
入门	番茄钟插件	悬浮窗、功能单一，最适合作为第一个任务
入门	右下角恐龙跳跃小游戏	学习如何指定插件位置
入门	GitHub Star 数查询插件	插件也可以是给智能体增加的新工具
进阶	世界地标 3D 展示	埃菲尔铁塔、长城、故宫等，左侧栏入口 + 3D 渲染，留一座由 AI 自选
进阶	可玩的 Transformer 3D 演示	做成学习工具；约束要避开 macOS 窗口按钮
进阶	全局换肤（含像素风）	插件可以改整个应用的外观
进阶	海报设计工作台	沿用官网着色器背景与英文字体，默认标题为 Everything is a plugin，要求极简
高级	视频剪辑工作台	深色界面、顶部大预览 + 底部时间线，可上传多视频、剪辑导出，支持自然语言编辑
高级	论文阅读器（右侧栏）	无损保留版式、字体、图片；选中文字可高亮、加笔记、对话中提问
高级	用量统计仪表盘	基于真实对话数据展示 Token 用量、对话数、预估费用与预算、用量时间线

怎么选第一个？建议从番茄钟或恐龙小游戏开始。

先跑通描述 → 生成 → 看效果 → 调整的流程，再挑一个贴近自己需求的案例。

把插件固化为自己的模式

当你积累了几个好用的插件，就走到了创作者模式的完整路径：

检查运行时 → 加载与测试插件 → 观察服务与依赖 → 调整组合 → 固化为新的预设模式

例如你可以组合出写作模式（论文阅读器 + 笔记 + 统计面板），或者数据分析模式。

社区里已有大量插件，可在 GitHub 搜索话题 dsh-plugin，awesome-dsh-plugin 是精选索引。

插件生态还很新，星标数代表关注度而非成熟度。使用别人写的插件前，先确认项目是否还在维护，并浏览一遍插件代码。

模式选择决策表

最后用一张决策表收束全文：从你想做的事出发，反向选择模式。

你想做的事	选择
整理文件、分析数据、改代码、写文档	标准模式
一个步骤很多、需要程序化编排的大任务	PTC 模式
评测模型、排查是模型问题还是环境问题	极简模式
给 Harness 加界面或工具、做自己的预设	创作者模式

安全与注意事项

创作者模式让定制变得容易，但也意味着更多代码在你的机器上运行，以下六点请放在心上。

注意点	说明	建议做法
插件就是代码	生成的或从 GitHub 下载的插件都会运行，权限可能很大	来源不明的谨慎安装，生成的代码建议浏览一遍
实验环境隔离	试验目录可能被读写	只用测试文件夹，不在含密钥或未提交工作的目录里试验
确认弹窗	命令执行前需要你确认	新手阶段逐条看清再同意
日志可追溯	Harness 会把模型看到的一切记录到只追加的日志里	出问题时可以回溯日志定位原因
预览版变动快	仍处于开发者预览阶段，可能有破坏性更新	重要环境固定版本号，以官方 README 为准
费用	Harness 免费，模型调用按量计费	多轮迭代会消耗更多 Token，注意控制轮数

常见问题

下面是初学者最容易产生的四个疑问。

问题	回答
创作者模式是不是最强的模式？	不是。它侧重改造 Harness，日常干活用标准模式更合适
不会编程能用创作者模式吗？	可以，用自然语言描述即可。描述得越清楚结果越好，懂一点基础更容易排查问题
极简模式是给低配电脑用的吗？	不是。它是为评测设计的刻意受限环境
必须用 DeepSeek 的模型吗？	不必须。模型也是插件，可配置其他提供方

返回顶部

∧

菜鸟教程