跳转到内容

更新日志

supastack 发布的每一次更新——新功能、改进和修复。

  1. 即将推出

    路线图

    开发中

    我们正在积极构建并计划近期发布的功能与改进。此列表可能根据用户需求和社区反馈而调整。

    Stripe Connect

    多卖家分账与拆分支付:卖家入驻 connected 账户,平台收取费用,转账落入同一套权益账本。这是大多数 starter 都会跳过的市场层。

    公开的 agent 运行 API

    为 agent 框架运行提供带预算的端点;AGENT_FRAMEWORK 已经可以在 AI SDK、Mastra、LangGraph 和 OpenAI Agents SDK 之间切换。

    Supabase 原生模式

    Supabase Auth 加上 RLS 优先的 schema,让自托管的 Supabase 能安全地在应用旁暴露其 Data API。

    Passkey 与生物识别登录

    网页端使用 WebAuthn passkey,移动端使用设备生物识别,让最终用户在每个平台上都能获得抗钓鱼的登录体验。

    桌面端更新渠道

    面向 Tauri 外壳的 stable 与 beta 发布轨道:先把已签名的更新推送给较小的人群,再让所有人收到。

    移动端离线模式

    Expo 应用让最近加载的工作区数据在无网络连接时仍可读取,现场工作不会因断网而停摆。

    ……以及更多改进、修复和依赖更新。

    • Next.js
    • Expo
    • Tauri
    最新

    工作区主页、用量提醒、智能体 API,以及可直接发布的桌面版本

    新增

    • Web 应用登录后打开全新的工作区主页,在一个页面集中展示用量、套餐、设置进度、快捷操作和最新通知。
    • 移动端主屏新增用量进度条、套餐卡片、快捷操作磁贴、最新通知和下拉刷新。
    • 当工作区达到每月 AI 预算或某项用量上限的 80% 和 100% 时,所有者和管理员会收到通知。
    • 通过新的公开 API 端点,在你自己的代码中运行有预算控制的多步骤 AI 智能体。
    • 设置清单会突出下一步、按状态筛选,并一键复制仍需填写的环境配置。
    • 新增四款配色方案和四种配套设计风格可供选择。
    • 六个应用区块加入区块库:用量计、活动动态、操作网格、新手引导清单、设置分区和成员列表。
    • 借助现成的发布工作流和自动生成的更新清单,发布已签名的桌面版本。
    • 在移动应用中向 AI 助手询问工作区相关问题。
    • 无需 AI 服务商密钥,即可在本地开发中试用智能体运行。
    • 移动应用现已全面使用清晰的矢量图标。
    • 修复:移动端用量进度条会随用量上升显示警告色和上限色。
    • Next.js
    • Expo

    通行密钥、应用锁、自托管文件、按量计费和翻译后的应用

    新增

    • 在网页端使用通行密钥登录,并在设置 → 安全中管理已保存的通行密钥。
    • 移动应用从后台返回时,可以通过 Face ID、指纹或设备密码锁定。
    • 自托管产品可以将上传的文件保存在服务器自己的磁盘上,通过短期有效的签名链接提供访问。
    • 套餐可以按用量计费:计量的用量会自动报告给支付提供商,绝不会重复计算。
    • 网页端和移动端的应用界面会遵循所选语言,包括日期和价格。
    • 借助为 Claude Code、Cursor、Codex 等编程代理准备的 26 项内置代理技能,涵盖功能、支付、数据库变更和测试,更快交付。
    • 修复:本地磁盘存储的文件现在以更安全的方式提供 —— 上传的文件无法再在你的域名上执行代码。
    • 修复:外观偏好现在也会保存到工作区的自定义域名上。
    • 修复:保存用量设置时会保持所选语言。
    • 修复:无论以何种方式启动 pnpm,本地检查命令都能可靠运行。
    • Next.js
    • Expo
    • Tauri

    开箱即用的套件:设置清单、用量限制、移动端离线与全新样式

    改进

    • 通过应用内设置清单完成任何新项目的初始化——它会显示已配置的内容、以演示模式运行的内容以及下一步该做什么。
    • 在新的用量设置中为每个工作区设置每月 AI 预算和用量上限——当前用量在网页端和移动端均可见。
    • 所有者和管理员可以下载工作区内容、商务、成员和设置的完整副本。
    • 分析仪表板显示与上一周期相比的趋势、实时访客数以及适配各种屏幕尺寸的布局。
    • 从五个新配色包和五个配套设计风格中进行选择。
    • 最近查看过的移动端页面在离线状态下依然可读,并会显示数据的保存时间。
    • 桌面应用可以在稳定版发布之外提供 beta 更新通道。
    • 不再接收通知的移动设备会自动退出推送投递。
    • 修复:页面一加载,站点页眉就会显示正确的账户按钮。
    • Next.js
    • Expo
    • Tauri

    套件功能回顾:安装、移动端与桌面端

    改进

    • 通过引导式安装和环境检查,做好应用启动前的准备。
    • 移动端套件包含内容与电商管理、推送通知和个人数据导出。
    • 通过更新配置检查、自动更新和可选的登录时启动,为桌面端发布做好准备。
    • 你的外观设置会跟随登录状态,在浏览器、桌面应用和移动端之间同步。
    • 新增的“Match web app”主题模式会使用你在网页端选择的配色包为移动应用着色。
    • Next.js
    • Expo

    分析开发工具与更可靠的计费

    改进

    • 通过 TypeScript SDK 和开箱即用的 React 追踪组件,为应用接入分析功能。
    • 在命令行查看流量、访客和收入,并通过 JSON 输出支持自动化。
    • 更可靠地识别 Stripe、Lemon Squeezy、Creem、Polar 和 Whop 的预付积分购买。
    • Next.js
    • Expo
    • Tauri

    更顺畅的 AI 工作流,更完善的移动端与桌面端

    改进

    • AI 任务拥有独立控制台,各语言的导航和任务恢复链接保持一致。
    • 在移动应用中管理定时任务、聊天、Webhook 历史、内容、个人资料和带有效期的 API 密钥。
    • 桌面应用支持常用编辑快捷键,并记住你偏好的缩放比例。
    • 修复:各语言的设置页正常显示开发工具、审计历史和活跃会话,管理导航也不再指向不存在的页面。
    • Next.js
    • Expo
    • Tauri

    预付费额度、向导式设置,以及更强大的移动端与桌面端套件

    新增

    • 为工作区提供预付费额度余额 — 当套餐月度配额用尽时,AI 任务会自动消耗额度,付费高峰得以继续运行而非失败。
    • 额度通过计费事件或管理员发放到账,成员可在账单卡片中查看余额与最近记录 — Web 与移动端一致。
    • 在全新检出中运行 `pnpm setup` — 向导会检查环境、写入安全配置、提供迁移选项,并显示后续步骤。
    • 使用 `pnpm setup --check` 以非交互方式验证任何机器 — 适合 CI 和开始前的快速体检。
    • 在移动应用中管理工作区的内容与电商业务 — 列出、创建并发布 CMS 条目,并推动商品和订单完成各自的状态流转。
    • 点按推送通知即可打开正确的页面,发送时还可以使用可选的 `EXPO_ACCESS_TOKEN` 进行身份验证。
    • 成员可以在移动应用的安全设置中将自己的个人数据导出为 JSON。
    • 桌面构建可以自我更新 — 外壳在后台检查,确认后安装并重新启动 — 并提供可选的登录时启动开关,以及用于校验更新器配置的发布检查。
    • Next.js
    • Expo

    推送通知、无处不在的分析,以及全语言的信任页面

    新增

    • 通过手机直接触达成员 — 移动应用通过 Expo 发送推送通知,设备在登录后自动注册,设置中的开关可以开启或关闭推送。
    • 选择产品衡量站点流量的方式 — 匿名第一方统计、Plausible、PostHog 或完全关闭 — 始终以访客同意为前提,页脚中的「分析偏好设置」链接可以随时重新打开选择。
    • 管理员可以在概览页直接查看 30 天的页面浏览量、独立访客和热门页面。
    • 你产品的更新日志、路线图和 API 参考现在从头到尾完成本地化 —— 路线图如实展示已发布的内容,深层链接能把读者带到正确的章节。
    • 在 boilerplate 上交付完整的分析产品 — 跟踪代码片段、实时访客、页面与渠道细分、目标、漏斗、访客旅程、告警和公开分享仪表盘。
    • 看清哪些渠道真正带来收入 — 通过 API 或计费 webhook 发送的付款会附带渠道、来源和活动信息,并提供 MRR 与洞察视图。
    • 以编程方式访问每个分析界面 — 版本化 REST 端点与面向代理的 MCP 工具,全部限定在工作区范围。
    • 修复:登录请求可能因服务器错误而失败 — 邮箱验证码、魔法链接和 Google 登录现已恢复正常。
    • 修复:导航链接在悬停时不再显示下划线。
    • Next.js

    公开产品页面与交互式功能导览

    新增

    • 为你的产品提供公开的更新日志、精选路线图和能自动列出接口的 API 参考——三个新的营销页面,全部本地化,并接入页脚、站点地图和代理索引。
    • 用交互式标签页展示产品功能——新的可复用营销区块为每项功能提供标题、要点列表和产品视觉,完全支持键盘操作,没有 JavaScript 也能完整阅读。
    • Next.js
    • Expo
    • Tauri

    开箱即用的更精致模板

    改进

    • 当访问者滚动到页面底部时,每个会话只提示一次 — 新的营销区块会打开一个带有你自己的后续链接的对话框,且不会打断表单或其他对话框。
    • 在网站页脚添加主题和语言选择器 — 两个菜单都已内置。
    • 登录页不再显示营销页脚,账户页面保持专注。
    • 落地页各区块在滚动时仅出现一次,主视觉区块在页面加载时播放简短的入场动画。
    • 修复:像 `APP_ENV` 这样导出的环境变量现在会正确传入构建 — 生产构建不会再因为实际已设置的变量而验证失败。
    • Next.js
    • Expo
    • Tauri

    更多设计选择与面向智能体的配置

    改进

    • 使用 21 种配色主题、17 种协调风格和四种响应式布局定制你的产品。
    • 通过 43 个可复用组件和共享控件构建应用与营销页面。
    • 使用 Docker 或 Podman 搭建本地环境,再按 Coolify 或直接使用 Docker 的 VPS 指南部署。
    • 重新运行安装流程时,无需替换现有设置或加密密钥。
    • 在认定部署已就绪前,使用安全与发布检查清单验证身份验证、数据访问、日志和恢复能力。
    • 安全更新覆盖应用和开发工具。
    • Next.js
    • Expo
    • Tauri

    为编码智能体打造的安装与文档

    新增

    • 新的 `llms.txt` 为编码智能体整理了所有指南、提示词、环境变量分组和配置文件 — 并为每个交付的仓库(网页、移动端、桌面端)附带限定范围的版本。
    • 新的 `docs/agent-setup.md` 操作手册让编码智能体可以无人值守地完成套件安装 — 本地通过 Docker 或 Podman 完全容器化运行,然后部署到 VPS — 每个阶段都有验证检查点。
    • `prompts/agent-setup.md` 提供可直接粘贴的提示词,以正确的安全默认值驱动整个智能体安装流程。
    • 每个交付的 `llms.txt` 都写明了智能体必须遵守的安全规则 — 工作空间范围限定、身份验证、密钥处理、行级安全、速率限制和审计日志。
    • 你的应用现在会自己提供 `/llms.txt`,基于套件构建的产品开箱即可被编码智能体读取。
    • 修复:随附的指南和文档文案不再包含内部引用 — 升级说明对你 fork 或购买的仓库保持通用。
    • Next.js
    • Expo
    • Tauri

    更安全的账户,更轻松的产品定制

    改进

    • 加强登录、账户恢复和工作空间成员管理的安全保护。
    • 中性演示采用纯文字品牌展示,方便替换为你自己的产品内容。
    • 修复:更改一次设计风格即可同时更新营销页面和应用。
    • 修复:Windows 开发和本地邮件预览更加可靠。
    • Next.js
    • Expo
    • Tauri

    AWS 邮件与更安全的默认配置

    改进

    • 按照新配置指南,使用 AWS SDK 或 IAM SMTP 为网页、移动端和桌面端发送事务邮件。
    • 新的依赖审计会自动持续验证已打补丁的包版本 — 依赖和容器安全检查现在会在 CI 中运行。
    • 修复:使用自有 AI 密钥的工作区此前可以让智能体运行无上限地消耗平台的 AI 预算 — 此类运行现在会被提前阻止。
    • 修复:首次设置现在会验证示例配置,因此设置失败时会指出实际缺失的内容。
    • Next.js
    • Expo
    • Tauri

    许可条款更明确、桌面端更友好

    改进

    • LICENSE 文件和 README 章节现在明确说明了您的购买范围 — 可无限制地构建和销售产品,每位开发者一个席位。
    • 桌面应用在无法连接服务器时会显示友好的重试界面,被占用的键盘快捷键也不再阻止它启动。
    • 桌面构建现在会在 Windows、macOS 和 Linux 上自动验证。
    • 在应用离线期间到期的定时任务,现在会在恢复时补跑一次,并且每个计划都会显示跳过了多少次运行。
    • Next.js
    • Expo
    • Tauri

    桌面端、移动端与引导式配置之旅

    改进

    • 更完整的桌面使用体验。
    • 移动端功能更丰富,支持应用内购买和更完整的 AI 聊天。
    • 逐步文档带你从五分钟的首次运行,一路走完每个供应商的配置。
    • Next.js

    安全更新

    改进

    • 安全更新降低了生产环境中的风险。
    • Next.js

    与网站设计一致的登录体验

    修复

    • 已修复:登录页面现在会采用为网站选定的颜色。
    • Next.js

    故障提醒与更清晰的运行监测

    新增

    • 后台任务或 Webhook 投递失败时,可以收到提醒。
    • 可以追踪 AI 任务、计费活动和定时任务的完整过程。
    • 更容易找出运行缓慢的 AI 任务并排查故障。
    • Next.js
    • Expo

    移动应用发布与用户评价

    新增

    • 借助新的发布指南,准备将移动应用提交到 Google Play 和 App Store。
    • 新增应用内购买、可复用页面区块、公开 API 和搜索曝光指南。
    • 客户故事区块现在支持评分和个人主页链接。
    • 营销页面可以跟随访客选择的设计风格。
    • Next.js

    内容、图表与公开页面

    新增

    • 文章和研报可按订阅等级开放,并为未解锁内容显示升级提示。
    • 页脚新增公开的许可协议页面。
    • 页脚新增可接受使用政策和免责声明页面。
    • 折线图、柱状图、环形图和趋势卡片可用于营销页与应用界面。
    • 可定期向工作区成员发送内容摘要,附每周投递示例。
    • 修复:浮动 FAQ 面板打开时不再压暗背后的页面。
    • Next.js

    九家计费提供商、自托管文档与营销打磨

    新增

    • Paddle 加入计费提供商——按席位数量的商家代收款结账与托管客户门户。
    • Dodo Payments 加入计费提供商——商家代收款结账与客户门户会话。
    • PayPal 订阅加入计费提供商——托管批准流程与自动扣款自助管理。
    • 九家计费提供商共用同一契约——用 `BILLING_PROVIDER` 即可切换。
    • 修复:openai-compatible AI 提供方现在兼容真实的第三方网关(new-api、LiteLLM、Ollama、vLLM)。
    • 修复:结构化 AI 补全现在接受第三方模型返回的 schema 包裹响应。
    • 修复:聊天回复等同步 AI 调用现在计入工作区月度预算。
    • 新的自托管指南:用 Coolify 部署到廉价 VPS——机上构建或部署 CI 构建的镜像。
    • 新配方:为 Midtrans、Xendit 等区域网关添加你自己的 `BILLING_PROVIDER`。
    • 修复:自托管部署现在发布正确的 `:8080` 端口。
    • 产品框架区块新增 app-chrome 变体——品牌槽位、分段标签页与可选状态条。
    • Lucide 图标现已取代营销区块中的文字箭头和手绘符号。
    • 极简营销区块获得技术网格样式——等宽大写 eyebrow、强调刻度与编号步骤。
    • 对减弱动效安全的实时状态条加入极简 showcase——纯 CSS,无 JavaScript 时保持静态。
    • 极简营销区块去掉卡片边框与装饰细线——产品框架仍是唯一的浮起面。
    • 修复:FAQ 回答现在带有展开与收起动画。
    • logo-strip 区块新增边缘渐隐的 marquee 变体,悬停时暂停。
    • 分栏 FAQ 区块新增互斥手风琴模式——共享 `name` 时一次只展开一个回答。
    • 修复:工具页面(showcase、联系、法律页)可能丢失水平居中。
    • Next.js

    已连接账户、配额与生产调度器

    新增

    • 已连接账户——通过 OAuth 关联 X、Google 或 Microsoft,或接入 SMTP 邮箱——在「设置 → 连接」中管理。
    • 用量配额——按工作区统计的计数器;方案可声明月度限额。
    • 生产调度器——基于数据库的任务调度,通过 Trigger.dev cron 或受保护的 tick 端点触发。
    • 营销页头现在在任何滚动位置都保持磨砂效果。
    • 营销按钮换上新的按键式悬停——向下按压并展开强调色下划线。
    • 修复:canonical、Open Graph 与 sitemap URL 在部署站点上现在使用你的真实域名。
    • 修复:带自有标题或描述的页面不再丢失社交分享图。
    • Next.js

    AI 智能体、更多提供商与极简设计家族

    新增

    • OpenRouter 加入 AI 提供商;新的 agent 层可自由选择框架——AI SDK、Mastra、LangGraph 或 OpenAI Agents。
    • 内置 MCP 服务器通过带作用域的 API 密钥把工作区工具开放给外部 agent。
    • Polar 与 Whop 加入计费提供商;事务性邮件开箱即用支持七家服务。
    • 工作区可绑定自定义域名并使用白标品牌。
    • Supabase 部署已有端到端文档,附 provision 与 doctor 命令。
    • 新增套件区块:tooltip 提示、骨架屏、动画氛围背景与更新日志时间线。
    • 每个 starter 仓库现在都附带生成的 wiki。
    • 登录页更新——完全本地化、无密码化,返回按钮更顺手。
    • 主题切换从点击位置以扩散的彩色圆形展开——减弱动效下即时完成。
    • 速率限制现在通过 Postgres 在服务器实例间共享。
    • AI 调用可返回经 schema 校验的类型化 JSON,并自动尝试一次修复。
    • 无需登录的公开 AI 功能在平台级每日支出上限内运行。
    • 新的 OTP 输入区块——六个数字格,支持粘贴、短信自动填充与自动提交——现已驱动邮箱验证码登录。
    • Minimal 配色包与 Minimal Product 风格——白纸、细线结构、胶囊按钮。
    • 八个极简营销区块:产品主视觉、细线步骤、功能故事行、细线对比表、连体定价面板、分栏 FAQ、居中 CTA 表单与产品框架。
    • 新区块配有明确目的、仅播放一次的动效——减弱动效与无 JavaScript 时保持静态。
    • Next.js

    CMS、电商与增长工具

    新增

    • 全新工作区 CMS——以草稿到发布的工作流撰写文章、页面与文档。
    • 全新电商模块——商品、可选库存与含退款的订单生命周期。
    • Creem 加入计费提供商,结账现可提供支付宝与微信支付。
    • 增长工具——带推荐链接的候补名单区块,以及抢先体验邀请码。
    • 功能看板让成员提交需求并投票——本站已在 /feedback 公开运行。
    • 新增四款配色与设计风格,另有 product-grid 与 data-table 套件区块。
    • 联系、订阅与登录表单新增 Turnstile 反垃圾保护。
    • 首次安装开箱即用。
    • Next.js
    • Tauri

    文档、SEO 与界面打磨

    改进

    • 文档新增 Desktop 标签页、可折叠侧边栏分组,并为每篇指南提供原始 Markdown 版本。
    • 完整 SEO 优化——规范 URL、结构化数据、生成的分享卡片、站点地图与 hreflang。
    • 界面打磨:移除页面边缘过度滚动、滚动条跟随主题,每页头部均已本地化。
    • Tauri

    Tauri 桌面应用

    新增

    • Tauri 桌面外壳带来基于同一代码库的 macOS 与 Windows 应用。
    • 全平台套装现已覆盖 Web、移动端与桌面端。
    • Next.js

    法律页、联系与展示

    新增

    • 隐私与条款页面。
    • 分析功能的同意开关。
    • 联系与订阅表单。
    • 展示基于该套件构建产品的 showcase 页。
    • Next.js

    营销首页

    改进

    • 全新黑色编辑风首页,配有精心编排的动效与真实功能故事。
    • Next.js
    • Expo

    设置与生产就绪

    新增

    • 个人资料账户设置。
    • 可靠的 AI 任务恢复。
    • 生产部署的参考界面。
    • Next.js
    • Expo

    端到端本地开发

    新增

    • 完整产品闭环可本地运行——注册、获取权益、运行 AI 任务、接收完成邮件。
    • 一切基于内置本地适配器——无需任何凭据。

常见问题

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