> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 让代理完成安装

把一条现成的提示词粘贴到编码代理中，让它在您的计算机上执行 Mobile 安装，然后检查它为每个步骤写出的报告。

## 枯燥的部分可以交出去

这个存储库是按“编码代理也能读懂”来编写的。它附带一份地图文件（`llms.txt`）、一份规则文件（`AGENTS.md`）、按文件的记忆笔记（`.ai/`）以及任务技能（`.agents/skills/`）。独立的 Mobile checkout 不包含 `prompts/` 文件夹，因此现成的提示词直接印在本指南中——请从下方复制，而不是打开某个文件。

把敲键盘的活交出去并不意味着跳过检查。代理在你的存储库副本中工作，并且必须拿出证据汇报它做了什么。下面几节展示一份合格的报告长什么样，让你始终掌控结果。

这条路径会安装 Expo 应用及其与 Web 后端的连接——即处理账户和数据的服务器。如果您的 checkout 也包含 apps/web，代理可以在本地运行该后端；仅含 Mobile 的 checkout 则需要使用提供给您的可访问后端地址。

[改为手动运行 Mobile 应用](https://supastack.dev/zh/docs/mobile/ship-in-5-minutes.md)


## 先准备好这些

先完成准备指南：安装 Node.js、Git 和编辑器，接受 GitHub 邀请，并把 supastack 文件夹下载到你的计算机。代理在该文件夹内工作，因此[开始之前](https://supastack.dev/zh/docs/mobile/before-you-start.md)中的所有内容依然适用。

你还需要一个能充当编码代理的工具——内置 AI 编码代理的编辑器（AI IDE），或在终端中运行的代理（代理 CLI）。任何具备代理能力的现行工具都可以；提示词已经写明它必须读什么、运行什么，你不必自己编写指令。

最后，确定提示词要求的两件事：您的设备可访问的后端地址——本地后端用计算机的局域网地址，或使用提供给您的 HTTPS 地址——以及您将在哪里查看应用：手机上的 Expo Go、Mac 上的 iOS 模拟器，或 Android 模拟器。


## 复制提示词、填两个空、粘贴

提示词就是下面的代码块——请全选并复制整个代码块。

有两个占位符需要您来选择。把 `<API_URL>` 替换为您的设备可访问的后端地址——同一 Wi-Fi 下的本地后端用您的计算机局域网地址加 3000 端口，或使用提供给您的 HTTPS 地址。把 `<DEVICE: expo-go | simulator>` 替换为 expo-go（实体手机）或 simulator（已安装的 iOS/Android 模拟器）。编号步骤保持原文不变。

```
Set up this supastack Mobile checkout end to end and open the Expo app on **<DEVICE: expo-go | simulator>** against the backend at **<API_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run corepack pnpm install.
3. Create apps/mobile/.env.local from the names in .env.example: EXPO_PUBLIC_API_URL=<API_URL>, EXPO_PUBLIC_APP_SCHEME=supastack and EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off. Never invent a variable absent from .env.example.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <API_URL> answers from this computer and report its status.
5. Start Expo with corepack pnpm --filter @supastack/mobile start and report the QR preview or simulator launch with the real output.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.
```


## 代理拿到提示词后做什么

提示词会把地图、规则和安全检查清单指给代理，并让它按顺序执行安装且逐一证明每个阶段。通俗地说，代理会：

- 动手之前先读仓库地图（`llms.txt`）、项目规则（`AGENTS.md`）和凭据处理规则（`docs/agent-security.md`）。
- 只用 `.env.example` 中出现的名称创建 `apps/mobile/.env.local`，填入您提供的 API 地址和 scheme——代理绝不会发明示例文件中没有的 `EXPO_PUBLIC_` 设置。
- 验证后端在您的地址上确有响应——只有当该 checkout 中存在 apps/web 文件夹时才会自行启动它——而不是假设一台并不存在的服务器。
- 安装依赖并启动 Expo 开发服务器，然后附上实际输出报告二维码预览或模拟器启动情况。
- 同一步骤失败两次后停止并报告——它不会绕过失败，也不会在未询问的情况下删除任何东西。


## 你要在代理报告里检查什么

一份好的报告展示的是证据而不是结论。请寻找每个 PASS 背后的后端 URL 应答、依赖安装完成以及 Expo 服务器输出——而不是“一切正常”这样的一句话。

提示词要求代理在同一步骤失败两次后停止并报告——而不是绕过失败——并在执行任何破坏性操作前询问您。如果您的代理在反复失败后仍继续自行发挥，请停止它，并把第一个错误带到[故障排除指南](https://supastack.dev/zh/docs/mobile/troubleshooting.md)。

有两件事绝不允许出现：为了消除报错而关掉某个安全功能，以及把密码或密钥之类的机密值打印到对话或报告里。看到任何一种，都把这次运行视为失败。

请在头脑里把预览和真实登录区分开。二维码预览成功只说明界面能显示——真实账户需要后端的数据库，真实购买需要 EAS 开发构建。“预览能打开”还不等于“账户可用”。


## 如果你更想自己动手

代理执行的每一步都在下面的手动指南中完整写出——同样的命令、同样的检查，按您的节奏来。

[5 分钟运行 Mobile 应用](https://supastack.dev/zh/docs/mobile/ship-in-5-minutes.md)

[阅读完整的本地安装](https://supastack.dev/zh/docs/mobile/local-setup.md)

[修复安装失败](https://supastack.dev/zh/docs/mobile/troubleshooting.md)


## 下一篇

[5 分钟启动移动应用](https://supastack.dev/zh/docs/mobile/ship-in-5-minutes.md)