5

本地验收;云端 Agent 与对外部署的边界

用 Git 固化可审阅结果;说明何时不要把任务丢到云端 Agent,以及「能本地跑」和「已上线」的差别。

图文8 分钟Cursor 官方文档 ↗

课程目录5 / 5

学习位置仅保存在当前浏览器,有效期 180 天。

01 / 图文教材

本地验收与上云边界

本课的完成定义仍是本机可运行、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、对外上线。
  • 课程目标已达到:可审阅的小全栈,而不是演示片。