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