> ## 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 # 讓代理完成安裝 把一條現成的提示詞貼上給編碼代理，讓它在你的計算機上執行 Web 安裝流程，並檢查它為每個步驟寫下的報告。 ## 枯燥的部分可以交出去 這個儲存庫是按“編碼代理也能讀懂”來編寫的。它附帶一份地圖檔案（`llms.txt`）、一份規則檔案（`AGENTS.md`）、一份分步驟執行手冊（`docs/agent-setup.md`）和一條現成的提示詞（`prompts/agent-setup.md`）。你不必自己逐條學習安裝命令——貼上一條提示詞，代理就會在你的計算機上照著執行手冊執行。 把敲鍵盤的活交出去並不意味著跳過檢查。代理在你的儲存庫副本中工作，並且必須拿出證據彙報它做了什麼。下面幾節展示一份合格的報告長什麼樣，讓你始終掌控結果。 一個需要如實說明的限制：這條自動化路徑安裝的是 Web 應用及其後端——即處理賬戶和資料的伺服器。該提示詞和執行手冊隨 Web 儲存庫以及 All Platforms monorepo 一起提供。純 Mobile 和純 Desktop 檢出則改為攜帶各自限定範圍的 `llms.txt` 和平臺安裝指南。 [在本地安裝 Mobile 應用](https://supastack.dev/zh-tw/docs/mobile/local-setup.md) [執行 Desktop 應用](https://supastack.dev/zh-tw/docs/desktop/run.md) ## 先準備好這些 先完成準備指南：安裝 Node.js、Git 和編輯器，接受 GitHub 邀請，並把 supastack 資料夾下載到你的計算機。代理在該資料夾內工作，因此[開始之前](https://supastack.dev/zh-tw/docs/web/before-you-start.md)中的所有內容依然適用。 你還需要一個能充當編碼代理的工具——內建 AI 編碼代理的編輯器（AI IDE），或在終端中執行的代理（代理 CLI）。任何具備代理能力的現行工具都可以；提示詞已經寫明它必須讀什麼、執行什麼，你不必自己編寫指令。 最後，執行應用的方式二選一：在計算機上安裝 Node.js 22 或更新版本——即準備指南配置好的路徑——或者使用 Docker、Podman 這類容器工具，把應用跑在容器裡，無需安裝 Node.js。在提示詞中選擇其一，代理會照此執行。 ## 複製提示詞、填兩個空、貼上 在編輯器中開啟 `prompts/agent-setup.md`——它位於 supastack 資料夾頂層的 `prompts` 資料夾中，與 `llms.txt` 並列。全選其文本並複製。 有兩個佔位符需要你做出選擇。把 `` 替換為 docker、podman 或 host 之一——host 用你已安裝的 Node.js 直接在本機執行應用；docker 或 podman 則把它執行在容器中。把 `` 替換為應用最終的去處——local-only 只在本機執行、不做任何部署，是首次體驗的合適選擇。 把改好的文本貼上到代理的對話方塊中併傳送。下方填好的第一行展示了 docker 加 local-only 的組合；該行下面的編號步驟保持檔案原樣即可。 ``` Stand up this supastack checkout end to end for **docker** and deploy it to **local-only**. ``` ## 代理拿到提示詞後做什麼 提示詞把代理指向執行手冊和安全規則，並要求它按順序執行、逐階段自證。通俗地說，代理會： - 動手之前先讀倉庫地圖（`llms.txt`）、專案規則（`AGENTS.md`）和憑據處理規則（`docs/agent-security.md`）。 - 用 `node scripts/setup-env.mjs` 建立 `.env` 配置檔案。該輔助指令碼只從 `.env.example` 複製，因此代理絕不會編造設定名；它也會保留你已有的金鑰，而不是覆蓋它們。 - 啟動 Postgres——存放應用賬戶與記錄的資料庫——以及應用本身：docker 或 podman 路徑使用容器，host 路徑則直接在你的計算機上執行命令。 - 在第一次真實登入之前執行資料庫遷移——即建立應用資料表的命令——因為在資料表尚不存在時建立的賬戶是壞的。 - 在每個檢查點驗證對應階段，最後交出一份報告，把每項檢查標記為 PASS、FAIL、BLOCKED 或 NOT RUN，並附上支撐結論的輸出。 ## 你要在代理報告裡檢查什麼 合格的報告展示的是證據而不是結論。每個 PASS 背後要能看到真實的健康響應和命令輸出——而不是一句“一切正常”。 提示詞要求代理在同一步驟失敗兩次後停下並彙報——而不是繞過失敗——並在執行清空資料庫這類破壞性操作前先徵得你同意。如果你的代理在反覆失敗後仍自行發揮，讓它停下，把第一個錯誤帶到[故障排查指南](https://supastack.dev/zh-tw/docs/web/troubleshooting.md)。 有兩件事絕不允許出現：為了消除報錯而關掉某個安全功能，以及把密碼或金鑰之類的機密值列印到對話或報告裡。看到任何一種，都把這次執行視為失敗。 在頭腦中把演示和真實登入分開。`/dashboard` 演示的本地參考流程不需要資料庫，因此它可以獨立通過；而在 `/auth` 建立賬戶只有遷移執行後才會成功。“演示跑通了”還不等於“賬戶能用”。 ## 如果你更想自己動手 上面的每一步也都有對應的逐步點選教程。先跑[五分鐘 Web 指南](https://supastack.dev/zh-tw/docs/web/ship-in-5-minutes.md)完成首次演示，再按 [Web 本地安裝](https://supastack.dev/zh-tw/docs/web/local-setup.md)搭建帶真實資料庫的完整本地環境。 即便安裝不是代理做的，它在安裝完成後依然有用——[代理工作流指南](https://supastack.dev/zh-tw/docs/web/agents.md)涵蓋新介面、改版式和審查等日常任務。 ## 下一篇 [5 分鐘啟動](https://supastack.dev/zh-tw/docs/web/ship-in-5-minutes.md)