第 35 课教师讲稿｜让 AI 找到相关代码，然后用证据检查修改

对应 AIPath 第 7 阶段 Cursor 案例，60 分钟。学生将处理一个只有四个文件的原创小项目：合计学习时长，却把没有填写的时长当作了零。主问题是“编程工具找到一段代码以后，怎样知道它找全了必要条件，改动也符合要求？”本课不要求从零背 JavaScript 语法；教师带学生认输入、转换、求和、调用和检查五个动作。

学完可以独立做什么

学生能够依据错误现象找到规则、计算函数、调用输入和测试；能够说明代码检索与把整个仓库全读一遍的区别；能够给一个候选修复准备正常、边界及调用兼容的核验记录。实际成果是四文件项目的原始失败、修改差异与测试结果，或浏览器中相同规则下的本地验证记录。拥有已可用 Cursor 的学生可让工具协助阅读和编辑；课堂网页本身不会调用 Cursor。

本课不把 AI 生成了多少行代码当作成绩。学生可以使用工具提出修复，但必须能说清：它从哪里看到了规则，哪些输入以前错了，修改后有没有把本来允许的输入也拒绝。若环境还没有准备好，保留真实完成的浏览器计算，不把安装和登录故障混成算法理解失败。

教师课前准备：让课堂时间用在读代码和判断结果

准备已安装可运行的 Node.js，不在这 60 分钟临时下载运行时。把以下四个文件放到同一个自建目录 ai-study-time。这是独立练习目录，不打开学生的真实业务项目：

• README.md：规则与操作约定。
• total.cjs：待修复计算函数。
• main.cjs：三条示范输入和实际调用。
• test.cjs：八个固定输入的检查脚本。

教师用自己的终端先运行 node --version，再在练习目录执行 node main.cjs 与 node test.cjs。初始程序故意不符合全部规则，测试出现 FAIL 是预期教学素材，不要课前把它修好。四文件无安装依赖、不联网。终端找不到 node、文件保存成 .cjs.txt 或当前目录不对时，先纠正这一层，不连续让 AI 改代码“修复”环境问题。

同时打开本课“找到时长合计的错误，再检验候选修复”，默认关键词 minutes、原始直接转换版、三条 25、15、空格记录。核心按钮“检索摘录并运行检查”。确认能看到自定义记录、Number 转换示意、八个固定检查三部分，再复位。无 Node 或无 Cursor 的学生直接用本地网页；这仍是真实 JavaScript 运算，但不是实际编辑器检索或 AI 修改。

完整任务和四份证据

业务规则写在 README：输入是记录数组，每条 minutes 可以是数字或只含十进制数字的字符串，字符串允许首尾空格。换算后必须为 1 至 480 的整数。空串、全空格、零、负数、小数、布尔值、null、缺字段与非数字字符串拒绝。空数组返回零。历史调用还在传字符串，因此不能随意把接口改成只收数字。

学生必须看到的原函数只有三行：

function total(rows) {
  return rows.reduce((sum, row) => sum + Number(row.minutes), 0);
}

逐个给符号贴中文含义：rows 是一叠记录；row 是当前这条；row.minutes 取这一条的时长；Number 尝试转成数字；sum 是目前累计值；末尾 0 是从零开始。reduce 这个名字暂时只需理解成“逐条处理并累计”，不让零基础学生在开头背完整函数式编程定义。

main.cjs 实际给了阅读 25、练习 15、复盘一个空格。规则希望未填写的复盘触发拒绝，不能偷偷计零。test.cjs 把八个事先定义的输入和预期放在一起，既含这次错误，也含本来应该工作的正常情况。README、函数、调用、测试是四种证据，不能用其中一份代替其他三份。

0—6 分钟｜先说清“算出 40”为什么可能是错的

教师展示 main 的三条记录，说：“前两条能加成多少，大家都会。第三条没填。你希望程序把它当零，还是提醒数据没填完？生活里两种设计都可能存在，但这次 README 已经给定了规则，我们要检查实现是否服从规则。”学生完成 Q1，先按规则写预期，再猜旧程序实际会怎样。

这里一定先问规则，后看代码。若学生说输出数字就是成功，追问：“这三条里有一条没有合法时长，40 是否表达了全部记录已经有效？它与只提交两条有效记录有什么差别？”让学生在纸上分成“数学合计”和“输入是否合法”两栏。程序有结果，不等于任务要求得到满足。

教师打开 README 标注范围 1—480 和字符串兼容，再打开 total 函数。说：“AI 编程工具也需要这些条件。如果我们只说‘修一下’，它可能修成与原本约定不同的功能。今天我们会把缺陷、边界和验收标准写出来，让建议有可以对照的对象。”

6—12 分钟｜从四文件找到一条因果链

请学生按 Q2 在编辑器文件树依次打开 README、total、main、test，写每份文件回答的问题。用编辑器全项目搜索输入 minutes，点击一处函数命中和一处调用命中。没有编辑器时使用页面摘录检索，明确页面只查四段精选文字，并不读取磁盘项目。

