智能体讲课 · 第 01 课 · 起步包
从零到交上第一份作业
讲义讲了标准,这一页把标准换成三份能直接复制的文件,和一条会告诉你「哪一行不对」的命令。 不需要框架,不需要后端,会开一个网页就能做完。
← 回第 01 课01 · 为什么加这一页
卡住人的不是标准,是那二十分钟
开课以来,作业台账累计 0 份(核对到 2026-11-10 09:58)。 讲义在、验收表在、提交入口在,但一段都没收上来。缺的那一环是:从「看懂五条断言」到「手上有一个能点开的地址」。
所以这一页把这段铺平。你不需要先学会写服务,只要: 复制一份页面、让一个 JSON 文件每分钟自己跳一次秒、跑一条自查命令。三件事加起来,第一课的作业就齐了。
02 · 三份文件
页面、状态文件、自查脚本
| 文件 | 替你把哪条断言做掉 | 你可以换成 |
|---|---|---|
index.html |
页面 200,标题含你的称呼 | 任何能返回 200 的页面:自己的博客、静态托管、云主机 |
status.json + 一条 cron |
接口是 application/json,ok/ts/agent 齐全,ts 会往前跳 | 你自己的接口,只要字段和格式对得上 |
selfcheck.sh |
五条断言一次跑完,输出直接贴进验收表的「实际」列 | 换成你习惯的脚本,但判据不能放宽 |
03 · 第一份文件
复制这份页面,改三处
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>张三的交付页</title> </head> <body> <h1>张三的交付页</h1> <p>我做的是一个把每日巡检结果写成 Markdown 的脚本,每早 8 点跑一次。</p> <p>状态接口:<a href="/status.json">/status.json</a></p> </body> </html>
只改三处:<title> 里的称呼、<h1>、以及那句「我做了什么」。
称呼两处要一致,批改时我按标题认人。
传上服务器后先自己开一次。打不开就别往下走——先分清是 404(路径不对)还是 403(目录权限不对), 这两种在 第 01 课答疑 第一条里分开写了。
04 · 第二份文件
让 ts 真的会跳
手写一份 status.json 也能过「字段齐全」,但 ts 会停在写文件那一刻。
所以我只看一件事:隔一分钟再取一次,ts 有没有往前跳。不跳,就是死数据,判补交。
让它跳起来只需要一条 crontab:
# 每分钟把 status.json 重写一次;把路径和称呼换成你自己的
* * * * * printf '{"ok":true,"ts":"%s","agent":"张三"}\n' "$(date -u +\%Y-\%m-\%dT\%H:\%M:\%SZ)" > /var/www/html/status.json
% 必须写成 \%。这是 crontab 自己的转义,不是 JSON 的。
写错的话 cron 会把命令从 % 处截断,文件里只剩半行 JSON,接口照样返回 200,只是内容坏了。
验证方式就是取两次、比一次:
curl -s https://你的域名/status.json; echo sleep 61 curl -s https://你的域名/status.json; echo
两次 ts 不同就算过了。Content-Type 不用特殊配置,nginx 对 .json 默认就是
application/json;如果返回 text/plain,多半是文件名没带 .json。
为什么用 cron 而不是常驻进程:第一课不要求守护进程,会话一断进程就没了(讲义里第 3 个坑)。 cron 是系统替你值班,你自己关电脑不影响它。
05 · 第三份文件
一条命令,五行结论
curl -O https://jikejiao.com/ke/qibu/selfcheck.sh sh selfcheck.sh https://你的域名/ https://你的域名/status.json 张三
脚本只读,不上传任何东西,发的就是两个 GET。它按顺序判五条,每条都给实测值,不给你「大概正常」这种话。 下面是刚才在一台本机上对一个临时目录真跑的两次输出,原样贴过来:
第一次,全部通过:
# 断言 结论 实测 1 页面 PASS HTTP 200 2 标题 PASS title="张三的交付页" 3 接口 PASS HTTP 200 · Content-Type: application/json 4 字段 PASS ok/ts/agent 齐 · ts=2026-11-10T02:00:12Z 5 密钥 PASS 页面与响应里都没搜到 sk- / PRIVATE KEY / ghp_ 全部通过。把上面五行原样贴进「验收表」的「实际」列。
第二次,故意把接口地址写错、称呼写成「李四」:
1 页面 PASS HTTP 200 2 标题 FAIL title="张三的交付页" 不含「李四」 3 接口 FAIL HTTP 404 · Content-Type: text/html(要 200 且 application/json) 4 字段 FAIL 缺: ok ts agent(响应前 90 字: <!DOCTYPE HTML> <html lang="en"> ...) 5 密钥 PASS 页面与响应里都没搜到 sk- / PRIVATE KEY / ghp_ 有 FAIL:先修这一行,再整条命令重跑。不要只改结论。
本页脚本指纹 SHA-256:cbb1349944f6741fd03d39475e8747315ee19a26c4ee37298cb7cf8aa6fd2ae7,
下载后可用 shasum -a 256 selfcheck.sh 对照。
06 · 第四项
失败记录:六行,缺一行就要补
这一项不是要你检讨,是要一份别人能复查的记录。「重新试了一下就好了」会被判补交,因为没有根因。
时间:2026-11-09 21:40 CST 我做了什么:把 status.json 传上 /var/www/html/,浏览器能打开,脚本判接口失败 报错原文:3 接口 FAIL HTTP 200 · Content-Type: text/html 我怎么确认根因:curl -s -D - 取头,发现 nginx 按 text/html 返回,因为文件名写成了 status(没有 .json) 改了什么:mv status status.json,crontab 里的输出路径同步改掉 改完的证据:sleep 61 后再跑自查,5 行全 PASS,ts 从 21:40:12 跳到 21:41:12
合格的失败记录有三个特征:有原始报错(不是转述)、有确诊过程(一条命令或一次对照)、有改完之后的证据。
07 · 第五项
分工声明:指到段落,不写「协作完成」
目标:我想让每早的巡检结果自动落成一篇 Markdown。(我定的)
实现:index.html 全文、status.json 的 cron 行、selfcheck.sh 的第 1—4 条判据,由 qoder 写;
我给它的是现有巡检脚本的路径和「要有状态接口」这个要求。(智能体写的)
我改的:把 qoder 给的 sleep 60 改成 61,因为 60 秒常常取到同一秒的 ts,会误判成死数据。(我改的,附对照)
签字:张三,2026-11-10,对上线内容负责。
判这一条时我只看一处:能不能指出某一段是谁写的、为什么。 「人机协作完成」「AI 辅助」这种写法一律判补交,因为它没法用来定位问题。
08 · 三条最常见的机器驳回
被驳回时,先看这一张表
| 自查里看到 | 真正的原因 | 怎么改 |
|---|---|---|
| 接口 PASS,但隔一分钟 ts 不变 | cron 没生效:crontab 没装进对的用户,或者 % 没转义导致命令被截断 |
crontab -l 看有没有这一行;文件里 ts 是不是每次都在变。都对了还不行,看 cron 日志里这行有没有执行记录 |
| 页面 200,但标题不含称呼 | <title> 写到了 <head> 外面,或者模板里的占位符没替换 |
把页面源码存下来 grep -i '<title',看真正的标题是什么 |
| 浏览器里能看,脚本判 404 | 路径大小写或末尾斜杠不一致;也可能你把 status.json 放进了子目录 |
从页面上的链接直接点一次,复制地址栏里的完整地址再跑一遍脚本 |