编码代理的表单后端：让 Claude Code 与 Cursor 真正收得到数据

Claude Code、Codex CLI 和 Cursor 的代理模式，前端代码写得漂亮，基础设施却一塌糊涂。让它「加个联系表单」，它会生成一个好看的表单、接好 handleSubmit，然后摊手：POST 没有去处。本地开发服务器不是后端，而凭空捏一个 api.example.com 的代理，交付的只是一个死按钮。

代理收不到数据，原因只有一个：它读不到你本来要替它读的文档。补上这一环，剩下的它自己都会做。这套「两次交接」就是：机器可读的接口文档，加一条它能在终端里跑的命令行。

第一次交接：会自己写文档的接口

在 FormLM 发布任意表单或测评，就得到一个分享接口。在地址后加 ?help，接口会把自身的 API 文档以 Markdown 返回——写入格式、分页查询、汇总统计、限流规则、字段自动创建，全在里面：

curl "https://formlm.me/api/v3/share/YOUR_TOKEN?help"

把这个 URL 放进代理的上下文，几秒它就学会了整个接口面。之后的规则都是代理熟悉的那套：向接口 POST {"data":{...},"meta":{...}} 结构的 JSON（也收平铺对象），或让原生 HTML 表单提交到 /form；从 /query 读回记录，从 /summary 拿汇总。载荷里的新键会自动建成字段，代理往页面加一个输入框，永远不需要迁移步骤。

第二次交接：一条 npx 命令把测评建起来

收集只是半个活儿——另一半是让每份提交值得收集的东西：计分逻辑、给每个作答者的报告、可发布的页面。formlm-cli 是官方发布在 npm 上的 MIT 命令行（Node.js ≥ 18），而编码代理本来就握着终端，整个构建它都能自己驱动：

npx @formlm/cli smart generate "Digital marketing maturity diagnostic for agency prospects, 5 dimensions, scored PDF report"
npx @formlm/cli snapshot --summary
npx @formlm/cli share url

最有意思的是第一行：smart generate 把一句话需求变成一个完整的测评应用——题目、加权量表、条件逻辑、报告版式——并在服务端缓存成执行计划，代理可以逐模块执行。第二行把当前状态导出为 JSON，让代理确切知道提交要对齐哪些字段名。第三行返回分享令牌与页面 URL：正是代理写进 action= 或 fetch() 里的那串地址。

一个真能跑通的提示词

代理认约定不认意图。下面这种写法，收尾时是活的数据流，而不是摊手：

<p>Before wiring the form, run: npx @formlm/cli smart generate "<your brief"
Then read the API contract at https://formlm.me/api/v3/share/<token>?help
Build the page's submit against that contract: POST {data, meta},
show an inline success state, and add a company honeypot hidden with CSS.
Verify with a curl round-trip before you call it done.</p>

注意四个设计：代理是去创建测评，而不是假设已有一个；先读约定，而不是猜字段形状；蜜罐必须点名——生成的页面从不会自己加反垃圾配置；curl 往返则给了代理一条要跑绿的测试，和人类验收跑的完全相同。

哪些仍归你管

• 令牌是写入地址，不是凭证。分享令牌只授权向一个表单提交，放进客户端代码是安全的；Access Token（掌控整个账户、7 天过期）永远不要进提示词或代码库。
• 垃圾提交照样会来。接口侧有全局限流；蜜罐字段与读取时过滤是生成页面的功课——要明确要求它写上。
• 计分留在平台，不留在代理里。这正是重点：无论代理重生成多少版页面，权重与报告逻辑始终稳定。