跳转到内容
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/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 美元(限时优惠价,较常规价 349 美元优惠 100 美元),或全框架(Next.js、iOS、Android)499 美元(限时优惠价,较常规价 599 美元优惠 100 美元),每个额外开发者席位 75 美元。套件本身没有订阅。本站结账后通过邮件发送许可证密钥,仓库访问通过 GitHub 邀请授予。

工作区如何界定我的数据?

用户记录按 workspaceId 划定边界。身份、权限、AI 用量、计费事件与审计条目都留在个人工作区边界内。

后台任务如何工作?

Trigger.dev 是明确的任务运行时。JobRunner 契约只承诺 enqueue、status 与 cancel——工作流语义保持 Trigger.dev 专有且显式。

邮件与营销触达有何不同?

事务性邮件覆盖产品工作流,如任务完成通知。冷触达与营销活动属于产品自身的范畴,不在本套件的邮件模块内。

移动端购买如何运作?

移动端已支持 RevenueCat 原生购买和恢复购买,访问权限由服务端验证。发布前需配置商店账户并完成设备测试。Web 计费保持独立。

AI 供应商密钥存放在哪里?

自带密钥凭证经过加密且仅存于服务端。密钥在日志中被脱敏;用量与预算在工作区级别保持可见。

结账支持哪些付款方式?

Stripe 托管结账接受银行卡,在 Stripe 账户启用后还可提供支付宝与微信支付——方便中国买家。钱包授权为异步确认,付款完成后许可证页面会立即更新。

我能申请退款吗?

获得代码仓库访问权限后,supastack 将永久归你所有,因此无法退款。但请放心,你将获得包含终身更新的完整源代码,可为你自己或客户构建并发布无限数量的产品。你只需注意不能转卖代码,也不能将仓库作为启动模板二次分发。

CN
主题