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

# 你會遇到的詞

用大白話解釋安裝指南、錯誤資訊和產品本身會用到的術語。

## 檔案與資料夾

這些詞描述的是你下載的程式碼。每當安裝指南讓你開啟或編輯檔案時，都會用到這些名字。

- 儲存庫（Repository）——專案資料夾加上它的全部變更歷史，託管在 GitHub 上並複製到你的計算機。
- 克隆（Clone）——儲存庫在你計算機上的副本；由 git clone 命令建立。
- Monorepo——一個儲存庫中放多個應用和共享包；All Platforms 套裝就是一個 monorepo。
- package.json——每個應用或包裡都有的檔案，列出它的名字、命令和所需的庫。
- pnpm-workspace.yaml——monorepo 根部的檔案，列出哪些資料夾屬於該工作區。
- 鎖定檔案（Lockfile）——記錄每個已安裝庫確切版本的檔案，保證每次安裝結果一致。


## 計算機上的工具

首次執行前安裝一次的程式。指南會在 node --version 這類命令中提到它們。

- 終端（Terminal）——輸入命令的視窗，比如 Windows 上的 PowerShell 或 macOS 上的 Terminal。
- Node.js——在瀏覽器之外執行 JavaScript 的程式；套件的伺服器和指令碼都跑在它上面。
- npm——隨 Node.js 捆綁的庫安裝器；在本套件中你主要用它來啟用 Corepack。
- Corepack——啟用專案所指定的確切包管理器版本的工具。
- pnpm——下載庫並執行專案指令碼的包管理器；通過 corepack pnpm 呼叫。
- Git——下載你的儲存庫並記錄你對它所做每一次改動的工具。
- 編輯器或 IDE——用來開啟資料夾、編輯檔案的應用；指南使用 Visual Studio Code。


## 配置用詞

設定儲存在檔案裡，而不是終端裡。這些詞說明它們的位置和叫法。

- 環境變數——形如 EMAIL_PROVIDER=local 的具名設定，改變應用的行為。
- .env——儲存庫根部的檔案，存放資料庫遷移等命令使用的設定。
- .env.local——單個應用的設定檔案，比如 Web 伺服器使用 apps/web/.env.local。
- 機密（Secret）——必須保持私密的值，比如密碼或簽名金鑰；絕不提交它，也別粘進對話。
- API key——外部服務給你的機密字串，讓它認出你的應用是合法呼叫方。
- 提供商（Provider）——套件可用於 AI、郵件、計費、儲存等工作的外部服務。


## 產品裡用到的詞

執行中的應用及其設定介面使用這些術語。Workspace 帶有兩個不同含義——注意看上下文。

- 工作區（Workspace）——在產品中，指一個團隊各自獨立的使用者、資料和設定；在 pnpm 命令中，指 monorepo 內的一個包資料夾，用 --filter 選擇。
- 授權（Entitlement）——伺服器上記錄某個工作區被允許使用付費功能的憑證。
- 遷移（Migration）——建立或更新資料表的帶版本資料庫變更；用命令應用遷移。
- 會話（Session）——告訴伺服器“誰在請求”的登入狀態，直到過期或你退出登入。
- Webhook——外部服務在某事發生（比如賬單已支付）時傳送到你應用 URL 的訊息。
- 賬戶與組織（Account vs organization）——賬戶是一個人的登入身份；組織是成員加入的團隊共享空間，也叫工作區。


## Web 開發用詞

當你在瀏覽器中開啟應用時，執行、構建和部署指南會用到這些詞。

Ctrl + C 指按住 Ctrl、點按 C 再鬆開——它會停止終端中正在執行的命令。

[動手學習命令、檔案和配置](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)

[如何使用這些檔案](https://supastack.dev/zh-tw/docs/web/using-the-docs.md)

- localhost——瀏覽器地址中“這臺計算機”的名字；開發期間你的應用就跑在那裡。
- 埠（Port）——localhost 後面那道帶編號的門，比如 :3000；每個執行中的應用各用一扇。
- 開發伺服器（Dev server）——你工作時持續重建並伺服應用的命令；用 Ctrl + C 停止。
- 構建（Build）——把原始碼變成伺服器可部署的最佳化檔案的那一步。
- 伺服器渲染（SSR）——伺服器先組裝好頁面再傳送，讓第一屏內容完整到達。


## 下一篇

[套件改進時更新你的副本](https://supastack.dev/zh-tw/docs/web/updating-the-kit.md)
