MACOS 三日创造营 · 2026Day 1 · OpenCode 与挑战
跟着路线，一站一站来
从第一次启动，到三个游戏通关
每完成一步，就亲手打一个勾。切换日期或刷新后，进度仍会保留。01STEP
上午 · 认识新搭档
认识 OpenCode、模型和 API Key
老师讲OpenCode 像一位会操作文件和终端的编程搭档，DeepSeek 是它背后的思考引擎，API Key 则像成人保管的服务通行证。
01 学员操作
- 说出终端、OpenCode、DeepSeek 各自负责什么。
- 记住 API Key 不是聊天内容，也不是可以分享的课堂口令。
- 在访达中新建专用课堂文件夹，今天只在这里练习。
!提示词和 OpenCode 读取的项目文件会发送给远程模型处理；不要放个人信息。
02STEP
上午 · 安装工具
在 macOS 安装 OpenCode
老师讲先由老师核对官方命令，再由你在终端手动执行。第一次安装发生在 OpenCode 启动之前。
01 学员操作
- 打开 macOS 的“终端”应用。
- 在老师确认后运行官方安装命令。
- 等待安装结束，不关闭终端。
- 如果学校统一使用 Homebrew，只运行老师指定的备选命令。
查看 OpenCode 官方安装说明↗TERMINAL · 官方推荐安装
curl -fsSL https://opencode.ai/install | bash
TERMINAL · Homebrew 备选
brew install anomalyco/tap/opencode
!不要运行 sudo，不从群文件或陌生网盘下载 OpenCode。
遇到问题？展开排查 +
- 出现网络错误：停止重复尝试，让老师检查网络。
- 出现权限或 sudo 提示：不要输入电脑密码，举手。
03STEP
上午 · 安装验收
确认 OpenCode 可以启动
01 学员操作
- 关闭并重新打开终端。
- 运行版本检查。
- 进入专用课堂文件夹，再运行 opencode。
TERMINAL · 版本检查
opencode --version
遇到问题？展开排查 +
- command not found：先重开终端；仍失败就请老师检查 PATH。
老师讲OpenCode 默认可能很能干，所以课堂开始前要装上护栏：改文件和普通命令先询问，外部目录和危险删除直接拒绝。
01 学员操作
- 确认顶部没有 auto 标识。
- 由老师确认课堂 permission 配置已经生效。
- 记住只选 once，不选 always。
- 遇到 sudo、删除、覆盖或课堂目录之外的请求，选择 reject 并举手。
查看 OpenCode 权限说明↗!权限配置由老师课前完成；学生不自行改成 allow，也不使用 --auto。
05STEP
上午 · 选择连接方式
选择 DeepSeek 连接分支
老师讲课堂网关和 DeepSeek 直连不是同一套步骤。默认使用老师预配置的限额课堂网关；只有成人明确安排时才使用设备专用 Key 直连。
01 学员操作
- 听老师宣布本班使用 A 直连还是 B 课堂网关。
- B 网关：只选择老师命名的课堂 Provider，不输入 DeepSeek 主 Key。
- A 直连：由成人准备每台设备独立、低额度、可撤销的 Key。
- 不要把两条路线混用。
!禁止把共享 DeepSeek 主 Key 分发到学生设备。
老师讲网关模式由老师课前配置；直连模式才使用 /connect 搜索 DeepSeek。
01 学员操作
- 网关模式：启动后找到老师命名的课堂 Provider。
- 直连模式：在成人现场监督下运行 /connect，选择 DeepSeek。
- 直连时由成人处理设备专用 Key，不展示、不截图。
- 出现错误时只告诉老师错误码，不展示 Key。
查看 OpenCode Provider 文档↗TERMINAL · 仅用于成人账号直连
/connect
!网关模式不要运行 /connect → DeepSeek。401 是凭据问题，402 是余额问题，429 是请求过快，都交给成人处理。
老师讲模型会更新和下线，所以教程不写死名称。老师会从当天列表里选择支持工具调用的模型。
01 学员操作
- 运行 /models。
- 进入当前连接分支对应的 Provider。
- 选择老师写在投影上的模型。
- 把最终模型名称与老师核对。
08STEP
上午 · 第一次协作
让 OpenCode 做一张测试卡片
老师讲普通聊天成功还不够，要验证 OpenCode 真的能在专用目录创建文件。
01 学员操作
- 把下面提示词发给 OpenCode。
- 阅读计划后，只批准一次所需的编辑。
- 打开 index.html 检查。
- 让 OpenCode 告诉你怎样在浏览器预览，不让它猜测危险命令。
OPENCODE 提示词 · 第一次任务
请在当前专用课堂目录创建一个 index.html，只做一张写有“你好，OpenCode！”的彩色欢迎卡。先列出计划，等我确认后再编辑；不要读取目录外文件，不运行删除或 sudo 命令。完成后告诉我怎样安全预览。
老师讲你只拿到规则，不拿完整答案。让 OpenCode 先复述规则、列计划，再一小步一小步做。
01 学员操作
- 必做：随机动物订单、选择食材、提交判断、积分和重新开始。
- 正确订单加 1 分并出现下一单；漏料或多料不加分并提示错误。
- 重新开始后分数归零，仍能继续接单。
- 加分挑战：倒计时、连胜奖励或更多动物客人。
OPENCODE 提示词 · 起始提示词
我要制作“动物汉堡店”浏览器小游戏。请先复述玩法并把任务拆成小步骤，只完成第一步后停下来让我检查。不要一次给出完整答案。
老师讲这次提示更少。你要自己告诉 OpenCode 操作方式和游戏结束条件。
01 学员操作
- 必做：方向键移动、障碍物、碰撞结束、分数和重新开始。
- 飞机不能越出画面；躲过障碍后分数增长。
- 碰撞后停止计分；重新开始恢复初始位置和 0 分。
- 加分挑战：生命值、道具或难度递增。
OPENCODE 提示词 · 起始提示词
请和我一起规划“太空飞机”浏览器小游戏。先问我三个最重要的规则问题，再列分阶段计划；每完成一阶段就停下来等我验收。
11STEP
下午挑战 3 · 钻石对对碰
交换相邻钻石，连成三颗
老师讲这是今天最难的挑战，先把规则说准确，再让 OpenCode 实现。
01 学员操作
- 只允许交换上下左右相邻钻石；非相邻交换拒绝。
- 横向或纵向三颗以上才消除；斜线不算，无消除交换要换回。
- 消除后下落补位并计分；无可走步时自动重排。
- 初始和重置棋盘不能自带三连，并且至少有一个有效移动。
OPENCODE 提示词 · 起始提示词
我要制作“钻石对对碰”。请先把相邻交换、有效三连、无效换回、补位、无路重排和重置规则写成验收清单，等我确认后再开始第一阶段。不要一次生成完整游戏。
老师讲今天的重点不是三个游戏有多华丽，而是你能否清楚描述目标、分步检查并安全批准。
01 学员操作
- 选择一个游戏向同学演示。
- 说出一次你修改提示词后变好的地方。
- 检查项目中没有 Key、密码、真实姓名或个人照片。
- 关闭 OpenCode，通知老师课后撤销或轮换课堂凭据。