第 5 课
本地验收;云端 Agent 与对外部署的边界
用 Git 固化可审阅结果;说明何时不要把任务丢到云端 Agent,以及「能本地跑」和「已上线」的差别。
课程目录第 5 / 5 课
学习位置仅保存在当前浏览器,有效期 180 天。
本地验收与上云边界
本课的完成定义仍是本机可运行、diff 可审。云端 Agent 与外部托管是可选后路,附带额外泄露面。对照:Cloud Agents 入口说明 · Cloud environment setup · Cursor 工具页
停服务,留下可复现的本地状态
停掉本机 Node 进程。确认 todos.json 不要提交真实个人事项;练习数据可改成两条假数据或恢复为空数组。README 里启动步骤应短到别人能照做。
用 Git 做可审阅快照
查看 status 与 diff。确认没有密钥、没有把依赖目录加进去。若你提交:说明写清「本地待办练习,按 SPEC 验收」,而不是声称已可生产。
再对照规格打勾
- 标准库、单进程、回环地址。
- 三个 API 与页面路径符合 SPEC。
- 没有部署清单、没有 CI 密钥、没有顺便加的登录。
缺哪一条,回到 Agent 做最小补丁,不要开新史诗。
何时不要用云端 Agent
官方可在浏览器 cursor.com/agents 跑 Cloud Agents:在云端环境改仓库,完成后可开 PR。本练习默认不要开。出现以下任一情况就留在本地:
- 仓库或工作区里还有真实密钥、客户数据、未脱敏待办。
- 你还没有读完 diff,不能解释每一处改动。
- 任务其实是「在我这台机器上听 3456 端口」——云端环境对不上你的本机验收。
- 只是想省掉阅读计划:云端并行不会自动让规格变清楚。
若以后真用云端:先换无密钥的公开练习仓,并阅读 Cloud environment setup,而不是把本课目录直接授权出去。
「能本地跑」不是「已上线」
把进程打到公网、配反向代理、配托管平台,都不在本课验收内。旧课把「测完丢到某家托管」写成十几分钟终点,那是营销句,不是工程完成定义。若你个人要部署:另开任务,单独处理 HTTPS、绑定地址、密钥与依赖钉版本;不要让 Agent 在未审 diff 上追加部署配置。
用量习惯(不是套餐推荐)
日常本课这种小任务优先留在 Composer 2.5 / Grok 4.6 所在的 Cursor 自有模型池。第三方前沿模型按 API 价从另一池扣,超额后官方允许按量续用,账单以控制台为准。Bugbot 是按量代码审查,与本课本地 Agent Review 不是同一件事。
失败与安全
- 误把练习仓推到公司远程:按对方托管平台流程收紧可见性,并轮换可能泄露的密钥。
- Agent 主动添加容器和云配置:从 diff 删除,除非你另开了部署课。
你做完应该看到
- 仅靠 README 能再次启动并打开页面。
- 你能用自己的话区分:检查点、Git、云端 Agent、对外上线。
- 课程目标已达到:可审阅的小全栈,而不是演示片。
本课资料
适用环境
- 网页
- iOS
- macOS
- Windows
- Linux




