教程

开始使用哪里跑

配置模型，打开一个真实项目，让 Agent 完成修改，再直接在手机上测试结果。

最后更新：2026 年 9 月 4 日

发送第一条需求前

哪里跑把开发工作区放在手机本地，模型推理由你配置的服务商提供。先完成下面三项检查，首次运行会更顺利。

准备模型 API 密钥

使用你所选模型服务商提供的密钥，只通过哪里跑设置保存，切勿放进项目或提示中。

使用 Agent 时保持联网

模型推理需要网络；Git 网络操作和未缓存的依赖下载也可能需要联网。

从兼容项目开始

选择内置 Web 或 Expo 起始项目，或导入具有有效哪里跑 Preview 入口的兼容仓库。

核心流程

从设置到完成一次真实测试

完成模型设置后，跟随 Baby game 示例创建 Expo 项目、提出游戏需求、批准修改，再到原生 Preview 中试玩 Animal Parade。

设置 → 模型 · 安全保存
配置服务商和模型
打开“设置 → 模型”，选择要使用的服务商和模型，粘贴该服务商提供的 API 密钥，再点击“安全保存”。
密钥会留在设备的安全存储中。Agent 推理使用你选择的服务商，因此发送需求时设备需要联网。
新建项目 · Web / Expo
创建项目或导入仓库
点击“新建项目”，填写名称；要制作 React 网站就选择 Web，要制作使用原生 Preview 的应用就选择 Expo。
本次演示输入 Baby game，选择 Expo，将可选仓库地址留空，然后点击 Create and open Agent。
如果要继续现有代码，可以改为输入兼容的 Git 仓库。导入项目会由 runwhale.json 决定 Preview 目标。
Agent
描述一个明确结果
告诉 Agent 你想构建或修改什么，说明预期行为，并让它运行与当前任务有关的受支持检查。
演示中的完整需求只有“Make a game for baby”。Agent 据此规划了一个使用大触控区域、温和反馈和六张动物卡片的游戏。
审阅 · 仅允许一次 · 活动
跟进过程并审查结果
在 Review（审阅）模式下，Agent 写入 index.tsx 前，哪里跑会请求批准。点击 Allow once（仅允许一次）后，就能在同一会话中继续跟进文件写入和检查活动。
Agent 运行了 TypeScript 诊断和 Git diff。它在结果说明中指出新工作区的依赖尚未解析，随后转到原生 Preview，通过实际运行检查应用。
运行 / 重新加载 · Preview
在 Preview 中运行同一个项目
录屏中，Agent 直接启动了原生 Preview。你也可以在一轮任务完成后点击刷新图标（运行 / 重新加载）。Web 项目使用 Web Preview；兼容的 Expo 项目使用原生 Preview。
不要只看第一个画面，要实际操作结果。如果 Preview 显示诊断信息，返回项目并把这条准确、非敏感的信息用于下一次修复。
原生 Preview · Animal Parade
点击动物，检查游戏反馈
Animal Parade 打开后，在狗、猫、牛、小鸡、青蛙和狮子六张卡片上方显示“Can you find the Dog?”。点击卡片，观察提示和反馈的变化。
演示中可以看到“Yay!”、“Great job!”和“You found it!”等反馈，随后出现下一个寻找动物的提示。需要继续修改时，回到同一个已保存的 Agent 会话即可。