跳轉到內容
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/using-the-docs.md (or send Accept: text/markdown).

如何使用這些檔案

在檔案中找到方向——標籤頁、分組、搜尋和小節連結——並用內建的複製工具把任何一篇指南交給編碼代理。

詢問本指南
開啟方式

頁面是如何組織的

這些檔案是你下載的套件的使用手冊。指南列表上方的介面切換器——Web、Mobile 和 Desktop——分別收納各端的指南:瀏覽器應用、手機應用和桌面視窗。從 Web 開始;它覆蓋每個介面都要與之通訊的伺服器。每個介面都以自己的五分鐘快速上手開篇。

左欄把指南列在“入門”“配置提供商”等命名分組中;點選分組標題即可展開或收起其列表,當前頁保持高亮。右欄“本頁內容”列出你正在閱讀的指南的各個小節——點選即可直達。要按正文中出現的某個詞(比如檔名或設定名)查詢指南,使用左欄頂部的“搜尋”,或按 Ctrl + K(Mac 上為 ⌘K)。

在指南底部,一張“下一篇”卡片——大多數頁面還有“上一篇”——帶你前往相鄰頁面。安裝類指南上方還會顯示一句“如果你想繼續完成設定,可以閱讀”,並附上下一步配置的連結,讓你按順序接入各個提供商。

複製工具

每篇指南標題下方都有兩個按鈕。“複製為 Markdown”把整篇指南以 Markdown 放進剪貼簿——與頁面 .md 版本提供的純文本格式相同——包括其中的命令、列表和下一篇指南的連結。“複製提示詞”複製一條現成的單行指令:Read 加上本頁 Markdown 版本的地址。把它貼上進 AI 對話,模型會自行獲取這篇指南。

在它們旁邊,“詢問本指南”會在新標籤頁中開啟 ChatGPT,並已預先填好同一條指令。“開啟方式”選單提供同一個 ChatGPT 快捷方式,外加 Markdown——在瀏覽器中開啟純文本版本,即同一頁面地址末尾加上 .md。

每個命令塊的頂角都有一個小的“複製”按鈕。它只複製塊內的命令而不含周圍解釋,方便你直接貼上進終端。複製成功後,每個按鈕會短暫顯示“已複製”。

把指南交給編碼代理

編碼代理——能讀寫你專案的 AI 助手,比如 Claude Code、Cursor 或 Codex——讀到和你一樣的說明時表現更好。最簡單的交接方式是“複製提示詞”:把複製好的那行指令貼上進代理的對話方塊,它會自己去讀指南的 Markdown 版本。想讓全文內聯時選擇“複製為 Markdown”——比如讓代理把指南與你的檔案對照,或讓沒有聯網許可權的對話也能看到內容。

你也可以把以 .md 結尾的頁面地址貼上進幾乎任何 AI 對話;它會返回不含頁面裝飾的同一份 Markdown。套件就是為這種工作流而寫的——在你的儲存庫裡,AGENTS.md 和 prompts/ 資料夾為代理準備了規則和現成任務。

儲存庫裡的同一批內容

並不是每個答案都需要這個網站——其中很大一部分隨你下載的程式碼一起交付。在 Web 儲存庫和 All Platforms monorepo 中,docs/ 資料夾存放更長的 Markdown 參考檔案,比如 agent-setup.md(無人值守安裝執行手冊)和 upgrading.md(本組更新演練的詳細版),prompts/ 資料夾則放著可直接貼上的指令。獨立的 Mobile 和 Desktop 檢出攜帶一套較小的精選內容。無論哪種情況,儲存庫根部的 llms.txt 檔案都是一張地圖:它列出代理應先讀哪些檔案,以及必須遵守的規則。

你執行中的應用本身也貫徹同一理念:它為你要構建的產品提供自己的 /docs 指南,以及一條 /llms.txt 路由,把應用的即時索引交給代理。

連結到小節,而不只是頁面

指南頁上的每個小節標題同時也是一個錨點——頁面內可連結的位置。在“本頁內容”欄中點選某個小節,或直接點選標題本身,瀏覽器位址列就會多出 #section-name 這樣的結尾。用這個完整地址開啟頁面時,會直接滾動到該小節。

當你指的是某個具體步驟時,把帶錨點的地址發給同事;出於同樣的理由,也可以把它粘進代理提示詞。本組還有兩篇配套頁面:下面的術語表,以及套件自身改進時使用的更新演練。

常見問題

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
主題