教程

开始使用哪里跑

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

最后更新：2026 年 9 月 4 日

发送第一条需求前

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

准备模型 API 密钥

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

使用 Agent 时保持联网

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

从兼容项目开始

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

核心流程

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

下面使用同一个 Snake Sprint 项目，完整展示从创建项目、打开原生 Preview，到测试后续修改的过程。

设置 → 模型 · 安全保存
配置服务商和模型
打开“设置 → 模型”，选择要使用的服务商和模型，粘贴该服务商提供的 API 密钥，再点击“安全保存”。
密钥会留在设备的安全存储中。Agent 推理使用你选择的服务商，因此发送需求时设备需要联网。
新建项目 · Web / Expo
创建项目或导入仓库
点击“新建项目”，填写名称；要制作 React 网站就选择 Web，要制作使用原生 Preview 的应用就选择 Expo。
如果要继续现有代码，可以改为输入兼容的 Git 仓库。导入项目会由 runwhale.json 决定 Preview 目标。
Agent
描述一个明确结果
告诉 Agent 你想构建或修改什么，说明预期行为，并让它运行与当前任务有关的受支持检查。
在 Snake Sprint 示例中，第一条需求把 Expo 起始项目改成竖屏贪吃蛇游戏，并加入移动、计分、控制和碰撞行为。
活动 · 文件
跟进过程并审查结果
查看 Agent 活动、检查它修改的文件，并阅读检查结果。在“审阅”权限模式下，哪里跑会在可写操作前请你批准或拒绝。
如果出现依赖请求，请先核对软件包和计划，再决定是否仅允许本次安装。哪里跑支持 npm 注册表中兼容的纯 JavaScript 软件包；原生扩展、二进制文件、安装脚本和项目专用原生 SDK 不在当前运行环境范围内。
运行 / 重新加载 · Preview
在 Preview 中运行同一个项目
Agent 完成后点击刷新图标（标注为“运行 / 重新加载”）。Web 项目会打开 Web Preview；兼容的 Expo 项目会打开原生 Preview。
不要只看第一个画面，要实际操作结果。如果 Preview 显示诊断信息，返回项目并把这条准确、非敏感的信息用于下一次修复。
后续消息 · 运行 / 重新加载
继续优化并测试真实状态
在同一个已保存会话里提出有针对性的后续要求，不必重新开始。示例中的 Agent 会在现有项目上加入障碍模式。
重新加载 Preview，实际触发新行为并验证关键状态。Snake Sprint 会开启障碍模式，并通过碰撞进入真实的游戏结束状态。