着陆页启动
准备一个构建好的着陆页以启动:托管、页面分析、其单一行动号召的转化事件、一个可用的潜在客户表单、可选的A/B测试以及一份启动检查清单。本技能在本地准备并测试所有内容。未经用户同意,绝不部署或更改DNS。
Cloudflare的命令、配置键和限制会发生变化。此处列出的内容已于2026-10-04对照Cloudflare文档进行核对,Worker代码使用Wrangler 4.147.0运行。在依赖某个命令或限制之前,请确认当前Cloudflare文档中的内容,并以文档为准(若与本技能存在差异)。
输入
首先读取文件,仅在一次消息中询问用户未提供的信息。
| 输入 | 位置 | 如果缺失 |
|---|---|---|
构建好的页面,以及当表单提交至此技能的Worker时的/thanks/和/form-error/ | 构建输出(dist/、public/、导出文件夹),由landing-skills:landing-build生成 | 运行构建。如果尚无页面,则停止并说明页面应首先准备好(landing-skills:landing-build)。 |
转化操作:表单或外部页面、表单字段、端点状态(none yet或URL),或外部URL | landing/brief.md中的Conversion action | 从页面读取:表单的action和每个字段的name,或主要链接。通过一个问题向用户确认。 |
表单提交的每个字段name及端点状态 | 构建的交接信息;否则为构建后表单的name属性 | 从构建后的表单中读取。 |
| 域名 | landing/brief.md中的Domain | 询问。如果保持为unknown,则使用workers.dev地址并将域名相关项标记为待处理。 |
联系途径,针对/form-error/和页脚 | landing/brief.md中的Contact routes | 询问。在用户回答前,显示可见的[占位符: ...],项目待处理。 |
| 表单、感谢和错误消息 | landing/copy.md | 用页面语言编写简短、清晰的消息,并列出供用户批准。 |
| 托管选择 | 用户 | 推荐Cloudflare(见下文)。如果用户拒绝,则转到“不使用Cloudflare”。 |
| 隐私声明 | 页面页脚和表单 | 向用户询问;在此之前显示可见的[占位符: ...],项目待处理。切勿自行编造。 |
本技能编写的内容:托管配置、需要时的表单Worker、分析代码片段和转化事件,以及包含检查清单的landing/launch.md。它不会编写文案或重写构建的页面。
在编写任何配置前,识别技术栈(纯HTML、Astro、Vite + React、Next.js)及其输出文件夹。
推荐
建议将Cloudflare用于所有三项任务,并说明原因:
- 托管: Workers静态资源提供页面服务;免费计划中静态请求免费且无限制,Cloudflare建议新项目使用Workers而非Pages。同一项目可以运行一个小型Worker处理表单,因此页面无需其他后端。
- 分析: Cloudflare Web Analytics无需Cookie或指纹识别即可统计流量和Web核心指标。它没有自定义事件,因此转化由同一账户中的Workers Analytics Engine中的Worker统计,免费计划中免费。
- A/B测试: 同一Worker可以在页面服务前在边缘分配变体。无需客户端测试脚本、无闪烁,且即使禁用JavaScript也能工作。
同时说明成本:自定义域名需要该域名的DNS在Cloudflare上,且每个运行Worker的请求计入免费计划每天100,000次的限制。
流程
-
读取输入。 从
landing/brief.md中获取转化操作(表单或外部页面、其字段、端点状态)、域名和联系途径。从构建的页面中,记录每个表单及其action和字段名称,以及每个行动号召链接。仅询问缺失的内容。然后选择情况,以确定添加内容:
- 表单,端点
none yet(表单提交至/api/lead,尚无服务响应):表单Worker,步骤4和5。 - 表单,端点已存在: 无需表单Worker和Turnstile。检查表单是否提交到该端点,结果页面是否与其返回内容匹配,并记录验证和垃圾邮件防护是该端点的职责。
- 外部页面(结账、预订、应用商店):无需处理表单。链接指向真实URL,点击通过步骤5中的信标统计;检查清单中的表单项标记为
n/a。
- 表单,端点
-
首先修复死胡同。 在构建中搜索:action无效或提交被取消的表单、仅显示感谢消息的提交处理程序、指向裸
#的链接、以及指向自身所在区域的按钮。每种情况意味着转化不存在。表单在步骤4获得Worker端点;链接获取用户的真实URL,或显示可见的[占位符: ...]和待处理的检查清单项。 -
托管配置。 为技术栈编写
wrangler.jsonc,在项目中安装Wrangler,如果缺失则添加404.html,仅在有内容可放入时才添加_headers或_redirects。阅读references/hosting.md。 -
表单端点(表单,端点
none yet)。 添加表单Worker:服务器验证、使用Siteverify进行Turnstile验证、D1存储,以及JavaScript和无JavaScript响应路径。向构建的表单添加Turnstile小部件;保留构建的标记和增强脚本。检查/thanks/和/form-error/是否存在,且/form-error/提供brief中的联系途径。仅在缺失时创建结果页面,切勿覆盖现有页面:landing-skills:landing-build拥有它们。阅读references/forms.md。每个字段都要处理。 列出表单提交的每个字段
name,并为每个字段在Worker的FIELDS表中添加条目(是否必填、长度上限、有意义的格式检查(否则为带上限的文本))、在leads表中的列,以及适合它们的MAX_BYTES。未经验证的内容不被存储。Worker拒绝包含未处理字段的POST请求,返回unknown_field,这会在测试中暴露问题,但在字段添加之前,访问者的提交仍会丢失。 -
分析和转化事件。 向每个页面添加Web Analytics代码片段,并在Analytics Engine中记录转化:在添加了表单Worker的情况下,在Worker中完成;对于链接,通过信标记录。对于已有端点的情况,转化从该端点的记录中统计,信标是可选项。阅读
references/analytics.md。 -
A/B测试,仅当被要求时。 在编写任何代码前,就单一变更、基准线、值得采取行动的最小差异及样本量达成一致。然后添加变体文件和A/B Worker。阅读
references/ab-testing.md。 -
本地测试。 使用Turnstile测试密钥运行
npx wrangler dev(在.dev.vars中配置),并使用curl和浏览器测试每个路径:包含所有字段的有效POST、无效电子邮件、每个字段超出上限、Turnstile验证失败、禁用JavaScript;对于测试:用户分配、第二次请求时的粘性Cookie、转化端点。然后运行npx wrangler deploy --dry-run并检查资源数量和大小。本地运行无需账户。修复任何失败内容后再继续。 -
等待用户许可。 部署、创建预览、添加自定义域名或路由、创建D1数据库、运行
d1 execute --remote、设置密钥、创建Turnstile小部件以及向Web Analytics添加站点都会更改用户的Cloudflare账户,且部署或DNS更改会立即对公众可见。用户可能正在进行审核,域名可能仍在服务旧站点,错误的DNS更改可能导致在线站点宕机。因此,列出每个面向外部的步骤及其确切命令和将要更改的内容,仅在用户当时同意时才执行每个步骤。一个步骤的同意不代表同意下一步。如果用户希望自行运行,则按顺序提供命令。 -
部署后(与用户一起)。 提交一次在线表单,确认D1中的行和Analytics Engine中的转化,确认Web Analytics显示访问,并检查只有在线才能检查的检查清单项。
-
编写
landing/launch.md。 记录托管设置、转化操作及其统计方式、A/B计划(如有)、面向外部步骤的命令,以及启动检查清单,每个项目标记为done、pending、fail或n/a,并说明每个非done项的原因。向用户展示检查清单。
启动检查清单
将以下内容复制到landing/launch.md中,并将每一行标记为done、pending (原因)、fail (原因)或n/a (原因)。无法检查的项目标记为待处理,而非已完成。当行动号召是外部页面时,表单项标记为n/a。
转化
- 行动号召导向一个可用的操作:表单提交至
/api/lead(或用户现有的端点),或链接指向用户的真实URL。无href="#",无自锚点,无虚假成功。 - 表单提交的每个字段
name在FIELDS中有条目(含长度上限)和leads列。任何未处理的字段均为失败,绝不通过。 - 对于已有端点:当
Accept: application/json时返回ok的JSON,否则重定向至/thanks/或/form-error/,或结果页面与其返回内容匹配;验证和垃圾邮件防护记录为其职责。 - 当表单提交至此技能的Worker时:
/thanks/和/form-error/存在(构建的页面,未被覆盖),且/form-error/提供brief中的联系途径。对于已有端点,页面与其返回内容匹配;对于外部链接,标记为n/a。 - 表单经过本地测试:有效POST、无效电子邮件、Turnstile验证失败、禁用JavaScript(跳转到
/form-error/)。 - 按钮在发送时禁用;成功和错误通过
role="status"元素声明。 - 蜜罐字段对视觉和辅助技术均隐藏。
- 部署后测试一次在线表单;行已在D1中。
- 除非用户有发送方式,否则不承诺确认邮件。
度量
- Web Analytics代码片段已启用真实令牌,并存在于每个页面(待处理:令牌存在前,代码片段位于HTML注释中),包括
/thanks/、/form-error/和404.html。 - 转化写入Analytics Engine,在线测试转化出现在SQL查询中。
- Web Analytics显示在线访问。
- 在A/B测试期间:每个变体的访问者和转化计数可见,样本量和结束规则写入
landing/launch.md。
托管
-
npx wrangler deploy --dry-run通过;资源文件少于20,000个,均小于25 MiB。 - 自定义域名通过HTTPS提供页面服务;
workers_dev按用户意愿设置。 -
_redirects中的重定向经过在线测试。 - 未知路径返回自定义
404.html,状态码404。
页面
- 标题、元描述、规范URL、Open Graph和社交卡片标签存在;卡片图片从在线URL加载,预览在粘贴到分享调试器或聊天应用时正确显示。
-
robots.txt和包含在线URL的站点地图;结果页面和预览标记为noindex。 - 网站图标存在。
- 隐私声明链接位于表单旁和页脚中,提及Turnstile(Cloudflare脚本)和表单存储的每个字段(按名称),以及联系详情(电子邮件、电话或用户实际使用的消息渠道)和网站运营者。
- 任何“无Cookie”声明仍然真实(A/B测试设置Cookie时则不成立)。
- 所有
[占位符: ...]已解决:真实照片和截图已放置,价格和日期已确认。
账户和密钥
- 为生产主机名创建Turnstile小部件;真实站点密钥在HTML中。
-
TURNSTILE_SECRET通过wrangler secret put设置(绝不提交);.dev.vars*和.wrangler/在.gitignore中。 - 每个面向外部的步骤在运行前已由用户确认。
不使用Cloudflare
构建是纯静态输出:HTML、CSS、JavaScript和资源在一个文件夹中。任何静态主机或用户自己的服务器均可按原样提供。
如果用户不希望使用Cloudflare,则不要添加任何Cloudflare文件:不添加wrangler.jsonc、Worker、Turnstile、Web Analytics代码片段、.dev.vars。移除之前会话中添加的任何此类文件。然后直接转到启动检查清单,处理那些不涉及Cloudflare产品的项目。对于表单和转化,检查清单项目仍然适用:表单需要用户服务器或服务上的真实端点,且需服务器端验证;转化需要统计方式。指出缺失的内容,标记为待处理,并将工具选择权留给用户。本技能不提供其他主机的方案。
自查
在报告之前:
- 未经用户同意,未部署、预览、路由或创建任何账户内容。
- 每个配置变更均通过
npx wrangler deploy --dry-run,本地curl检查返回预期状态码。 - 没有文件声称Web Analytics统计点击或转化。
- 没有密钥、令牌或账户ID写入已提交的文件。
landing/launch.md存在,检查清单每一行均已标记,每个非done项附有原因,且没有提交的表单字段未被处理。
参考
references/hosting.md:按技术栈的配置、命令、干运行、自定义域名、_redirects和_headers、缓存、404、预览。步骤3时阅读。references/forms.md:表单标记、经过测试的表单Worker、使用Turnstile测试密钥的本地测试、生产设置。当页面有表单时在步骤4阅读。references/analytics.md:Web Analytics设置、Analytics Engine中的转化事件、查询、隐私声明、部署后检查内容。步骤5时阅读。references/ab-testing.md:免费计划下的成本、经过测试的...
… [为翻译截断]