实验 01 · 22 分钟 · 入门
第一个可打开的作品
用一个 HTML 文件完成从想法、生成到浏览器预览的完整闭环。你不需要先学会写代码。
完成后你能
本课目标
- 认识项目文件夹、HTML 文件和浏览器预览
- 给 Agent 一条包含内容与验收条件的任务
- 完成第一次基于真实页面的修改
开始前
准备这些
- 打开一个能创建和编辑文件的 AI Agent
- 新建空文件夹 agent-web-course
- 准备你的姓名、一个学习目标和一个真实链接
01 · 先把终点说清楚
本课只做一件事:得到一个双击即可在浏览器打开的个人探索卡。先不要追求复杂动效,也不要拆成多个文件。单文件能减少第一轮失败点。
把姓名、目标和链接换成你自己的真实内容。真实内容会暴露排版问题,示例占位符不会。
- 在 agent-web-course 中创建文件夹 01-first-artifact。
- 告诉 Agent 只能在这个文件夹内工作。
- 复制下面的 Prompt,并替换方括号里的内容。
复制给 Agent
请在当前项目的 01-first-artifact 文件夹中创建 hello-artifact.html。
目标:做一张能在浏览器直接打开的个人 AI 探索卡。
内容:姓名是「[你的姓名]」;目标是「[你的目标]」;加入链接「[链接文字]」并指向「[https://...]」。
约束:只用一个 HTML 文件;CSS 和 JavaScript 写在文件内;不加载外部框架、字体或图片;中文排版清楚;手机宽度不横向滚动。
验收:页面有且只有一个 h1;链接能点击并在新标签页打开;宽度 390px 和 1440px 时内容都完整。
完成后说明你创建了什么文件,以及我应如何打开它。02 · 打开真实结果
先查看文件是否真的存在,再用浏览器打开。不要只相信 Agent 的“已完成”。网页工作最可靠的证据永远是可见结果。
- 在文件列表找到 hello-artifact.html。
- 双击文件,或在 Agent 提供的预览中打开。
- 点击真实链接,确认目标地址正确。
- 把浏览器缩窄到接近手机宽度,观察是否出现横向滚动。
03 · 做一次可验证的修改
第一次迭代不要说“再高级一点”。要求一个能用眼睛确认的变化,例如标题变短、按钮文案更明确、链接获得键盘焦点样式。
- 刷新浏览器,而不是打开旧截图。
- 按 Tab 键移动焦点,确认按钮有明显轮廓。
- 对照 Agent 的说明,在页面上逐项指出结果。
复制给 Agent
请修改 01-first-artifact/hello-artifact.html:
1. 把主标题改为「我正在用 AI 做真实作品」;
2. 把链接呈现为明确按钮,按钮文字使用动作动词;
3. 为键盘焦点加入清晰可见的轮廓;
4. 保留原有单文件与移动端约束。
修改后逐条说明四项要求分别落在页面哪里。04 · 留下本课证据
保存文件,并截取一张桌面宽度和一张手机宽度的页面图。截图不是装饰,它能帮助你在后续课程里比较作品如何变化。
- 确认文件位于 01-first-artifact/hello-artifact.html。
- 记录一句复盘:哪条要求最容易遗漏?
- 完成下方检查点后进入下一课。
不要跳过
完成检查
逐项在真实页面中验证。勾选状态只保存在这台设备的浏览器中。
0 / 5 已完成
这一课完成了。产物留下来,下一课会继续用到。
常见错误
卡住时先看这里
- 让 Agent 自由决定所有内容
- 至少提供姓名、目标、链接和四条验收标准。
- 页面第一次生成后就结束
- 做一次可观察的修改,并刷新真实页面验证。
- 一开始就引入框架
- 首课坚持单 HTML 文件,先缩短反馈回路。
可选加练
再多走一步
加入一句不超过 40 字的自我介绍,但仍要保证手机首屏能看到主按钮。