第 1 课：装好 DeepSeek Harness、装上 FlyPython Skill、让 Agent 取回课程

第 1 课：装好 DeepSeek Harness、装上 FlyPython Skill、让 Agent 取回课程

目标

本课结束时，DeepSeek Harness 已经跑起来、FlyPython Skill 已装好（联网权限已 打开），Agent 已把本课文件取回你的工作目录——你没有手动下载任何 东西。文件夹就位后，你运行课程的客观检查命令，并解释「starter 失败」在测试名里的含义。本课不改任何代码。

第 1 步——把 DeepSeek Harness 跑起来

装好 DeepSeek Harness（deepseek-harness 项目的 Python 包）并配置好模型插件——你自己提供的 API key 或本地 端点——在一个空工作目录里启动会话。

第 2 步——（可选）预装 FlyPython Skill

这一步可选：第 3 步的开课句子会直接从 URL 读取 Skill，不装也能上课——预装只是省掉一次权限往返。

Harness 会读取项目根目录的 AGENTS.md：

curl -s https://flypython.com/skills/flypython/SKILL.md >> AGENTS.md

Agent 请求联网时批准；如果沙箱禁网，就自己跑 curl，把文件粘贴 过去。

Skill 只是一个文件，在每个工具里都一样：它告诉 Agent 如何为你 授权、取课程文件、验证、提交认领码。

第 3 步——让 Agent 取回本课文件（你不下载）

在工作目录里新开一个会话/对话/线程，粘贴这一句话：

Read https://flypython.com/skills/flypython/SKILL.md and start the FlyPython course hands-on-with-deepseek-harness.

Agent 会给你一个授权链接和一组短码。打开链接、登录、核对码与 Agent 显示的一致后点「允许」，然后对 Agent 说「好了」。它取一次 token，把本课文件写到 courses/hands-on-with-deepseek-harness/。

前提：这些课程需要一个能执行命令并且能联网的编码 Agent。 只能聊天的网页 AI 做不了。

为什么有这一课

AI 写的 Python 大多是同一种死法：演示输入能跑，真实输入一到，脚本 在第 3 行崩掉——或者更糟，悄悄算出一个错的数。修复不从更好的 提示词开始，而从把「坏了」变成一条任何人都能跑、且得到相同答案的 命令开始。DeepSeek Harness 再加一层：你跑的 Agent 是组装出来的 ——模型、工具、存储、循环都是 cordis.yml 里接好的插件——它走的 每一步都落进可检查、可搜索、可重放的只增轨迹日志。「相信我」变成 「这是轨迹」。

热身（2 分钟）

打开 starter/report_tool.py，从头读到尾。它看起来很合理：带 docstring 的函数、类型标注、CLI。这正是 AI 生成代码的样子—— 表面干净、行为缺失。现在打开 TASK.md，放在手边。

本课内容

本课文件现在已经位于 courses/hands-on-with-deepseek-harness/——你这边没有发生任何下载。 让 Agent 先只读不动手：

“读 COURSE.md——它是本文件夹的教学契约。再读 TASK.md 和 starter/report_tool.py。不要改任何文件。告诉我测试期望哪些行为、 starter 缺了哪些。”

趁它读的时候，运行学员命令——整个课程你只需要这一条检查命令：

python verify.py

你会看到 starter 复现五类真实世界故障，外加两个端到端后果——共七个具名失败测试——并与测试名一一对应：

失败的测试	真实含义
test_load_json_records_returns_list_of_dicts	工具只处理 CSV；API 场景直接崩
test_unsupported_suffix_raises_value_error	一个 .xlsx 上传变成莫名其妙的崩溃，而不是清楚的拒绝
test_invalid_records_are_isolated_with_reasons	一个空单元格中止整个运行——没有部分报告，没有原因
test_group_totals_are_rounded_to_two_decimals	0.1 + 0.2 在报告里打印成 0.30000000000000004
test_write_report_creates_missing_parent_directories	工具无法写进新建的输出目录
test_run_scenario_writes_report_file、test_main_prints_summary_and_returns_zero	上述问题的端到端后果

想看缺失行为对应的失败测试名，维护者命令会打印它们：

python verify.py starter --expect-failure

（参考答案 solution/ 是给维护者证明目标可达用的。你不需要运行 它，它也从来不是完成标准——你的实现（starter/）才是。）

现在做 Harness 原生的一步：检查会话轨迹。找到 Agent 读 TASK.md、 跑（或被告知）verify 命令、产出总结的那几步。轨迹是只增的——它是 发生之事的底账，也是以后让 Agent 工作可审计的依据。

练习

挑一个你最有代入感的场景皮肤（excel-report、data-monitor 或 api-tool），打开它的数据文件，找出会被拒绝的行。先不看运行结果， 写下每个坏行会触发哪个测试，再对照上面的表自查——并在轨迹里找到 Agent 得出相同结论的那一步。

检查点

在课程文件夹里运行 python verify.py。不看材料能回答下面三个 问题即算通过：

1. 哪五个行为把 starter 和 solution 区分开？其中哪两个失败测试是它们的端到端后果？
2. python verify.py 为什么故意以非零退出——它在报告什么状态？ 为什么这是成功条件而不是报错？
3. 在轨迹的哪个位置能证明 Agent 确实读过 TASK.md？

本检查点的认领码已经在默认命令的输出里——能回答这些问题之后再 提交。

预期证据

默认命令的完整输出记录、你找到的轨迹步骤、加你的三个答案。保留好 ——第 4 课还会用到。