常见问题
哪里跑问题解答
快速了解如何开始、哪些内容在手机上运行、项目边界，以及遇到故障时先检查什么。
最后更新：
选择下面的问题查看答案。内容只描述当前产品边界，不预设特定服务商、设备发行状态或下载渠道。
开始使用
首次运行 Agent 前需要准备什么？
在“设置 → 模型”中选择服务商和模型，保存该服务商提供的有效 API 密钥，并保持设备联网。随后创建 Web 或 Expo 项目，或导入兼容的代码仓库。
应该选择 Web 还是 Expo 项目？
要制作在 Web Preview 中运行的 React 网站，请选择 Web；要制作在哪里跑固定原生容器中运行的 React Native 项目，请选择 Expo。两种模板都使用同一套项目与 Agent 工作流程。
可以导入现有代码仓库吗？
可以，但仓库需要兼容哪里跑的 Web 或 Expo 运行环境。导入项目通过 runwhale.json 声明入口和 Preview 目标；依赖不受支持的原生代码、二进制文件或构建步骤的仓库不适合当前运行环境。
本地运行与数据
所有内容都在本地运行吗？哪里跑可以离线使用吗？
项目文件、Agent 编排、会话、Node.js 和 TypeScript 工具、受支持的任务、Git、Metro 与 Preview 都在手机上运行。模型推理使用你配置的远程服务商；明确发起的 Git 网络操作和未缓存的依赖下载也会使用网络，因此哪里跑并不是离线产品。
哪些项目数据可能发送给模型服务商？
运行 Agent 时，哪里跑会把你的提示，以及回答所需的项目或会话上下文发送给你选择的服务商。根据具体需求，这些上下文可能包括源代码、文件内容、图片、工具结果和对话历史。
API 与 Git 凭据保存在哪里？
模型 API 密钥与设备 Git 私钥会保存在 iOS Keychain 或 Android Keystore 中，不会写入项目文件、环境变量、Git 配置、Agent 会话、日志或 Preview 包。
兼容性与限制
哪里跑可以使用私有 Git 仓库吗？
可以，但当前指通过 SSH 访问 GitHub 私有仓库。在“设置 → Git SSH 密钥”中生成或复制设备公钥，把公钥添加到 GitHub，再使用仓库的 GitHub SSH 地址。私钥会继续留在设备安全存储中；访问是否成功仍取决于网络和 GitHub 上授予的仓库权限。
项目可以安装任意 npm 软件包吗？
不可以。哪里跑支持 npm 注册表中兼容的纯 JavaScript 软件包。生命周期脚本和二进制链接会被禁用；Git 或路径依赖、原生扩展或二进制文件、动态 Expo 配置插件，以及项目专用原生 SDK 均不受支持。根据权限模式，哪里跑可能会要求你批准安装。
哪里跑会构建独立的 iOS 或 Android 应用吗？
不会。用户项目会作为 Web 或 React Native Preview 目标在当前应用中运行，不会触发 Xcode、Gradle、EAS、IPA 或 APK 构建。
Agent 或 Metro 会在后台继续工作吗？
不要依赖持续后台执行。特别是在当前产品中，iOS 进入后台后不会持续运行 Agent 或 Metro。正在执行开发轮次或构建 Preview 时，请让哪里跑保持在前台。
故障排查
Agent 为什么无法启动？
请确认所选服务商已经保存有效的 API 密钥，并且设备已联网。如果哪里跑报告本地运行环境故障，请先重启运行环境并再次尝试，不要急于修改项目。
Web 或原生 Preview 为什么无法打开？
点击刷新图标（标注为“运行 / 重新加载”），再确认 runwhale.json 声明了预期的 Preview 目标和与之匹配的 Web 或原生入口。阅读界面显示的 Metro 或原生 Preview 诊断，并在请 Agent 修复时使用这条准确且不含敏感信息的内容。
Git clone、fetch、pull 或 push 为什么失败？
请确认仓库使用受支持的 HTTPS 地址或 GitHub SSH 地址，并检查所选分支、网络连接和远程权限。使用 GitHub SSH 时，请确认设备当前公钥已添加到 GitHub。pull 还要求工作树保持干净；包含内嵌凭据的地址会被拒绝。
提交支持请求时应该提供什么？
请提供哪里跑版本、设备型号、操作系统版本、尝试执行的操作、完整错误信息、最少复现步骤，以及应用显示的非敏感诊断。切勿提供 API 密钥、私钥、凭据、私有项目数据、个人数据，或未经脱敏的日志和截图。
仍然需要帮助？
通过分步教程完成第一次完整流程；如果你有私密问题或可以复现的故障，请联系支持。