当您将 NueForm 嵌入到自己的应用中时，通常已经知道用户是谁——他们在您的系统中有账户，您有内部用户 ID，并且希望表单在每次打开时静默恢复他们之前的答案。无需您管理 NueForm 的 cookies、浏览器存储，也无需让受访者看到「继续还是重新开始？」提示。
nf_visitor URL 参数处理这一切。结合表单的允许恢复 + 自动恢复设置，您的最终用户只看到表单——永远不会看到 NueForm 的恢复界面。
快速示例
https://nueform.io/f/your-form-slug?nf_visitor=user-12345
如果存在 user-12345 的部分响应，表单会静默恢复它。如果没有，表单将重新开始。用户从未看到模态框，从未选择「继续还是重新开始」，甚至不知道恢复机制的存在。
要「重置」用户（让他们重新开始），选择新的 nf_visitor 值：
https://nueform.io/f/your-form-slug?nf_visitor=user-12345-attempt-2
身份跟踪是您的责任——选择适合您应用的方案。
设置清单
- 在 NueForm 构建器中打开您的表单。
- 展开允许恢复部分。
- 启用允许受访者从上次中断处继续。
- 启用新的自动恢复子开关。
- 使用上述 URL 模式嵌入表单，提供您自己的
nf_visitor值。
就是这样。
工作原理
nf_visitor在每次加载时由受访者页面读取。- 它替换 NueForm 通常用于恢复 + 去重的基于 cookie 的访客 ID。
- 当
nf_visitor存在时，不会向localStorage写入任何内容——您的值是事实来源，受访者的浏览器保持干净。 - 提交、部分保存和恢复查找均基于您的值。
- 在表单变量替换运行之前，该参数已从
urlVariables中剥离，因此它绝不会泄漏到隐藏字段、webhook payload 或分析流量来源检测中。
验证规则
值必须：
- 长度在 1–256 个字符之间
- 匹配
[A-Za-z0-9_\-:.@]+——字母、数字、下划线、连字符、冒号、句点和@
UUID、电子邮件地址和您自己数据库中的大多数不透明 ID 自然适用。如果值不匹配，NueForm 会静默忽略它并回退到基于 cookie 的访客 ID。不会向用户显示错误，因此请在上线前使用您的测试设置验证行为。
何时忽略 nf_visitor
当表单启用了「需要受访者登录」时，nf_visitor 将被完全忽略。
这两个功能互斥——您不能同时拥有两者。如果「需要受访者登录」开启，NueForm 使用受访者经过身份验证的身份（Auth0 会话），URL 参数被视为从未提供过。一切自然地按照正常的已登录表单加载流程进行。
如果您需要在同一表单上同时具备这两种行为，则必须二选一——它们回答的是根本不同的问题：
- 「需要受访者登录」表示：「我需要在每次提交时都能信任的已验证身份。」
nf_visitor表示：「我自己为身份担保，请使用此不透明 ID。」
两者无法在表单层面调和。如果您需要在嵌入式场景中具备已验证身份，请使用「需要受访者登录」，让用户直接登录 NueForm。
与自动恢复配合使用
自动恢复是让 nf_visitor 在嵌入式场景中大放异彩的功能。两者均启用时：
- 返回的用户立即看到他们之前输入的答案。无提示，无选择。
- 新用户（新的
nf_visitor值）看到空白表单。 - 「提交后只读」会被遵守——一旦用户提交，使用相同
nf_visitor的后续加载会显示已完成的只读视图，这正是嵌入式记录/收据场景所需要的。
如果没有自动恢复，即使您提供了身份，返回的用户仍会看到 NueForm 的「继续还是重新开始？」模态框——这是嵌入式用例的 UX 缺陷。自动恢复消除了它。
隐私说明
nf_visitor成为 NueForm 数据库中响应的主要查找键。选择您可以控制且不会在不相关用户之间冲突的值。- 不要将您不希望存储在 NueForm 中的 PII 放入值中（例如，如果可以使用不透明 ID，就不要传递原始电子邮件地址）。该值会传递到响应的 webhook payload + 分析中。
- 任何拥有该 URL 的人都可以看到该值——将其视为任何其他 URL 令牌。如果您的嵌入式场景向用户显示 URL 栏，请考虑使用不透明 ID 而非可猜测的内容。
与隐藏字段结合
其他 URL 参数仍可与 nf_visitor 一起作为表单变量使用。例如：
https://nueform.io/f/your-form-slug?nf_visitor=user-12345&plan=premium&source=upgrade-flow
plan 和 source 可用于问题标题、逻辑跳转等中的变量插值，遵循标准的隐藏字段行为。仅 nf_visitor 是保留参数。