用途:管理表单从草稿到发布、关闭的完整生命周期,处理公开访问地址、验证码保护、品牌展示与表单设置,并在收到提交时通知外部服务。
主要能力:表单有三种状态——draft(草稿,不公开)、published(已发布,接受回复)、closed(已关闭,显示关闭提示不再接受回复)。发布后的表单可通过 /f/ 路径公开访问,slug 由标题加短唯一后缀自动生成,例如标题 "Contact Form" 生成 contact-form/a1b2c3,完整地址为 https://yourapp.com/f/contact-form/a1b2c3,标题变化时 slug 会自动更新。公开提交可选启用 Cloudflare Turnstile 验证码防止机器人提交。公开表单默认显示"Built with Agent Native"标识,可在设置中配置。
使用方式:用 pnpm action create-form --title "Survey" --fields '[...]' 创建表单,默认状态为草稿;用 pnpm action update-form --id --status published 发布;用 pnpm action update-form --id --status closed 关闭收集。每个表单有 settings JSON 对象,可配置 submitText(提交按钮文字)、successMessage(提交成功后的提示)、redirectUrl(提交后跳转地址)、showProgressBar(多区段表单进度条)、anonymous(匿名模式,抑制 IP、提交者身份、聊天/运行 ID、页面 URL 与客户端表面元数据)、integrations(Webhook/Slack/Discord 通知配置)。集成类型包括 webhook(向任意 URL 发送 JSON POST)、slack(发送到 Slack 频道)、discord(发送到 Discord webhook)、google-sheets(追加行到 Google Sheet)。若需要真正的匿名表单,须在创建时设置 anonymous: true;已发布的普通表单只是接受公开回复,并不等同于匿名模式。
适用场景:需要快速发布调查、联系表单等并管理其公开访问与提交通知的场景,以及需要控制提交匿名性或接入外部通知系统的场景。
限制:验证码为 Cloudflare Turnstile 且需主动启用;公开表单默认带品牌标识;匿名与已发布是不同概念,普通发布不会抑制识别与来源元数据。相关技能为 form-building(创建与结构化表单)和 form-responses(查看已发布表单的数据)。其余细节资料未提供。