DSH入门

第 1 章 认识 DSH:模型、Harness、Agent

约 5 分钟 · 2,372 字 · 11 个小节

本章你会学会

  • 用一句话解释 DSH 是什么;
  • 分清“模型”“Harness”“Agent”三个容易混淆的词;
  • 知道 Session、Workspace、Tool、Skill 分别在说什么;
  • 知道自己该用 Desktop、Web 还是 Headless。

1.1 一个公式:Agent = Model + Harness

先记住一个公式:

Agent = Model + Harness

拆开看:

词 你可以把它理解成 它负责什么
Model(模型) 大脑 理解你的话、推理、写文字、写代码
Harness(脚手架/工作台) 手、眼睛、工具箱、工作台、规章制度 读写文件、执行命令、搜索网页、保存会话、控制权限
Agent(智能体) 正在工作的助手 模型 + Harness 组合起来,真正去完成任务

如果只有模型,它像一个很聪明但被关在房间里的人:能思考、能说话,但看不见你的文件,也不能帮你运行程序。

Harness 把房间打开:给它文件、终端、浏览器、工具、记忆和规则。它才能从“聊天”变成“干活”。

DeepSeek Harness,简称 DSH,就是这样一个 Harness。[1]


1.2 DSH 是什么,不是什么

它是

  • 一个运行 Agent 的工作台;
  • 一个可以把模型、工具、技能、插件组合起来的宿主;
  • 一个支持 Desktop、Web、Headless 多种入口的平台;
  • 一个“几乎一切皆插件”的可扩展系统。

它不是

  • 不是模型本身。DSH 不包含“DeepSeek 的大脑”,你要连接一个模型服务。
  • 不是普通的聊天软件。它的重点不是陪你聊天,而是读写文件、执行任务、交付结果。
  • 不是只有程序员才能用。日常任务完全可以用自然语言完成。
  • 不是绝对安全的。它能执行真实操作,所以权限和审查很重要。

一句话:

DSH 是 Agent 的工作台,不是 Agent 的大脑。


1.3 五个核心词

先认识五个词,后面会反复出现。

Agent:正在工作的助手

Agent 不是“一个模型”,而是“模型 + 当前工作区 + 当前会话 + 可用工具 + 当前模式”的组合。

同一个模型,换一个工作区、换一个模式,能力就不一样。

Session:一次对话

Session 是你和 Agent 的一次连续对话。

  • 同一个 Session 里,它记得前面说过什么;
  • 新建 Session,它不会自动继承上一个 Session 的全部上下文;
  • 一个工作区可以有很多 Session。

你可以把 Session 理解成“一次会议记录”。

Workspace:工作区

Workspace 是一个文件夹。Agent 默认在这个文件夹里读文件、写文件、执行命令。

  • 工作区是你的“项目边界”;
  • Agent 的很多权限,都以工作区为边界;
  • 不要一上来就把整个用户目录当工作区。

Tool:工具

Tool 是 Agent 能执行的一个动作,比如:

  • 读文件;
  • 写文件;
  • 修改文件;
  • 执行终端命令;
  • 搜索网页;
  • 启动子代理;
  • 交付文件。

Tool 是 Agent 的“手”。

Skill:技能

Skill 是一份“操作手册”,告诉 Agent:

  • 遇到某类任务时,应该先做什么、后做什么;
  • 有哪些注意事项;
  • 可以调用哪些脚本或参考资料。

Skill 不是工具,它不直接执行动作;它是知识,帮助 Agent 更稳定地使用工具。

Tool 是“手”,Skill 是“操作规程”,Model 是“大脑”,Harness 是“工作台”。

后面还会遇到 Preset、Plugin、Bundle、Profile,先不用急,第 7、8 章会讲。


1.4 为什么需要 Harness

你可能会问:模型已经很聪明了,为什么还要 Harness?

因为真实任务需要三样模型本身没有的东西:

  1. 感知:看见你的文件、目录、网页、报错;
  2. 行动:写文件、跑命令、调用工具;
  3. 约束:知道哪些能做、哪些不能做、做完怎么验收。

举个例子。你说:

“帮我把 notes/ 里的三篇文章合并成一份摘要。”

模型可以写摘要,但它需要 Harness 帮它:

  • 找到 notes/ 目录;
  • 读取三个文件;
  • 写入 summary.md;
  • 确认文件真的写成功了;
  • 在你允许的范围内操作。

没有 Harness,这些动作都发生不了。


1.5 三种入口:Desktop、Web、Headless

DSH 可以用不同方式启动。对 0 基础用户,建议从 Desktop 开始。

入口 适合谁 特点
Desktop 绝大多数人 图形界面,点按钮,最容易上手
Web 想在浏览器里用、或跑在远程服务器上的人 打开一个网址,界面与 Desktop 类似
Headless 自动化、脚本、批量任务 命令行一次性执行,没有图形界面

三种入口共享同一套核心概念:Agent、Session、Workspace、Tool、Skill、Preset、Plugin。[2]

本书以 Desktop 为主。遇到 Web/Headless 的不同之处,会用“换一种入口”小栏说明。


1.6 本书怎么读

  • 日常用户:读第 1–7 章,足够覆盖 90% 的使用场景。
  • 想装插件/技能:加读第 8 章。
  • 想做插件:再加第 9 章。
  • 遇到问题:直接翻第 10 章。

不要试图一次记住所有名词。先会用,再理解。


马上试试

拿出一张纸,写下你想让 Agent 做的三件事。每件事标注:

  1. 它需要读哪些文件?
  2. 它需要写哪些文件?
  3. 它需要运行什么命令?
  4. 哪些操作你希望它先问你?

写不出来也没关系,第 3 章会教你怎么把任务说清楚。


常见坑

  • 把 DSH 当成模型:DSH 只是工作台,模型要单独连接。
  • 把 Agent 当成永远记得一切的人:Session 之外的记忆需要你自己设计。
  • 一上来就给整个硬盘权限:先用一个专门的小文件夹。

小结

  • Agent = Model + Harness。
  • DSH 是 Harness,不是模型。
  • Session 是一次对话,Workspace 是一个文件夹,Tool 是动作,Skill 是知识。
  • Desktop 最适合入门;Web 和 Headless 是不同入口,不是不同产品。

参考

  1. DeepSeek Harness 官方网站
  2. DeepSeek Harness GitHub 仓库

链接均为公开来源;产品行为可能随版本变化。


↑