# 访客留资配置
> 开启后访问者需先填写登记表单才能进入作品，可自定义表单字段并查看已收集的留资记录。

## 1. 页面信息

- 网页地址：https://9kvr.cn/tour/editor
- 所属模块：全景编辑器
- 页面用途：进入编辑器后，在「基础设置」中打开「访客留资配置」。在「留资设置」标签开启留资并选择显示平台，填写登记提示，配置表单字段（可拖拽排序、启用或禁用、添加自定义字段）；在「留资管理」标签查看访客提交的记录。点击「保存配置」并重新发布作品后生效。
- 适用用户：需要在线编辑全景作品的登录用户（作者本人）
- 访问条件：需登录后访问

## 2. 功能说明

- 开启或关闭留资功能，并选择显示平台
- 设置登记访问页面顶部的提示文字
- 配置表单字段：拖拽排序、启用禁用、设置必填
- 预设姓名与手机号字段，可添加自定义字段
- 在「留资管理」中查看访客提交的记录

## 3. 业务说明

### 配置区域

面板顶部为「留资设置」与「留资管理」两个标签。留资设置含开启留资、显示平台、登记提示设置与表单字段配置；留资管理展示留资数据列表，逐条显示各字段内容与填写时间。

### 字段说明

| 配置项 | 作用说明 | 类型/可选值 | 默认值/必填 |
| --- | --- | --- | --- |
| 开启留资 | 是否要求访问者填写表单后才能进入作品 | 开关 | 默认关闭 |
| 显示平台 | 留资在哪些平台生效 | 平台选择（微信小程序／手机网页／电脑网页） | 默认微信小程序 |
| 登记提示 | 登记访问页面顶部显示的提示内容 | 多行输入框，最多 50 个字符 | 选填 |
| 字段名称 | 表单字段的名称 | 输入框 | 添加／编辑字段时必填 |
| 字段类型 | 表单字段的类型 | 单选：单行文本、数字、邮箱、多行文本（预设字段不可修改类型） | 默认单行文本 |
| 占位提示 | 字段输入框内的提示文字 | 输入框 | 选填 |
| 最小长度 | 字段可输入内容的最小长度 | 数字，不能小于 0 | 默认 1 |
| 最大长度 | 字段可输入内容的最大长度，为 0 表示不限制 | 数字，不能小于 0 | 默认 0 |
| 是否必填 | 该字段访问者是否必须填写 | 开关 | 默认关闭 |

### 保存与生效

点击「保存配置」提示「留资配置保存成功」。保存前需至少启用一个表单字段，否则无法保存。预设的姓名与手机号字段不可删除，但可禁用。重新发布作品后对访问者生效，访客提交的记录可在「留资管理」中查看。

## 4. 使用说明

1. 在编辑器左侧点击「基础设置」，打开「访客留资配置」
2. 在「留资设置」开启留资并选择显示平台
3. 填写登记提示，配置表单字段（拖拽排序、设置启用与必填，或添加自定义字段）
4. 点击「保存配置」
5. 在「留资管理」查看访客提交记录，重新发布作品后对访问者生效

## 5. 规则与限制

- 开启后浏览此作品时用户需填写表单才可进入
- 至少启用一个表单字段才能保存
- 预设字段不可删除但可禁用；字段类型为预设字段时不可修改
- 最大长度设置为 0 表示不限制，且最小长度不能大于最大长度

## 6. 状态与异常

- 留资管理无记录：显示「暂无留资数据」
- 编辑字段与新增字段互斥，同一时间只展开一个编辑表单
- 未启用任何字段时保存：提示至少启用一个字段
- 未填写字段名称：提示「请输入字段名称」
- 最小／最大长度非数字：提示长度必须是数字
- 最小长度大于最大长度：提示「最小长度不能大于最大长度」

## 7. 相关文档

- [芊云编辑器配置项总览](https://9kvr.cn/site/tour/editor/config.md)
- [基础设置（一级菜单）](https://9kvr.cn/site/tour/editor/config/basic.md)
- [访问权限与暂停](https://9kvr.cn/site/tour/editor/config/basic/password.md)
- [全景作品播放页](https://9kvr.cn/site/tour.md)
- 上级目录索引：[/tour](https://9kvr.cn/site/tour/llms.txt)

## 8. 文档信息

- 事实来源：芊云编辑器公开版本配置与真实界面
- 文档构建时间：2026-10-20 19:04:23
- 数据获取/快照时间：不适用（静态产品知识）
- 可信状态：已核验