第 1 章 认识 DSH:模型、Harness、Agent
本章你会学会
- 用一句话解释 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?
因为真实任务需要三样模型本身没有的东西:
- 感知:看见你的文件、目录、网页、报错;
- 行动:写文件、跑命令、调用工具;
- 约束:知道哪些能做、哪些不能做、做完怎么验收。
举个例子。你说:
“帮我把
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 做的三件事。每件事标注:
- 它需要读哪些文件?
- 它需要写哪些文件?
- 它需要运行什么命令?
- 哪些操作你希望它先问你?
写不出来也没关系,第 3 章会教你怎么把任务说清楚。
常见坑
- 把 DSH 当成模型:DSH 只是工作台,模型要单独连接。
- 把 Agent 当成永远记得一切的人:Session 之外的记忆需要你自己设计。
- 一上来就给整个硬盘权限:先用一个专门的小文件夹。
小结
- Agent = Model + Harness。
- DSH 是 Harness,不是模型。
- Session 是一次对话,Workspace 是一个文件夹,Tool 是动作,Skill 是知识。
- Desktop 最适合入门;Web 和 Headless 是不同入口,不是不同产品。
参考
链接均为公开来源;产品行为可能随版本变化。