跳轉到內容
supastack
瀏覽檔案

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

AI 聊天與助手

基於共享 API 的流式聊天執行緒與一次性代理執行。

詢問本指南
開啟方式

聊天執行緒沿用 Web 契約

聊天標籤頁呼叫與瀏覽器應用相同的 REST 介面:/api/chat/threads 上的列表與建立,/api/chat/threads/:id 上的讀取、重新命名與刪除。標題會歸一化到共享的 120 字元上限,執行緒列表也納入離線讀取快取。

流式回覆

回覆經 expo/fetch 通過 POST /api/chat/stream 流式下發;服務端幀會轉成 chunk、done 或 error 事件,畸形幀被跳過。模型別名為 fast、smart、cheap —— fast 是預設值 —— structuredOutput 標誌會轉發對應要求,停止按鈕會中止進行中的請求。

一次性代理執行

隱藏的助手介面向 /api/v1/agent-runs 提交 {alias, prompt, workspaceId, maxSteps: 4} —— 在當前工作區中執行一次有預算上限的任務。客戶端嚴格校驗響應,並拒絕歸屬於其他工作區的執行。速率限制、未登入、缺少權益與 forbidden 應答各自對映為不同狀態;執行歷史在會話記憶體中保留最近十條,成本以微單位精度格式化。

驗證與排障

測試被取消的流、執行中途被吊銷的會話、有權益與被鎖定的工作區,以及飛航模式下快取執行緒列表的表現。被伺服器拒絕的執行必須呈現為不可用狀態,絕不應靜默地顯示空回覆。

常見問題

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