Communitygithub.com

落地页上线 — Cloudflare 托管、转化事件、留资表单

把做好的落地页准备上线:Workers 静态托管、无 Cookie 的 Web Analytics、唯一 CTA 的转化事件、能用的留资表单 Worker、可选 A/B 测试,以及 landing/launch.md 上线清单。全部先在本地测试,没有你点头绝不部署、不动 DNS。

落地页上线 — Cloudflare 托管、转化事件、留资表单 是什么?

落地页配方第 3 步(上线):来自 Im-Fran/landing-skills 的 landing-launch。读取构建产物和 landing/brief.md,识别技术栈(纯 HTML、Astro、Vite/React、Next.js),然后写托管配置、表单 Worker、统计代码,并用 Workers Analytics Engine 计转化。Cloudflare 命令于 2026-10-04 对照文档核对、用 Wrangler 4.147.0 跑通;技能提醒你再核实一次,也提供非 Cloudflare 方案,隐私声明和联系方式在你提供前保持显眼占位。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-launch

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

着陆页启动

准备一个构建好的着陆页以启动:托管、页面分析、其单一行动号召的转化事件、一个可用的潜在客户表单、可选的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),或外部URLlanding/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次的限制。

流程

  1. 读取输入。 从landing/brief.md中获取转化操作(表单或外部页面、其字段、端点状态)、域名和联系途径。从构建的页面中,记录每个表单及其action和字段名称,以及每个行动号召链接。仅询问缺失的内容。

    然后选择情况,以确定添加内容:

    • 表单,端点none yet(表单提交至/api/lead,尚无服务响应):表单Worker,步骤4和5。
    • 表单,端点已存在: 无需表单Worker和Turnstile。检查表单是否提交到该端点,结果页面是否与其返回内容匹配,并记录验证和垃圾邮件防护是该端点的职责。
    • 外部页面(结账、预订、应用商店):无需处理表单。链接指向真实URL,点击通过步骤5中的信标统计;检查清单中的表单项标记为n/a。
  2. 首先修复死胡同。 在构建中搜索:action无效或提交被取消的表单、仅显示感谢消息的提交处理程序、指向裸#的链接、以及指向自身所在区域的按钮。每种情况意味着转化不存在。表单在步骤4获得Worker端点;链接获取用户的真实URL,或显示可见的[占位符: ...]和待处理的检查清单项。

  3. 托管配置。 为技术栈编写wrangler.jsonc,在项目中安装Wrangler,如果缺失则添加404.html,仅在有内容可放入时才添加_headers或_redirects。阅读references/hosting.md。

  4. 表单端点(表单,端点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,这会在测试中暴露问题,但在字段添加之前,访问者的提交仍会丢失。

  5. 分析和转化事件。 向每个页面添加Web Analytics代码片段,并在Analytics Engine中记录转化:在添加了表单Worker的情况下,在Worker中完成;对于链接,通过信标记录。对于已有端点的情况,转化从该端点的记录中统计,信标是可选项。阅读references/analytics.md。

  6. A/B测试,仅当被要求时。 在编写任何代码前,就单一变更、基准线、值得采取行动的最小差异及样本量达成一致。然后添加变体文件和A/B Worker。阅读references/ab-testing.md。

  7. 本地测试。 使用Turnstile测试密钥运行npx wrangler dev(在.dev.vars中配置),并使用curl和浏览器测试每个路径:包含所有字段的有效POST、无效电子邮件、每个字段超出上限、Turnstile验证失败、禁用JavaScript;对于测试:用户分配、第二次请求时的粘性Cookie、转化端点。然后运行npx wrangler deploy --dry-run并检查资源数量和大小。本地运行无需账户。修复任何失败内容后再继续。

  8. 等待用户许可。 部署、创建预览、添加自定义域名或路由、创建D1数据库、运行d1 execute --remote、设置密钥、创建Turnstile小部件以及向Web Analytics添加站点都会更改用户的Cloudflare账户,且部署或DNS更改会立即对公众可见。用户可能正在进行审核,域名可能仍在服务旧站点,错误的DNS更改可能导致在线站点宕机。因此,列出每个面向外部的步骤及其确切命令和将要更改的内容,仅在用户当时同意时才执行每个步骤。一个步骤的同意不代表同意下一步。如果用户希望自行运行,则按顺序提供命令。

  9. 部署后(与用户一起)。 提交一次在线表单,确认D1中的行和Analytics Engine中的转化,确认Web Analytics显示访问,并检查只有在线才能检查的检查清单项。

  10. 编写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:免费计划下的成本、经过测试的...

… [为翻译截断]

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

相关技能