第1章 从“问答”到“交付”

第 1 节 / 共 13 节 课程:DeepSeek Harness 实战课

面向应用者的 DeepSeek Harness 实战课:讲清 API、Agent、Harness 三者关系,带你安装 DSH、写出可验收任务、让 Agent 读文件改代码跑测试、接 MCP/插件、做定时任务,并划清安全边界。12 章 + 6 个附录,不需要编程基础,也不讲模型训练。

这一章先建立判断:什么时候该用聊天窗口,什么时候该把任务交给 Agent。后面所有章节,都围绕“把任务交付出去”展开。

目标观察计划行动验证失败或不完整:回到观察,而不是硬着头皮交付Agent 不是一次生成,而是一个可回退的循环
图 1-1 观察—计划—行动—验证,失败就回到观察

三个场景

整理行业报告:网页版要把十几篇文章一段段粘进去,粘不全、前后不一致、引用找不到。Agent 的做法是:把文章放进文件夹,告诉它“读这个目录,按主题归类,输出带出处的报告,存成 report.md”。它会列文件、读内容、做笔记、写初稿、检查遗漏。

修一个 bug:网页版只能给你“可能有用”的代码。Agent 进入仓库,复现报错、定位文件、改代码、跑测试、把 diff 给你看。你只需要审批命令和修改。

每日简报:网页版每天手动问。Agent 可以设一个每天 8 点运行的任务,抓取、去重、排序、写简报、投递到对话。

三个场景的共同点:目标明确、需要多步操作、需要接触外部世界、需要交付物。这正是 Agent 的战场。

聊天机器人的天花板

限制表现后果
只有对话,没有手脚不能读文件、不能执行命令只能建议,不能交付
上下文有限聊久了忘事、长文档读不全任务一大就失真
没有环境反馈写完不运行、写完不检查错误无法发现
没有权限模型要么什么都不能做,要么什么都能做不敢碰真实系统
不可复现每次重新解释无法沉淀为流程

Agent 的价值不是“模型更聪明”,而是把模型放进一个能观察、能行动、能验证的循环。

Agent 的四个动作

  1. 观察:读任务、读文件、看报错、查资料;
  2. 计划:拆步骤,决定先用哪个工具;
  3. 行动:读写文件、执行命令、调用接口;
  4. 验证:看结果对不对,不对就回到第 1 步。
目标
  ↓
观察环境 → 制定/修正计划 → 执行动作 → 检查结果
  ↑ │
  └──────────── 失败/不完整 ←────────────┘

这个循环解释了 Agent 为什么强,也解释了它为什么翻车:观察错了,后面全错;计划错了,越努力越偏;工具坏了,卡住;验证缺失,自信地交付错误结果。

任务生命周期

  1. 定义目标:到底要什么交付物;
  2. 准备上下文:文件、数据、约束、样例;
  3. 制定计划:先做什么、哪些不能碰;
  4. 执行;
  5. 检查:测试、对照、抽样、找反例;
  6. 修正;
  7. 交付与记录。

新手常只做第 1 步和第 4 步;老手的时间主要花在 2、3、5、7 步。

本章练习

写下你最近一周重复做过 3 次以上的 3 件事,标注:需要读什么、写什么、执行什么、失败怎么发现;判断哪件最适合先交给 Agent。

《DeepSeek Harness 实战课》常见问题

DeepSeek Harness 是什么?

DeepSeek Harness(DSH)不是另一个聊天窗口,而是 Agent 运行台:它把 DeepSeek API、工具、文件、权限、审批和日志组合起来,让模型能读文件、改代码、跑测试,并把任务交付出来。

DeepSeek Harness 和 DeepSeek API 有什么区别?

API 只提供模型推理,按 token 计费;Harness 是运行在 API 外面的外壳,负责给模型工具、上下文、循环、权限和可追溯记录。只有 API 只能聊天,加上 Harness 才能动手做事。

不会编程,能学 DeepSeek Harness 吗?

可以。课程从安装、工作台、提问和验收讲起,不要求先学语法;但读代码、调试、测试和系统设计仍然重要,第 2 章专门讲该学什么、不必学什么。

学完这门课能做什么?

能独立安装并配置 DSH,写出可验收任务,让 Agent 读文件、改代码、跑测试,接入 MCP 或插件,配置定时任务,并判断哪些事不能交给 Agent。

学 DSH 需要什么环境?

Windows、macOS 或 Linux 都可以;命令行方式需要 Node.js 22 以上,桌面端可直接安装;还需要 DeepSeek API Key 和一个专门给 Agent 用的工作目录。