7 天学会 DeepSeek Harness

完成第一次
可撤销的小修改

建立 Git 基线,让 Harness 只完成一个小改动,并通过差异检查确认范围。

预计阅读 24 分钟公开免费核验于 2026.08.19
内容目录 当前:第 03
7 天完成第一个 AI 项目7
7 天学会 DeepSeek Harness7
7 天建立 Agent 工作流7
7 天做出个人知识库7
本文目录 8 个部分

大家好,我是云途。今天允许 Harness 第一次写文件,但改动必须很小,而且能够撤销。

我们会先建立基线,再修改一份 README。这样你能清楚看到它改了哪里,而非凭页面印象判断。

先理解今天的原理

可撤销任务包含三个条件:修改前有基线、修改范围足够小、修改后有验证。Git 差异能展示新增、删除和变化位置,是检查 Agent 文件操作的基础工具。

第一次写入任务要避免跨多个文件。一个小修改可以验证权限、路径、编码和差异查看流程,为后面的真实项目建立安全习惯。

项目基线、允许修改的文件和验证证据共同构成安全工作区。终端输入窗口Shell解释命令路径指出位置项目限定范围
项目基线、允许修改的文件和验证证据共同构成安全工作区。

为什么今天要做这件事

  1. 基线能在出错时快速恢复。
  2. 小范围任务便于理解每一处改动。
  3. 差异检查可以发现任务外修改和意外生成文件。

开始前检查

这是第 03 天。先完成下面的检查,再开始操作。缺少关键材料时,先补材料,不要让 Agent 猜。

  1. Harness 可以稳定启动并识别正确目录。
  2. Git 已安装;无法提交时也要能运行 git statusgit diff
  3. 练习目录不包含任何生产代码或隐私资料。

一步一步完成

第 1 步:创建最小 README 并初始化 Git

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚,让第二天重新打开项目时仍然知道它的用途。

  1. 创建最小 README 并初始化 Git。
  2. 打开新材料逐项检查,删除示例占位内容,补上本次真实信息。
  3. 记录保存路径,并确认关闭页面或重新打开项目后仍能找到。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 2 步。
完成这一步后,你应该看到:创建最小 README 并初始化 Git,产物内容完整并且可以重新找到。

第 2 步:保存首次基线,确认工作区干净

这一步负责确认事实。请以当前页面、文件或命令输出为准,同时记下来源、版本和检查时间,避免只凭印象继续操作。

  1. 保存首次基线,确认工作区干净。
  2. 把看到的实际信息摘出来;教程与本机不同的地方单独标注。
  3. 保存链接、截图或命令输出,确保之后可以复查。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 3 步。
完成这一步后,你应该看到:保存首次基线,确认工作区干净,相关来源和实际结果已经保存。

第 3 步:要求 Harness 只增加“练习目标”一节

先把这一项单独完成,再继续后面的动作。操作过程要留下可以检查的材料,方便发现偏差时回到当前步骤。

  1. 要求 Harness 只增加“练习目标”一节。
  2. 记录输入、实际动作和得到的结果。
  3. 对照今日目标检查;结果不一致时,先保存证据并处理当前问题。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 4 步。
完成这一步后,你应该看到:要求 Harness 只增加“练习目标”一节,过程与结果均有可复查证据。

第 4 步:运行状态与差异检查,逐行阅读修改

这一步负责确认事实。请以当前页面、文件或命令输出为准,同时记下来源、版本和检查时间,避免只凭印象继续操作。

  1. 运行状态与差异检查,逐行阅读修改。
  2. 把看到的实际信息摘出来;教程与本机不同的地方单独标注。
  3. 保存链接、截图或命令输出,确保之后可以复查。
  4. 对照今天的目标检查这一项,发现偏差时先处理偏差,再进入第 5 步。