教师说：“知道精确名字时，可以按字找；只记得‘合计学习时长’这种意思时，某些工具会用语义检索辅助找相关片段。但找到片段后仍要打开前后文和调用位置。标题再像、相似分数再高，也不能替你证明这就是全部调用。”让学生画出 main 输入 → total 转换累计 → test 比较预期，并把 README 画在旁边作为共同规则。

官方公开证据简要说明即可：Cursor 的索引工程文章介绍了根据内容变化更新索引、按语法切块与形成嵌入表示等做法；搜索文档也提供按名称和文本查找的说明。教师只借此解释“变化检测 → 分块 → 表示与索引 → 查找 → 取回相关上下文”的用途，不宣称课堂四文件检索复现了 Cursor 内部系统。

12—18 分钟｜真正运行，找到空格变成零的那一步

具备 Node 的学生在练习目录打开终端，先运行 node main.cjs，保留完整输出，再运行 node test.cjs。教师投影终端时保留输入命令和当前目录，让学生看到输出来自哪个文件。若显示 Cannot find module，先核对目录与文件名；这不证明函数算法错了。

浏览器后备学生点击“检索摘录并运行检查”，保持原始版本。每人抄一个中间过程：原始 minutes 是一个空格字符串，类型是 string，Number 转换显示什么。教师说：“Number 是 JavaScript 的转换规则，不是 AI 读懂了‘没填’。程序没有先按业务规则判空，于是把一个不应参与计算的输入送进了合计。”

运行八个检查后，让学生先数正常、空数组和字符串调用这几项，找出为什么旧程序不是完全不能用，却仍不能交付。此处不要求全班背通过率；更重要的是把 B 空格失败指到具体输入与转换步骤。让学生写 Q3 的错误定位句：“当……输入经过……时，程序……，但 README 要求……。”

18—25 分钟｜给 AI 一项清楚的阅读任务

已经有可用 Cursor 的学生通过 File → Open Folder 打开练习目录，进入 Agent 面板。具体界面名称以已安装版本为准；找不到对应面板时用编辑器的命令面板搜索 Agent。先粘贴以下任务，不要求新购订阅，也不往账户里添加付款：

这是课堂原创学习时长项目。请先阅读README.md、total.cjs、main.cjs、test.cjs，不修改文件。
问题：main里minutes只有空格，却输出了合计。请指出输入从哪个文件进入，在哪一步被转换，并引用实际文件和函数。
解释规则对空白、数字字符串、整数范围、空数组的要求。列出最小修复计划以及需要保留的正常和边界测试。
没有读取到的文件请明确说明，不推测已经看过整个项目。

请学生核查输出是否真的引用 total 与 main，有没有把 README 的“数字字符串也允许”漏掉。若工具给的答案没有实际引用，学生自己打开文件补核，不用反复要求“更专业”。没有 Cursor 的学生照这个阅读清单用四文件或本地摘录回答相同问题，并标记人工阅读。

教师继续说：“这里第一步限定阅读，是因为我们正在练定位。读完计划后，下一步会明确让它改具体范围。过程不应停在它说‘可以修’；要看到真实文件差异和测试。”若工具已偏离课程范围去引入数据库、框架或统计模型，使用 Stop 停止当前生成，回到三行求和与输入规则。

25—32 分钟｜比较一个很像修好了的候选

教师给出候选逻辑 if (!row.minutes) throw ...，翻译成“如果原始值在 JavaScript 的真假判断中为假，就拒绝”。不要把它说成“字符串没有可见内容”。让学生先预测空格字符串和 0 能否被拦住。随后在网页只把程序版本改为“仅增加真假值判空”，运行并检查 B、C 两行。

教师问：“空格看起来空，字符串长度却不是零。我们用的是哪套规则在判断？”请学生口头区分人的视觉、语言转换规则与本课业务规则。然后比较只判真假值与完整校验版：后者先检查类型、字符串格式，再检查换算后的整数范围，最后才参与求和。

不需要初学者当场发明正则表达式。说明 /^\d+$/ 在本课只用于判断去掉首尾空格后是否全是十进制数字；Number.isInteger 再判断数字是否整数；1 与 480 是业务给定边界。小数、负数、布尔值不能因为能转成某个数就自动被允许。请学生做 Q4，写两个能区分候选的输入，不能只写“多测一下”。

32—38 分钟｜实际修改并检查差异

Cursor 路径学生在同一项目提出第二条明确请求：

现在执行最小修复。只修改total.cjs中与输入校验有关的代码，保留导出的total名称以及数字、十进制整数字符串两类调用。
按README拒绝空白和非法类型/范围，空数组仍返回0。不要删除或放宽已有八个测试，不安装依赖，不改其他项目。
修改后运行node main.cjs与node test.cjs，报告真实结果和未运行的部分。

让学生打开文件差异，检查新增校验是否发生在累加之前、函数名字和导出有没有变化、测试预期是否被改成迎合错误。教师按Cursor 的代码审阅课程中可见的差异审阅与测试思路组织检查；实际按钮位置随版本确认，不根据本课网页冒称已操作了产品。

