> ## 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

# 本地安裝

使用精確的 Windows 和 macOS 命令在您的計算機上執行 Web 演示，無需付費提供商憑據，並且具有通往真實資料庫支援帳戶的清晰路徑。

## 1.準備好電腦並開啟專案

首先完成在開始之前：接受 GitHub 邀請，安裝 Node.js 22 或更高版本、Git、編輯器和 Corepack，然後克隆您的 Web 儲存庫或所有平臺 monorepo。在編輯器中開啟 supastack 資料夾，然後選擇 Terminal → New Terminal。您應該在編輯器的頂級檔案列表中看到 package.json。下面的所有命令都從此儲存庫根目錄執行。

這將啟動本地演示，無需人工智慧、計費或電子郵件提供商的帳戶，也無需 Docker。為首次依賴項下載留出額外的時間。在後續步驟中僅遵循 Windows 塊或僅遵循 macOS/Linux 塊；不要同時執行。

[安裝工具並獲取程式碼](https://supastack.dev/zh-tw/docs/web/before-you-start.md)

[瞭解如何執行命令和編輯檔案](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)


## 2. 建立配置檔案——macOS/Linux

在您的終端中，執行下面的每一行。第一個副本為以後的遷移命令建立 .env。第二個建立 apps/web/.env.local，Web 伺服器實際讀取它。兩者都包含示例的本地設定。如果任一目標檔案已存在，則保留它並跳過該複製命令；不要覆蓋儲存的設定。 Windows 使用者使用下一部分。

corepack pnpm install 下載應用程式所需的庫。如果 Corepack 要求下載 pnpm，則回答 y。等待完成並返回終端提示符。如果最終訊息 Done 沒有錯誤，則意味著您可以繼續。

```
cp .env.example .env
cp .env.example apps/web/.env.local
corepack pnpm install
```


## 2、建立配置檔案——Windows PowerShell

在包含 package.json 的資料夾中的 PowerShell 中使用這些命令。如果 .env 或 apps/web/.env.local 已存在，請跳過其複製行並保留您的設定。啟動伺服器之前等待安裝完成。如果指令碼執行被阻止，請使用 corepack.cmd 而不是 corepack，如開始之前中所述。

```
Copy-Item .env.example .env
Copy-Item .env.example apps/web/.env.local
corepack pnpm install
```


## 3. 啟動 Web 伺服器 — 保持此終端開啟

從儲存庫根目錄執行以下命令。它僅啟動 Web 應用程式，因此它可以在純 Web 儲存庫和所有平臺 monorepo 中執行。等待終端顯示 Local: http://localhost:3000 和 Ready。第一頁的編譯時間可能會稍長一些。終端應保持執行；這是預期的。

在所有平臺 monorepo 中，corepack pnpm dev 一起啟動可用的開發工作區。如果存在 apps/docs，則該單獨的檔案應用程式使用 http://localhost:3001. 您正在閱讀的公共指南是 http://localhost:3000/docs. 上的 Web 應用程式的一部分 您不需要埠 3001 即可遵循本教程。

```
corepack pnpm --filter @supastack/web dev
```


## 4. 開啟應用程式並完成一項本地任務

在瀏覽器的位址列中，開啟 http://localhost:3000 以檢視主頁。然後開啟 http://localhost:3000/dashboard. 保留預先填寫的姓名和電子郵件，或輸入您自己的測試值，然後單擊 Start local reference flow。這將建立一個記憶體中的演示工作區；它不會建立持久帳戶或傳送真實的電子郵件。

在演示中，從側邊欄開啟 AI task，輸入一個簡短的請求（例如 Summarize the local Acceptance criteria），然後單擊 Queue local task。當其狀態為排隊時，單擊 Run local task，然後單擊 View result。您應該看到已完成的輸出和 Email queued 狀態。人工智慧的反應是故意偽造的且可重複的；排隊的電子郵件是本地的。重新啟動伺服器會清除該演示資料。

要使用 /auth 進行真實註冊，請首先啟動 Postgres 並使用資料庫和遷移指南應用遷移。此後，來自 EMAIL_PROVIDER=local 的註冊或 OTP 訊息可以在 http://localhost:3000/mail-preview; 上進行檢查，它們不會到達外部收件箱。移動登入也使用這種資料庫支援的身份驗證，而不是演示會話。

[新增Postgres和持久帳戶](https://supastack.dev/zh-tw/docs/web/database.md)


## 5. 停止、重新啟動和修復常見的首次執行問題

成功意味著主頁載入、本地工作區開啟並且排隊任務完成。完成後，單擊伺服器終端並按 Ctrl + C。要稍後恢復，請在儲存庫根目錄中重新開啟終端並重復步驟 3 中的伺服器命令；您不必每次都重新安裝依賴項。

如果 localhost:3000 未開啟，請檢查伺服器終端是否仍在執行並顯示 Ready。如果埠 3000 正在使用，請使用 Ctrl + C 停止其他開發伺服器，然後重試。如果您在開啟 /auth 後看到資料庫錯誤，請返回 /dashboard 進行演示或完成資料庫指南。如果本地演示缺失，請檢查apps/web/.env.local中的APP_ENV=local、AI_PROVIDER=fake、BILLING_PROVIDER=local、EMAIL_PROVIDER=local和JOB_PROVIDER=local，然後重新啟動。

要自定義名稱和營銷文本，請在編輯器中開啟 apps/web/src/marketing/site-config.ts。按照 Branding 獲取確切的欄位和驗證步驟。對於真實賬戶的外觀設定，請先完成資料庫設定，然後開啟/settings/appearance。自動接受命令比首次執行演練花費的時間更長；在工作區命令下找到它們。

[修復首次執行錯誤](https://supastack.dev/zh-tw/docs/web/troubleshooting.md)

[更改產品名稱並複製](https://supastack.dev/zh-tw/docs/web/marketing-site.md)


如果你想繼續完成設定，可以閱讀《[設定資料庫](https://supastack.dev/zh-tw/docs/web/setup-database.md)》。


## 下一篇

[專案結構](https://supastack.dev/zh-tw/docs/web/project-structure.md)