跳轉到內容
supastack
瀏覽檔案
移動端Expo

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh-tw/docs/mobile/agent-setup.md (or send Accept: text/markdown).

讓代理完成安裝

把一條現成的提示詞貼上到編碼代理中，讓它在您的計算機上執行 Mobile 安裝，然後檢查它為每個步驟寫出的報告。

詢問本指南
開啟方式

枯燥的部分可以交出去

這個儲存庫是按“編碼代理也能讀懂”來編寫的。它附帶一份地圖檔案（llms.txt）、一份規則檔案（AGENTS.md）、按檔案的記憶筆記（.ai/）以及任務技能（.agents/skills/）。獨立的 Mobile checkout 不包含 prompts/ 資料夾，因此現成的提示詞直接印在本指南中——請從下方複製，而不是開啟某個檔案。

把敲鍵盤的活交出去並不意味著跳過檢查。代理在你的儲存庫副本中工作，並且必須拿出證據彙報它做了什麼。下面幾節展示一份合格的報告長什麼樣，讓你始終掌控結果。

這條路徑會安裝 Expo 應用及其與 Web 後端的連線——即處理賬戶和資料的伺服器。如果您的 checkout 也包含 apps/web，代理可以在本地執行該後端；僅含 Mobile 的 checkout 則需要使用提供給您的可訪問後端地址。

先準備好這些

先完成準備指南：安裝 Node.js、Git 和編輯器，接受 GitHub 邀請，並把 supastack 資料夾下載到你的計算機。代理在該資料夾內工作，因此開始之前中的所有內容依然適用。

你還需要一個能充當編碼代理的工具——內建 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 伺服器輸出——而不是“一切正常”這樣的一句話。

提示詞要求代理在同一步驟失敗兩次後停止並報告——而不是繞過失敗——並在執行任何破壞性操作前詢問您。如果您的代理在反覆失敗後仍繼續自行發揮，請停止它，並把第一個錯誤帶到故障排除指南。

有兩件事絕不允許出現：為了消除報錯而關掉某個安全功能，以及把密碼或金鑰之類的機密值列印到對話或報告裡。看到任何一種，都把這次執行視為失敗。

請在頭腦裡把預覽和真實登入區分開。二維碼預覽成功只說明介面能顯示——真實賬戶需要後端的資料庫，真實購買需要 EAS 開發構建。“預覽能開啟”還不等於“賬戶可用”。

如果你更想自己動手

代理執行的每一步都在下面的手動指南中完整寫出——同樣的命令、同樣的檢查，按您的節奏來。