先理解 Harness
的位置和风险

先理解今天的原理

模型负责理解目标和提出下一步，Harness 负责组织会话、上下文、工具调用与执行过程。工具得到权限后可以读写文件、运行命令或访问网络，因此 Harness 的边界会直接影响真实环境。

开发者预览表示接口、配置和插件可能变化。学习时要记录版本、来源、权限和恢复方式。这样升级后出现差异，你能判断变化来自哪里。

为什么今天要做这件事

1. 先理解组件关系，后面遇到错误时才能区分模型、Harness、插件和项目问题。
2. 独立练习区可以避免误改正式项目和隐私资料。
3. 记录版本与官方入口能减少使用过时教程造成的偏差。

开始前检查

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

1. 能够访问官方仓库与 README。
2. 准备一个不含客户资料、密钥和生产配置的练习目录。
3. 确认练习过程中不会连接生产数据库或真实支付服务。

一步一步完成

第 1 步：阅读官方 README 的项目定位、状态和快速开始

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

1. 阅读官方 README 的项目定位、状态和快速开始。
2. 把看到的实际信息摘出来；教程与本机不同的地方单独标注。
3. 保存链接、截图或命令输出，确保之后可以复查。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 2 步。

完成这一步后，你应该看到：阅读官方 README 的项目定位、状态和快速开始，相关来源和实际结果已经保存。

第 2 步：记录仓库地址、核验日期和当前安装入口

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

1. 记录仓库地址、核验日期和当前安装入口。
2. 打开新材料逐项检查，删除示例占位内容，补上本次真实信息。
3. 记录保存路径，并确认关闭页面或重新打开项目后仍能找到。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 3 步。

完成这一步后，你应该看到：记录仓库地址、核验日期和当前安装入口，产物内容完整并且可以重新找到。

第 3 步：画出模型、Harness、工具与项目目录之间的关系

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

1. 画出模型、Harness、工具与项目目录之间的关系。
2. 记录输入、实际动作和得到的结果。
3. 对照今日目标检查；结果不一致时，先保存证据并处理当前问题。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 4 步。

完成这一步后，你应该看到：画出模型、Harness、工具与项目目录之间的关系，过程与结果均有可复查证据。

第 4 步：写允许访问的目录、禁止操作和需要人工批准的动作

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

1. 写允许访问的目录、禁止操作和需要人工批准的动作。
2. 打开新材料逐项检查，删除示例占位内容，补上本次真实信息。
3. 记录保存路径，并确认关闭页面或重新打开项目后仍能找到。
4. 对照今天的目标检查这一项，发现偏差时先处理偏差，再进入第 5 步。

完成这一步后，你应该看到：写允许访问的目录、禁止操作和需要人工批准的动作，产物内容完整并且可以重新找到。

第 5 步：建立七天学习日志，后续每天记录版本与证据

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

1. 建立七天学习日志，后续每天记录版本与证据。
2. 打开新材料逐项检查，删除示例占位内容，补上本次真实信息。
3. 记录保存路径，并确认关闭页面或重新打开项目后仍能找到。
4. 对照今天的目标完成最后检查，确认所有证据已经保存。

完成这一步后，你应该看到：建立七天学习日志，后续每天记录版本与证据，产物内容完整并且可以重新找到。

# Harness 七天练习

## 官方来源
- 仓库：https://github.com/deepseek-ai/deepseek-harness
- 核验日期：2026-08-19
- 当前状态：Developer Preview

## 允许
- 只访问本练习目录
- 运行只读检查和本地测试

## 禁止
- 访问生产项目、真实密钥和客户资料
- 自动发布、付款或删除目录外文件

## 必须人工批准
- 新增插件
- 访问网络
- 批量修改或删除

# 第 01 天操作记录

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

## 实际完成的步骤
- [ ] 1. 阅读官方 README 的项目定位、状态和快速开始。
- [ ] 2. 记录仓库地址、核验日期和当前安装入口。
- [ ] 3. 画出模型、Harness、工具与项目目录之间的关系。
- [ ] 4. 写允许访问的目录、禁止操作和需要人工批准的动作。
- [ ] 5. 建立七天学习日志，后续每天记录版本与证据。

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

## 与文章不同的地方

## 下一步

这次真实操作得到了什么

1. 浅克隆 deepseek-ai/deepseek-harness，固定 commit 99f6f02f…；确认 2026-08-19 仍为 Developer Preview。

本次实际结果：后续截图、命令和结论都有同一版本基线。

正确结果长什么样

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

1. 能用自己的话说明模型、Harness、工具和项目各自负责什么。
2. 练习目录与正式项目完全分开。
3. 官方来源、核验日期和当前状态已记录。
4. 允许、禁止和必须批准的动作写得具体。

常见错误与恢复

留给明天的材料

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

1. 七天练习目录。
2. 边界与批准清单。
3. 官方来源、状态和核验日期记录。