跳轉到內容
supastack
瀏覽檔案
WebNext.js

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/glossary.md (or send Accept: text/markdown).

你會遇到的詞

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

詢問本指南
開啟方式

檔案與資料夾

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

  • 儲存庫(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 再鬆開——它會停止終端中正在執行的命令。

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

常見問題

14 個問題

supastack 是什麼?

supastack 是用於構建 AI 驅動 SaaS 產品的模組化基礎。它把通用基礎設施整合在一起,讓你專注於產品專屬的功能。

它支援 Web 和移動端嗎?

支援。supastack 包含 Next.js 與 Expo 應用,作為 Web 與移動端體驗的起點。

包含哪些認證方式?

Better Auth 覆蓋郵箱/密碼、OTP 與社交登入。個人工作區隨賬戶一起開通,產品記錄從第一天起就有邊界。

AI 是如何支援的?

supastack 包含可配置的多供應商 AI、用量追蹤、預算,以及加密的自帶金鑰(BYOK)支援。

訂閱如何處理?

對於基於該套件構建的產品,Stripe 計費、訂閱與許可權構成付費訪問的基礎。供應商金鑰僅存於服務端。

我的產品專屬程式碼放在哪裡?

產品專屬功能保留在獨立的程式碼庫中,產品通過配置接入 supastack 的基礎模組。

supastack 如何定價?

套件為一次性購買、終身更新:單棧 249 美元(Next.js(Web)、Expo(iOS 與 Android)、Tauri(macOS 與 Windows 桌面)倉庫任選其一),雙棧 398 美元(任選兩個倉庫),或完整套裝 399 美元(全部三個倉庫與完整 monorepo),每個額外開發者席位 75 美元。套件本身沒有訂閱。本站結賬後通過郵件傳送許可證金鑰,倉庫訪問通過 GitHub 邀請授予。

工作區如何界定我的資料?

使用者記錄按 workspaceId 劃定邊界。身份、許可權、AI 用量、計費事件與審計條目都留在個人工作區邊界內。

後臺任務如何工作?

Trigger.dev 是明確的任務執行時。JobRunner 契約只承諾 enqueue、status 與 cancel——工作流語義保持 Trigger.dev 專有且顯式。

郵件與營銷觸達有何不同?

事務性郵件覆蓋產品工作流,如任務完成通知。冷觸達與營銷活動屬於產品自身的範疇,不在本套件的郵件模組內。

移動端購買如何運作?

移動端已支援 RevenueCat 原生購買和恢復購買,訪問許可權由服務端驗證。釋出前需配置商店賬戶並完成裝置測試。Web 計費保持獨立。

AI 供應商金鑰存放在哪裡?

自帶金鑰憑證經過加密且僅存於服務端。金鑰在日誌中被脫敏;用量與預算在工作區級別保持可見。

結賬支援哪些付款方式?

Stripe 託管結賬接受銀行卡,在 Stripe 賬戶啟用後還可提供支付寶與微信支付——方便中國買家。錢包授權為非同步確認,付款完成後許可證頁面會立即更新。

我能申請退款嗎?

獲得程式碼倉庫訪問許可權後,supastack 將永久歸你所有,因此無法退款。但請放心,你將獲得包含終身更新的完整原始碼,可為你自己或客戶構建併發布無限數量的產品。你只需注意不能轉賣程式碼,也不能將倉庫作為啟動模板二次分發。唯一的例外是上線返現——上線一款用 supastack 打造的真實產品並公開分享,在購買後 60 天內達到 5,000 次自然瀏覽或 50 個自然按讚,即可退還已付款項的 50%;詳見條款。

TW
主題