跳转到内容
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/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 美元(限时优惠价,较常规价 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
主题