跳转到内容
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/docs/desktop/external-accounts.md (or send Accept: text/markdown).

创建桌面端发布账户

Apple 签名与公证凭据、Windows 代码签名选项,以及已发布外壳需要的托管后端。

询问本指南
打开方式

什么时候需要它们

本地桌面开发不需要本页任何内容——corepack pnpm --filter @supastack/desktop dev 就能运行外壳,tauri build 产出的未签名安装包在你自己的机器上也能正常工作。

这些账户只在公开发布前才重要:代码签名和 Apple 公证是消除他人电脑对未知应用弹出安全警告的手段。等发布临近时再创建,而不是第一天就办。

Apple:证书 + 公证密钥

1. 注册 Apple Developer Program——每年 99 美元。提交 iOS 应用的同一个会员资格同时覆盖 macOS 签名;无需重复付费。

2. 在 Mac 上创建 Developer ID Application 证书:Xcode → Settings → Accounts → 你的账户 → Manage Certificates → + → Developer ID Application(Keychain Access 的证书助理流程是替代方案)。

3. 公证——Gatekeeper 信任的 Apple 服务端检查——使用 App Store Connect API 密钥:打开 appstoreconnect.apple.com → Users and Access → Integrations → App Store Connect API → 生成密钥,立即下载 .p8 文件(只提供一次),并记下 Key ID 和 Issuer ID。

这些凭据对应“代码签名”文档中的 APPLE_* 环境变量名——证书、证书密码、签名身份,以及 API 密钥/签发者对。把它们全部放进密钥存储,绝不进仓库。

Windows 代码签名

有两个选择:从证书颁发机构购买 OV 或 EV 代码签名证书——EV 最快消除 SmartScreen 警告,OV 则随时间积累声誉;或者使用 Microsoft 的 Azure Trusted Signing 服务(需要 Azure 账户),这是较新的订阅制路线。

未签名的安装包仍然可以安装和运行;只是任何下载者都会看到 SmartScreen 警告。这对私下测试可以接受,对公开发布则不行。

证书指纹或自定义 signtool 命令写入 Windows 打包配置——细节在“代码签名”中,本页只讲账户。

公开的后端 URL

桌面外壳是一个 webview,不是独立应用:发布构建必须加载公开的 HTTPS 后端,通过把 SUPASTACK_APP_URL 烘入构建来提供。指向 localhost 的外壳只是本地工具,不是产品。

先部署 Web 应用——Google Cloud 指南会产出 HTTPS URL,部署清单是更简短的参考。构建发布版时把 SUPASTACK_APP_URL 指向它。

更新端点

Tauri 的更新器通过 HTTPS latest.json 清单来获知新版本。任何静态托管都可以——GitHub Releases 的发布,或 S3/R2 存储桶中的一个文件——所以现有的 GitHub 账户就足以起步;不需要单独的服务。

这只是账户层面的准备:更新器接线本身是“打包和发布”阶段的发布工作,现在不用配置。

完成的标志

开始发布工作前检查每一项:Apple 显示有效的 Developer Program 会员资格,Keychain 中已有 Developer ID Application 证书,App Store Connect 的 .p8 已保存且 Key ID 和 Issuer ID 已记录。Windows 侧已选定证书路线——CA 购买或 Trusted Signing——或者你已明确决定暂时发布未签名版本。

后端检查:存在一个公开的 HTTPS 部署,且发布构建的 SUPASTACK_APP_URL 指向它。更新检查:已为 latest.json 选定托管方——GitHub Releases 或存储桶。

然后按顺序继续:

如果你想继续完成设置,可以阅读《打包和发布》。

常见问题

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