不能实际改文件的学生在网页选择完整校验版运行，读八项结果，填写“浏览器候选逻辑检查已完成；实际项目编辑未完成”。有 Node 但无 AI 工具者可由教师带着人工添加校验，在本课独立目录执行。教师参考修复放在答案区，独立练习仍由新输入检验，不能只复制最终通过截图。

38—48 分钟｜独立任务：旧错误之外还能发现什么

给学生 Q5 的新材料，不展示答案。A 为 12 与字符串8两条 minutes；B 为字符串00；C 为首尾有空格的字符串7；D 为 true；E 为缺 minutes 的对象。每题先写规则预期，再把工作纸的完整记录 JSON 放入实验，选择已校验版运行并记录。未修复项目的同学也可以用后备验证，但要写清实际执行位置。

教师巡查只问“哪个规则支持你的预期”“首尾空格和全空格在这题一样吗”“原始类型是什么”。不要提前公布数值或拒绝结论。学生需要选一个失败输入解释阻止它进入合计的检查层；再选一个合法字符串说明为什么不能简单改成只收数字。

后半段发出迁移卡：“另一个调用方仍把 minutes 作为字符串传入；AI 建议把函数改成只收数字，并称目前所见测试都通过。”请学生独立写还需检索哪里，以及怎样证明接口兼容。这里不增加服务器或数据库部署任务；只要求识别没看到的调用证据是待查，不能从一个函数的局部正确直接跳到整个项目安全。

48—54 分钟｜讲评与一段可信的修改说明

独立段结束再打开答案。先比较 A、C 与 B、D、E 的规则依据，而不是只报一串结果。教师说：“如果你猜错，但运行后找到了类型、格式或范围中的具体一层，已经形成了可复查的修订。把测试预期直接改成程序输出，反而丢掉了最有价值的差异。”

请学生写 Q6 修改说明：“空格时长原先经 Number 被当零，现在按规则先拒绝无效输入；保留数字字符串调用和空数组；实际执行了……；还未覆盖……。”工具协助的部分如实注明，不把人工候选说成 Cursor 自动生成，也不把八例通过说成适用于所有输入。学生两人互读，检查是否同时有问题、改动、证据和限制。

54—60 分钟｜回看索引与代码质量的联系

教师画六格：本地文件变化 → 定位变化部分 → 切分相关片段 → 更新可检索表示 → 按问题取回材料 → 修改与验证。请学生把这节课亲手做过的格子用实线圈出：打开文件、精确搜索、修改、执行检查；未实测的 Cursor 嵌入索引与后台更新用虚线标。讲的是公开流程作用，不拿课堂记录去断言完整产品结构。

问：“如果只改 total，为什么我们仍读 main 和 README？”让学生用字符串调用与空数组规则举例。再问：“八个测试全过以后，接下来的合理工作是什么？”可答保存版本与证据，针对新使用场景补真实需求和相关案例；不必无限新增与任务无关的测试，也不能立即推广成万能数据系统。

最后交付 Q1 预测、四文件角色图、原始失败、候选对比、独立新输入记录与修改说明。实际操作 Cursor 的同学另交真实文件差异与终端输出。工具尚不可用的状态保留，课程不会把它统计成产品已跑通。60 分钟结束时，学生应能把“AI 帮我改好了”换成“我知道它改了哪里，并留下了为什么符合这些规则的证据”。

后置讲评、板书和补救

原始默认总数 40，但按规则应拒绝第三条空格记录；原版八例通过 3 个，仅真假值检查通过 4 个，完整校验版通过 8 个。独立题 A 合计 20；B 拒绝零值；C 合法为 7；D 布尔拒绝；E 缺字段拒绝。迁移题要查调用方、接口约定与传参测试，不能默改成只接收数字。

板书：规则 → 实际输入 → 转换与校验 → 结果；找到一段代码不代表找齐全部条件；修改差异＋正常/边界/调用检查。 如果学生读不懂 reduce，让他把三条卡放在桌上，逐条说当前值与累计值；算法概念可以先于语法熟练。如果终端出错，写下原错误和目录，切换浏览器继续同一规则实验，另列环境问题待解决，避免吞掉整节课。

课后可在已授权的非敏感小项目中添加一项真实需求，再重复阅读、最小修改和针对新场景的验证。不引入真实同学学习记录做能力排名。本课 Node 与网页指定案例可以检验局部代码行为，不能代替外部产品完整验收或真人试教。

公开来源与原创范围

• AIPath 对应课：课序和主题。
• Cursor 官方索引工程文章，2026-01-27：公开索引流程的有限依据。
• Cursor 官方搜索文档：精确查询与相关上下文查找的操作说明。
• Cursor 官方审阅与测试课程：差异审阅和测试的基本用法。

四文件项目、分钟安排、材料摘录、候选程序和独立题为本课原创。随课浏览器不是 AI IDE，也不是 Cursor 内部实现的复刻。真实工具操作是否完成，以学生保留的实际记录为准。