完成这一步后,你应该看到:运行状态与差异检查,逐行阅读修改,相关来源和实际结果已经保存。
VS Code 中 add.js 修改前后的 Git 差异
真实软件截图:VS Code 的 Git 差异视图只出现一行变化,左侧基线是减法,右侧工作树改为加法。它证明修改范围与任务要求一致。

第 5 步:验证内容正确后保存提交;发现越界时立即恢复

这一步会生成后续课程继续使用的材料。文件名、保存位置和内容边界需要写清楚,让第二天重新打开项目时仍然知道它的用途。

  1. 验证内容正确后保存提交;发现越界时立即恢复。
  2. 打开新材料逐项检查,删除示例占位内容,补上本次真实信息。
  3. 记录保存路径,并确认关闭页面或重新打开项目后仍能找到。
  4. 对照今天的目标完成最后检查,确认所有证据已经保存。
完成这一步后,你应该看到:验证内容正确后保存提交;发现越界时立即恢复,产物内容完整并且可以重新找到。
VS Code 集成终端运行 add.test.js 并显示 PASS
真实软件截图:在同一个练习仓库中运行测试后得到 PASS,同时保留上方一行 Git 差异。终端中的本机账号与设备名已经模糊处理。
建立基线并检查修改SHELL
mkdir dsh-seven-day
cd dsh-seven-day
printf '# Harness practice\n' > README.md
git init
git add README.md
git commit -m 'initial practice'

# 让 Harness 只修改 README.md 后运行:
git status --short
git diff -- README.md
如果本机尚未配置 Git 提交身份,至少保存原文件副本并使用 diff 检查。
当天操作记录MARKDOWN
# 第 03 天操作记录

## 今天使用的入口与版本

## 实际完成的步骤
- [ ] 1. 创建最小 README 并初始化 Git。
- [ ] 2. 保存首次基线,确认工作区干净。
- [ ] 3. 要求 Harness 只增加“练习目标”一节。
- [ ] 4. 运行状态与差异检查,逐行阅读修改。
- [ ] 5. 验证内容正确后保存提交;发现越界时立即恢复。

## 保存的证据
- 文件:
- 截图:
- 命令或测试结果:

## 与文章不同的地方

## 下一步
请填写实际发生的情况。没有执行的步骤保持未勾选,遇到的差异直接写入记录。

这次真实操作得到了什么

S02 第 3 天真实操作结果
一行可撤销修改完成闭环
  1. 练习仓库先提交基线 c43208f;只把 add.js 的减法修成加法,失败测试变为 PASS,测试文件没有变化。
本次实际结果:git diff 可以证明修改范围,git restore 可以回到基线。

正确结果长什么样

完成操作后,用结果来判断今天是否学会。页面能打开或命令能运行,只能说明流程启动了;下面这些证据同时出现,今天才算完成。

  1. 修改前工作区有明确基线。
  2. Harness 只修改了 README,没有新增无关文件。
  3. 差异内容与任务要求逐项对应。
  4. 能够恢复到修改前状态,或保存一条清楚的提交记录。

常见错误与恢复

一次要求改很多文件

撤回任务,只保留 README 的一个小节。

看到结果正确就不看差异

运行状态和差异检查,确认没有隐藏改动。

工作区原本就有未保存变化

先区分并保存原有变化,再开始 Harness 修改。

留给明天的材料

结束前把今天的关键结果保存到项目目录。下一天会直接使用这些材料,保存清楚可以减少重复说明和错误猜测。

  1. 带 Git 基线的练习项目。
  2. 第一次修改的差异和验证记录。
  3. 明确的恢复方法。
完成检查

第 03 天完成检查

  • 修改前工作区有明确基线。
  • Harness 只修改了 README,没有新增无关文件。
  • 差异内容与任务要求逐项对应。
  • 能够恢复到修改前状态,或保存一条清楚的提交记录。

官方依据与延伸阅读

DeepSeek Harness 官方仓库图文教程:Harness 安全启动图文教程:Harness 插件判断