第 2 天

先解释项目,再做一次最小修改

今天继续使用个人造物名片。先看懂文件之间的关系,再把一次修改压缩到最小,练习让计划、改动和结果彼此对得上。

建议时间
45-60 分钟
完成标志
项目地图 + 修改记录

继续使用昨天的项目

打开第 1 天创建的项目,或解压个人造物名片起步包。先确认页面还能正常打开。今天不增加功能,只解释现状并修改一行可见反馈。

共同练习项目个人造物名片网页起步包已经完成第 1 天项目的学员不必重复下载

先让 Codex 画出项目地图

“读懂项目”不是背代码。你只需要知道入口在哪里、每个文件负责什么、一次点击经过了哪些位置,以及这次应该动哪里。

只读分析
请先不要修改任何文件,也不要安装依赖。

请阅读当前项目,并用零基础学习者能听懂的语言输出一份“项目地图”:
1. 列出实际存在的文件和文件夹,不要补写你猜测的内容。
2. 说明哪个文件是打开网页的入口。
3. 说明页面结构、样式和按钮反馈分别写在哪里。
4. 按真实顺序解释:打开页面后,浏览器怎样加载内容;点击按钮后,哪段逻辑怎样更新页面。
5. 指出修改按钮反馈文字时,最可能需要改哪个文件,哪些文件不需要动。
6. 如果有无法从文件确认的地方,请明确写“无法确认”。

最后用“文件 / 作用 / 与其他文件的关系 / 本次是否需要修改”四列整理,不要执行修改。
index.html页面入口与内容

浏览器直接打开它。页面结构和按钮反馈逻辑都在这里。

styles.css外观与手机适配

由入口文件加载,负责颜色、排版、间距和按钮样式。

README.md运行说明

告诉使用者怎样打开、填写和检查页面,不参与网页运行。

这张图只对应课程起步包。你的项目如果文件不同,以 Codex 真实读取的结果为准。

核对它有没有讲真话

看见陌生文件怎么办

先问它“这个文件是否参与当前页面运行,证据是什么”。不要因为名字像配置文件就随手删除。

只改一处按钮反馈

下面这份指令故意很窄。它能帮助你看清一次修改从计划、确认、执行到验证的完整链条。

最小修改
现在只做一次最小修改:

把点击“查看我的第 16 个案例”按钮后显示的反馈文字,改为:
我的第一版目标:邀请一位真实用户试用。

边界:
1. 只修改实现这句反馈所必需的文件和位置。
2. 不改页面结构、颜色、字体、按钮文字和其他内容。
3. 不安装依赖,不创建新文件,不修改项目文件夹以外的内容。

执行前先告诉我准备修改哪个文件、哪段内容,以及验证方法。等我确认后再修改。完成后给出实际修改摘要和复测结果。
确认计划时只看三件事
  • 修改文件是否与项目地图一致。
  • 计划中是否出现了范围外的重构、依赖或新功能。
  • 验证方法是否真的需要打开页面并点击按钮。

真实打开页面复测

先由你亲手刷新页面并点击按钮,再让 Codex 整理记录。页面能打开、按钮能点击、只出现新文字,才算完成。

完成后复测
请检查刚才的最小修改,不要顺手优化其他内容。

请回答:
1. 实际修改了哪个文件?
2. 修改前和修改后的文字分别是什么?
3. 页面是否仍能正常打开?
4. 点击按钮后是否只显示新的反馈文字?
5. 页面其他可见内容是否保持不变?

如果无法真实验证,请明确说明未验证,不要写“已经完成”。
下载材料第 2 天项目地图与修改记录Markdown,按真实项目填写
当天交付物

项目地图 + 修改记录

你的记录应该能回答:项目原来怎样运行、为什么只改这个位置、修改后怎样证明它仍然正常。

进入第 3 天