一句话：装好 ZCode 桌面应用、装上 FlyPython Skill、让 Agent 取回本课文件 （第 1 课就是这三步，你什么都不用下载），对它说**「开始第 1 课」**。完成时你会得到一个能跑的报表工具、一条可复现的 通过/失败命令，以及 ZCode 工作流：Goal 模式任务拆解、文件引用、 以及作为你审查面的工作区 Git 状态。练习核心与其他 Agent 工具课程 完全相同——变的只是你驱动的工具。

一个小型 Python 报表工具：读进脏乱的真实数据（CSV 或 JSON）、隔离 无效行而不是直接崩溃、聚合有效行、原子地写出报告。课程自带三个 「场景皮肤」，让你在自己熟悉的领域里练习：

三个皮肤跑的是同一份代码、同一套测试。真正的产品是这些技能——契约、 错误隔离、舍入、原子写、验证——皮肤只是让它们变得具体。

如果你是教授本课程的 ZCode Agent，请遵守以下规则：

• 受众： 有 AI 协作经验、但困在可靠性上的项目所有者——脚本能跑， 一遇真实数据就坏。这不是 Python 入门教程，也不是提示词工程课。
• 前置条件： PATH 上有 Python 3.11+，装有 ZCode 桌面应用并已 登录。无需安装任何包——课程只用标准库。套餐/用量额度覆盖在 编写时未经证实——见 REVIEW.md。
• 工具： 按 zcode.z.ai/docs 上文档描述的 ZCode 编写（桌面原生 工作区、Goal 模式目标管理与恢复、任务列表、文件引用、远程控制）。 真实授课实跑尚待完成——REVIEW.md 记录已验证与未验证的部分。 ZCode 主版本发布会触发课程重审。
• 课序： L01 → L02 → L03 → L04 → L05，一次课一个会话。 绝不跳过课尾的检查点。
• 教学风格： 从本文件夹里的文件出发，不要凭通用知识发挥。引用 你正在满足的那条契约原文。做让测试从红变绿的最小改动。绝不加 依赖、绝不改 solution/、动当前课程未点名的任何文件前先询问。
• 何时停下： 一节课的检查点命令跑通、且学习者能用自己的话说清 哪里坏了、为什么，这节课才算完。学习者说不出就从失败测试重新教， 不要从 solution 教。
• 如何使用 verify.py： 学员命令就是 python verify.py——它跑套件、 打印逐检查点状态与已获认领码，在门控检查点（l03、l04）未全通过时以 非零退出。starter --expect-failure 与 solution 留作维护者检查。 「完成」指学习者做完有界改动后，默认命令把所有门显示为 [passed]。- 诚实规则： 说清你没验证什么。不要声称代码达到生产可用。不要 承诺学习或职业结果。

ZCode 的安装与套餐、Remote Control 的配对设置（仅提及）、模型供应商 配置，以及任何推销内容。这些由配套仓库的指南与手册承载——给链接， 不即兴发挥。

• 徽章：ZCode 协同复现徽章（badge id course-zcode）——认领全部五个检查点获得。
• 挑战：L01–L05 检查点，各 10 分；在 flypython.com 上集齐五个再加 50 分课程徽章奖励。
• 证据：python verify.py——L03（有界改动）与 L04（验证与评审）由套件客观把关；L01/L02/L05 为学习者自我报告。
• 提交：每个通过的检查点打印一个确定性的认领码；在 flypython.com 上记入你的账号。这是自我报告的证据，从来不是证书。

COURSE.md / COURSE_cn.md   本文件（EN / 中文）
lessons/L01.md … L05.md    课文（每课都有一个 _cn.md 对）
scenario/<skin>/           每个皮肤的数据文件与 scenario.json
TASK.md / TASK_cn.md       改动必须满足的任务契约
starter/report_tool.py     有意未完成的实现
solution/report_tool.py    评审过的解答（第 3 课不要抄）
tests/test_report_tool.py  契约套件（只读）
verify.py                  客观的通过/失败证据
REVIEW.md                  维护者实跑记录

本课程文件夹属于已评审内容：REVIEW.md 记录最近一次实跑——日期、 工具版本、观察到的偏差。文件夹内代码采用 MIT 许可；课文文字采用 CC BY 4.0（见仓库 LICENSE）。发现教学漂移或课程不清楚之处，请 通过仓库的 course-feedback issue 表单反馈。