用 AI 助手接入
这是默认的接入方式:FormPostbox 生成一份包含你表单真实值的提示词,由你的 AI 编程工具把网站上已有的表单接上它们。代码改动由工具完成;FormPostbox 负责接收每条提交、保存消息并跟踪邮件通知。
本页按一次真实接入的五个任务组织:准备好表单、把工作交给 AI 工具、验证第一条提交、排查问题,以及之后安全地修改表单。
1. 准备好表单,然后复制提示词
先完成快速上手里的首次设置:账户邮箱验证、添加网站、启用表单;仅开启邮件通知时验证通知地址。Turnstile 防护是可选的;只有希望保护网站时才保存密钥。FormPostbox 会在确认账户、来源、通知邮箱(开启邮件通知时)和表单设置后生成提示词。
- 打开 表单 → 你的表单。
- 在 连接你的网站 中找到 使用 AI 接入。
- 选择目标技术栈——HTML、React 或 Astro——以及指令使用的语言。
- 选择 复制 AI 提示词,或复制/下载完整的 Markdown 接入包。
条件未齐时,面板会逐项列出还缺什么并给出链接——它不会生成看似“已经可直接使用”的接入包。
2. 让 AI 工具修改你的网站
把提示词(或整个接入包)粘贴到 Cursor、Claude Code、Codex、Lovable 或类似工具,在包含目标表单的网站项目里工作。生成的文本是填入你真实值的固定模板——不由模型生成,同一个表单每次都会得到相同的指令,复制它也不会改动你的网站。提示词是自包含的:无法打开链接或安装 Skill 的工具同样可以完成工作。
接入包 = 提示词 + 提交契约、能力边界和链接。提示词要求 AI 工具做什么:
- 先检查你的项目和现有表单,保留你的布局、样式、字段和合理校验。
- 用真实端点和公开配置提交,并携带
_intent_id。只有开启防护时才添加cf-turnstile-response并加载 Turnstile;未开启防护的提示词会省略 widget、脚本、响应字段和令牌检查。 - 网络重试复用同一个 intent,保证一条消息只保存一次;保存确认或明确开始新消息后生成新的 intent。
- 开启防护时,只加载一次 Turnstile 脚本,令牌来自 widget,并在验证过期或失败后更新挑战。未开启防护的网站不要添加 widget 或脚本。
- 只有当响应中出现
saved: true才算保存成功——并把“已保存”与邮件通知分开。 - 补充适合你项目的测试,并如实报告实际验证结果。
支持的技术栈是 HTML、React / Next.js 和 Astro 表单。面向能够打开链接的工具,还有这些公开参考:
- llms.txt — 面向 AI 工具的简短索引,包含官方链接和能力边界。
- HTML Skill、React Skill、Astro Skill — 按技术栈给出说明和同一套参考实现;每个都有简体中文版(
.zh-CN.md)。 - Markdown 接入指南(中文版)— 以纯 Markdown 描述提交契约。
不需要安装 Skill:把提示词或接入包直接粘贴给工具即可。有些工具会自行抓取链接,但那只是惯例,不是保证。
把你的目标告诉 AI
把以下要求附在从工作区复制的真实提示词或接入包后面。不要用这些短句替代完整接入包。
接通已有表单
请按我提供的 FormPostbox 接入包连接现有联系表单。保留布局、字段和校验;完成后验证真实保存,并报告尚未测试的部分。增加业务字段
请在现有表单中增加 company 字符串字段,保留原有接入包的保存判断、重试 intent 和防护规则。验证新字段随提交保存,并检查失败重试。接入失败时,使用下方完整的排查提示词。
3. 验证第一条提交
- 如果项目有构建或类型检查步骤,先运行它,然后发布改动。
- 从表单运行的真实页面发送一条测试消息。被接受的测试会占用当月 1 条提交额度。
- 打开 收件箱,确认消息显示为 已保存。
- 打开这条消息,查看它独立的邮件通知状态——“已保存”和邮件是两种不同结果,服务商已接受也不代表邮件已进入收件箱。
生成或复制文本不会改动你的网站,工具的“完成”报告也不是证据。工具结束后,请发送一条测试消息,并在收件箱确认保存记录;提示词里的清单覆盖了这些细节。
4. 用可复制的提示词排查问题
把这个模板交给修改过网站的 AI 工具,让它先检查可访问的代码和浏览器诊断信息;只补充它无法获取的情况。提供错误文本或页面地址前,先去除凭据、令牌和访客内容。
- 提交测试消息时的现象——出现报错、没有反应,或者保存结果始终无法确认。
- 相关浏览器错误文本,先去除凭据、令牌和访客内容。
- 提交请求的 HTTP 状态码,以及 JSON 响应里的错误码,例如 400 与 “origin”。
- 测试页面的来源与路径:脱敏路径中的敏感值,去掉查询参数和片段,并注明发生时间。
- 先检查并脱敏上述信息;不要提供私密密钥、账户凭据、会话 Cookie 或访客消息。
我网站上的 FormPostbox 接入没有按预期工作。请检查表单代码和提交时发出的请求,并修正接入。保留我现有的布局、字段,以及之前给你的 FormPostbox 接入包里的接入规则。
请先自行检查可用的浏览器和项目诊断信息,只向我询问你无法获取的信息;区分实际验证结果和无法测试的项目。
现象:[提交测试消息时我看到的情况]
浏览器控制台错误:[已去除凭据、令牌和访客内容的相关错误文本,或“无”]
提交请求:[HTTP 状态码和响应里的错误码,例如 400 origin]
测试页面:[来源与路径,路径中的敏感值已脱敏;去掉查询参数和片段]
时间:[日期和时间]
不要向我索要私密密钥、账户凭据或会话 Cookie,也不要把它们写进代码;同样不要包含访客的消息内容。
共享诊断信息前,先脱敏地址和错误文本中的敏感值;不要复制请求正文、认证请求头或整份控制台日志。你也可以自己按常见错误页逐一排查。首次失败的一个常见原因是页面允许来源与 Cloudflare widget 主机名不一致——Turnstile 指南并排介绍了这两个设置。
5. 之后安全地修改表单
当你要新增字段、调整校验或改变表单行为时,把原始提示词或接入包连同改动需求交给同一个 AI 工具,让它来修改。保持接入规则不变:
- 保留
_intent_id的生命周期:每条消息生成一次,重试时复用;保留以saved: true为准的保存判断。开启防护时,Turnstile 令牌来自 widget 回调;未开启防护时,省略 widget、脚本、响应字段和令牌检查。 - 表单界面上任何状态文案都要把“已保存”和邮件通知分开。
- 新字段只需要一个
name(1–128 个字符);字段值是字符串、最多 32768 个字符,每条提交最多 50 个业务字段。 - 不要放宽页面代码里的允许来源检查,也不要把提交经由服务端代理转发。
- 任何改动之后,都重复第 3 步——只有测试提交才算证据。
覆盖范围与边界
- 覆盖:只使用公开值的浏览器接入——不需要 Developer API Key,也不需要服务端代理;与代码面板使用同一个表单,字段、限制和重试语义与平台完全一致。
- 不覆盖:附件与 multipart 上传(端点会拒绝)、从你自己的服务器读取提交(那是 开发者 API,随付费套餐提供),以及任何创建表单的接口。
- 受保护的网站需要在 Cloudflare 账号中配置 widget 主机名——FormPostbox 无法替你核实。请让它与允许来源保持一致;Turnstile 指南 对照介绍了二者。
该功能面向所有已经能正常使用表单的工作区,不新增套餐门槛、额度变化或费用。更喜欢手工改代码?代码示例 页有同一套带占位符的参考实现。
仍需帮助?联系 support@formpostbox.com. 请附上相关文档主题和脱敏后的错误信息,不要发送密钥或访客消息。
浏览全部主题 ↑