使用 Spacefast 构建并发布 AI Web 应用:实用指南
使用 AI 创建会议成本计算器,探索在 Spacefast 上的部署,并逐步学习如何添加安全的保存历史数据库,而不暴露凭据。
用 Spacefast 构建并发布 AI Web 应用:实操指南
AI 助手能在几分钟内生成一个可运行的应用。但把这个应用上线——并且判断它是否安全可用——则是另一项任务。
来自 Automattic 的 Spacefast 旨在连接这两个步骤:先与 AI 助手协作,然后发布由此产生的应用。为了探索这一工作流,我们将构建一个实用工具:会议成本计算器,先做成一个简单的浏览器应用,然后作为可选的第二阶段,再加入保存计算记录的功能。
本指南能证明什么、不能证明什么: 下文的应用设计、计算示例和安全原则都是可复现的。但 Spacefast 的确切连接界面、受支持的 AI 客户端设置和部署命令,仍需对照其最新文档核实。我们尚未完成一次手动的 Spacefast 部署,因此不会假装我们已经做过。
我们的项目分四个阶段
1. 从一个实用、可测试的应用开始
我们的计算器需要三个值:人数、会议时长(分钟)和每人每小时的估算成本。它会立即显示总额。
公式: 参与人数 × (分钟数 ÷ 60)× 每小时成本。
对于 6 人开会 45 分钟、每小时 €40 的情形,结果为 €180。
预期的应用界面——示意性模拟图
这是预期结果的示意图,而非一个部署在 Spacefast 上的应用截图。
给 AI 一个精确的提示词
用你偏好的编码助手使用以下提示词:
Create a responsive meeting-cost calculator using plain HTML,
CSS and JavaScript. No external dependencies or backend.
Inputs:
- Participants: integer, minimum 1, default 6
- Duration in minutes: positive number, default 45
- Hourly cost in EUR: non-negative number, default 40
Formula:
total = participants * durationMinutes / 60 * hourlyCost
Requirements:
- Update the result when any input changes.
- Use accessible labels and aria-live for the result.
- Validate inputs and never display NaN or Infinity.
- Work on a 360px-wide screen.
- Do not add tracking, external APIs or accounts.
- Return complete index.html, styles.css and app.js files.
- Explain how to test them locally.
将三个文件保存在同一个目录下。检查 index.html 是否引用了正确的样式表和脚本。在浏览器中打开该页面。如果助手引入了依赖项或构建步骤,请它在继续之前先作出说明。
2. 部署前先测试计算器
生成的应用并不自动等于正确的应用。先测试已知的输入。
| 人数 | 时长 | 每小时成本 | 预期总额 |
|---|---|---|---|
| 6 | 45 分钟 | €40 | €180 |
| 3 | 120 分钟 | €50 | €300 |
| 1 | 30 分钟 | €0 | €0 |
然后清空一个字段、输入一个负数、把浏览器宽度调整到手机尺寸,并用键盘进行导航。计算器应当能优雅地拒绝无效值。
如果某项测试失败,把确切的输入和观察到的输出发给助手。要求它做一次有针对性的修复,然后重新运行测试。在尝试发布之前,先保留一个可用的本地版本。
3. 将你的 AI 助手连接到 Spacefast
该服务的定位是一种面向 AI 的项目托管方式。请从官方 Spacefast 网站及其当前文档入手,而不是依赖从旧教程中复制的说明。
- 创建一个 Spacefast 账户,并查看你可用的套餐。
- 查阅针对你所用特定助手(ChatGPT、Claude、Cursor 或其他受支持的客户端)的最新设置说明。
- 使用官方文档记载的连接方法。在授权访问之前先审查权限。
- 确认该连接支持你所创建的项目类型:静态 HTML/CSS/JavaScript。
- 让凭证和私有令牌远离公开聊天、源代码和截图。
重要: 本指南目前还无法给出经过核实的按钮标签或通用的连接命令。这些取决于受支持的客户端和当前的 Spacefast 集成方式。我们不会凭空杜撰它们。
4. 发布已测试的应用
一旦你的助手通过受支持的工作流完成连接,就给它已测试过的文件和一个范围明确、界定清晰的指令:
Publish my tested meeting-cost calculator to my Spacefast
workspace using the officially supported publishing workflow.
Keep the HTML, CSS and JavaScript logic unchanged.
Do not add analytics, authentication, external APIs or a database.
If a private preview is supported, use it first.
Report the published URL, the files deployed and any errors.
Do not configure a custom domain without my confirmation.
这是一个建议性的指令,而非经过核实的 Spacefast 命令。如果助手无法发布该项目,请遵循实际的集成文档,并记录错误信息,而不是靠猜测。
部署之后,在一个独立的浏览器中打开该 URL。检查两个预期计算、响应式布局、缺失文件(404)、控制台错误和意外的网络请求。测试一位无痕浏览访客能否打开该链接:一个难以猜测的 URL 并不必然等同于访问控制。
最后,修改一个无害的标签,重新部署,并确认更新后的版本已经出现。
5. 改进应用:保存计算历史
我们的第一个版本只能在浏览器中运行。一旦你关闭页面,它先前的计算就不会存储在共享数据库中。
一个实用的下一项功能是保存计算,随后是一个先前估算的列表。
我们接下来想构建的内容——示意性的历史记录
示意性结果。这些记录尚未保存在 Spacefast 上。
6. 如何使用数据库而不暴露密码
这部分往往听起来比实际更复杂。让我们从这个问题开始:当有人点击"保存"时,这次计算会去哪里?
第 1 步——理解三个组成部分
保存计算是如何工作的——三个步骤
浏览器 → 服务端验证 → 托管数据库。
关键规则: 浏览器永远不需要 MySQL 的用户名或密码。它调用服务端代码,由后者负责安全地访问数据库。
在传统 PHP/MySQL 托管中,你通常把数据库凭证保存在一个私有的服务器配置文件中。Spacefast 为受支持的服务器运行时记录了托管数据库绑定。在其 Zero 运行时中,服务端代码可以使用 ctx.db;在 Functions 中,文档记载的绑定是 env.DB。这些是由平台管理的连接的、面向开发者的名称——而不是要复制进 JavaScript 的秘密。
确切的各种 API 和受支持的运行时,应在实施之前对照 Spacefast 数据库文档进行核实。
第 2 步——请助手添加持久化
不要要求 AI"把 MySQL 密码放进 JavaScript 里"。相反,给它一份功能规格说明:
Extend our tested meeting-cost calculator so a signed-in user
can save calculations and see their own history after reloading.
Use a Spacefast-supported server runtime and its managed database
binding, following the current official documentation.
Requirements:
- Add a Save calculation button and a history list.
- Store participant count, duration, hourly cost and total.
- Validate all inputs and recalculate the total on the server.
- Restrict reading and writing records to their owner.
- Do not put database credentials, tokens or API keys in the browser.
- Explain each created or changed file.
- Explain how to test saving, reloading and access permissions.
- Do not invent unsupported Spacefast APIs.
为什么要要求用户登录? 如果历史记录是个人化的,服务器就需要一种可靠的方式来确定它返回的是谁记录。若没有身份验证和授权,一位访客有可能读取到另一位访客的计算记录。托管数据库并不会自动解决这个问题。
第 3 步——了解 AI 应当创建什么
助手应当产出三个可用的部分:
| 组成部分 | 用途 | 运行位置 |
|---|---|---|
| 保存按钮与历史 | 发送请求并显示结果 | 浏览器 |
| 服务端保存/读取处理程序 | 校验输入、强制所有权、执行查询 | Spacefast 服务器运行时 |
| Estimates 表 | 存储这些计算 | 托管数据库 |
一条合适的记录可以包含内部 ID、所有者 ID、参与人数、时长、每小时成本、计算得出的总额和创建日期。服务器应当自行计算总额,而不是信任浏览器提供的值。
第 4 步——按正确顺序测试数据库
- 保存一次会议,6 人、45 分钟、€40/小时。预期在历史记录中得到 €180。
- 重新加载页面。已保存的记录应当仍然可见。
- 保存第二次会议:3 人、120 分钟、€50/小时。预期得到 €300。
- 以另一位测试用户身份登录。该用户不得看到第一位用户的私有记录。
- 尝试无效输入,并确认服务器将其拒绝。
- 重新部署一处无害的界面改动,并确认已保存的记录仍然存在。
- 在把项目视为可投入生产之前,检查可用的备份/导出流程。
这是一份测试计划,而非宣称我们已在 Spacefast 上执行过它。请在真实部署过程中记录实际结果和错误信息。
第 5 步——其他服务的 API 密钥怎么办?
数据库连接只是密钥的一种。如果你的应用日后要调用外部的电子邮件、支付或 AI 服务,该服务提供方可能会给你一把 API 密钥。
不要把它放进 HTML、浏览器 JavaScript、GitHub 或截图里。 Spacefast 记录了用于保存密钥的服务端环境变量;服务器在不把密钥返回给浏览器的情况下访问该密钥。请检查当前的环境变量文档,并审查你的 AI 代理会获得哪些权限。
第 6 步——了解何时不需要数据库
一个只显示结果的计算器不需要数据库。只有当你需要保存历史、账户、共享记录或类似功能时,才添加持久化。每一个数据库都会带来额外的责任:校验、访问控制、备份、留存和恢复。
7. "20 个 Space"究竟意味着什么?
一个 Space 就是一个托管的项目,例如一个站点、应用或原型。它不是一个 AI 提示词,其额度也不是每月 20 个新项目。
例如,一个着陆页 + 一个计算器 + 一个原型 = 三个 Space。编辑并重新发布计算器并不会创建新的 Space,除非你有意再创建一个新项目。
详细的 Spacefast 定价文档 描述了这些套餐额度:
| 套餐 | 标出的基础价格 | Spaces | 每个 Space 的存储 |
|---|---|---|---|
| Personal | $0 | 20 | 1 GB |
| Go | $5/月 | 100 | 10 GB |
| Pro | $15/月 | 500 | 25 GB |
| Enterprise | 定制 | 定制 | 按合同 |
还有一项独立的限制很重要: 按使用量计费的资源(例如算力或流量)可能有每月额度或收费。Space 的数量并不意味着资源用量无限。详细文档描述了每月用量额度,它会重置而非累积。
定价页面和发布材料未必总使用相同的套餐名称或额度。在升级或依赖某一具体限制之前,请检查实时的账单面板和当前条款。
8. Spacefast 还是传统托管?
Spacefast 之所以有趣,是因为它旨在缩小用 AI 创建项目与发布项目之间的差距。传统托管可能提供更多直接的服务器控制,但往往需要额外的设置。
对于一个真实项目,请比较受支持的框架、部署与回滚、日志访问、备份/导出、自定义域名、安全、数据可移植性和总费用——而不仅仅是被宣传的订阅价格。
我们这个小计算器之所以是一个有用的首个实验,正是因为我们能够检验它是否可用。数据库扩展则增加了一个更有意义的第二项测试:该平台能否在多次更新之间安全地保存数据?
常见问题
我能使用现有的 AI 助手吗?
Spacefast 的定位是能与现有的 AI 开发工具协作。请为你所选择的助手核实当前受支持客户端的清单和连接说明。
每个应用都需要 MySQL 吗?
不需要。我们的第一个计算器是静态的。保存历史的版本则需要持久化存储和服务端访问控制。
我必须在 JavaScript 中输入 MySQL 凭证吗?
不需要。永远不要把数据库凭证放进浏览器代码里。对于受支持的 Spacefast 运行时,请使用由平台管理的服务端数据库绑定。
20 个 Space 就是每月 20 个提示词吗?
不是。它们代表的是托管项目。每月资源用量另行统计。
我能用它做客户项目吗?
在承诺一个可投入生产的部署之前,请先审查当前的商业条款、隐私要求、身份验证、备份选项和实际资源限制。
试试 Spacefast: 如果你想发布一个由 AI 构建的应用,Spacefast 服务 是一个值得考察的选项。CeiKay 上的联盟链接可能会产生佣金,而对你没有任何额外费用。本指南是一份说明性的工作流,而非一次独立完成的托管基准测试。