# 来数调研 · 问卷系统产品使用手册
更新日期：2026-10-22 · 共 90 篇
在线文档公开可读，业务数据按各自账号权限控制。
## 入门与工作空间
- [快速上手：发布第一份问卷](#quick-start)
- [登录、工作空间与功能权限](#workspace)
- [项目列表、文件夹与回收站](#projects)
## 创建与编辑问卷
- [空白、模板与研究助手建卷](#create)
- [编辑器、题目大纲与自动保存](#editor)
- [如何选择题型：34 种能力总览](#types-overview)
- [问卷外观、品牌与图片选项](#appearance)
- [版本快照与结构恢复](#versions)
- [团队题库与文本批量录入](#question-bank)
- [测验计分、标准答案与解析](#assessment)
- [多语言问卷与翻译维护](#languages)
- [导入电子问卷：先预览题目、逻辑与执行条件](#questionnaire-import)
## 题型与题目设置
- [文件上传：图片、凭证和研究材料](#type-upload)
- [手写签名：触屏书写、清除重签与答卷查看](#type-signature)
- [单选题：收集一个明确选择](#type-single)
- [多选题：收集多个选择并限制数量](#type-multiple)
- [下拉选择：用紧凑列表收集单项答案](#type-dropdown)
- [排序题：收集项目优先顺序](#type-ranking)
- [单行填空：收集简短开放文本](#type-text)
- [多行填空：收集原因与详细意见](#type-textarea)
- [手机号码：收集符合格式的大陆手机号](#type-phone)
- [邮箱地址：收集常见格式的联系邮箱](#type-email)
- [身份证号：仅检查号码字符串格式](#type-idcard)
- [网址题：收集完整网页地址](#type-url)
- [数字题：收集有范围与步长的数值](#type-number)
- [日期题：收集标准日历日期](#type-date)
- [时间题：收集小时与分钟](#type-time)
- [省市区：按地区层级联动选择](#type-location)
- [评分题：使用固定整数分值评价](#type-rating)
- [NPS 推荐值：收集零至十分推荐意愿](#type-nps)
- [滑杆题：在指定区间拖动选择数值](#type-slider)
- [量表题：用有序文字等级表达态度](#type-scale)
- [矩阵单选：多行共用一套答案选项](#type-matrix)
- [矩阵多选：每个对象分别选择多项](#type-matrix_multiple)
- [多项填空：一题收集多个固定文本字段](#type-multi_text)
- [矩阵填空：当前按行收集文本](#type-matrix_text)
- [比重分配：把固定总额分配给多个项目](#type-constant_sum)
- [MaxDiff 最优最劣：在展示项目中做一次取舍](#type-maxdiff)
- [KANO 需求分析：成对询问功能有无时的感受](#type-kano)
- [语义差异量表：按多个维度选择端点位置](#type-semantic)
- [知情同意：要求主动勾选确认](#type-consent)
- [说明文字：插入无需作答的研究说明](#type-description)
- [分页：在分页模式下划分页面](#type-page_break)
- [分组题：把固定子题组织成一个整体](#type-group)
- [自增题：由受访者按需增加记录组](#type-repeat)
- [随机抽题：从候选子题中记录本次抽取结果](#type-random_draw)
## 逻辑与填写流程
- [题目显示条件与嵌套条件组](#display-logic)
- [甄别、跳题与提前结束](#flow-rules)
- [动态选项与矩阵行列引用](#dynamic-options)
- [在题目标题中引用前题答案](#title-reference)
- [逻辑检查与测试预览](#logic-check)
- [DSL 逻辑：用代码设置显示、跳题与甄别](#logic-dsl)
- [DSL 完整语法参考：语句、运算符、优先级与限制](#dsl-syntax)
- [DSL 执行与保存：判断时机、优先级和双向同步](#dsl-execution)
- [DSL 示例库：从单条判断到完整调研问卷](#dsl-examples)
- [DSL 报错排查：错误原因、改法与试答检查](#dsl-errors)
## 样本配额
- [总配额、分项配额与计数口径](#quota-rules)
- [快速批量设置配额：多题、比例与 Excel 粘贴](#quota-batch)
- [自定义交叉配额与条件维护](#quota-custom)
- [渠道按总配额比例自动分配](#channel-allocation)
## 发布分享与回收
- [发布、停止回收与填写限制](#publish)
- [定向样本与一人一链](#targeted)
- [渠道管理与项目分发](#channels)
- [渠道专属进度链接](#channel-share)
- [项目总配额进度分享](#project-share)
- [中断作答与刷新恢复：临时答案的范围](#answer-recovery)
- [回收时间与作答倒计时：北京时间和自动交卷](#collection-time)
- [样本服务：提交人群需求与确认报价](#sample-service)
## 质控与答卷审核
- [质控中心：时长、重复与注意力检测](#quality-overview)
- [IP 地区与问卷答案一致性](#ip-region)
- [限制电脑或手机作答](#device-limit)
- [查看质控原因与人工审核](#quality-review)
- [后期清洗：检测跨题条件，再由人工判定](#response-cleaning)
## 数据查看与专业分析
- [提交、有效完成与质控状态](#response-status)
- [原始答卷、筛选与导出](#raw-data)
- [数据概览、趋势、题目与交叉分析](#analysis-overview)
- [专业统计：如何选择 14 类方法](#analysis-methods)
- [统计样本范围、变量编码与缺失值](#analysis-data)
- [AI 解读、研究目标与历史报告](#analysis-ai)
- [SPSS、Stata、Excel 与可复现分析包](#analysis-export)
- [原始数据多格式导出：文字、编码与变量字典](#raw-export)
## 协作与开放集成
- [团队成员、邀请与角色管理](#team-members)
- [企业设置与免费使用](#enterprise-settings)
- [问卷开放 API：密钥与只读数据接入](#survey-api)
- [问卷 Webhook：可靠投递、自动重试与补发](#webhooks)
- [官网需求表单：收件与跟进](#website-inquiries)
- [统计日期与免费使用说明](#launch-billing-time)
## 常见问题与更新
- [常见问题与排查顺序](#faq)
- [当前功能范围与上线核对](#capability-boundaries)
- [产品更新与文档使用说明](#release-notes)
---
# 快速上手：发布第一份问卷
从研究目标到回收结果，按顺序完成一次真实的问卷项目。
## 开始前准备
先确定研究目的、目标人群、期望回收数量和截止时间。把“必须符合的条件”与“希望达到的样本结构”分开：前者用甄别逻辑，后者用配额。准备好账号，并确认当前工作空间属于本次项目。
## 六步完成第一份问卷
1. 登录后进入“问卷项目”，点击“新建问卷”，或从“模板中心”选取结构相近的模板。
2. 在编辑器中修改问卷标题与说明，按顺序添加题目，设置选项、必答和必要的格式限制。
3. 进入“逻辑”设置不符合人群时的甄别终止；进入“配额”设置总目标及男女、年龄或地区分项。
4. 在“外观”和“设置”中调整品牌、按钮文字、开始截止时间、访问方式与结束文案。
5. 使用“逻辑检查”和“测试预览”，分别走通正常、被甄别、跳题及动态引用路径；确认保存完成后发布。
6. 复制正式填写链接或创建渠道链接回收。进入数据分析和质控中心查看结果，不把测试预览当成正式答卷。
## 一个常见项目示例
目标为回收 200 份北京消费者答卷，男女各 100 份。先用地区题和流程规则筛出目标人群，再设置项目总配额 200、男性 100、女性 100。如需核验 IP 地区，在质控中心另设 IP 地区一致性规则。人群答案、配额、IP 地区是三个独立条件。
## 如何判断已准备好发放
标题与隐私说明明确；必答不会与隐藏逻辑冲突；手机上选项可读；甄别文案得体；正式访问方式符合公开或定向要求；成员已分工。预览不保存正式答卷，也不占用配额。发布后修改结构会影响实际填写，正式改卷建议先停止回收并留存版本。
---
# 登录、工作空间与功能权限
理解账号、团队、工作空间和公开填写页之间的关系。
## 工作空间是什么
工作空间是问卷、答卷、渠道、成员和配置的数据边界。一个账号可以加入多个空间，左侧“当前工作空间”用于切换。切换后看到的项目和统计随空间变化，不能凭另一个空间的问卷编号直接读取内容。
## 登录与加入团队
使用自己的账号登录。新注册用户可创建企业工作空间；被邀请的成员使用有效邀请链接加入指定团队。团队邀请通常七天有效，失效后由管理员重新邀请。登录出错先检查账号输入、密码和账号状态，再联系团队管理员。
## 五种空间角色
| 角色 | 常见职责 |
| --- | --- |
| 所有者 | 负责空间的全部管理 |
| 管理员 | 管理问卷、成员、配置与集成 |
| 编辑者 | 创建、编辑、发布问卷，并查看答卷 |
| 分析员 | 查看问卷、答卷和分析，按授权处理答卷审核 |
| 查看者 | 查看问卷，不能直接获得答卷查看权限 |
具体按钮和接口都按权限校验。平台级管理身份与工作空间角色不同，成为一个空间的管理员不代表能管理所有企业空间。
## 文档公开与数据权限
本产品文档无需登录即可阅读，适合发给团队了解使用方法。公开阅读文档不会开放后台权限，也不会显示团队问卷或答卷。正式问卷是否允许任意人作答，由每份问卷的访问方式控制。
## 找不到问卷时
先确认当前空间，再清除项目名称、状态和文件夹筛选，最后检查回收站。若成员角色被调整，重新加载后权限实时以服务端结果为准；不要共享管理员账号代替正式授权。
---
# 项目列表、文件夹与回收站
整理项目、查找问卷，并区分停止回收、归档与永久删除。
## 查找项目
进入“问卷项目”，可按名称或说明搜索，按状态、文件夹筛选，并按最近更新、最近创建、名称或答卷数量排序。列表和卡片是同一批项目的两种呈现方式；筛选结果少不代表数据被删除。
## 用文件夹整理研究
1. 在项目侧栏输入文件夹名称并创建。
2. 在问卷操作中选择移动，放入对应客户或研究主题文件夹。
3. 点击文件夹查看其中项目，或回到全部项目清除范围。
文件夹用于组织当前空间内问卷，不自动建立独立团队授权，也不改变填写链接。
## 复制与修改
复制适合复用问卷结构开展新一轮研究。复制后检查标题、逻辑、时间、配额和渠道，不把历史项目的回收进度当作新项目进度。结构相似的持续研究，建议命名包含周期，例如“品牌追踪 2026Q4”。
## 三类操作的区别
| 操作 | 适用场景 | 核对重点 |
| --- | --- | --- |
| 停止回收 | 暂时或最终关闭正式填写 | 当前正在发放的入口及渠道通知 |
| 归档 | 不再放在常用项目列表 | 进入回收站后仍保留结构和答卷 |
| 永久删除 | 确认无需保留项目 | 操作不可当作普通归档，先完成导出与确认 |
归档项目可在回收站恢复。删除属于更高风险操作，仅有相应权限的成员可执行。
## 项目数量与数据口径
列表上的有效、提交与质控数量各有含义：提交包含不同结束状态，有效完成通常排除质控拒绝但包含待复核。做交付报告时还需明确是否只纳入审核通过的数据，不直接将列表总提交作为有效样本量。
---
# 空白、模板与研究助手建卷
选择适合的起点，生成后逐题核对内容、逻辑和回收规则。
## 三种创建方式
空白创建适合已有完整问卷；模板适合满意度、品牌、产品或报名等常见结构；“AI 生成问卷”研究助手适合整理第一版研究框架。三种方式生成的内容都可继续编辑。
## 从模板创建
进入“模板中心”，选取目标接近的模板，点击“使用模板”。替换研究对象、品牌、选项、说明和结束文案。模板中的人群设置不能代替本项目的抽样设计，原始目标和时间也应重新核对。
## 使用研究助手
1. 输入清晰的研究目的和目标人群，选择研究类型。
2. 配置题目数量、预计时长及是否包含知情同意、甄别、人口属性和开放意见。
3. 生成草稿后先核对研究问题是否被覆盖，再修改题目和选项。
4. 检查自动生成的逻辑、总配额与说明，用测试预览确认路径。
当前建卷助手采用规则和模板生成草稿，适合加快结构整理；不能把它当作已连接大型模型的开放研究服务，也不能替代研究人员审核。数据分析页面的 AI 解读是另一项功能。
## 常用题的复用
编辑器中的常用题包含性别、年龄、学历、收入、职业、地区、姓名、手机、邮箱以及体验和满意度指标。插入后仍能修改类型支持的设置。使用固定年龄区间前，先确认区间互不重叠且覆盖目标人群。
## 建好后必须复核
核对每个题目的研究用途、必答和选项完整性；删除重复内容；检查题目移动后的引用顺序。复制或生成成功只表示草稿建立，不代表正式发布或已有答卷。
---
# 编辑器、题目大纲与自动保存
掌握题目库、画布、属性和工作区切换，提高改卷效率。
## 编辑界面怎么用
编辑器围绕题目库、问卷画布和属性面板工作。选择画布上的题目后，右侧显示该题的标题、说明、必答和类型专属设置。题型库可以搜索，常用题提供可修改的问题模板；切换大纲可按顺序定位题目。
## 添加和调整题目
1. 从题型库选择类型，或从常用题插入。
2. 输入清晰标题和必要说明，选择类题目逐行维护选项。
3. 设置必答和选择数、数值范围或文本长度等约束。
4. 在大纲中拖动调整顺序；手机可用题目工具栏上移、下移。
移动或删除题目时系统会保护显示逻辑、跳转和引用依赖。遇到不能移动，先查看后题引用了什么，调整依赖后再操作，不通过反复删除绕开提示。
## 自动保存与离开页面
编辑会触发保存，等待保存状态完成后再关闭。网络失败时先保留当前页面并恢复网络，确认修改已保存。多个成员同时改同一份问卷时建议明确负责人、错开结构修改时间，避免最后提交覆盖双方预期。
## 工作区切换
“逻辑”配置流程规则；“配额”配置样本上限；“外观”配置品牌与版式；“设置”控制填写与回收；“样本”管理定向名单；“语言”维护翻译；“版本”保存和恢复结构。切换工作区不会自动把草稿变成已发布项目。
## 发布中改卷的注意事项
当前编辑与正式填写配置有关联，不能假定有独立的线上版本隔离。改题型、删选项、调整条件或改编码前，建议停止回收、保存版本、导出已有数据，再预览验证。题目答案含义改变后，历史数据与新数据应分口径解释。
---
# 如何选择题型：34 种能力总览
按数据结构和研究任务选择类型，避免一题混用多种含义。
## 先确定希望得到什么数据
单一类别用单选或下拉，多类别用多选，优先级用排序；数值、时点、地区和联系方式使用专门题型以获得对应校验。开放意见适合多行填空，不能用评分题代替原因说明。
| 任务 | 对应题型 |
| --- | --- |
| 选择与优先级 | 单选、多选、下拉、排序 |
| 文字与格式输入 | 单行、多行、手机、邮箱、身份证号、网址 |
| 数值和时间地区 | 数字、日期、时间、省市区 |
| 评分与态度 | 评分、NPS、滑杆、量表、语义差异 |
| 多条目数据 | 矩阵单选、矩阵多选、多项填空、矩阵填空 |
| 研究模型 | 比重分配、MaxDiff 最优最劣、KANO |
| 结构与流程 | 知情同意、说明文字、分页、分组、自增重复、随机抽题 |
| 资料与笔迹 | 文件上传、手写签名 |
## 一个类型与另一个类型如何区分
评分强调分值和标签，NPS 固定采用 0—10 推荐意愿并按推荐者、贬损者计算；排序输出次序，不等于选择频次；比重分配要求各项总和达到设定值，适合预算或重要性分配。矩阵减少重复题干，但手机上长矩阵会增加作答负担。
## 可用设置以类型为准
题目库能添加的类型会在属性面板显示对应设置。并非每种类型都适合动态引用、固定答案计分或专业统计，具体见各题型说明。联系方式格式校验不代表短信或实名验证。
## 统一设计建议
必答只用于确实必须获得的信息；选项保持互斥且覆盖实际情况；对敏感信息说明用途。图片选项使用可公开访问的图片地址，目前不能把它理解为文件上传或受访者图片采集功能。分组和随机抽题属于容器，应测试内部题目的顺序和依赖。
---
# 问卷外观、品牌与图片选项
配置可读的主题、品牌和结束文案，并检查真实手机填写效果。
## 外观设置入口
进入问卷编辑器“外观”，选择主题后调整主色、背景、页眉、封面、Logo、品牌、页脚和题目间距。主题示意用于预览内容层级，实际交互和换页应在测试预览里检查。
## 推荐调整顺序
1. 先选择浅色背景和高对比文字，确定主色。
2. 填写品牌和页脚，再设置可公开访问的 Logo 或封面图片地址。
3. 调整题目间距，长问卷用分页组织，避免单页信息过多。
4. 到“设置”修改按钮与不同结束状态的文案。
5. 在电脑与手机宽度各预览一次，检查长题干、矩阵和图片。
## 单选、多选的图片排版
选择题目，在“选项排版与图片”设置单列、双列或图片卡片。图片与选项文字绑定，修改选项后应重新核对映射。图片必须允许受访者网络访问，不能使用自己的磁盘路径或需要后台登录的附件链接。
## 文字与视觉一致性
题干应保留足够字号，不用过浅灰色承载重要提示。品牌色适合按钮和重点，正文保持稳定。说明文字用于解释填写方法，成功、甄别和满额文案应分别表达结果，不把被甄别误写为提交成功。
## 功能边界
外观随当前问卷保存，不等于建立团队级皮肤管理。公开图片地址的展示也不等于图片上传、对象存储或电子签名采集。外观不会改变服务端的权限、甄别和配额判断；正式回收前仍需检查这些业务规则。
---
# 版本快照与结构恢复
为重要改卷保存可识别的结构版本，并理解恢复对线上配置的影响。
## 版本保存什么
版本记录问卷标题、说明、设置和题目结构，适合在发布、改逻辑、改配额前留存。它不是答卷数据库备份，也不是整个平台的灾难恢复副本。已有答卷的保护与导出需要另行执行。
## 保存版本
进入编辑器“版本”，为当前结构创建快照，填写容易识别的版本说明，例如“正式发布前”“追加华南配额前”。先确认当前修改已保存，再建立版本；不能只靠时间猜测哪份符合客户确认稿。
## 恢复步骤
1. 检查当前问卷是否仍在回收，结构性恢复建议先停止发放。
2. 查阅目标版本的编号、时间和说明，明确将恢复的题目与设置。
3. 执行恢复。系统在恢复前会自动建立当前结构快照，再保存目标版本内容。
4. 重新核对逻辑、配额、渠道分项、语言和填写预览。
5. 确认客户交付口径后，再恢复回收。
## 已有数据怎么解释
恢复旧结构不等于删除已有答卷，也不自动把新旧题目语义统一。若版本间删除题目或修改选项，导出时需说明回收时间与结构差异。保持题目含义和编码稳定，有助于持续研究对比。
## 恢复失败时
版本管理免费开放，不设付费版本数量额度。恢复前系统仍会保存自动快照；遇到保存错误时，先检查权限和服务端提示，不连续重复点击。数据分析历史报告可能依赖原结构，改卷后应重新生成分析，避免旧报告与现有编码混用。
---
# 团队题库与文本批量录入
复用已确认的题目和标准答案，插入后独立维护。
## 团队题库
在编辑器打开“团队题库”，可搜索题目标题或分类，勾选后插入当前问卷。题库适合保存重复使用的人口属性、量表条目或测验题；不要把含真实受访者资料的内容作为题目模板保存。
## 使用流程
1. 先在当前题目上完成选项、必答、校验和计分等配置。
2. 使用收藏到题库入口保存，并选择清晰分类。
3. 其他项目从题库勾选插入，再调整题干中的产品、日期与场景。
4. 插入后预览，检查依赖和本项目的逻辑，不假定旧项目条件自动适配。
## 文本批量录入示例
在题库的文本导入区域按支持的格式输入题目，先预览并核对识别结果，再导入。下面示例表示一题单选、一题多选，星号用于必答标记：
```text
[单选] 您最近购买的渠道是？ *
- 线下门店
- 电商平台
- 其他
[多选] 您关注哪些因素？ *
- 价格
- 质量
- 售后
```
## 快照与更新
插入问卷或候选题组的是题目快照。后续修改团队题库不会自动覆盖已配置问卷，适合稳定执行；反过来改问卷也不会让题库所有项目一起变化。需要统一更新时，应明确受影响项目并逐一核对。
## 常见问题
识别不正确先看题型标签、选项分行和空行分题。复杂矩阵、嵌套逻辑或组合题不适合只靠一段纯文本推断；导入后进入属性补齐。题库的删除与编辑按当前空间权限执行，题库共享范围仍属于所在工作空间。
---
# 测验计分、标准答案与解析
为支持的题型设置客观答案，按实际答题结构计算得分。
## 启用方式
在问卷的测验设置中开启计分，配置及格百分比、交卷后是否展示得分，以及是否展示标准答案与解析。随后在支持的题目属性中设置标准答案、分值和解释。
## 配置步骤
1. 先确认题目具有可判定的客观答案，不将开放意见直接当作标准判断。
2. 为每道可计分题打开计分并设置答案，检查选项文字和当前配置一致。
3. 设置合理分值和解析，不把解析写到正式答题题干中。
4. 若使用随机抽题，核对各候选题难度和分值。
5. 在预览中分别走全对、部分错误、不同抽题结果的路径，再核对总分与及格判断。
## 满分如何计算
计分由服务端处理，随机抽题按该份实际抽中的题目计算满分，不把未抽中的题目都记入分母。隐藏、重复或组合结构的题目应以对应题型支持范围和测试结果为准，不能仅用编辑器表面题数推算满分。
## 与研究问卷的区别
态度、偏好、NPS 等研究问题通常没有“正确答案”。是否通过测验也不自动替代质控规则，更不等于已经通过客户有效性确认。需要甄别时仍配置流程规则。
## 限制与维护
动态引用选项不支持固定标准答案计分。改动选项、分值或题型后重新核对标准答案，发布中的结构变更先保存版本并停止回收。此功能不包含监考、摄像头认证或自动证明受访者本人作答。
---
# 多语言问卷与翻译维护
在同一问卷维护语言版本，保证题目与选项含义一致。
## 配置入口
在编辑器“语言”维护可用语言和默认语言。当前最多配置 10 个语言项，语言编码不能重复。选择语言后维护标题、说明、题目和选项等翻译内容，保存后到公开填写页检查。
## 推荐流程
1. 先完成主要语言的结构、逻辑与配额，再增加目标语言。
2. 逐题维护翻译，保持选项顺序和语义一致。
3. 检查按钮、结束文案与品牌内容，避免一半翻译一半原文。
4. 使用语言入口实际试填，检查长文、矩阵和手机换行。
5. 对动态引用、标题答案插入和条件路径分别测试。
## 数据如何保持一致
不同语言对应同一份问卷的题目结构，填写展示可本地化，分析仍需保持统一编码和含义。不要把同一选项在不同语言中翻译成不同概念，否则统计合并会产生解释错误。
## 改卷后的工作
新增选项、修改题干或删除题目后，重新核对全部语言，不只检查默认语言。标题引用和动态候选也会影响翻译呈现。正式回收中大改结构前先停止并留存版本。
## 功能边界
当前提供翻译内容管理与填写语言呈现，不能把添加语言理解为已自动完成专业翻译。量表、医学或法律内容应由懂领域的人员审校。语言切换也不改变地区、设备和邀请限制，所有真实提交仍遵守同一组回收规则。
---
# 导入电子问卷：先预览题目、逻辑与执行条件
将 Excel、CSV、TSV 电子问卷转换为可编辑草稿，核对编码、路径、最低目标和上限配额。
## 适用范围与权限
在“问卷项目”点击“导入电子问卷”，选择文件，系统先解析预览，再由你确认生成新草稿。上传预览不会直接发布，也不会覆盖已有问卷。当前工作空间的所有者、管理员、编辑者可操作；分析员和只读成员没有导入权限。
### 文件准备
| 文件结构 | 要求与限制 |
| --- | --- |
| 电子问卷 XLSX | 最大 30 MB，兼容题干与选项分行格式，以及“题号、调研信息点/题目内容、题型、选项”的每行一题格式 |
| CSV、TSV | 使用 UTF-8 编码，逗号或制表符分列，只承载单张表内容 |
| 题库模板结构 | 包含“题目标题”“题型”，通过电子问卷入口支持最大 30 MB，题库模板仍限一百题；单独的题库导入入口保持两 MB 限制 |
| 旧版 XLS | 不支持，应先另存为 XLSX；题目与编码宜使用文本或数值 |
电子问卷可以按题号组织题干与后续选项行，也可以一行一道题。每行一题格式兼容“调研信息点”“题目内容”“问题内容”等列名，表头前可有封面说明；合并单元格中的共享选项、模块、逻辑和备注会保留到相应题目中。原字母选项标签可在预览中查看，数据编码采用整数；重复标签或重复文字会明确提示核对，不会静默丢弃选项。
XLSX 旧格式还可读取配额、清洗相关工作表；每行一题格式的明确“过滤某选项”条件可生成甄别规则，无法确认的复杂逻辑保留原文并提示核对。系统会自动配置可明确识别的固定选项随机、时间范围文字标红，以及部分跨题显示和范围甄别规则。图片、定时观察及无法明确识别的循环提问等内容会列为“尚未完成”。展开各题的“原文件”可核对原行号、题型、逻辑和备注；“其他”注明会拆成条件填空子题。
单表最多五千个非空行；最终草稿仍须满足单份问卷最多二百题等保存校验。
## 预览与创建步骤
1. 检查原题数与转换后题数，展开题目核对选项、原编码、矩阵行和显示条件。
2. 核对跳转、甄别、提前完成、上限配额、最低目标与清洗条件的摘要。
3. 在统一结果页查看“自动处理”“推荐方案”“尚未完成”，可按题号或关键词搜索、按状态筛选。确认名称后，点击一次“确认采用并生成草稿”，统一采用本次推荐方案。
4. 草稿保存处理记录、采用方案和确认时间。编辑器顶部可打开处理记录，再预览试答关键路径并发布。尚未完成项不会因点击确认而变成已解决。
自动处理按已支持的规则执行，不理解任意自然语言。对可提供建议的歧义，页面会明确展示推荐口径（例如采用“或者”的显示关系），确认后按所展示的方案执行；无法可靠处理的要求仍标为“尚未完成”。部分共享选项、条件子题或“其他”补充会拆分为独立题目，转换后题数增加属于可能结果。配图要求不等于导入了图片，未完成的要求会保留原文。确认只生成草稿，不会发布、覆盖已有问卷或自动废卷。预览方案有效期三十分钟，过期需重新上传；同一有效方案重复确认会复用已创建的草稿。未完整识别的清洗条件可能停用或仅列为待核对，不能按摘要数量判断全部可执行。
### 最低目标与上限的区别
例如“渠道甲至少五十份”是结构监控目标，达到后继续回收；“渠道乙上限八十份”会参与满额控制。配额表中识别出的“≥五十”会作为最低目标，普通数量按上限处理，不能将两者互换。总目标有时依据同一分组题的上限相加生成，必须在预览中核对。
最低目标按已完成且未被拒绝的答卷计数，包含待复核；废卷后可能重新未达标。规则与清洗不是同一步：导入不会自动废卷，后续需进入[后期清洗](#response-cleaning)检测并人工判定。
## 常见错误
- 将预览成功理解为所有备注、公式、图片和复杂路径均已转换，跳过正式试答。
- 把最低目标当作停止回收的上限，或调整选项后不再检查原编码及关联条件。
导出时的编码与缺失口径参阅[原始数据多格式导出](#raw-export)。
---
# 文件上传：图片、凭证和研究材料
设置附件格式、数量与大小，在答卷详情下载，并了解暂存与空间限制。
## 添加与配置
在问卷编辑器“题目 → 文件与确认”选择“文件上传”，填写题目及资料用途，并按实际需要开启必答。在右侧设置允许扩展名、最多文件数和单文件大小。支持 png、jpg、jpeg、webp、pdf、txt、csv、docx、xlsx；扩展名用逗号分隔。每题最多 5 个文件，单个最高 5 MB，可以将限制设得更低。文本文件需采用 UTF-8 编码；本题只收集上传文件，不提供录音、录像或压缩包解压功能。
## 受访者填写
点击“选择文件”后等待上传结束，文件名和大小会显示在题目下方。不需要的文件可以移除后重传。本次作答全部附件合计上限 25 MB，包含尚未移除的旧版签名。单次作答最多保留 50 个待提交附件，上传过于频繁时会暂时限制。上传进行中应保持页面打开，完成后再提交。预览页的附件只在浏览器页面中模拟选择，不上传服务器，不生成正式答卷。
## 查看、下载与导出
正式交卷后，在“数据洞察 → 答卷明细 → 查看详情”中查看文件名并下载。图片可在详情中显示；文档使用下载方式打开。附件绑定当前工作空间和本次作答，不能将另一份答卷的附件编号复制进来。下载需要在所属企业登录并具有答卷查看权限；文件地址不是公开分享链接。CSV 导出包含附件编号、文件名、大小及受权限保护的下载路径，CSV 本身不打包文件内容。
## 保存与运行边界
文件以二进制内容和校验摘要保存在问卷数据库中，随数据库的在线备份保存，不依赖某个发布目录。默认每个企业附件空间为 512 MB，部署者可用 SURVEY_ASSET_STORAGE_MB 调整。未提交的附件在作答凭证 24 小时过期后由后台定期清理；已提交附件跟随答卷保留。签名也计入附件空间。格式和大小检查不等同于杀毒；服务端不执行或解析受访者上传的 Office 文档。商业使用需要进一步的病毒扫描或对象存储时，应另行接入对应服务。
---
# 手写签名：触屏书写、清除重签与答卷查看
采集并保存手写笔迹，区分知情同意勾选、笔迹记录与电子签章。
## 创建签名题
在“题目 → 文件与确认”选择“手写签名”，明确写出确认事项、资料用途和保存要求。题目可设为必答，并可用于分组、自增或随机题组。知情同意题仍用于勾选确认；需要手写笔迹时，应添加独立的手写签名题。
## 填写与保存
电脑使用鼠标，手机和平板可用手指或触控笔在画布中书写。完成后点击“保存签名”，看到“签名已保存”再继续或交卷。画布上的未保存笔迹不会被当成已提交的签名；需要修改时点击“清除重签”并重新保存。空白、只有一个点、过少的笔迹或超出画布的无效坐标会被服务端拒绝。为避免异常请求，笔迹限制为最多 50 笔、2500 个坐标点。
## 结果与权限
服务端根据有效坐标生成固定格式的 SVG 笔迹图，不接受受访者自行提供的 SVG 脚本或图片代码。正式交卷后在答卷详情查看图像和下载签名文件，CSV 导出保留对应附件元数据和受保护的下载路径。其他企业不能访问，未提交的签名也不能作为正式答卷附件下载。正式填写时已保存的签名会跟随当前标签页的临时答案恢复；未点击保存的笔迹不要依赖刷新恢复。
## 使用边界
本题记录填写者提交的笔迹及所属答卷，不具备实名核验、可信时间戳、数字证书或电子签章服务。系统不验证书写者的真实身份，不自动证明签名的法律效力。需要合同签署或身份认证的场景应接入合适的认证和电子签约服务。预览仅演示签名操作，不上传文件、不产生正式记录。到达正式作答期限后不能继续上传或替换签名，超时答卷按限时规则处理。
---
# 单选题：收集一个明确选择
设置单选选项、其他项、随机顺序和图片排版，了解频数与条件引用的边界。
## 用途与创建路径
单选题适合收集唯一首选、使用状态或互斥分类。受访者只能保留一个答案；选项应覆盖研究范围，避免“经常使用”和“每周使用”等含义重叠。
1. 打开问卷编辑器，进入“题目”，在“添加题目”的“选择题”中点击“单选题”。
2. 选中题目，在右侧填写标题、补充说明与选项，并按需要开启必答。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 选项 | 每行一个，至少两项，名称不能重复，每项最多一百字符 |
| 选项随机 | 打乱填写端的初始展示顺序，不改变答案文字 |
| 允许其他项 | 可修改其他项名称，选择后填写补充文本 |
| 展示方式 | 单列、双列、图片卡片；图片使用公开可访问的图片地址 |
| 自动计分 | 可设置标准选项、分值和解析，需同时开启问卷测验计分 |
## 示例、统计与逻辑限制
例如询问“您最希望先改善哪个环节”，设置“办理速度、说明清晰度、服务态度”，另开“其他”。结果概览按答案统计人数和比例，其他文本会形成相应答案项；比例以本题有答案的人数为分母。
可用前题答案控制本题显示，也可让后题引用本题已选或未选的固定选项。引用不带入其他填空内容，来源未答或引用为空时后题会跳过。图片地址仅用于展示，不提供受访者文件上传。
### 常见错误
- 只写“其他”普通选项却希望自动出现输入框，应使用“允许其他项”。
- 回收后改名或删除选项会影响历史答案对照，修改前应核对统计与逻辑条件。
需要同时选择多个答案时参阅[多选题](#type-multiple)，长列表可参阅[下拉选择](#type-dropdown)。
---
# 多选题：收集多个选择并限制数量
配置多选数量、其他项与排版，正确理解选择比例和动态选项。
## 用途与创建路径
多选题适合收集接触渠道、关注因素或已经使用的功能。每人可选择多个项目，适合描述覆盖情况；若研究目标是唯一首选，应改用单选。
1. 在问卷编辑器选择“题目 → 添加题目 → 选择题 → 多选题”。
2. 在右侧输入标题、补充说明和逐行选项，设置必答及选择数量。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 固定选项 | 至少两项，名称唯一，每项最多一百字符 |
| 最少选择 | 零至固定选项数，不能大于最多选择 |
| 最多选择 | 一至固定选项数，限制总选择数量 |
| 随机与其他项 | 可打乱选项，可开启并命名其他填空项 |
| 展示与计分 | 支持单列、双列、图片地址卡片；计分要求答案集合完全一致 |
## 示例、统计与逻辑限制
例如“您通过哪些渠道了解活动”，列出“搜索、朋友介绍、线下宣传”，设置至少一项、最多两项。开启必答才能阻止整题空答；单设最少选择并不等于必答。
概览统计每个选项被选人数，分母为本题回答人数，各项比例合计可能超过百分之百。统计工作台可把固定选项展开为选中与未选中的零一变量，其他自由文本不会成为同样的固定变量。
后题可引用已选或未选固定选项，引用为空会自动跳过。普通选项写成“以上都没有”并不会自动建立独占规则，不能仅靠选项名称阻止它与其他答案同时被选中。
### 常见错误
- 减少选项后忘记重设最多选择，或把最少数设得更大。
- 将多选百分比当作互斥分类比例相加，或以为计分支持漏选部分得分。
参阅[单选题](#type-single)与[矩阵多选](#type-matrix_multiple)选择合适结构。
---
# 下拉选择：用紧凑列表收集单项答案
创建下拉列表，设置随机与其他项，并核对分类统计和引用条件。
## 用途与创建路径
下拉选择适合行业、岗位类别等较长的单项列表。填写者展开列表后选择一个答案，能节省页面空间；选项很少或需要同时比较全部内容时，可优先考虑单选题。
1. 打开问卷编辑器，进入“题目 → 添加题目 → 选择题 → 下拉选择”。
2. 在右侧填写标题、补充说明与逐行选项，按需要开启必答并测试预览。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 选项 | 至少两项，不能重名，每项最多一百字符 |
| 选项随机 | 随机改变列表顺序，固定编码列表通常应保持关闭 |
| 允许其他项 | 可修改名称，选中后出现补充文本输入框 |
| 自动计分 | 可指定一个标准答案、分值和解析，依赖问卷测验开关 |
## 示例、统计与逻辑限制
例如收集“您所属的业务类别”，设置“零售、制造、服务、公共事务”，并允许其他填写。未选择时显示“请选择”，提示项不是有效业务答案。应同时试填普通选项、其他项和整题未答的路径。
概览按答案计数，统计工作台把固定选项作为分类变量；其他自由文本不会自动纳入既有固定分类。题目可按前题条件显示，后题也可引用本题已选或未选的固定选项，其他填空不参与动态选项引用。
当前控件是普通下拉列表，不提供搜索框、多选下拉或多个下拉之间的通用级联配置。省市区应使用专用地区题，而非手工假定列表能自动联动。
### 常见错误
- 把下拉当作可输入任意文本的搜索选择器，导致遗漏其他类别。
- 给按字母或业务顺序查找的列表开启随机，增加受访者查找成本。
少量答案可参阅[单选题](#type-single)，地区联动参阅[省市区](#type-location)。
---
# 排序题：收集项目优先顺序
设置全量或部分排序，区分入选次数、原始顺序和统计工作台名次变量。
## 用途与创建路径
排序题用于比较购买因素、改进方向或品牌的优先级。答案保存项目的先后顺序，可以要求全部排序，也可只选出前几项；它不直接收集项目之间差距有多大。
1. 在问卷编辑器选择“题目 → 添加题目 → 选择题 → 排序题”。
2. 输入标题与逐行选项，在右侧设置必答、最少排序和最多排序。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 排序项目 | 至少两项且名称唯一，每项最多一百字符 |
| 最少排序 | 至少一项，不能超过项目总数 |
| 最多排序 | 不小于最少排序，不超过项目总数 |
| 初始选项随机 | 打乱待选项目的初始顺序，最终顺序由填写者决定 |
## 示例、统计与逻辑限制
例如设置“价格、品质、效率、售后”四项，最少与最多均设为三，即要求选出前三并排顺序。填写者点击项目加入排序后，可用上移、下移和移除按钮调整，不能给两个项目相同名次。
概览条形图统计项目入选次数，不是平均名次或加权排名；全量排序时各项入选数往往相同。统计工作台可将各项目展开为名次变量，未排入的项目是缺失值，分析时应注意有效样本差异。
后题引用本题选项时按已选或未选项目取集合，不能据此配置“第一名等于某项”的专用名次条件。复杂比较应核对原始顺序，而非只看概览图。
### 常见错误
- 新增或删除项目后保留原数量限制，造成实际要求与题目说明不一致。
- 把同样入选的项目解释为同等偏好，忽略它们在答案中的排序位置。
只需收集覆盖情况可用[多选题](#type-multiple)，最优最劣取舍参阅[MaxDiff](#type-maxdiff)。
---
# 单行填空：收集简短开放文本
配置输入提示、字符数和内置格式校验，了解文本统计与自动判分。
## 用途与创建路径
单行填空适合填写产品型号、简短原因或自定义称呼。它保留文字内容，不会自动把自由输入归并成分类；若需要计算金额或数量，应改用带数值校验的数字题。
1. 在编辑器进入“题目 → 添加题目 → 文本与信息 → 单行填空”。
2. 填写题目标题、补充说明和输入提示，再配置必答与长度规则。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 输入提示 | 未填写时显示的提示文本，不作为默认答案提交 |
| 格式校验 | 不限格式、手机号码、邮箱地址、身份证号或网址 |
| 最少字数 | 零至三百字符，不能超过最多字数 |
| 最多字数 | 一至三百字符，默认三百 |
| 自动计分 | 可设置分值、标准文本和解析，按完整文本精确匹配 |
## 示例、统计与逻辑限制
例如“请用一句话描述最希望改进的环节”，设置最少五、最多八十字符，提示“请描述具体场景”。最少字符只约束已经填写的答案；如不允许整题跳过，还需开启必答。系统按字符长度校验，不是按中文词语数量计数。
概览显示文本回答示例，完整内容应在答卷明细或原始导出中核对；开放文本不作为统计工作台的数值或分类变量。后题可按本题等于、包含文字或已作答等条件显示，匹配取决于实际文本，不会自动识别同义表达。
### 常见错误
- 用占位提示代替题目说明，以为受访者不输入也会保存提示内容。
- 开启精确判分却预期自动接受同义词、关键词或语义近似答案。
长意见参阅[多行填空](#type-textarea)，多个固定字段参阅[多项填空](#type-multi_text)。
---
# 多行填空：收集原因与详细意见
设置长文本长度、格式与提示，避免将开放回答误认为自动编码结果。
## 用途与创建路径
多行填空提供较大的文字输入区域，适合收集使用经历、评分原因和改进建议。建议写清希望受访者描述的角度，避免只问“其他意见”而难以获得可比较的有效反馈。
1. 在问卷编辑器进入“题目 → 添加题目 → 文本与信息 → 多行填空”。
2. 设置标题、补充说明、必答和输入提示，再填写最少与最多字数。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 输入提示 | 提示回答方向，空白时显示，不会成为正式答案 |
| 字符范围 | 最少零、最多三千字符；最多字数必须为正，且不小于最少字数 |
| 格式校验 | 支持不限格式及手机、邮箱、身份证号、网址等内置规则 |
| 自动计分 | 支持标准文本、分值与解析，要求文本完全一致 |
## 示例、统计与逻辑限制
例如在评价后追问“请描述一次等待时间较长的经历”，设置二十至五百字符，并说明可写“发生环节、等待感受、改进建议”。如果开启手机号等格式校验，系统会校验整段文本，通常不适合这种开放叙述。
概览提供有限条文本示例，原始内容保留在答卷明细与导出中；当前统计工作台不将此题自动展开为主题分类或文本变量。需要主题编码时应另行整理，不能把收集文本等同于已完成情绪或关键词统计。
可以按前题答案决定是否出现，也可用本题具体文字或作答状态驱动后题。条件匹配不是自然语言理解，敏感的路径判断宜使用明确选项题。
### 常见错误
- 字数要求过长却没有说明回答口径，增加受访者负担和无效重复文字。
- 把长文本精确判分当作自动批改论述题，或假定能附加上传文件。
短回答参阅[单行填空](#type-text)，作答材料可放在[说明文字](#type-description)中。
---
# 手机号码：收集符合格式的大陆手机号
说明手机号输入规则、可配置提示，以及格式校验与号码验证的区别。
## 用途与创建路径
手机号码题用于回访联系、报名通知等确需号码的场景。创建前应在题目说明中写明联系用途与填写口径，尽量只收集项目真正需要的信息，避免将联系电话当作受访者身份结论。
1. 在编辑器进入“题目 → 添加题目 → 文本与信息 → 手机号码”。
2. 在右侧设置标题、补充说明、输入提示和是否必答，使用测试预览检查错误提示。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 输入提示 | 可修改默认的十一位手机号提示 |
| 号码规则 | 十一位纯数字，首位为一，第二位为三至九 |
| 必答 | 开启后不允许整题空答；关闭不代表放宽已填写号码的格式 |
| 格式扩展 | 当前没有国家区号、座机格式或自定义正则配置 |
## 示例、统计与逻辑限制
例如题目写“如需接收回访通知，请填写大陆手机号”，补充说明“仅用于本次项目联系”。示例可描述为“十一位数字，不加区号、空格和分隔符”，无需在题目中放入任何实际号码。
输入控件与提交校验都会检查号码形态，但不发送短信验证码，也不验证号码是否开通、是否属于填写者或能否接通。相同号码的唯一性也不是本题自动承担的规则。
概览按文本展示回答，完整内容可在答卷明细中核对；联系信息不进入统计工作台变量。后题可使用本题的作答状态等条件，号码是文本，不能按连续数值解释或计算。
### 常见错误
- 将国际号码、座机或带分隔符的号码填入专用题，误以为可自动转换。
- 将格式通过写成“手机认证成功”，或未说明用途就把题目设为必答。
授权说明参阅[知情同意](#type-consent)，其他联系方式口径可参考[单行填空](#type-text)。
---
# 邮箱地址：收集常见格式的联系邮箱
配置邮箱输入提示，了解基本格式检查、统计范围和联系信息限制。
## 用途与创建路径
邮箱地址题适合收集后续通知、资料联系或自愿回访使用的邮箱。应明确填写一个地址，避免受访者把多个邮箱、显示名称和联系说明混在同一答案中。
1. 在问卷编辑器选择“题目 → 添加题目 → 文本与信息 → 邮箱地址”。
2. 选中题目，在右侧填写标题、用途说明、输入提示与必答状态。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 输入提示 | 可提示“请填写一个常用邮箱地址” |
| 基本格式 | 检查地址含有邮箱分隔符及域名点号，且相关部分不含空白 |
| 长度 | 使用三百字符上限，界面不提供单独的邮箱长度配置 |
| 必答 | 控制是否允许整题不填，不会改变邮箱格式要求 |
## 示例、统计与逻辑限制
例如“您希望通过哪个邮箱接收后续联系”，可用保留示例域的地址 user@example.com 说明格式，并写清用途。题目只接受地址本身，不应输入“联系人姓名加邮箱”或用逗号连接多个地址。
当前检查的是常见字符串格式，不会发送验证邮件，不检查域名邮箱服务是否存在，也不确认邮箱可投递或归填写者所有。格式通过不代表联系人已确认，题型本身也不会自动完成通知发送。
结果概览把地址作为文本回答展示，完整记录可在答卷明细与原始导出中核对；联系信息不进入统计工作台变量。可按前题控制是否出现，也能用本题已作答等条件驱动后题，但不宜凭邮箱后缀推断人员身份。
### 常见错误
- 要求多个联系人却仅放一个邮箱题，导致格式校验失败或无法区分对象。
- 把通过格式检查解释为已验证、已订阅或已发送资料。
其他联系渠道参阅[手机号码](#type-phone)，用途确认参阅[知情同意](#type-consent)。
---
# 身份证号：仅检查号码字符串格式
说明身份证号题的格式规则和最小配置，明确不提供真实身份核验。
## 用途与创建路径
身份证号题用于确有必要的证件号码记录。应先确认收集目的与范围，在补充说明中讲清用途；如果研究仅需年龄、地区或一般资格，应优先使用对应问题，避免收集完整号码。
1. 在编辑器进入“题目 → 添加题目 → 文本与信息 → 身份证号”。
2. 填写标题、用途说明与输入提示，谨慎决定是否必答，再测试空答和格式错误情况。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 输入提示 | 可自定义证件号码填写提示 |
| 接受格式 | 十五位数字，或前十七位数字加末位数字或大小写字母 X |
| 输入长度 | 填写控件最多十八字符 |
| 必答 | 控制整题是否可留空，不提供证件类别切换 |
## 示例、统计与逻辑限制
可在示例说明中写“请按证件号码原样填写，末位为 X 时保留该字符”，无需放入完整证件样例。系统只检查上述字符形态，不计算校验码，不核对出生日期、地区编码或号码是否实际存在。
本题没有姓名与证件一致性比对、联网实名核验、人脸识别或证件照片上传能力。因此，不能把保存成功或格式通过称为“身份认证完成”，也不应直接将其作为资格真实性结论。
结果以文本保留，可在答卷明细或原始导出核对；当前不进入统计工作台变量，也没有从证件号自动生成年龄、性别或地区统计的配置。可以按前题显示本题，后续流程宜根据明确的资格选项判断。
### 常见错误
- 为了普通样本画像就要求完整证件号码，超出实际研究需要。
- 将护照、其他证件或带掩码的号码放进本题，期待系统自动识别类别。
用途确认参阅[知情同意](#type-consent)，其他文本口径参阅[单行填空](#type-text)。
---
# 网址题：收集完整网页地址
设置网址提示，区分地址格式校验、链接可访问性与文件上传。
## 用途与创建路径
网址题适合收集作品页面、机构介绍页或公开资料的地址。答案是一条网页链接文本，适合已经发布的内容；设计时应说明是否需要公开可访问，以及接受哪一类页面。
1. 在问卷编辑器选择“题目 → 添加题目 → 文本与信息 → 网址题”。
2. 在右侧设置标题、补充说明、输入提示与必答状态，预览检查完整网址的填写方式。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 输入提示 | 可提示填写包含协议的完整网址 |
| 地址规则 | 必须能解析为 HTTP 或 HTTPS 地址 |
| 输入长度 | 三百字符上限，无单独的域名白名单配置 |
| 必答 | 开启后不允许整题留空，已填写内容始终需要通过格式检查 |
## 示例、统计与逻辑限制
例如题目为“请填写作品展示页地址”，示例使用 https://example.com/work，并提醒不要只写域名或页面标题。若需要收集多条独立链接，应分题明确标签，避免将一串地址拼接成一个答案。
系统校验地址结构与协议，不主动打开网页核验内容、权限、有效期或归属，也不会抓取页面截图、附件和标题。收集地址不等于把目标文件保存进问卷系统，本题不提供受访者文件上传。
概览按文本展示回答，完整链接在答卷明细与原始导出中核对；当前不进入统计工作台变量。后题可依据本题是否已答等条件显示，但链接中包含某段文字不代表目标页面已经通过审核。
### 常见错误
- 忘记写协议，或填写本机文件地址、共享目录、页面名称，导致格式不通过。
- 把需要登录、短期有效的地址当作长期可用资料，却没有告知访问要求。
一般文字可用[单行填空](#type-text)，统一作答要求可放入[说明文字](#type-description)。
---
# 数字题：收集有范围与步长的数值
配置数值上下限、步长和计分，核对空白边界保存行为与数值统计。
## 用途与创建路径
数字题适合收集件数、时长、预算等可计算数值。应在题目或说明中写清单位和时间范围，让不同受访者使用相同口径；答案中只填数值，单位文字放在题目里。
1. 在编辑器进入“题目 → 添加题目 → 数值与评价 → 数字题”。
2. 配置输入提示、最小值、最大值、步长与必答，再通过预览核对边界值。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 输入提示 | 自定义未填写时的提示 |
| 最小值、最大值 | 下限不能大于上限，建议明确填写两端 |
| 步长 | 必须为正，默认一；可使用小数步长 |
| 自动计分 | 可指定标准数值、分值和解析，按数值相等判分 |
## 示例、统计与逻辑限制
例如“上周用于学习的总小时数”，设置最小零、最大一百六十八、步长零点五，可填写零、零点五、一等数值。步长以最小值为基点；存在非零下限时，不能只看答案的小数位判断是否有效。
当前保存实现会把空白上下限转成零，因此不要把清空输入框理解为可靠的“无限制”。应明确设定合理范围，并在保存后重新检查最小值、最大值和预览表现。
概览提供平均值、中位数与范围，统计工作台可使用数值变量。后题显示条件可比较大于、小于、等于等数值关系；字段没有公式、单位自动换算或根据其他题自动计算的配置。
### 常见错误
- 收集金额却沿用整数步长，导致小数答案提交失败。
- 只放宽一端并留空另一端，或忽略步长基点与题目单位。
拖动选择参阅[滑杆题](#type-slider)，固定总额分配参阅[比重分配](#type-constant_sum)。
---
# 日期题：收集标准日历日期
设置最早与最晚日期，了解日期格式、浏览器输入和统计逻辑限制。
## 用途与创建路径
日期题用于收集购买日、参与日或其他明确的日历日期。它表达某一天，不同时表达具体时刻；设计时应说明按哪次事件填写，以及不记得日期时是否允许跳过。
1. 在问卷编辑器选择“题目 → 添加题目 → 数值与评价 → 日期题”。
2. 填写标题与补充说明，在右侧设置最早日期、最晚日期和必答状态。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 最早日期 | 设置可接受的日期下界，可不填写 |
| 最晚日期 | 设置可接受的日期上界，可不填写 |
| 答案格式 | 标准的年、月、日结构，提交形如 2030-01-15 |
| 必答 | 开启后必须填写；范围参数不是自动默认答案 |
## 示例、统计与逻辑限制
例如收集某次模拟活动的参加日期，可将范围设为二〇三〇年一月一日至一月三十一日，并提示只填写活动发生的日期。日期选择器的外观由浏览器和设备决定，电脑与手机可能呈现不同日历界面。
提交端检查标准格式与已配置边界，不自动识别“上周一”等自然语言，也不将日期换算成年龄、距今天数或事件间隔。上线前应试填两端日期及超界日期，并确认下界没有晚于上界。
概览以文本形式展示日期答案，当前统计工作台不把本题展开为日期分析变量。显示条件可使用已作答或明确日期文字的匹配；编辑器不提供日期早晚的专用比较运算，也没有相对今天自动滚动范围的开关。
### 常见错误
- 只在题目里写研究周期，却忘记设置日期边界。
- 需要日期与时刻的组合记录，却以为一个日期字段已保存时间和时区。
时刻参阅[时间题](#type-time)，已知时长参阅[数字题](#type-number)。
---
# 时间题：收集小时与分钟
配置时间上下界，明确分钟精度、跨午夜口径及日期和时区限制。
## 用途与创建路径
时间题用于收集到店、开始服务或结束活动的时刻，答案精度为小时与分钟。应说明按哪个地点的当地时间填写，并明确关联的事件，避免将“用了多久”与“几点发生”混为一谈。
1. 在编辑器进入“题目 → 添加题目 → 数值与评价 → 时间题”。
2. 设置标题、说明、最早时间、最晚时间和是否必答，再在常用设备中试填。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 最早时间 | 可设置允许的最早时分，也可留空 |
| 最晚时间 | 可设置允许的最晚时分，也可留空 |
| 答案格式 | 使用 HH:mm，例如 09:30，不包含秒 |
| 时间口径 | 通过标题或说明解释，当前没有时区选择与自动换算参数 |
## 示例、统计与逻辑限制
例如“您通常几点开始当天学习”，可限制为早上六点至晚上二十二点，并在说明中写明按当地时间填写。填写控件可能采用不同的十二小时或二十四小时外观，保存口径仍是标准时分字符串。
最早与最晚时间按同一天的先后范围判断，不能用“二十二点至次日两点”的上下限直接表达跨午夜区间。此类场景应重新设计问题或分开说明日期与时刻，不要把范围颠倒后期待系统自动跨日。
概览展示时间文本，当前统计工作台不自动计算平均到店时刻、时间差或时段分布。后题可判断是否已答或匹配指定文字，编辑器不提供时刻大小的专用条件控件。
### 常见错误
- 把“九点半”“两个小时”或带秒的内容当作标准时分答案。
- 需要计算持续时长却收集单个时刻，或未交代跨日与时区口径。
具体日期参阅[日期题](#type-date)，持续时间可用[数字题](#type-number)收集。
---
# 省市区：按地区层级联动选择
设置省市或省市区县层级，了解联动选择、地区校验与统计范围。
## 用途与创建路径
省市区题适合收集居住地、门店所在地或服务覆盖地区。它使用系统地区列表逐级选择，能减少自由输入的同名和别名问题；题目应明确收集的是常住地、工作地还是其他所在地。
1. 在问卷编辑器进入“题目 → 添加题目 → 文本与信息 → 省市区”。
2. 填写标题与口径说明，在右侧选择地区层级，并根据需要开启必答。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 地区层级 | 省／市两级，或省／市／区县三级，默认三级 |
| 联动关系 | 先选省，再选市，三级模式继续选择区县 |
| 必答 | 要求完成所选层级，不能只选上级后结束 |
| 地址范围 | 当前不提供街道、门牌、地图点位或自定义地区层级 |
## 示例、统计与逻辑限制
例如“您目前常住地属于哪个省市”，选择两级即可；若研究需要区县对照，则使用三级。更换省份后需要重新选择城市，更换城市后需要重新选择区县，避免沿用原上级地区的下级答案。
提交时会核对地区名称及其上下级关系。题目本身是受访者主动选择，不自动读取定位，不代表已验证实际居住地；其他地区一致性质控设置属于独立配置，不能仅凭添加本题就认为已生效。
答案按省、市、区县组成记录，概览主要展示回答内容，当前统计工作台不自动展开地区变量。流程或配额条件使用地区文字时，应试答核对名称与层级，不能把对象答案当作单一数值比较。
### 常见错误
- 题目要求区县，却把层级设成省市，导致所需信息没有收集。
- 更换上级地区后只检查省份，遗漏下级选择，或把行政区选择当作详细地址。
普通分类列表参阅[下拉选择](#type-dropdown)，自定义区域分层可参考[单选题](#type-single)。
---
# 评分题：使用固定整数分值评价
设置五分、七分或十分上限，区分评价分数、量表文字与考试计分。
## 用途与创建路径
评分题适合让受访者评价服务满意度、易用程度或总体体验。实际填写端以数字选项展示，答案是一个整数；应在左右说明中清楚表达低分与高分的含义。
1. 在编辑器进入“题目 → 添加题目 → 数值与评价 → 评分题”。
2. 填写标题、补充说明，选择评分上限，再设置左右说明与必答状态。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 评分上限 | 支持五、七或十分，默认五分 |
| 最低分 | 固定一分，不提供零分下限或半分配置 |
| 左右说明 | 可分别修改，每侧最多四十字符 |
| 必答 | 控制是否允许整题空答，受访者须明确点击分数 |
## 示例、统计与逻辑限制
例如“您对本次服务的总体满意程度是多少”，选五分上限，左侧写“非常不满意”，右侧写“非常满意”。同一研究中应保持评价方向一致，避免有的题高分代表好、有的题高分代表差却没有说明。
概览提供平均值、中位数、最低与最高值；统计工作台可将答案作为数值变量。后题显示条件支持分数大小比较，例如只向低分者展示原因题。样本范围和缺失情况会影响指标，比较项目时应使用相同口径。
这里的“评分”是受访者表达评价，并不自动代表考试得分；本题没有标准答案自动判分设置。当前也没有星星样式切换、分数权重或自定义分值映射参数。
### 常见错误
- 需要零至十分推荐意愿，却使用最低一分的评分题。
- 修改评分上限后仍将新旧分数直接比较，或只看均值而忽略有效回答人数。
文字态度等级参阅[量表题](#type-scale)，标准推荐意愿参阅[NPS](#type-nps)。
---
# NPS 推荐值：收集零至十分推荐意愿
配置推荐意愿端点，理解推荐者、贬损者与净推荐值的计算口径。
## 用途与创建路径
NPS 推荐值题用于衡量受访者推荐产品或服务的意愿，采用零至十分的整数选择。建议清楚写明推荐对象与使用背景，并保持不同批次的提问和样本口径一致。
1. 在问卷编辑器进入“题目 → 添加题目 → 数值与评价 → NPS 推荐值”。
2. 设置标题、补充说明、零分说明、十分说明与必答状态，再检查预览。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 分值范围 | 固定零至十分，不提供自定义上限与小数分值 |
| 零分说明 | 默认“完全不可能”，可修改端点文字 |
| 十分说明 | 默认“极有可能”，可修改端点文字 |
| 必答 | 开启后需明确提交一个分数，零分也是有效答案 |
## 示例、统计与逻辑限制
例如“您有多大可能向朋友推荐这项服务”，保留标准端点，并在后面设置开放原因题。若希望只追问低分人群，可在原因题使用前题分数条件；不应把低分自动当作废卷。
概览提供均值、中位数、范围与净推荐值。九至十分为推荐者，零至六分为贬损者，七至八分为中立者；净推荐值是推荐者占比减去贬损者占比，中立者仍计入分母，理论范围为负一百至正一百。
界面百分比经过取整展示，手工用原始样本复算时应注意取整差异。统计工作台提供原始分值变量，数值均值不等于净推荐值。本题没有标准答案判分或自动推送回访的配置。
### 常见错误
- 把十分制满意度直接命名为 NPS，却没有询问推荐意愿。
- 从分母中删掉中立者，或用平均分代替净推荐值解释结果。
一般体验评价参阅[评分题](#type-rating)，追问原因参阅[多行填空](#type-textarea)。
---
# 滑杆题：在指定区间拖动选择数值
配置滑杆上下限、步长与端点，核对未操作状态和数值校验。
## 用途与创建路径
滑杆题适合收集程度、概率或可接受数值，填写者在区间内拖动选择。它能表现相对位置，但数值精度仍受步长控制；若要求快速准确录入金额，可考虑直接使用数字题。
1. 在编辑器进入“题目 → 添加题目 → 数值与评价 → 滑杆题”。
2. 配置最小值、最大值、步长和左右说明，再设置必答并在手机上试填。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 最小值、最大值 | 默认零至一百，最小值必须严格小于最大值 |
| 步长 | 正数，默认一，按最小值为基点划分可用值 |
| 左右说明 | 自定义区间端点含义，每侧最多四十字符 |
| 初始显示 | 未作答时滑块位于中间附近，提示“拖动选择” |
## 示例、统计与逻辑限制
例如“您认为这项方案成功的可能性有多大”，设零至一百、步长五，端点为“完全不可能”和“非常可能”。应在说明中交代这是百分比，避免受访者把数值理解成十分制评价。
初始滑块位置不是已保存的默认答案；受访者需要实际操作才能形成回答，尤其要测试必答题中直接点击下一步的情况。提交会核对数值范围和步长，不能用任意小数绕过可选刻度。
概览显示均值、中位数与范围，统计工作台可使用数值变量，后题也可按大小条件显示。当前没有双滑块区间、对数刻度、动态端点或根据前题自动设定范围的配置。
### 常见错误
- 把未操作的中间位置当作受访者认可的分值，造成空答误判。
- 区间过大且步长过小，在手机上难以精确选择，或端点含义与标题不一致。
精确输入参阅[数字题](#type-number)，固定整数等级参阅[评分题](#type-rating)。
---
# 量表题：用有序文字等级表达态度
维护文字量表顺序，了解频数、顺序编码和标准答案计分的区别。
## 用途与创建路径
量表题适合收集满意程度、同意程度或重要程度，填写者从一组有序文字中选择一个等级。设计重点是每档含义明确、方向一致，中间选项是否表示中立应在研究设计中确定。
1. 在编辑器进入“题目 → 添加题目 → 数值与评价 → 量表题”。
2. 在右侧输入标题、说明和逐行等级文字，并检查必答状态。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 等级文字 | 至少两项，名称不能重复，每项最多一百字符 |
| 等级顺序 | 按录入顺序展示，界面标示从一开始的序号 |
| 必答 | 开启后必须选择一个等级 |
| 自动计分 | 可设置标准等级、分值与解析，依赖问卷测验计分开关 |
## 示例、统计与逻辑限制
例如“这项流程容易理解”，使用“非常不同意、不同意、一般、同意、非常同意”五档。不要把“不了解”随意夹在高低等级之间，否则后续按选项顺序编码时会混入不同含义。
概览按文字等级统计人数与比例，保存的答案是选项文字，不是另设权重。统计工作台按选项顺序将其展开为有序变量；当前编辑器没有逐选项自定义数值权重，也不会因文字写“十分”就按十分计算。
后题可按选中等级或是否已答设置显示条件；当前动态选项引用来源不包含本题。自动计分表示是否命中指定标准等级，与调查中的态度高低编码是两套用途，不能相互替代。
### 常见错误
- 同一量表前后颠倒方向却直接合并分析，或把“不适用”当作普通中间分值。
- 为态度题配置正确答案，并把不符合预期的真实态度解释成错误回答。
直接数字评价参阅[评分题](#type-rating)，多项目共用等级参阅[矩阵单选](#type-matrix)。
---
# 矩阵单选：多行共用一套答案选项
配置矩阵行列、必答与前题引用，理解行统计分母和按行展开的变量。
## 用途与创建路径
矩阵单选让多个评价对象共用一套列选项，每行只能选择一项，适合品牌属性或服务环节评价。应确保所有行都能使用同一回答口径，避免把不同单位的问题拼进同一个矩阵。
1. 在编辑器进入“题目 → 添加题目 → 矩阵题 → 矩阵单选”。
2. 分别逐行输入矩阵行和列选项，填写说明，再设置是否必答并预览。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 矩阵行 | 至少一个评价对象，行名不能重复，每行最多一百字符 |
| 列选项 | 至少两项，列名不能重复，每项最多一百字符 |
| 必答 | 开启后每一行都必须完成单选 |
| 动态引用 | 行或列可引用前面单选、多选、下拉或排序题的已选、未选固定选项 |
## 示例、统计与逻辑限制
例如用“咨询、办理、售后”作为行，用五档满意度作为列。整题为选答时可以只完成部分行；若研究要求每个环节都有评价，应开启必答并提供研究上合理的答案口径。
概览按行展示各列选择次数，比例分母是本题有答案的答卷数，选答时部分行未填会使行比例合计不足百分之百。统计工作台可按行展开有序变量，列顺序决定默认编码，因此不宜随意混入非等级类别后当连续分数解释。
动态引用为空时题目自动跳过，引用不会包含其他填空文字。显示条件作用于整题，当前属性面板没有逐行独立必答或指定某行答案的专用条件编辑器。
### 常见错误
- 行列过多导致手机阅读困难，未试填就按电脑画布判断效果。
- 把本题回答人数当作每一行的实际回答人数，忽略选答缺失。
每行多选参阅[矩阵多选](#type-matrix_multiple)，单个态度问题参阅[量表题](#type-scale)。
---
# 矩阵多选：每个对象分别选择多项
设置矩阵每行的选择上下限，正确理解必答、行缺失与多选比例。
## 用途与创建路径
矩阵多选适合让多个对象分别勾选多个属性，例如各产品的使用场景或各渠道接触的内容。每行保存一个选择集合，数量限制按每行执行，不是全表合计。
1. 在问卷编辑器进入“题目 → 添加题目 → 矩阵题 → 矩阵多选”。
2. 设置矩阵行、列选项、最少选择、最多选择和必答，再检查手机端效果。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 行与列 | 至少一行、两列；行内名称与列内名称分别不能重复 |
| 最少选择 | 每行零至列数，不能大于最多选择 |
| 最多选择 | 每行一至列数，所有行共用同一上限 |
| 必答与引用 | 必答要求每行至少选一项；行列可引用前题固定选项 |
## 示例、统计与逻辑限制
例如行设“产品甲、产品乙”，列设“学习、办公、娱乐”，每行最多两项。即使最少选择设为零，开启必答后也不能让某行完全空着；若每个对象都不适用，应在设计阶段补充合理选项或改用分题询问。
整题选答且没有任何答案时可跳过；已经填写的行仍需满足数量与选项校验。概览按行统计每个列选项被选次数，以本题回答人数作分母，各列比例可以合计超过百分之百，也可能受未填行影响。
统计工作台按行与列组合展开零一变量。动态引用来源限定于前面的单选、多选、下拉和排序，引用为空自动跳过；当前没有逐行分别配置数量、其他填空或独立跳题的面板。
### 常见错误
- 把最多选择当成整张表的总选择数，导致题意与系统校验不一致。
- 使用“以上都没有”等列名就期待它在每行自动与其他列互斥。
每行唯一答案参阅[矩阵单选](#type-matrix)，单一对象多选参阅[多选题](#type-multiple)。
---
# 多项填空：一题收集多个固定文本字段
配置固定填写项、统一提示与长度，明确每项校验和文本统计的限制。
## 用途与创建路径
多项填空用于在一道题中收集多个固定标签下的简短文本，例如产品名称、型号和用途。填写项数量由设计者决定，受访者不能自行增加字段，适合结构稳定的资料记录。
1. 在编辑器进入“题目 → 添加题目 → 文本与信息 → 多项填空”。
2. 逐行输入填写项名称，设置统一输入提示、每项最多字数与必答。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 填写项 | 至少一个，名称不能重复，每个名称最多一百字符 |
| 输入提示 | 所有填写项共用同一提示文本 |
| 每项最多字数 | 一至一千字符，默认三百，分别限制每个字段 |
| 必答 | 开启后每个填写项都必须有内容，无逐项独立必答开关 |
## 示例、统计与逻辑限制
例如题目为“请补充您使用的设备信息”，填写项为“设备类别、设备型号、主要用途”，每项最多八十字符。答案按标签保存文本；即使填入数字，也不会自动变成可计算的数值字段。
当前没有逐项设置手机号、邮箱、网址格式或不同字数上限的参数。需要对某一项做专用校验时，应拆成独立题目，而不是只在标签中写“手机号”就认为会触发号码规则。
概览以组合文本展示有限条回答，完整内容在答卷明细或原始导出中核对；统计工作台不自动把各填写项展开为变量。显示条件作用于整题，当前没有针对某个字段的专用条件选择器，不能把聚合文字匹配解释成精确字段判断。
### 常见错误
- 给字段取相同名称，或开启整题必答后仍期待部分填写项可以留空。
- 让受访者填写数量不定的多条记录，却把字段数量固定在本题中。
独立短文本参阅[单行填空](#type-text)，数量可变的记录参阅[自增题](#type-repeat)。
---
# 矩阵填空：当前按行收集文本
明确矩阵填空的实际行式输入结构，不将其描述为可配置二维数据表。
## 用途与创建路径
矩阵填空可把多个行标签集中放在一道题中，每行对应一个文本框，适合分项说明或简短记录。当前实际结构与多项填空相近，题型名称不代表可以建立任意行列交叉的二维单元格。
1. 在编辑器进入“题目 → 添加题目 → 矩阵题 → 矩阵填空”。
2. 设置矩阵行、输入提示、每项最多字数和必答，预览确认每行一个输入框。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 矩阵行 | 至少一项，名称不能重复，每行名称最多一百字符 |
| 输入提示 | 各行共用一个提示文本 |
| 每项最多字数 | 一至一千字符，默认三百，按行独立检查长度 |
| 必答 | 开启后所有行均须填写，选答允许只完成部分行 |
## 示例、统计与逻辑限制
例如“请分别说明三个服务环节的改进建议”，行设“咨询、办理、反馈”，每行最多一百五十字符。若想记录“数量、单价、金额”三列的多门店表格，当前题型无法直接配置这种二维结构，应重新拆题设计。
各行保存普通文本，不能为单元格设置数字步长、独立格式、公式或合计，也不会把输入数字自动转换为数值统计。题目属性没有列字段、增删答题行或表格文件上传配置。
概览显示组合文本回答示例，当前统计工作台不将各行展开为变量。可以按前题设置整题显示条件，但没有逐格跳转或按指定行单独配置校验的面板；需要精确流程判断时宜拆成独立问题。
### 常见错误
- 根据“矩阵”名称推断有可编辑列，或把示意画布当作完整表格功能。
- 需要数值统计却用文本行收集数量，后期无法直接使用数值分析变量。
类似文本结构参阅[多项填空](#type-multi_text)，数值字段参阅[数字题](#type-number)。
---
# 比重分配：把固定总额分配给多个项目
配置目标合计与小数，理解逐项填写、总额校验和数值变量。
## 用途与创建路径
比重分配让受访者把一个固定总数分给多个项目，适合预算安排或相对重要性比较。应明确总数的单位和含义，总数为一百时也不自动表示真实市场份额或模型计算权重。
1. 在编辑器进入“题目 → 添加题目 → 数值与评价 → 比重分配”。
2. 逐行填写分配项目，设置目标合计、允许小数与必答，再测试全部项目。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 分配项目 | 至少两项，名称不能重复，每项最多一百字符 |
| 目标合计 | 默认一百，必须为正且不超过一百万 |
| 允许小数 | 关闭时仅接受非负整数；开启后接受非负数值 |
| 合计校验 | 已填写的分配必须等于目标总额，界面显示当前合计 |
## 示例、统计与逻辑限制
例如“请把一百分分配给改进方向”，项目为“速度、质量、便利”，可填写四十、三十五、二十五。不分配的项目也应明确填零；初始显示的零不保证已经形成完整答案，提交会逐项核对数值。
整题选答时可以完全跳过，但一旦作答就不能只分配一部分总额。系统不自动把比例归一化，不提供锁定项目、逐项上限或余额自动分摊设置，小数总和也须满足合计要求。
概览主要展示分配记录文本，统计工作台可以把每个固定项目展开为数值变量。项目之间受总额约束，分析时不能将其误当作完全独立评分。显示条件没有指定项目分配值的专用比较控件，宜用独立问题承载关键分支。
### 常见错误
- 直接输入百分号或单位文字，或把未触碰项目的画面零值当作已保存。
- 期待自动修正合计，或把未通过总额校验的分配作为有效答案。
独立数值参阅[数字题](#type-number)，只比较先后可用[排序题](#type-ranking)。
---
# MaxDiff 最优最劣：在展示项目中做一次取舍
配置项目池、展示数量与随机开关，明确单组选择和频数分析的范围。
## 用途与创建路径
MaxDiff 最优最劣题让受访者在当前展示的一组项目中各选一个最吸引与最不吸引项目，适合初步比较卖点、权益或概念。两个答案必须不同，不能只完成其中一侧。
1. 在编辑器进入“题目 → 添加题目 → 专业研究 → MaxDiff 最优最劣”。
2. 逐行填写待比较项目，设置每组展示项目数、随机抽取项目与必答。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 项目池 | 至少三个不同项目，每个名称最多一百字符 |
| 每组展示项目 | 三至八项，实际不能超过项目池数量 |
| 随机抽取项目 | 默认开启，填写页打乱项目后截取展示数量 |
| 关闭随机 | 按原项目顺序取前若干项，不会轮换覆盖其余项目 |
## 示例、统计与逻辑限制
例如准备六个权益项目，每组展示四个，请受访者各选最吸引与最不吸引的一项。题目的一次作答只保存这一组的最佳项与最差项，不会自动生成多轮平衡比较任务。
概览分别统计最吸引和最不吸引的选择次数，比例分母是本题回答人数，未按每个项目的实际展示次数校正。随机展示数量小于项目池时，直接比较原始频数须谨慎，不能把差异当作精确偏好效用。
当前没有均衡实验设计、个体效用估计、层级贝叶斯或高级 MaxDiff 模型，统计工作台也未展开本题变量。没有指定最佳项或最差项的专用逻辑控件；通用文字匹配不能区分两个轴的研究含义。
### 常见错误
- 关闭随机后以为所有项目会轮流出现，或把单组题当作完整多轮研究设计。
- 用未校正的选择次数宣称模型权重、市场份额或显著优先级。
完整顺序参阅[排序题](#type-ranking)，服务端抽选候选题参阅[随机抽题](#type-random_draw)。
---
# KANO 需求分析：成对询问功能有无时的感受
配置功能及正反提问，了解固定回答选项、分类结果和缺失评价边界。
## 用途与创建路径
KANO 需求分析通过同一功能具备与不具备时的两种感受，按配对结果归类需求属性。适合比较产品功能，不宜把功能名称写成模糊概念或把反向问题写成另一项无关功能。
1. 在编辑器进入“题目 → 添加题目 → 专业研究 → KANO 需求分析”。
2. 逐行输入待评价功能，修改正向与反向提问，再设置必答并试填两侧。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 待评价功能 | 至少一个，名称不能重复，每项最多一百字符 |
| 正向提问 | 默认询问具备该功能时的感受，最多一百字符 |
| 反向提问 | 默认询问不具备该功能时的感受，最多一百字符 |
| 回答选项 | 固定为喜欢、理所当然、无所谓、可以接受、不喜欢 |
| 必答 | 开启后所有功能的正反两侧都必须完成 |
## 示例、统计与逻辑限制
例如功能为“离线查看内容”，分别问具备与不具备时的感受；项目名称应描述同一项清晰能力，避免把价格优惠和功能体验同时塞进一行。
概览按固定配对表将各功能分成魅力、期望、必备、无差异、反向和存疑，并统计分类次数。选答漏行在当前概览中可能被计入存疑，应核对明细，不能把缺失解释为真实需求态度；需要完整比较时建议必答。
当前没有自定义分类表、满意与不满意系数或高级需求模型，统计工作台未展开本题变量。通用条件把答案文字聚合匹配，不能精确表达“某功能正向答案”等专用分支，关键筛选应另设明确问题。
### 常见错误
- 正反问法并非同一功能有无，导致配对分类失去意义。
- 把反向或存疑结果直接删除，未核对题意、缺失和实际答案。
品牌印象参阅[语义差异量表](#type-semantic)，共同等级评价参阅[矩阵单选](#type-matrix)。
---
# 语义差异量表：按多个维度选择端点位置
设置评价维度、五七九点量表及共用端点，核对均值和范围元数据。
## 用途与创建路径
语义差异量表让受访者对多个维度选择整数位置，适合品牌印象或概念感知。当前每行共用同一对左右说明，设计时应让这些说明适用于全部维度，不能假定每行可独立设置反义词。
1. 在编辑器进入“题目 → 添加题目 → 专业研究 → 语义差异量表”。
2. 逐行填写评价维度，选择点数、左右说明与必答，预览整组方向。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 评价维度 | 至少一个，名称不能重复，每项最多一百字符 |
| 量表点数 | 五、七或九点，默认七点，分数从一开始 |
| 左右说明 | 每侧最多四十字符，各维度共用 |
| 必答 | 开启后每个维度必须选择一个有效整数位置 |
## 示例、统计与逻辑限制
例如行设“可信、易懂、有吸引力”，使用七点，端点为“完全不符合”和“非常符合”。若研究需要“传统—创新”“复杂—简单”等逐行不同端点，应拆成独立问题，而非写一次端点就期待各行自动变化。
概览提供各维度平均值，选答时各行有效人数可能不同；统计工作台可按行展开变量。当前工作台的范围元数据未完整随五点、九点配置同步，不能直接假定其反向计分边界正确，使用前应核对。
显示条件作用于整题，没有逐行分数的专用比较控件；当前没有单题自动判分、自动反向题配置或品牌定位图。比较不同批次时应保持点数和端点方向一致。
### 常见错误
- 把左右说明当成逐行独立配置，或混用点数后直接合并均值。
- 部分维度反向表述却没有明确转换口径，导致高低分含义相反。
单个态度条目参阅[量表题](#type-scale)，共同文字等级参阅[矩阵单选](#type-matrix)。
---
# 知情同意：要求主动勾选确认
配置研究说明与同意文案，明确必答勾选、拒绝路径和电子签名边界。
## 用途与创建路径
知情同意题用于在研究开始或敏感信息收集前呈现用途说明，并让受访者主动勾选确认。应清楚写明参与目的、收集范围和退出口径，文案需由项目负责人根据实际研究审核。
1. 在编辑器进入“题目 → 添加题目 → 内容组件 → 知情同意”。
2. 在标题和补充说明中填写研究信息，修改勾选项文案，并核对默认开启的必答。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 标题 | 最多三百字符，用于标识确认事项 |
| 补充说明 | 最多五百字符，解释用途与参与条件 |
| 勾选项文案 | 最多二百字符，默认“我已阅读并同意以上内容” |
| 必答 | 默认开启，开启时未确认无法通过本题 |
## 示例、统计与逻辑限制
例如标题为“参与研究确认”，说明本次仅收集体验评价、参与方式与联系用途，再用“我已了解上述说明并自愿参与”作为勾选文案。长背景可使用相邻说明组件拆分，但应确保确认所指内容清楚。
当前答案只记录勾选同意状态，没有单独的“不同意”答案选项。若需要记录拒绝并终止，请使用单选题询问同意或不同意，再设置流程规则；只放一个必答勾选框不会生成拒绝答卷或自动分流。
概览可查看回答记录，统计工作台不展开本题变量。本题不提供手写签名、可信时间戳、真实身份验证或法律效力认证，不能把勾选记录解释为已完成这些程序。
### 常见错误
- 未写清参与内容就使用默认同意文字，或以为修改文案会自动修改研究规则。
- 期待取消勾选等于提交“不同意”，却没有设计明确的拒绝路径。
背景材料参阅[说明文字](#type-description)，记录明确选择参阅[单选题](#type-single)。
---
# 说明文字：插入无需作答的研究说明
添加背景、章节引导与填写口径，了解普通文本展示及非作答组件限制。
## 用途与创建路径
说明文字用于放置章节背景、统一概念或填写提醒，不要求受访者回答。应将影响答案理解的定义放在相关题目前，用简洁文字说明，避免让受访者在长段材料中寻找关键条件。
1. 在问卷编辑器进入“题目 → 添加题目 → 内容组件 → 说明文字”。
2. 选中组件，在右侧填写标题与说明内容，再调整到关联题目前方并预览。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 标题 | 最多三百字符，作为说明区块的标题 |
| 说明内容 | 最多五百字符，按普通文本展示 |
| 位置 | 可在问卷中上移、下移、复制与删除 |
| 作答属性 | 没有必答开关、选项、标准答案或作答输入框 |
## 示例、统计与逻辑限制
例如在体验评价前写“以下问题均指您最近一次使用经历，请以该次体验为准”。如果需要章节换页，先明确分页模式，再将说明与对应题目一起组织；添加说明组件本身不会强制换页。
在一页一题模式中，题目前的说明通常随下一道作答题一起显示，末尾说明会并入已有末页；按分页符模式则随其所在页面展示。因此应同时检查前后页，而不能把画布中的独立区块当作填写端独立页面。
当前内容以转义后的普通文本呈现，不提供富文本编辑、任意 HTML 执行、文件上传或附件阅读验证。说明不会生成答案，也不计入题目回答统计，不能作为前题作答条件来源；属性面板不提供本组件的显示条件设置。
### 常见错误
- 用说明文字代替知情同意，认为看见材料就记录了授权。
- 在正文中写排版代码期待渲染，或用说明位置推断已经形成章节分页。
结构换页参阅[分页](#type-page_break)，主动确认参阅[知情同意](#type-consent)。
---
# 分页：在分页模式下划分页面
说明分页符与一页一题模式的关系，避免将结构分段当作跳转或作答题。
## 用途与创建路径
分页是问卷结构组件，用于把题目分成多个填写页面。适合分章节或让若干相关问题同页展示，但是否按分页符切页取决于问卷的答题展示方式，不能只添加组件后就假定页面已改变。
1. 在编辑器进入“题目 → 添加题目 → 内容组件 → 分页”，移动到需要分段的位置。
2. 打开“设置 → 显示设置”，将“答题展示方式”改为“按分页符展示（一页多题）”。
3. 使用测试预览逐页核对内容、下一页和返回按钮。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 标题与说明 | 可用于编辑时识别，本组件不渲染为独立的答题标题或说明块 |
| 按分页符模式 | 将分页符前积累的题目组成一页，再继续下一段 |
| 一页一题模式 | 系统自动按作答题分页面，手工分页符不额外切页 |
| 空段处理 | 开头或连续分页符不会凭空建立有内容的空白页 |
## 示例、统计与逻辑限制
例如把“使用情况”与“体验评价”分成两段，在两组问题之间放一个分页符，并开启按分页符展示。若希望页面出现章节名称，可额外加入说明文字，不能依赖分页标题自动显示章节。
分页不产生答案，不设置必答，也不会计入回答统计。它不是随机分组、条件显示或跳题指令；需要按答案改变路径时，应配置流程规则并验证目标题顺序。
分页符不能放在分组、自增或随机抽题的子题中；这些容器作为完整题目参与顶层页面组织。题目隐藏后实际可见内容可能改变，应测试关键人群的完整填写路径。
### 常见错误
- 保持一页一题模式，却用多个分页符期待出现手工章节布局。
- 把分页符标题当作已展示的章节说明，或把切页当作跳过题目的逻辑。
章节文案参阅[说明文字](#type-description)，同题组合展示参阅[分组题](#type-group)。
---
# 分组题：把固定子题组织成一个整体
管理固定子题、组标题与计分，明确容器必答、嵌套及统计展开范围。
## 用途与创建路径
分组题把一组固定子题组合展示，适合围绕同一产品或场景连续提问。在一页一题模式下，题组仍作为一道完整题展示，子题不会自动逐题分成独立页面。
1. 在编辑器进入“题目 → 添加题目 → 组合与测验 → 分组题”。
2. 在右侧使用“添加子题”或“从团队题库选题”，逐个点击“编辑”设置内容并保存。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 子题数量 | 一至五十道，可编辑、上移与移除 |
| 子题类型 | 基础或研究题型，不允许组合题、说明文字与分页 |
| 组标题与序号 | 组标题中的 {n} 替换为组号，可开关子题序号 |
| 必答与计分 | 子题分别设置必答；支持计分的子题可设置标准答案、分值与解析 |
## 示例、统计与逻辑限制
例如题组“方案甲评价”包含一题评分、一题选择和一题简短原因。容器必答与子题必答应分别核对，不能只勾选题组必答就假定所有子题都不可留空；无计分能力的题型也不会因进入题组而获得判分能力。
结果概览按子题展示相应统计，原始导出可以按题组与子题展开列。当前统计工作台不递归展开组合题，不能把概览中能看到子题理解为高级分析变量已经可选。
整体可按前题条件显示，子题编辑窗口没有独立的显示条件编辑面板。子题答案保存在容器内，不能假定它像顶层题一样直接供全卷规则选择。团队题库插入的是快照，后续题库修改不会同步覆盖题组。
### 常见错误
- 尝试在题组内再嵌套题组或放入分页符，导致校验不通过。
- 用固定题组收集数量不定的记录，或漏设关键子题的必答。
可增减记录参阅[自增题](#type-repeat)，抽选子题参阅[随机抽题](#type-random_draw)。
---
# 自增题：由受访者按需增加记录组
设置重复记录模板与组数边界，了解必答、导出、分析及计分限制。
## 用途与创建路径
自增题让受访者在同一套子题模板下添加多组记录，适合数量不固定的使用经历、设备或活动记录。每组字段结构相同，新增的是一整组，不是新增任意类型的问题。
1. 在编辑器进入“题目 → 添加题目 → 组合与测验 → 自增题”。
2. 配置子题模板，再设置最少组数、最多组数、组标题和添加按钮文字。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 子题模板 | 一至五十道，不含组合题、分页或说明文字 |
| 最少组数 | 零至五十，默认一组 |
| 最多组数 | 一至五十，不能小于最少组数，默认十组 |
| 组标题与按钮 | 支持 {n} 组号、子题序号开关和自定义添加文字 |
| 必答 | 容器必答至少要求一组，子题必答对每组分别执行 |
## 示例、统计与逻辑限制
例如收集使用经历，每组包含“产品类别、使用时长、简短评价”，最多五组。若允许没有经历的人填写零组，需将最少组数设为零且关闭容器必答；仅关闭必答而保留最少一组，仍会要求记录。
填写者可添加或移除组，但不能突破组数上下限，留下的每组仍须通过各子题校验。当前不支持组内再次嵌套容器，也不支持计分子题；自增题用于数据收集，不能作为可重复刷分的测验。
概览将各组拆开后统计子题，同一受访者可能贡献多条记录，记录数不等于人数。原始导出按实际组号与子题展开列；统计工作台当前未递归展开重复记录，题内字段也没有顶层独立逻辑选择器。
### 常见错误
- 把零组许可、容器必答和子题必答混为一个开关，造成空组无法提交。
- 将每组记录当作独立受访者计算人群比例，或在模板里加入自动计分题。
固定子题组合参阅[分组题](#type-group)，固定文本标签参阅[多项填空](#type-multi_text)。
---
# 随机抽题：从候选子题中记录本次抽取结果
设置候选池、抽取数量与顺序，区分正式抽题、草稿预览和考试判分。
## 用途与创建路径
随机抽题用于从固定候选题池抽取一部分子题，适合培训测验或减少单份问卷题量。正式作答由服务端记录本次抽中的题目，题池与每道题的配置仍由设计者维护。
1. 在编辑器进入“题目 → 添加题目 → 组合与测验 → 随机抽题”。
2. 添加候选子题或从团队题库选题，也可在团队题库选择题目后生成随机题组。
### 实际配置
| 参数 | 配置与约束 |
| --- | --- |
| 候选池 | 一至五十道，不能包含组合题、说明文字或分页 |
| 每份抽取题数 | 一至候选题总数，不会在本次抽取中重复选同一道 |
| 保持顺序 | 开启后仅将抽中题按候选原顺序排列，不改变抽取范围 |
| 标题与序号 | 可设组标题及子题序号，候选题独立设置必答与校验 |
## 示例、统计与逻辑限制
例如准备十道单选题，每份抽五道；配置标准答案后，还需开启问卷测验计分才能自动判分，满分按实际抽中的计分题计算。分值不同的候选题可能形成不同满分。
同一次有效作答记录保持抽题结果，问卷修改或记录失效可能要求重新打开；不能据此承诺同一人永久固定题组或不同人题目必然不同。团队题库加入的是快照，不随题库更新自动同步。
测试预览保留候选池，不执行正式的服务端抽取，不能用预览题数确认发布后的抽取数量。候选题不支持带条件组或动态选项引用。概览按实际回答子题统计，原始导出未抽到的子题为空；统计工作台未展开题组子题。
### 常见错误
- 删减候选题后未复查抽取数量，或以为开启保持顺序就是关闭随机。
- 未开启测验计分就期待结果页得分，或把抽题当作难度分层、均衡抽样模型。
固定组合参阅[分组题](#type-group)，项目取舍参阅[MaxDiff](#type-maxdiff)。
---
# 题目显示条件与嵌套条件组
让符合特定答案组合的受访者才看到后题。
## 显示条件与流程规则
显示条件决定“本题出现不出现”；甄别、跳题或提前完成决定后续填写流程。需要淘汰不符合人群的受访者时，使用流程规则，而不是仅隐藏全部研究题。
## 设置路径
在编辑器选中后题，展开“显示条件”，点击“设置显示条件”。选择前题、判断方式和答案。全部满足表示并且，满足任一表示或者；用条件组表达组合关系。
## 组合条件示例
目标为女性，居住北京或上海，年龄 18—35 岁。可在全部满足下放置女性条件、年龄大于等于 18、年龄小于等于 35，再加入一个任一满足组，里面放北京和上海。城市的两项不要直接与其他条件放在同一个全部满足组，否则单选答案无法同时满足两座城市。
## 规则数量与答案口径
每组最多 10 项，每题最多 30 条条件，最多两层嵌套条件组。来源题应位于本题之前。未作答不会自动满足“不等于”，需要判断空值时选“未作答”；被隐藏题目的旧答案不继续参与后续逻辑。
## 修改前题后的行为
受访者返回修改答案时，后题显示范围重新计算。依赖来源的无效旧答案会被处理，不能依赖一个已隐藏题目的旧选项保留路径。删除来源或改选项后，执行逻辑检查并完整试填。
## 排错顺序
先看题目是否被另一个跳题规则越过，再看来源是否实际回答、选项文字是否对应，最后检查全部/任一和条件组层级。预览中的“查看逻辑命中与动态选项”可以帮助检查实际命中原因。
---
# 甄别、跳题与提前结束
在换页或提交时，根据答案决定终止、跳转或完成。
## 三种流程动作
| 动作 | 结果 | 典型用途 |
| --- | --- | --- |
| 甄别终止 | 记录为甄别结束 | 非目标地区、不符合消费经历 |
| 跳转 | 前往后续指定题目 | 不同产品用户进入不同题组 |
| 提前完成 | 按流程提前结束填写 | 目标分支已完成，不再展示后续内容 |
进入编辑器“逻辑”，添加规则，设置名称、全部满足或任一满足、来源题及目标动作。每条规则最多 10 个条件，全卷最多 50 条流程规则。
## 甄别配置示例
如果“是否最近三个月购买过”为“否”，设置甄别终止。将筛选题设为必答，并在其后插入分页。这样受访者点击下一页时就能得到甄别结果，而不是填到整份问卷最后才结束。
## 触发时点
流程规则在点击下一页或提交时判断，并非每次点选选项立即弹出终止提示。需要尽早筛选时，用必答筛选题与分页组织。正式判定由服务端执行，隐藏按钮或在浏览器修改界面不能改变实际结果。
## 多规则冲突
终止类规则优先于跳转。跳转目标应位于相关条件题之后，避免回跳和不可达路径；不要用两条互相冲突的规则表达同一个分支。规则顺序、前题可见性和答题完整性都应纳入测试。
## 和配额的关系
甄别表示人群不符合，满额表示对应名额已用完，两者是不同状态。结束文案应分别配置。甄别记录和满额记录会保留用于分析，但不作为有效完成占用配额。
---
# 动态选项与矩阵行列引用
把前题已选或未选的选项带入后题，减少重复展示。
## 适合的研究场景
前题问使用过的品牌，后题仅评价选过的品牌；或前题问已购买产品，后题询问尚未购买的产品意向。动态引用维护的是候选选项集合，题干中展示答案请使用标题答案引用。
## 配置步骤
1. 先建立来源单选、多选、下拉或排序题。
2. 选中后面的单选、多选、下拉或排序题，展开“动态选项与矩阵引用”。
3. 在“本题选项来源”选择来源题，指定已选择或未选择。
4. 若为矩阵单选、矩阵多选，可以分别为行、列指定来源。
5. 在预览中选不同前题组合，并返回修改，核对候选和已填答案。
## 候选为空怎么办
来源未答、被隐藏或没有可引用选项时，后题自动跳过，即使它原本必答。最少/最多选择或排序数以当次真实候选数量为上限。不再有效的选项、排序内容和矩阵行答案会清除，避免保留不属于当前路径的旧答案。
## 选项维护规则
引用通常保留来源选项顺序，本题的随机设置再作用于当前候选。“其他”自由填空不成为动态选项。启用引用后到来源题维护内容，取消引用后才能回到后题手工维护选项或矩阵行。
## 依赖与限制
来源必须在目标题前；删除或移动来源要先解除依赖。动态引用不用于固定标准答案计分。随机抽题候选不能依赖这类动态引用或新的嵌套显示组，避免来源未抽中；需要保留依赖时使用普通分组题。
---
# 在题目标题中引用前题答案
让后续提问带上受访者已填写的答案。
## 用途与入口
例如前题询问最常购买的品牌，后题写“您为什么选择这个品牌”。可以将答案插入后题标题，使其显示为“您为什么选择华为”。在后题属性中展开“引用前题答案”，选择来源并插入。
## 使用步骤
1. 确认来源题已建立并位于目标题前。
2. 在后题标题中把光标放在希望出现答案的位置。
3. 使用引用入口插入来源，编辑时显示类似“【Q1的答案】”的标记。
4. 补全标题上下文，避免只留一个无法理解的答案标记。
5. 在测试预览填写来源题，检查单值、多选等答案的实际展示。
## 引用不到答案的原因
来源未回答、被逻辑隐藏或还没到达时，不应显示其旧答案；页面可能显示未填写提示。先检查前题显示条件、分页及是否必答。不要手工拼接内部标记或把标记当成可执行代码。
## 标题引用与选项引用不同
标题引用只改变显示的文字，不改变后题候选列表。若希望后题只评价选过的品牌，应同时设置动态选项。引用本身也不自动建立甄别或配额规则。
## 改卷维护
来源题移动、删除或题型变更会影响引用。系统会检查前后依赖，发布前运行逻辑检查。选择项文字改变后要复查题干是否仍通顺，尤其是多语言和矩阵场景。引用敏感信息时避免将手机号等不必要地反复展示。
---
# 逻辑检查与测试预览
在发放前检查路径、引用和手机体验，预览不会生成正式样本。
## 两个工具各解决什么
逻辑检查检查配置关系，例如已删除的来源、选项或不合理的顺序。测试预览用于实际走路径，验证文案、必答、分页、动态选项与结束结果。通过配置检查不能替代实际填写。
## 推荐测试清单
1. 正常目标人群从开头填写到完成。
2. 每个甄别条件分别命中一次，确认触发页与结果文案。
3. 每个跳转分支单独走一遍，不该出现的题没有出现。
4. 更改前题答案，确认后题候选和不再有效的答案被更新。
5. 必答题、空候选题、最少最多选择及格式限制分别测试。
6. 手机检查矩阵、长选项、排序、图片与组合题。
## 查看逻辑命中
在测试预览展开“查看逻辑命中与动态选项”，可观察条件是否成立、当前候选内容和流程规则。这个诊断面板只供预览，正式受访者不会看到。
## 预览与正式回收的区别
预览不保存正式答卷、不占用正式配额，也不代表正式渠道、定向凭证、重复限制和最终剩余量都已验收。配额最后由正式提交时的服务端状态决定。正式试收应使用合规的少量真实测试安排，并明确标记测试记录。
## 错误处理
先修复检查中明确的依赖错误，再针对异常路径逐步填写，避免只在最后一页查看。把复现用的前题答案、异常位置和预期结果发给管理员，有助于快速定位。修改规则后应重走所有受影响分支。
---
# DSL 逻辑：用代码设置显示、跳题与甄别
从快速上手进入完整语法参考、执行规则、可运行示例和报错排查。
## 完整文档导航
本文是快速上手。需要逐项学习语法时，请按以下顺序阅读：
- [DSL 完整语法参考：语句、运算符、优先级与限制](#dsl-syntax)
- [DSL 执行与保存规则：何时判断、规则优先级和双向同步](#dsl-execution)
- [DSL 示例库：从单条规则到完整问卷](#dsl-examples)
- [DSL 报错排查：错误原因、改法与试答检查](#dsl-errors)
以上说明对应当前上线的来数问卷 DSL v1。其他问卷平台的脚本需要按本平台语法转换，不能保证直接粘贴执行。
## 进入编辑器
打开一份问卷，进入“逻辑设置”，切换到“DSL 逻辑”。左侧为代码编辑区，右侧显示语法说明以及本卷题号、题目 ID 和可选答案。已有可视化显示条件、跳题和甄别规则会自动转换成代码。代码只描述主问卷的题间显示和流程规则，不用于创建题目、配置配额或编辑分组内部子题。
## 题目引用与条件
Q1、Q2 按当前主问卷顺序编号，说明和分页不计入题号。也可使用 Q("题目ID") 固定引用某道题；题目 ID 可在右侧查看。选项和文字用英文单引号或双引号包围，数字可直接填写。大小写不影响关键字，选项文字需要与实际选项一致。每行一条语句，也可以用分号分隔。# 和 // 后的内容是注释，不参与执行。字符串中的换行需写成反斜线 n。
支持 ==（等于或多选中包含此选项）、!=（不等于或未选此项）、>、>=、<、<=、contains（答案包含文字）、not_contains、answered（已答）和 not_answered（未答）。未作答不会自动满足 !=；需要检查空答时请使用 not_answered。
## 常见语法
以下例子的题号和选项需要根据本卷调整：
~~~text
# 选择“其他”后才显示补充题
if Q1 == "其他" then show Q3
# 未满18岁，甄别结束
if Q2 < 18 then screenout "感谢参与，本次研究到此结束。"
# 跳到后续题目
if Q1 == "否" then jump Q4
# 提前完成，仍受配额和质控规则约束
if Q4 == "结束" then complete "感谢参与。"
# 两个条件同时满足
if Q1 == "是" and Q2 >= 18 then show Q3
# 显示条件支持括号和嵌套组合；and 优先于 or
if Q1 answered and (Q2 >= 18 or Q2 not_answered) then show Q3
# 清除此题原有的显示条件
always show Q3
~~~
同一道题最多一条显示语句，多个条件请在同一语句内用 and 或 or 合并。显示条件只允许引用目标之前的题目，每组最多10项、每题最多30个条件，嵌套深度遵循可视化编辑器限制。流程规则最多50条、每条最多30个条件，只支持全 and 或全 or；混合条件需拆成独立规则。跳转目标必须在所有条件题之后。甄别和提前完成优先于跳转，同类规则按代码顺序匹配。含可选题的 not_answered 会在流程达到该题时判断，建议在测试预览中检查路径。
## 命名、停用与同步
系统生成的流程规则会包含名称和编号，便于和可视化卡片对应；可在规则前增加 disabled 停用，移除后重新启用：
~~~text
rule "未成年甄别" id "AGE-CHECK" disabled: if Q2 < 18 then screenout "感谢参与"
~~~
名称最多80字，编号最多60字，同卷不能重复。省略名称与编号时，系统自动生成。直接在可视化界面修改规则后，再打开DSL会根据最新规则同步；题目重新排序也会重新核对题号。原代码仅在仍准确对应当前规则时保留，避免旧题号影响新问卷。代码可导出为 .dsl 文本；需保留注释历史时可先导出。
## 检查、预览与保存
编辑代码不会直接改变正在回收的问卷。“检查语法”会列出行号、列号及错误原因，点击错误可定位；下方预览显示执行动作、停用状态和将被清除的显示条件。Ctrl+Enter检查，Ctrl+S保存，也可使用顶部按钮。请先修复失效题号、选项和跳转方向等错误。
“保存代码”会整体替换当前主问卷的显示条件与流程规则；未写显示语句的题目恢复始终显示，空代码会清空这些规则。题目内容、配额、品牌设置和答卷不随此操作删除。保存之后可返回可视化检查，也应通过测试预览验证每条路径。已发布问卷保存后，新进入或重新载入填写页的受访者使用更新的规则；已打开页面可能仍持有此前加载的问卷，正式回收期间请谨慎修改。
尚未应用的代码按问卷暂存在当前标签页会话中，切换页面后可恢复；关闭标签页或清理浏览器数据后不能保证保留，应及时保存或导出。存在草稿期间若可视化规则也已更改，系统会阻止直接覆盖并提示先导出草稿，再从当前规则重新生成。实际应用使用结构化规则，服务器再次校验；DSL不执行JavaScript，不支持联网请求、文件操作或任意程序代码。
---
# DSL 完整语法参考：语句、运算符、优先级与限制
逐项说明 DSL v1 的合法语法，包括题目引用、全部运算符、字符串、数字、规则命名和数量限制。
## 版本与使用范围
本参考对应当前上线的来数问卷 DSL v1。它用于已有主问卷的条件显示、前向跳题、甄别结束和提前完成。DSL 中的 Q1 等题目必须先在问卷设计里创建。语句中的题号和选项需要换成你自己问卷的实际内容。本文代码使用[示例库中的统一问卷](#dsl-examples)。
## 一条语句怎样写
条件语句的骨架是 if 条件 then 动作。关键字、比较符、括号、冒号和分号使用英文半角字符。每条语句写在一行；可以用分号在同一行分隔多条语句。长行在编辑区内横向滚动查看，不要把同一条语句手动拆为多行。
~~~dsl
if Q4 == "其他" then show Q5
if Q2 < 18 then screenout "感谢参与。"
if Q7 == "不愿意" then jump Q9
if Q7 == "不愿意" then complete "感谢参与。"
~~~
上面最后两条展示两种不同的处理方式，实际项目通常择一使用；同时保留且命中时，提前完成优先于跳转。多个例子写在同一代码块只表示语法都合法，不表示它们都适合放在同一项目里。
## 题号与固定 ID
| 写法 | 意义 | 注意 |
| --- | --- | --- |
| Q1、Q2、Q10 | 当前主问卷第1、2、10道题 | 从1开始，不能写 Q0 或 Q01 |
| q1、q2 | 与大写题号含义相同 | 关键字和 Q 大小写不敏感 |
| Q("AGE") | 固定引用 ID 为 AGE 的题目 | ID 必须与右侧“本卷题目”显示的值完全一致，大小写敏感 |
说明文字和分页符不计入题号。分组、自增、随机抽题按主问卷中的一个题目计数；DSL 当前不提供定位其内部某个子题的语法。Q1 是顺序位置，Q("AGE") 是固定题目身份，两者不要混淆。复制到另一份问卷时，需重新核对编号、ID和选项。
~~~dsl
if Q("AGE") >= 18 then show Q("CONTACT")
~~~
显示条件的来源题必须在目标之前，不能用后题决定前题是否显示。jump 的目标必须在所有条件题之后。Q("AGE") 中的 AGE 只是示例 ID；你自己的问卷通常使用系统生成的 ID。
## 全部比较运算符
| 运算符 | 写法示例 | 判断方式 |
| --- | --- | --- |
| == | Q3 == "北京" | 答案中存在完全相同的值；多选题表示选中了该项 |
| != | Q3 != "北京" | 已作答，并且答案中没有完全相同的值 |
| > | Q2 > 18 | 数值大于18，不含18 |
| >= | Q2 >= 18 | 数值大于等于18，含18 |
| < | Q2 < 65 | 数值小于65，不含65 |
| <= | Q2 <= 65 | 数值小于等于65，含65 |
| contains | Q9 contains "价格" | 任一答案值的文字包含这个片段 |
| not_contains | Q9 not_contains "价格" | 已作答，并且所有答案值均不包含这个片段 |
| answered | Q9 answered | 已有非空答案，后面不再写比较值 |
| not_answered | Q9 not_answered | 没有非空答案，后面不再写比较值 |
大小比较推荐用于数字题、评分、滑杆、NPS等数值答案；条件值必须能转成有限数字。== 和 != 按答案文字精确匹配，不做近义词、拼音或自动翻译。文字的大小写不同也视为不同，例如 Beijing 不等于 beijing。
未作答时，==、!=、contains、not_contains、>、>=、<、<= 均不命中；检查空答用 not_answered。数字0是有效答案，不等同于未答。普通单选和多选的 ==、!= 条件值必须是该题已有选项。自由填写的“其他”文字不一定等于选项标签；需收集并判断补充内容时，推荐使用独立填空题。
## 多选题的判断方式
假设 Q4 是多选题，已有选项为“品牌A”“品牌B”“其他”。
~~~dsl
# 选中其他（也可以同时选了其他品牌）
if Q4 == "其他" then show Q5
~~~
~~~dsl
# 同时选了品牌A和品牌B
if Q4 == "品牌A" and Q4 == "品牌B" then show Q6
~~~
~~~dsl
# 品牌A、品牌B中至少选一个
if Q4 == "品牌A" or Q4 == "品牌B" then show Q6
~~~
~~~dsl
# 已经作答，但是没有选择其他
if Q4 != "其他" then show Q6
~~~
这些是四种独立写法，不要把多条 show Q6 一起保存；同一道目标题只允许一条显示语句。contains 判断文字片段，不等同于“选中了某个完整选项”；判断多选选项优先使用 ==。暂不支持 in、数组字面量、索引、选中数量或集合相等写法。
## and、or 与括号
and 要求所有条件成立；or 要求至少一个成立。比较先于组合，and 优先于 or，可以通过括号改变分组。
~~~dsl
# A or (B and C)
if Q3 == "北京" or Q3 == "上海" and Q2 >= 18 then show Q6
~~~
如果意图是“北京或上海，并且满18岁”，必须写成下面的形式：
~~~dsl
if (Q3 == "北京" or Q3 == "上海") and Q2 >= 18 then show Q6
~~~
show 支持这样的混合分组。jump、screenout、complete 目前只支持全 and 或全 or；把相同组合加括号仍合法，但包含混合的嵌套组合会报错。例如“(北京或上海)并且满18岁”的甄别逻辑，需要拆成两条独立规则，分别处理北京与上海。不要把不同分组强行改写为一串 and，否则业务含义会改变。
## show：设置题目出现条件
~~~dsl
if Q4 == "其他" then show Q5
~~~
条件成立时Q5才显示，不成立时Q5隐藏；不是“额外显示一次”。本卷保存后的全部 show 共同定义显示条件，不按代码行号改变题目顺序。目标题不存在、引用后题或同一目标出现两条 show 都会报错。
## always show：取消显示条件
~~~dsl
always show Q5
~~~
把Q5恢复为始终显示，不是无条件跳到Q5。始终显示仍受上游跳题、问卷提前终止和其他收集设置影响。保存是整体替换，删去某题的 show 语句也会移除其原有显示条件。同一目标不能同时写 always show 与 if ... then show。
## jump：跳过中间题目
~~~dsl
if Q7 == "不愿意" then jump Q9
~~~
命中时从当前路径跳到后面的Q9，中间题目不参与本次有效答案。目标必须在本条全部条件题之后。jump 后只接一个题目引用，不能额外写提示文字；若需要最终提示，使用 screenout 或 complete。
## screenout：甄别并终止
~~~dsl
if Q2 < 18 or Q2 > 65 then screenout "感谢参与，您不在本次研究的目标年龄范围内。"
~~~
符合条件的作答会甄别结束，不计为有效完成。screenout 后的提示文字可省略，省略或空字符串时使用问卷统一甄别提示。提示是给受访者看的文字，不支持HTML模板或变量替换。
## complete：提前完成
~~~dsl
if Q7 == "不愿意" then complete "感谢参与，问卷已完成。"
~~~
提前结束并提交到正常完成处理流程，仍需接受配额及质控检查。它不保证最终一定计为有效样本，也不能代替甄别。省略或空提示时使用问卷统一完成提示。
## rule：名称、固定编号和停用
可选前缀的顺序为 rule "名称"、可选 id "编号"、可选 disabled、冒号，随后同一行写 if 语句。
~~~dsl
rule "年龄甄别" id "AGE-GATE": if Q2 < 18 then screenout "感谢参与。"
rule "备用年龄规则" id "AGE-BACKUP" disabled: if Q2 > 65 then screenout
~~~
rule 前缀只用于 jump、screenout、complete，不能放在 show 或 always show 前。名称和编号必须用引号包围；编号不能重复。省略名称前缀时系统生成“DSL 规则 N”；省略 id 时生成 DSL-NNN。手工指定编号时建议使用自己的业务前缀，例如 AGE-GATE，避免与自动编号碰撞。未写 disabled 即启用；不存在 enabled 关键字，启用方式是删除 disabled。
## 字符串、数字与转义
| 内容 | 合法写法 | 说明 |
| --- | --- | --- |
| 中文文字 | "北京" 或 '北京' | 两种引号均可，起止必须配对 |
| 整数、小数、负数 | 18、18.5、-1、.5 | 不加正号，不使用千分位 |
| 换行、制表符 | \n、\t | 仅在引号内作为转义使用 |
| 引号 | \"、\' | 在对应引号字符串中避免提前结束 |
| 一个反斜线 | \\ | 例如Windows路径内的反斜线 |
| Unicode字符 | \u5317 | 小写u加四位十六进制字符 |
关键字大小写不敏感，字符串值保留大小写；比较值、规则名称、规则编号和提示的首尾空白会被修剪。固定题目引用 Q("ID") 按ID原文查找，不要在引号内额外加空格。比较条件存为文字，== 18 和 == "18" 含义相同；精确等于不等同于数值约等于，判断数值大小优先用数值比较符。
~~~dsl
rule "年龄说明" id "AGE-NOTE": if Q2 < 18 then screenout "本次研究名称为\"成年人访谈\"。\n感谢理解。"
~~~
字符串不能直接跨行；指数写法1e3、十六进制、Infinity、NaN、true、false、null和undefined不作为未加引号的字面量支持。需要匹配文字“true”时，必须写成 "true"，且题目确有对应答案。
## 注释、空行与分号
~~~dsl
# 整行说明
if Q4 == "其他" then show Q5 // 行末说明
if Q2 < 18 then screenout; if Q7 == "不愿意" then jump Q9
~~~
# 或 // 在引号外开始注释，一直到该行结束；在引号内则是普通字符。空行不执行。没有 /* ... */ 块注释，也没有反斜线续行。分号仅分隔语句，不是必填字符。
## 当前上限
| 项目 | 上限 |
| --- | --- |
| 整份DSL | 50,000个编辑器字符单位 |
| 全部语句 | 300条，注释和空行不计 |
| 流程规则 | 50条，停用规则也占数量 |
| 每条流程规则的条件 | 30个 |
| 每道题的显示条件 | 30个叶子条件 |
| 显示条件的每个组 | 10项 |
| 显示条件组嵌套 | 根组之外最多2层子组 |
| 表达式括号 | 语法上最多6层，仍需满足显示条件组限制 |
| 同一目标的显示语句 | 1条，包括 always show |
| 规则名称／规则编号 | 80／60个字符 |
| 比较值／结束提示 | 100／500个字符 |
## 语法结构速查
下列为语法描述，不是可以粘贴运行的代码。方括号表示可选部分，竖线表示选择一种写法，大括号表示可重复。
~~~ebnf
语句 = 条件显示 | 始终显示 | 流程规则
条件显示 = "if" 表达式 "then" "show" 题目引用
始终显示 = "always" "show" 题目引用
流程规则 = [规则前缀] "if" 表达式 "then" 流程动作
规则前缀 = "rule" 字符串 ["id" 字符串] ["disabled"] ":"
流程动作 = "jump" 题目引用
| "screenout" [字符串]
| "complete" [字符串]
表达式 = 与表达式 {"or" 与表达式}
与表达式 = 单项 {"and" 单项}
单项 = "(" 表达式 ")" | 条件
条件 = 题目引用 比较符 值 | 题目引用 "answered" | 题目引用 "not_answered"
比较符 = "==" | "!=" | ">" | ">=" | "<" | "<=" | "contains" | "not_contains"
值 = 字符串 | 十进制数字
题目引用 = Q加正整数 | "Q(" 字符串 ")"
~~~
## 暂不支持的语法
不支持 hide、else、elseif、switch、for、while、变量赋值、数学表达式、函数调用、正则表达式、数组、点号访问、JavaScript和外部网络请求。不能用DSL新建题目、修改配额、动态修改选项或直接配置子题。遇到这些需求时，先查看对应可视化功能；不要把其他平台的语法当作本系统已实现能力。
---
# DSL 执行与保存：判断时机、优先级和双向同步
解释规则何时生效、多条规则如何竞争、隐藏答案如何处理，以及保存和可视化编辑之间的关系。
## 先区分显示条件与流程动作
show 决定题目在当前路径上是否出现；jump、screenout、complete 决定当前路径往哪里走或是否结束。显示条件不会改变题目原有排序。代码中先写某个 show，不代表这道题会提前到前面展示。
同一题的 show 条件只能引用它之前的题。多个条件合并到一条 show 中；不同目标题可以各写一条。没有 show 的题目默认始终显示，但仍可能被上游 jump 跳过，或因为先命中终止规则而不再出现。
## 什么时候检查
填写端根据已访问路径和当前答案计算哪些题可见，并在点击下一题、下一页或提交时处理流程。提交时服务端会重新校验路径，不能只靠浏览器传来的状态决定结果。
流程规则要等其条件涉及的题目进入可判断的路径阶段后才会执行。全 or 规则虽然只需一个条件成立，也不是读取到第一项就保证立刻终止；它仍受整条规则的条件题位置和当前访问阶段影响。需要尽早结束时，尽量用靠前的独立甄别规则。
按页填写时，同一页可能包含多道必答题。需要先甄别再展示后续题目时，推荐逐题填写，或在甄别题后添加分页符，并通过实际预览验证，避免同页后面的必答校验妨碍前面的甄别操作。
## 多条流程规则的优先级
| 同一判断位置的情况 | 执行方式 |
| --- | --- |
| screenout 与 jump 都命中 | 先处理 screenout |
| complete 与 jump 都命中 | 先处理 complete |
| 多条 screenout／complete 命中 | 在已能判断的终止规则中，按保存的代码顺序取第一条 |
| 多条 jump 命中 | 在已能判断的跳转规则中，按保存的代码顺序取第一条 |
| 某条规则 disabled | 保留显示，但不执行 |
优先级是在当前路径已经能够判断的规则之间比较，不会等待后面尚未出现的题目。screenout 和 complete 同属终止动作，不存在“甄别永远压过完成”；两者同时可判断且命中时，看哪条写在前面。
~~~dsl
# 两条条件相同，第一条甄别先结束，第二条不会再执行。
rule "先甄别" id "FIRST": if Q2 < 18 then screenout "不在目标范围内。"
rule "后完成" id "SECOND": if Q2 < 18 then complete "已完成。"
~~~
## 隐藏、跳过、未答不是“选择了否”
隐藏题或跳过题中的旧答案不作为当前路径的有效答案继续参与判断。回到前题修改选项后，也不能依靠之前填过的隐藏内容命中后续规则。
not_answered 检查的是当前有效答案是否为空，不代表选择了“否”、拒访或答题失败。若业务要区分“没填”和“明确拒绝”，请在题目中设计“愿意／不愿意”等明确选项，并用 == 判断。
例如题目没有显示过时，拿它做未答判断可能不符合你的业务意图；建议规则同时依赖一个已明确回答的前题，并分别预览“题目未出现”“出现但空答”“出现且填写”三条路径。
## 甄别与提前完成的结果区别
screenout 表示不符合目标条件，本次作答按甄别处理，不计有效完成。complete 表示问卷路径已经完成，但后续仍按正常流程核验配额、质控和收集设置。配额满或质控失败可能改变最终状态。
结束提示只是展示文案，不能把 screenout 改为有效完成。需要修改统计口径时，应选择正确动作，而不是把提示改成“提交成功”。
## 检查、预览与保存分别做什么
| 操作 | 结果 |
| --- | --- |
| 编辑代码 | 修改本地草稿，不立刻替换问卷规则 |
| 检查语法 | 检查题号、条件值、语句及限制，列出错误行列 |
| 下方变更预览 | 展示将保存的规则、启停状态及将清除的显示条件，不模拟具体受访者答案 |
| 测试预览 | 实际填写不同答案，验证路径；预览不产生正式答卷 |
| 保存代码 | 校验通过后，用代码结果替换主问卷的显示条件和流程规则 |
| 顶部保存 | 当前正在编辑DSL草稿时，同样保存该草稿 |
| 发布问卷 | 有未应用DSL草稿时会提示先处理，避免误发布旧逻辑 |
语法通过只说明写法和引用通过检查，不证明业务逻辑一定正确。上线前至少测试一条正常完成、一条甄别、每个分支及边界年龄。
## 保存是整体替换
DSL描述的是整份主问卷的显示和流程规则，不是只追加一条命令。若原本有5条流程规则，代码只保留1条，保存后就只有这1条。某题原本有显示条件，但代码没有它的 show，保存后它恢复始终显示。只保留注释或空代码再保存，会清空这些逻辑。
题目内容、样本配额、品牌、已有答卷等不随这次操作删除。重要修改前可创建版本快照，同时导出 .dsl 代码。不要拿生产问卷直接练习“清空代码后保存”。
## 与可视化规则怎样同步
DSL保存后可切回可视化，看到相应的流程规则卡片；单题show条件在问卷设计里该题的显示条件区查看。可视化修改后，再打开DSL会依据当前结构化规则核对或重新生成代码。
如果还保留着未应用代码，同时又更改可视化规则，系统会保留草稿并阻止直接覆盖。先导出需要保留的代码，再点击“从当前规则生成”，在最新规则基础上合并修改。代码中的注释在与当前规则仍一致时保存；重生成后不保证原有排版和注释保留。特别重要的说明应保留在项目文档或导出文件中。
## 生效范围和草稿恢复
已发布问卷保存新规则后，新进入或重新加载填写页的受访者使用更新内容。已经打开的页面可能仍持有此前的问卷，不保证强制热更新；正式执行中尽量避免调整关键甄别口径。
未应用草稿暂存于当前标签页的会话中，刷新和切换编辑页可恢复。关闭标签页、清理浏览器数据或换电脑后不保证恢复。只有保存成功的问卷规则及仍对应它的DSL源码才是服务器持久内容。
---
# DSL 示例库：从单条判断到完整调研问卷
提供统一题目表、常用条件、真实业务组合和试答路径，示例按当前解析器核验。
## 示例问卷题目表
以下代码均基于这份主问卷。先在设计页建好对应题型、选项和顺序，再使用题号；实际题目ID由系统生成，若使用固定ID写法，请换成右侧显示的真实ID。
| 题号 | 示例ID | 题型 | 题目及答案 |
| --- | --- | --- | --- |
| Q1 | CONSENT | 单选 | 是否同意参与；同意／不同意 |
| Q2 | AGE | 数字 | 年龄，设置0—120 |
| Q3 | CITY | 单选 | 北京／上海／广州／深圳／其他城市 |
| Q4 | BRANDS | 多选 | 品牌A／品牌B／其他 |
| Q5 | OTHER_BRAND | 单行填空 | 请说明其他品牌 |
| Q6 | SATISFACTION | 评分 | 满意度，设置1—5 |
| Q7 | RECONTACT | 单选 | 是否愿意后续访谈；愿意／不愿意 |
| Q8 | CONTACT | 手机号码 | 联系方式 |
| Q9 | SUGGESTION | 多行填空 | 建议 |
Q1、Q2等甄别来源题建议设必答。Q5、Q8可以设必答，只有显示时才要求填写。下面每个“小例子”是独立方案，不要把所有例子机械拼接；同一目标的多个show必须合并。最后提供一份可以整体采用的组合。
## 1．选择其他品牌才填补充说明
~~~dsl
if Q4 == "其他" then show Q5
~~~
只选品牌A时Q5隐藏，同时选品牌A和其他时Q5显示。多选 == 判断成员存在，不要求只有“其他”一项。
## 2．愿意后续访谈才显示手机号
~~~dsl
if Q7 == "愿意" then show Q8
~~~
来源是明确的意愿选项，不用 not_answered 代替“不愿意”。设为必答的手机号只在实际显示时需要填写。
## 3．年龄18—65岁，边界也算符合
~~~dsl
rule "年龄超范围" id "AGE-RANGE": if Q2 < 18 or Q2 > 65 then screenout "感谢参与，本次研究招募18—65岁受访者。"
~~~
17与66岁甄别，18与65岁不因为这条规则而甄别。若业务要求“满18但未满65”，把大于65改为大于等于65；边界需要按客户口径确定。
## 4．北京或上海，并且年满18岁，才做满意度
~~~dsl
if (Q3 == "北京" or Q3 == "上海") and Q2 >= 18 then show Q6
~~~
这是混合显示条件，括号不可省略。广州30岁、北京17岁都不显示Q6；上海18岁显示。
## 5．把混合甄别拆成两条规则
意图：北京或上海的未成年人甄别。流程规则不支持混合分组，所以分别为两个城市写一条全and规则：
~~~dsl
rule "北京未成年" id "BJ-UNDER18": if Q3 == "北京" and Q2 < 18 then screenout
rule "上海未成年" id "SH-UNDER18": if Q3 == "上海" and Q2 < 18 then screenout
~~~
这种拆法保持业务含义。不要写成“北京并且上海并且未成年”，因为单选城市不可能同时等于两个城市。
## 6．跳过手机号，继续填写建议
~~~dsl
if Q7 == "不愿意" then jump Q9
~~~
表示跳过Q8继续Q9，不是结束问卷。若希望不愿意者直接完成，则改用complete；两种方式择一。
## 7．不愿意后续访谈，直接提前完成
~~~dsl
rule "不参加后续" id "END-NO-INTERVIEW": if Q7 == "不愿意" then complete "感谢参与，本次问卷已完成。"
~~~
Q8和Q9将不再继续出现。提前完成仍进入配额及质控处理，不保证最后一定算有效样本。
## 8．文本包含与精确选项不要混用
~~~dsl
if Q5 contains "品牌" then show Q6
~~~
“某某品牌”会命中，“某某牌”不会。contains 不进行同义词推断，不支持正则表达式。文本检查适用于独立填空；如果判断的是Q4的选项“品牌A”，应写 Q4 == "品牌A"。
## 9．多个品牌同时选中才继续特定题
~~~dsl
if Q4 == "品牌A" and Q4 == "品牌B" then show Q6
~~~
品牌A、品牌B都选中才显示；再多选“其他”也符合。这不是“恰好选两项”的判断，当前DSL没有选项数量函数。
## 10．暂时停用一条甄别规则
~~~dsl
rule "临时停用年龄甄别" id "AGE-TEMP" disabled: if Q2 > 65 then screenout
~~~
规则会出现在预览和可视化列表中，但不会执行。需要启用时删掉 disabled，再检查并保存。
## 11．一份完整的基础调研逻辑
下列代码可作为上面9道题的整份逻辑起点。它保留不愿意后续访谈者的建议题，使用jump跳过手机号，不使用提前完成。
~~~dsl
# 不同意参与时立即甄别
rule "未同意参与" id "CONSENT-GATE": if Q1 == "不同意" then screenout "感谢关注，本次问卷到此结束。"
# 目标年龄18—65岁，含边界
rule "年龄超范围" id "AGE-GATE": if Q2 < 18 or Q2 > 65 then screenout "感谢参与，您不在本次研究的目标范围内。"
# 其他品牌补充说明
if Q4 == "其他" then show Q5
# 愿意后续访谈才收集手机号
if Q7 == "愿意" then show Q8
# 不愿意者跳过手机号，继续建议题
rule "跳过联系方式" id "SKIP-CONTACT": if Q7 == "不愿意" then jump Q9
~~~
正式使用前需确认问卷里的实际选项是否与代码完全相同，甄别题是否必答、页面设置是否合适，以及手机号收集用途是否已向受访者说明。保存代码后，Q6与Q9默认始终显示；若它们原先有显示条件，上面的整份代码会移除那些旧条件。
## 12．这份完整示例应该怎样试答
| 测试场景 | 关键输入 | 预期结果 |
| --- | --- | --- |
| 未同意 | Q1=不同意 | 甄别结束，显示同意规则提示 |
| 年龄下界外 | 同意，Q2=17 | 年龄甄别 |
| 年龄下界 | 同意，Q2=18 | 继续后续问卷 |
| 年龄上界 | 同意，Q2=65 | 继续后续问卷 |
| 年龄上界外 | 同意，Q2=66 | 年龄甄别 |
| 品牌无其他 | Q4只选品牌A | Q5不出现 |
| 品牌有其他 | Q4选其他，或品牌A和其他 | Q5出现并按必答设置填写 |
| 愿意联系 | Q7=愿意 | Q8出现，完成后进入Q9 |
| 不愿联系 | Q7=不愿意 | 跳过Q8，进入Q9 |
| 修改前题 | 先选其他并填写Q5，再回去取消其他 | Q5隐藏，旧补充答案不应驱动后续路径 |
最终有效完成还会受配额、质控、作答期限等配置影响。试答预期中的“继续”只描述路径，不是绕过其他收集规则。
---
# DSL 报错排查：错误原因、改法与试答检查
按真实错误信息查找修复办法，区分语法错误、保存冲突和业务规则不符合预期。
## 怎样看错误位置
点“检查语法”，错误区会显示“第几行、第几列”。点击某条错误可定位到编辑区。报错位置是解析器发现问题的地方，真正原因有时在它前面，例如少一个结束引号或括号。先从上往下修复；前面的错误修好后，再检查一次。
有错误时“保存代码”不可用，原问卷规则不会被这些错误代码替换。检查通过但按钮仍不可用，还应检查是否有未合并的可视化修改，或当前账号是否具有编辑权限。
## 常见错误与改法
| 提示或现象 | 常见原因 | 修改方法 |
| --- | --- | --- |
| 题目引用不存在 | 题号超出范围、题目被删除、把分页算进题号 | 对照右侧“本卷题目”，重新选择实际题号 |
| 请使用题号Q1、Q2或固定ID | 使用Q0、Q01、中文题号或点号访问 | 使用Q1等正整数题号或Q("实际ID") |
| 此处需要 then | 缺then、条件写法不完整、误用&& | 补then，并把&&改为and |
| 比较符应为指定运算符 | 把==写成=、把>=写成=>、使用in | 按语法参考替换比较符 |
| 比较值应为带引号的文字或数字 | 北京没加引号、使用null或数组 | 写"北京"；查未答使用not_answered |
| 某值不是该题的有效选项 | 选项拼错、已改名、使用字母A代替真实选项 | 复制右侧显示的完整选项文字 |
| 大小比较需要有限数字 | 与"十八"、Infinity等比较 | 改为18，确认来源题是数值答案 |
| 显示条件引用题必须位于它之前 | 用后题控制前题 | 调整题序或改写为前题控制后题 |
| 同一道题只能有一条显示语句 | 重复show同一目标，或show与always show冲突 | 合并and/or，或只保留一条 |
| 只能跳到所有条件题之后 | 跳回来源题、跳向前题、包含更靠后的条件 | 把目标移到全部来源题之后 |
| 流程规则请使用全and或全or | 在jump、screenout、complete里混合分组 | 按业务等价关系拆成多条规则 |
| 规则编号重复 | 复制rule行未改id，或与自动编号重合 | 为每条规则使用独立id |
| 字符串缺少结束引号 | 起止引号不配对 | 补同种引号；内容中的引号使用转义 |
| 字符串不能直接换行 | 提示文字在引号中直接回车 | 用\n表示换行，保持语句在一行 |
| 每行写一条语句 | 两条语句挤在一行且无分号，或动作后多了参数 | 换行或用分号；检查动作允许的参数 |
| 条件组或数量超出上限 | 条件过多、嵌套过深 | 按语法参考精简，避免无意义重复括号 |
## 错误与正确写法对照
以下错误示例用于识别问题，不要粘贴保存。
~~~text
错误：if Q3 = "北京" then show Q6
正确：if Q3 == "北京" then show Q6
错误：if Q2 => 18 then show Q6
正确：if Q2 >= 18 then show Q6
错误：if Q3 == 北京 then show Q6
正确：if Q3 == "北京" then show Q6
错误：if Q2 >= 18 && Q2 <= 65 then show Q6
正确：if Q2 >= 18 and Q2 <= 65 then show Q6
错误：if Q5 == null then show Q6
正确：if Q5 not_answered then show Q6
错误：rule "说明": if Q4 == "其他" then show Q5
正确：if Q4 == "其他" then show Q5
错误：rule "备用" enabled: if Q2 < 18 then screenout
正确：rule "备用": if Q2 < 18 then screenout
~~~
## 语法通过，题目却没出现
按顺序核对：是否已经“保存代码”；当前填写页是否重新加载；来源题是否实际出现且已回答；选项文字是否准确；and/or括号是否符合预期；是否先命中了jump或终止规则；是否另有动态选项等设置导致题目没有可用内容。
变更预览只是规则摘要，不会代替实际试答。以测试预览分别填入命中、不命中和边界答案。不要只观察原来已经打开、尚未更新的受访者页面。
## 语法通过，终止时间却不符合预期
检查本条是否引用了更靠后的题，特别是全or中包含后题时；检查前面是否有另一条同样命中的终止规则；检查是否在一页放了过多必答题。需要立即甄别时，尽量在靠前位置安排独立甄别题，再逐题填写或合理分页。
screenout表示甄别；complete表示提前完成。两者都可显示“感谢参与”，但结果口径不同。如果看到配额满或质控拒绝，需同时核对那些设置，不能仅凭DSL里的complete判断最终有效状态。
## 提示“当前可视化规则已变更”
说明正在编辑的DSL草稿与最新可视化结构不是同一版。系统会保留代码但阻止覆盖。先导出草稿；再点“从当前规则生成”；最后把仍需要的修改合并进去并重新检查。不要靠刷新试图绕过冲突，否则可能丢失未导出的文字。
## 保存失败或刷新后看不到修改
语法检查通过不代表网络保存成功。确认页面出现保存成功提示，检查账号编辑权限和网络状态。若提示自动保存失败，先导出代码再重试，不要退出后假定已经保存。
如果可视化修改后DSL的注释或格式变了，但规则内容相同，这是重新生成代码的结果；服务器以结构化规则为执行依据。需要保留某一版注释和排版时，导出 .dsl 文件或保存到项目文档。
## 定位问题时建议记录哪些信息
记录问卷名称、问题发生的题号、相关DSL片段、实际选择的答案、预期跳向哪道题、实际结果及是否在预览模式。截图保留错误行列和规则预览即可；不需要把真实受访者手机号或其他个人资料发出来。通过这些信息可以区分语法、引用、顺序、草稿同步和收集设置问题。
---
# 总配额、分项配额与计数口径
弄清什么数据占名额，避免把各分项相加后误判总回收量。
## 两层配额
项目总配额约束整份问卷有效完成量，0 表示不设项目总上限。分项配额约束命中指定答案条件的有效完成量，例如男性 300、女性 200。全卷最多 50 个分项，每个分项上限为 1—1,000,000。
## 配额何时生效
服务端在正式提交时检查总量与命中的分项，不在进入或正在作答时预留名额。两个人同时抢最后一个名额时，以最终事务校验为准；看到填写页不保证一定取得最后名额。达到限制的答卷以满额状态结束并保留记录。
## 哪些答卷计入
| 结果 | 是否占用有效配额 |
| --- | --- |
| 完成且质控通过 | 是 |
| 完成且待复核 | 暂时计入 |
| 甄别、满额终止 | 否 |
| 质控拒绝 | 否 |
| 仅进入或正在作答 | 不预留 |
## 重叠条件怎么理解
同一份答卷可以同时属于“男性”和“北京”两个分项，因此两个分项完成量不能相加作为总完成量。性别与地区各自是一套样本结构，也不等于自动建立“北京男性”的交叉上限；交叉人群需建立包含两个条件的自定义配额。
## 调小配额与审核恢复
修改目标不会删除已完成答卷。若新上限已达到，后续命中则满额结束。拒绝答卷会释放名额；恢复为通过或待复核时重新校验，若名额已被后续完成占用，会提示冲突。先调整实际目标或审核安排，再恢复，不把失败当成数据丢失。
---
# 快速批量设置配额：多题、比例与 Excel 粘贴
一次勾选多个题目，按数量或百分比生成和调整分项上限。
## 入口与适用题型
进入问卷编辑器“配额”，打开“快速批量设置配额”。支持从单选、下拉、量表和多选中选择题目，搜索后勾选多个题，不必逐题建立分项。多选选项可能重叠，配额仍各自独立判断。
## 按数量设置
1. 输入用于本次分配的项目总量，勾选需要处理的题目。
2. 选择数量模式，逐项填写，或使用单题均分、全部均分。
3. 已在 Excel 排好的一列数字可从第一个输入框开始粘贴，多行依次填入。
4. 查看每个题目的合计与校验提示，确认无误后点击应用。
5. 返回编辑器等待正常保存完成。
## 按百分比设置
每个已选题目的百分比合计必须为 100%，支持最多两位小数。系统按最大余数法把目标换算为整数。例如总量 7，三个选项均分，得到 3、2、2，保证合计为 7。不能用平均后全部取整的方式假定仍等于总量。
## 多个题目如何分配
性别和地区同时选中、总量 1,000 时，两套结构各按 1,000 进行分配，不是把 1,000 再分给两个题目。它不会自动生成性别×地区的所有交叉组合，交叉条件另用自定义配额。
## 修改既有配额的规则
应用时尽量更新原有对应分项，保留编号、名称、启用状态和历史关联。未选中的既有分项、自定义规则保持原设置；原来停用的分项不会自动开启。同一条件已有重复配额时不自动合并，应人工核对。
## 取消和小样本注意事项
取消不会写入本次总量或分项变更。每个新分项目标至少 1；总量太小无法让所有选项有名额时，应减少分项或改用自定义设置。没有建立某选项的配额，不代表禁止该选项人群参与。
---
# 自定义交叉配额与条件维护
把多个答案组合成一条配额，控制更细的人群结构。
## 什么时候使用自定义配额
若只需男性、女性各多少，优先批量生成。若需要“北京且女性且年龄 25—34”最多 80 份，则建立自定义配额，用全部满足组合相关条件。任一满足适合将多个允许地区合并为一组。
## 设置步骤
1. 在“配额”新增分项，填写可识别名称，例如“北京女性25—34”。
2. 设置数量上限和启用状态。
3. 选择全部满足或任一满足，再逐条选择题目、判断方式及答案。
4. 检查题目在填写流程中能够被实际回答，尤其是隐藏题和跳题分支。
5. 保存并预览条件路径，再检查渠道是否要为该分项单独限额。
## 同时命中多条的结果
一份答卷只要命中的某条有效配额已满，就可能满额结束。宽泛规则和精细规则叠加时，应在投放前检查是否存在更小的上限。例如总男性 300、北京男性 50，前者未满也不能继续接收已满的北京男性。
## 改题后如何维护
改选项文字、删除题目、修改动态引用后，原条件可能失效。运行逻辑检查，并核对每个配额绑定的题目与答案，不仅看名称。名称叫“北京”不会自动绑定地区题里的北京。
## 暂停、删除与历史记录
停用分项会改变后续名额约束，不等于删除历史答卷。配额统计与历史关联依赖原编号，优先修改现有规则，避免为相同条件反复新建。需要禁止某类人群时应设置甄别，不能把未建分项理解为零配额。
---
# 渠道按总配额比例自动分配
根据渠道总目标自动带出各分项数量，再按业务需要微调。
## 自动分配的计算方式
渠道分项目标按照“渠道总目标 × 原分项目标 ÷ 项目总目标”计算。例如项目 1,000 份、男性 600、女性 400，给渠道 200 份时，对应建议为男性 120、女性 80。分配只是填写便利，项目总上限与原分项上限仍然生效。
## 操作步骤
1. 先在问卷级建立总配额与分项条件。
2. 在“回收渠道”新建渠道或批量分配项目，填写渠道总目标。
3. 打开该渠道“查看配额 / 设置”，核对自动生成的分项目标。
4. 对有特殊人群能力的渠道手动修改个别分项，再保存。
5. 如需重新全部按比例计算，使用重置或重新分配入口，并检查原有手工值。
## 自动更新与手工修改
调整渠道总目标时，尚未手动改动的分项可重新计算；已手动填写的值会保留，包括留空和 0。旧渠道不会因为升级就无条件覆盖历史设置，需要进入设置核对并保存。项目总目标为 0 时没有可用的比例分母，按页面提示人工确认分项。
## 空白和 0 的区别
| 渠道设置 | 含义 |
| --- | --- |
| 渠道总目标 0 | 不单独限制此渠道总量 |
| 分项留空 | 不对该分项另设渠道上限 |
| 分项为 0 | 此渠道关闭该分项人群 |
渠道某分项目标不能突破问卷原有上限。多个渠道共同消耗同一个项目配额，即使本渠道尚有剩余，其他渠道已使项目满额时，也不能继续完成。
---
# 发布、停止回收与填写限制
把保存好的问卷变成可填写入口，并控制时间与访问方式。
## 发布前检查
确认题目、逻辑、配额和质控设置已保存，运行逻辑检查并测试主要分支。需要邀请名单的项目先准备定向受访者；需要渠道分流的项目先规划渠道编号。
## 发布与发放
点击编辑器顶部“发布回收”，默认进入本问卷的链接分享页，不会跳转到渠道管理。未发布的问卷会显示提示，点击“立即发布”并完成发布前检查后，正式链接才开放填写。发布成功后仍停留在分享页。普通用户无需建立渠道；将链接发送给受访者即可回收答案。
点击“复制链接”或“复制邀请文案”发送给填写者，也可下载 PNG 二维码用于海报和现场扫码。二维码在浏览器本地生成，与正式链接指向同一问卷；不会把问卷地址发送给外部二维码服务。
“分享设置”中可以选择所有收到链接的人、仅定向邀请名单，或公开加定向。默认公开填写不要求登录后台。仅定向邀请时普通分享按钮暂停使用，请到“管理定向邀请”获取一人一链。未发布、已停止和超过截止时间也会给出明确提示。尚未开始但已经发布的问卷可以提前分享，到设定的北京时间后开放。修改设置后请保存，自动保存成功后按钮也会恢复可用。
如需把问卷放进官网，可复制“嵌入网页”中的 iframe 代码。代码使用专门的公开填写入口，仍遵循发布状态、时间、配额和质控规则；管理后台不允许被外部网页嵌入。正式提交会写入答卷，测试预览不会。
按代理商或合作方追踪来源时，再展开“更多回收方式”，进入渠道分发；有明确名单时进入定向邀请。分享前请检查标题、品牌、访问范围和主要填写路径。
## 常用填写设置
| 设置 | 用途 |
| --- | --- |
| 开始、截止时间 | 控制开放时间窗口 |
| 访问方式 | 公开、定向邀请或混合 |
| 总样本目标 | 控制项目有效量上限 |
| 上一页、进度、序号 | 调整填写体验 |
| 按钮与结束文案 | 明确下一步和完成、甄别、满额结果 |
时间设置后应核对界面显示和实际业务时区，不手工把同一个时间重复换算。改变按钮文案不会改变服务端的判断。
## 停止与重新发放
停止回收后，正式入口不能继续正常提交。暂停单个渠道只影响对应渠道，停止问卷则影响整份项目。再次发放前核对开始截止时间、剩余配额和渠道状态，不只检查发布按钮。
## “链接打不开”先排什么
先检查是否已发布或已停止，再核对时间、渠道是否暂停、定向凭证是否有效、设备是否允许，以及网络是否正常。已满或不符人群通常是业务结果，不应通过换参数绕过；联系项目负责人核对规则。
---
# 定向样本与一人一链
通过名单和专属链接分发，区分公开与受邀参与。
## 三种访问方式
公开模式允许通过公开入口参与；定向模式要求受邀样本使用有效专属链接；混合模式兼顾公开和名单回收。仅把链接发在私聊中并不自动变成定向问卷，需要在设置中选择相应模式。
## 导入和管理名单
在编辑器“样本”维护外部编号、姓名、邮箱和手机号等名单字段。先使用导入页面提供的格式准备数据，外部编号应稳定且不重复，避免用容易变化的昵称作为唯一识别。导入完成后检查新增与更新数量，再导出专属链接。
## 发放与追踪
1. 核对访问模式和问卷发布时间。
2. 为每位受访者分发其专属链接，勿把一个人的链接群发。
3. 在名单中查看未打开、已打开和完成等状态。
4. 若同时按渠道发放，使用带对应渠道信息的专属链接，保留受访者与渠道归属。
## 使用边界
专属链接是参与凭证，应按个人保管。它提供名单关联，不等于短信验证或实名核验。收集联系方式前说明用途并控制访问，不把名单文件放在公共群或公开下载地址。
## 为什么有人有链接仍不能答
可能是问卷未开放、专属凭证无效或已使用、渠道暂停、设备不允许，或重复策略命中。先根据页面提示定位，不重新导入一批重复外部编号。名单完成状态与正式结果有关，不能仅凭“已打开”判定已获得有效样本。
---
# 渠道管理与项目分发
按合作方管理独立填写链接、项目和执行进度。
## 渠道的作用
渠道用于区分回收来源、设置独立目标和向合作方提供专属进度。进入“回收渠道”，可以按合作渠道查看其承接项目，并搜索名称、编号、问卷或状态。项目目录支持按页查看，常用每页 20、50 或 100 条。
## 创建与分配
1. 新建渠道，选择问卷，填写渠道名称和编号；编号在同一问卷内唯一，留空可自动生成。
2. 设置渠道总目标，核对按项目比例带出的分项目标。
3. 保存后复制“填写链接”，发给对应合作方实际回收。
4. 要让合作方查看进度，再单独生成渠道专属进度查看链接。
填写链接与进度查看链接用途不同，不能把只读进度链接当作答题入口。与样本平台联通的专用渠道应使用对应集成功能，不能仅凭同名手工新建渠道代替联通。
## 状态如何看
项目归档、问卷停止、草稿、渠道暂停、渠道总量满额等都会影响展示。一个渠道显示回收中，不保证所有分项仍有名额；具体提交还要同时满足项目、分项和质控条件。
## 暂停渠道
暂停后该渠道入口与提交都会受限，改配额不会自动恢复暂停状态。需要恢复时先核对项目仍开放、目标足够，再显式恢复渠道。暂停不删除已回收答卷和历史来源关系。
## 统计中“承接项目”的含义
同一问卷分给两个合作渠道，会形成两条执行关系；这不表示多了两份独立问卷。统计项目数量、关系数量和有效完成量时应使用正确指标，避免汇报重复计数。
---
# 渠道专属进度链接
让每个合作方只看到自己的目标、完成与剩余名额。
## 创建和发放
打开渠道详情，生成“渠道专属配额查看链接”，选择有效期后复制给该合作方。常用有效期为 7 天、30 天、90 天或长期有效。链接代表查看授权，转发给别人会让别人看到该渠道的只读进度。
## 合作方能看到什么
页面包含该渠道目标、有效完成、剩余量、分项进度和结束状态统计。支持电脑明细、手机卡片、分项搜索、手动刷新；页面处于当前标签时约每 30 秒自动刷新。
## 数据隔离
不会展示其他渠道的名称、编号、完成量，也不展示整个项目总完成量、个人信息和答卷答案。修改地址里的问卷号或渠道号不会改变查看范围，范围由该链接的独立凭证决定。
## 重置、撤销和失败提示
1. 担心链接被转发时，重置凭证并重新发给正确合作方。
2. 项目结束或不再需要分享时，撤销链接。
3. 重置或撤销会使旧链接失效，但不影响正式填写链接。
4. 页面提示更新失败时，当前数值可能不是最新；先刷新核对，不继续按旧剩余量大规模投放。
## 不要混用项目总进度
客户需要看整个项目时使用“项目总配额进度分享”。这两类链接权限范围不同。给渠道复制前确认页面标题和数据范围，避免把包含项目汇总的链接误发给单个供应方。
---
# 项目总配额进度分享
向客户展示整个项目汇总，和单渠道链接分开管理。
## 项目统计进度链接
进入问卷编辑器的“发布回收”，点击页面顶部“分享项目进度”，或右侧“生成 / 管理进度链接”。选择 7 天、30 天、90 天或长期有效，可决定是否展示渠道名称、逐题统计，并逐题勾选分享范围。生成后复制给客户，客户无需登录即可查看；这不是问卷填写链接。
查看页包含回收概况、逐题统计和配额进度，支持按北京时间日期、渠道、答卷状态及质控状态筛选。默认查看全部提交记录；研究分析时可切换为“有效完成”。逐题展示回答人数、跳过人数、选项频次与百分比，数字题展示数值汇总；支持题目检索、条形图与统计表切换，以及 30 秒自动刷新。多选题的百分比总和可能超过 100%。文字、联系方式、附件、签名及组合题只展示回答人数，不展示原文或单份答卷。不会对外提供会员编号、外部 token、IP 或答卷导出。
筛选影响顶部人数、渠道统计、趋势及逐题统计；项目总目标和分项配额始终按全部时间、全部来源的有效完成统计。开始时间由提交时间减答题用时估算，并非独立采集的精确开始时间。生成后新增的题目不会自动加入分享范围，需要重新生成链接。重置或撤销后，旧链接立即失效；新统计链接与原有总配额、渠道专属链接分别管理。
## 使用场景
项目总进度适合项目负责人或客户查看问卷整体目标、完成及分项结构。渠道专属链接只允许查看单渠道，总进度链接的范围更广，发放对象应单独确认。
## 操作步骤
在项目的总配额或进度入口创建项目查看链接，选择有效期，复制后用新页面核对标题与统计范围，再发给客户。需要变更访问者时重置凭证，需要停止公开时撤销。
## 统计怎么理解
整体有效完成排除甄别、满额终止与质控拒绝，包含待复核完成。分项可能重叠，一个受访者能同时属于性别与地区多个结构，不能相加作为总数。渠道汇总中的关系也不等同于不同问卷项目数。
## 更新与有效期
查看页提供手动刷新，并在页面活跃时定期更新。链接到期、被重置或撤销后不能继续读取，页面会显示失效信息。不要将截屏时间之前的剩余量视作当前可发放量，最终名额在真实提交时判断。
## 分享边界
只读进度链接不会让客户进入问卷编辑器，也不赋予答卷导出权限。链接本身具有查看效力，应按交付范围管理。若仅希望某个合作方看到自己的执行情况，重新使用对应渠道的查看链接。
## 核对差异的方法
当客户说数字不同，先对齐查看时间、问卷、渠道或全项目范围，再对齐是否包含待复核、是否排除质控拒绝。必要时在后台查看对应结束状态和审核变化记录，而不是直接调整完成量凑数。
---
# 中断作答与刷新恢复：临时答案的范围
理解暂存与正式提交的区别，以及问卷更新、身份变化和作答结束时的处理。
## 自动恢复什么
正式填写页会把未提交答案暂存在当前浏览器标签页，刷新后自动恢复答案、当前页、访问历史、选项顺序及本次抽题凭据。顶部进度与页面内容会一起恢复，填写页底部出现“已恢复当前标签页未提交的答案”。计时保留首次打开时间，暂停期间也包含在本次总用时中。
## 保存边界
暂存最长保留 24 小时，按问卷、渠道、受访者链接、样本参数、语言和设备标识隔离。它用于同一标签页的意外刷新恢复，不是账号云端草稿，不支持跨设备续答，也不承诺关闭浏览器后恢复。浏览器禁用存储或空间不足时会提示无法暂存，仍可继续填写，请保持页面打开。
## 何时清除
提交成功、甄别结束、配额满或确认重复参与后清除本次暂存。问卷题目、设置或抽题版本变化，作答凭据过期时，旧暂存会失效并提示重新填写。预览不写入正式填写暂存；暂存不生成答卷、不占用正式配额、不触发结果回调。
## 手动清除与规则
点击“清除暂存”会删除当前暂存并停止本页后续暂存；本页内存答案仍可继续填写，刷新后普通问卷重新开始。限时问卷的服务器截止时间仍保留，清除暂存不会延长倒计时。恢复不会跳过服务器的配额、设备、IP 地区、专属链接、防重复和有效期限检查。若提交失败，答案在当前页面保留，先检查提示再重试。
---
# 回收时间与作答倒计时：北京时间和自动交卷
设置开始、结束时间与单次作答限时，了解超时答卷如何与配额、质控、回调联动。
## 配置入口
进入编辑器“设置 → 回收限制”。开始回收时间与结束回收时间统一按北京时间（UTC+8）解释，不随服务器或填写者所在地变化。开始时间未到时不能打开或提交；结束时间到达后停止接收普通作答。时间留空表示不设对应边界，开始和结束都设置时，结束必须晚于开始。
## 单次限时
“单次作答限时”以时:分:秒设置，00:00:00 表示不限时，最多支持 12 小时。打开正式问卷时由服务器记录首次开始和截止时间，填写页展示剩余时长。刷新页面、清除标签页暂存或修改本机时钟不会延长同一浏览器、同一邀请及渠道的这次服务器期限。若总回收结束时间更早，实际截止时间以较早者为准。新设置默认关闭，不会给旧问卷自动加上限时。
## 到时与网络故障
剩余时间归零后冻结继续填写并自动提交当时已填写的内容。超时答卷结果为 screenout（甄别结束），质控为 rejected，终止原因为“作答超时，已自动交卷”。允许必答题未完成，合规的已填写内容仍保留；此类答卷不占有效样本配额，也不计为样本平台有效完成。结果通过原有问卷 Webhook 和已配置的样本平台回调通道传递，重复重试复用同一个答卷编号。
网络中断时页面会提示并定期重试，网络恢复后继续提交。晚于服务器期限收到的请求也按超时处理，不会因为客户端篡改时长变成有效完成。该功能需要页面保持打开；浏览器关闭后不会在服务器自动生成答卷，也不支持离线云端作答。作答凭证最长保留 24 小时，超出后不能依赖旧凭证补交。限时答卷以服务器记录的经过时间计算用时，普通不限时答卷继续使用原有计时口径。
## 发布前验证
先用正式测试问卷检查开始时间、结束时间和倒计时边界，再验证完成、超时和配额满等不同结果。测试预览不创建正式计时凭证、不自动写入答卷和附件；需要验证服务器限时规则时，使用单独发布的测试问卷，避免占用真实项目样本。
---
# 样本服务：提交人群需求与确认报价
选择受访者标签、数量与期望交期，把需求提交给来数服务团队，并在平台跟进。
## 什么时候使用
自己已有受访者时，可直接使用问卷链接或二维码回收。需要来数协助招募受访者和回收样本时，在问卷编辑器的“发布回收”页找到“样本服务”，点击“填写样本需求”。提交的是服务需求，不会自动购买样本、扣款或启动招募。
## 填写目标人群
- 地区可输入省、市或海外地区，并点击“添加地区”；也可选择常用城市。多个地区表示满足其中任意一个地区，不选表示地区不限。请使用具体城市名称，避免只写城市等级。
- 性别默认为不限。年龄上下限可选填，范围为 1–100 周岁；最小年龄不能大于最大年龄。涉及未成年人时，需在执行前另行确认研究与授权安排。
- 职业身份、教育程度、生活阶段和消费行为均可多选。同一组内满足任一标签，不同组之间需同时满足；某组不选表示该维度不限。
- 比例配额、品牌使用经历、行业限制等写在“其他人群条件与配额要求”。这些文字条件由服务人员审核，不会自动转换成问卷甄别或配额规则。问卷自身的逻辑、配额和质控仍需设置并测试。
## 数量、时间与联系人
填写 1–100,000 份目标有效样本、1–120 分钟预计答题时长，以及未来一年内的期望完成时间。页面时间按北京时间展示；期望交期不是已承诺的交期。预算可选填，最终以双方确认的报价为准。
联系人为必填，可选择电话、邮箱或微信。联系方式仅供本次需求沟通，请勿在需求说明里放入受访者个人资料。勾选信息确认后提交，系统生成 SS- 开头的需求编号。重复点击或原请求重试不会重复创建同一需求。
## 查看报价与确认
提交后，在当前问卷的“这份问卷的样本需求”中查看；工作空间侧栏“我的样本需求”可查询本企业全部需求。点击记录可查看人群、数量、联系人、公开回复、报价、预计交付时间和状态记录。
草稿问卷可以先申请可行性评估。开始执行前，需要保存并发布问卷，开放普通链接，确认时间、配额与质量要求有效。提交时会保留问卷名称和题量快照；之后修改问卷，请重新与服务团队核对范围、报价及交付安排。
服务人员报价后，状态为“待确认报价”。企业所有者或管理员核对总价、交付时间和服务范围后，点击“确认报价与交付安排”，再进行一次确认。确认后进入“已确认，待执行”，由来数安排执行。这里不处理在线付款，费用、付款方式、发票与交付验收由双方另行约定。
## 状态与取消
常见流程为：待审核 → 需求沟通中 → 待确认报价 → 已确认，待执行 → 执行中 → 已完成。可行性审核也可直接进入报价；无法承接时会显示说明。未确认报价前，编辑者及管理员可取消需求；已确认或执行中的需求需要联系服务人员处理。结束的需求保留历史，如有新需求请重新提交。
## 管理员接收入口
仅平台最高权限账号可在侧栏“样本服务需求”查看各企业提交的需求，按编号、问卷、联系人、企业或状态搜索，打开详情后审核、回复、报价、填写预计交付时间及跟进执行。企业自己的管理员账号不能访问该平台总管理入口。
“给用户的回复”会展示给需求方；“内部备注”及其历史仅平台管理员可见。报价必须同时给出总价、交付时间和服务说明，不能跳过用户确认直接开始执行。多人同时处理时，较旧的页面会提示刷新，以防覆盖其他人的更新。执行和完成状态由服务人员据实维护，不等同于自动计数或结算凭证。
---
# 质控中心：时长、重复与注意力检测
配置自动规则，区分直接甄别、打分和人工复核。
## 设置入口
进入“质控中心”，选择问卷并打开规则设置。先结合正常预览估计合理时长，再配置行为检测与分数阈值。规则应与研究难度匹配，不把正常快速填写一律当作无效。
## 常用规则
| 规则 | 实际含义 |
| --- | --- |
| 最短答题时长 | 0—7,200 秒，0 不限制，过短直接甄别 |
| 限制同一设备重复答题 | 同一浏览器设备在该问卷各渠道间统一判断 |
| 注意力检测题 | 指定题目与预期答案，参与质控判定 |
| 矩阵连续同选 | 检测适用矩阵出现连续相同模式 |
| 复核、拒绝阈值 | 分数较低进入待复核或拒绝，拒绝阈值应低于复核阈值 |
## 重复答题口径
同一浏览器曾提交该问卷的完成、甄别或满额记录，开启重复规则后可能在再次进入和提交时被拦截；更换渠道不能解除。预览不在此范围。浏览器设备识别与同 IP 限填不同，同网络多人的 IP 可能相同，浏览器标识也不是硬件实名身份。
## 配置与验收顺序
先保存规则，再检查正常、过快和注意力错误的测试路径。需要看正式效果时按实际试收安排核对，不用预览的成功结果推断真实配额与重复限制均已验证。
## 审核后对数据的影响
待复核完成暂时占有效配额；拒绝会释放；恢复则重新检查名额。不要把“完成”理解为已经质控通过。IP 地区和作答设备限制是独立设置，需按项目需要分别开启。
---
# IP 地区与问卷答案一致性
例如选择北京但 IP 解析为外地时，按规则甄别或进入复核。
## 配置前提
问卷中需要有地区答案来源，可以是省市区题或以地区为选项的单选、下拉题。质控根据真实请求 IP 解析归属地，再与指定答案按省级或市级比对；不是根据题目标题猜测城市。
## 设置步骤
1. 在质控规则中开启 IP 地区一致性检测。
2. 选择用于对照的地区题，指定比较省份或城市。
3. 明确地区无法识别、答案缺失或格式不适配时的处理方式：复核或甄别。
4. 保存后检查“北京 / 北京市”等地区名称映射，预览答案路径。
5. 用真实网络试收后检查结果与原因，再决定是否扩大投放。
## 判断示例
回答为北京，IP 可解析为上海，按启用的差异规则甄别。回答为北京，但 IP 只能获得不完整地区或为不可解析地址时，按未知地区策略处理，不能自动当作一致。
## 识别边界
IP 归属地不是 GPS 定位，也不是常住地证明。移动网络出口、企业网络、代理和运营商跨区路由可能造成差异。高要求研究应结合人口属性和人工复核，避免仅凭一项信号推断欺诈。
## 上线后维护
记录因地区问题终止或待复核的比例。如果某渠道异常高，先核对来源题、选项、比较层级及地区解析，再和渠道核实实际网络。调整规则不会自动把历史记录全部改成通过，历史处理需按审核流程进行。
---
# 限制电脑或手机作答
按实际浏览器设备类型控制入口，手机范围包含平板。
## 三种设置
在质控规则的答题设备设置中选择不限、仅电脑或仅移动端。移动端包含手机和平板；电脑和移动端是作答设备类型，与操作系统名称是不同维度。
## 操作步骤
1. 结合研究素材和问卷长度选择允许的设备。
2. 保存规则，在真实电脑浏览器和真实手机浏览器各检查一次。
3. 在发放说明中写清设备要求，避免受访者先答很久才发现不适配。
4. 需要变更设备限制时同步通知渠道，并重新检查正式链接。
## 系统如何判断
根据请求中的浏览器标识和客户端提示判断，不按浏览器窗口宽度判断。把电脑窗口缩成手机宽度不等于手机作答；浏览器设备模拟适合看布局，不能代替真实设备限制验证。
## 被拦截后的结果
不允许的设备在入口或提交校验处受限，不创建新的正式答卷、不占用邀请名额，也不会把这次拦截当作一次完成回传。受访者可使用原链接换到符合要求的设备继续，仍需满足其他规则。
## 与设备信息、重复检测的区别
设备限制控制能否参与；设备记录说明实际检测到的类型和系统；重复检测限制同一浏览器再次参与。三者需要分别理解。浏览器标识能被浏览器隐私策略简化，不能当作不可伪造的硬件身份证明。
---
# 查看质控原因与人工审核
对齐答卷结果、质控状态和有效样本量，再处理异常。
## 先看两个状态
答卷结束结果说明完成、甄别或满额；质控状态说明通过、待复核或拒绝。完成且待复核暂时计入有效配额，但不等于已经通过审核。项目交付时要约定是否仅使用审核通过的数据。
## 审核步骤
1. 在质控中心或原始答卷入口筛选需要核查的记录。
2. 查看时长、命中原因、来源和实际答案，必要时核对渠道说明。
3. 按证据进行通过、复核或拒绝处理，保存清晰原因。
4. 回到配额与统计查看有效量变化，并更新交付报告。
拥有答卷查看权限的角色可按当前授权使用相应审核入口；编辑质控规则需要编辑权限。能读公开产品文档不代表有这些后台权限。
## 名额为何恢复失败
一份拒绝记录不占配额，期间其他受访者可能已填满剩余名额。恢复为通过或待复核时系统重新校验，不允许悄悄超收；遇到冲突应先确认项目是否接受扩大目标，再调整对应配额。
## 历史规则与后续修改
修改时长或地区策略主要影响后续判定，不应期待历史状态自动按新规则批量重算。审核时以该份记录的证据、实际执行规则和客户约定为依据，不通过随意改结果补齐交付量。
## 建议的复核口径
交付说明包含总提交、完成、甄别、满额、待复核与拒绝量，说明采用的分析样本范围。不同页面数据对不上时，先核对时间和状态筛选，再查是否有审核变化。
---
# 后期清洗：检测跨题条件，再由人工判定
配置清洗规则、查看命中证据并人工保留或废卷，理解角色权限、配额释放和重新检测。
## 入口与角色分工
打开已保存问卷的编辑器，进入左侧“清洗”，查看“清洗条件与人工废卷”。可从电子问卷带入规则，也可由编辑人员新增跨题条件。这里判断的是完成后的答案是否需要核查，不是填写途中自动甄别。
| 当前工作空间角色 | 本清洗模块可执行操作 |
| --- | --- |
| 所有者、管理员 | 调整规则、检测答卷、人工复核 |
| 编辑者 | 调整规则、查看结果；不能执行检测或人工复核 |
| 分析员 | 查看、检测、人工复核；不能修改或保存问卷规则 |
| 只读成员 | 无答卷查看权限，不能读取本清洗队列 |
分析员点击“检测答卷”使用已保存规则；有编辑权限的检测人员点击“保存并检测答卷”会先保存。尚未保存的问卷需先由编辑人员保存，不能跨工作空间读取或处理答卷。
## 配置、检测与判定
1. 设置规则名称、启用状态、命中说明与条件，条件组可用“全部满足”或“任一满足”。
2. 检测后展开命中答卷，逐项核对题号、题目、实际答案与命中原因。
3. 勾选答卷，填写复核原因，再选择“确认废卷”或“复核保留”。
例如同时命中“从未使用某服务”和“最近一周每天使用”，只能提示存在矛盾；应检查时间口径、题意和跳转路径后决定，不能仅凭规则命中认定填写者无效。系统检测已完成答卷，不把甄别与满额终止记录混入本轮完成样本检测。
### 人工判定的实际影响
命中只建立待复核记录，不自动拒绝，不删除答案，也不自动释放配额。确认废卷后更新质控状态，原始答卷、命中证据与复核原因保留，有效配额随拒绝状态释放；最低目标按未被拒绝的完成答卷重新计数。
恢复保留废卷时，会核对总配额、分项和渠道可用额度。若名额已被后续答卷占用，恢复会被阻止，应先调整配额；不会默默制造超额。每批复核一至一百份，原因须二至一千字符，队列每页显示五十份。
### 规则变化与规模限制
相同规则与相同命中证据再次检测时可保留已有判定。规则或相关选项变化导致记录失效时，应先重新检测；仍命中的变化记录回到待复核，不能直接沿用旧原因。重新检测本身不会自动把已拒绝答卷恢复为有效。
清洗规则最多五十条，每组一至十个条件，最多嵌套两层条件组，每条最多三十个条件。单项目处理最多两万份答卷，另有数据量限制；提示任务繁忙时稍后重试。
## 常见错误
- 把“待复核”当作已经废卷，或把编辑问卷权限误认为有清洗审核权限。
- 修改规则后直接批量判定，未重新检测；恢复答卷前未检查名额。
最低目标达到后继续回收，上限配额才控制满额。来源转换参阅[电子问卷导入](#questionnaire-import)，留存核查材料参阅[原始导出](#raw-export)。
---
# 提交、有效完成与质控状态
统一项目执行、配额和分析中的数量定义。
## 两个维度一起看
一份答卷包含结束结果和质控状态。结束结果回答“这次填写怎么结束”，质控回答“这份完成数据是否被接受”。不能仅凭列表出现一条记录就将其计入有效交付。
| 结束结果 | 说明 |
| --- | --- |
| 完成 | 按正式流程完成，仍需看质控 |
| 甄别 | 规则判定不符合或触发直接甄别 |
| 配额已满 | 命中某层已用完的名额 |
| 质控状态 | 常用理解 |
| --- | --- |
| 通过 | 当前审核接受 |
| 待复核 | 需要进一步核实，完成时暂计配额 |
| 拒绝 | 排除有效配额和默认有效分析 |
## 口径示例
总提交 120，其中完成 100、甄别 15、满额 5；完成中拒绝 8、待复核 12。有效完成通常为 92，若只看已通过则为 80。向客户报量时应标明是否包含待复核，不能把 120 或 100 直接叫最终有效量。
## 为什么数据会变化
人工拒绝释放名额，恢复审核重新占用；时间、渠道、质量筛选也影响统计。自动刷新页面和导出文件可能采用不同时间点。先统一问卷、时间、来源与质量范围，再核对数值。
## 与样本结算的关系
问卷里的有效完成是一套回收口径；如果联通样本运营台，客户最终确认、计费与实际收付款仍有各自状态。问卷完成不能直接视为客户已确认有效或已结款。
---
# 原始答卷、筛选与导出
查看每份实际答案，保留结束状态和研究解释口径。
## 查看入口
在项目中进入数据分析，切换“原始答卷”。用结束状态、质控、来源和关键词等条件缩小范围，再展开需要核对的记录。分析员需要答卷查看权限；仅查看问卷的成员不会因此获得个人答案访问。
## 建议核对顺序
1. 确认当前问卷和回收时间范围。
2. 筛选完成、甄别或满额，避免混用状态。
3. 查看质控结果、耗时和终止原因，再核查实际答案。
4. 根据研究目标决定导出所有记录还是只采用有效或已通过样本。
5. 将所用口径写进交付说明，并记录导出日期。
## CSV 的基本用途
原始答卷导出提供答卷编号、结果、原因、提交时间、时长及题目答案；开启测验后还会包含适用的分数信息。复杂题型可能展开为多列或结构化值，先核对表头，不通过列的位置猜测题目含义。
## 多格式原始数据导出
当前原始数据导出窗口可选择 Excel 文字版、编码版与字典、CSV、SPSS、Stata 或完整数据包，并按全部、有效、已通过或拒绝筛选。它与专业统计工作台的分析矩阵用途不同，详见[原始数据多格式导出](#raw-export)。回收后跨题矛盾可使用[清洗条件与人工复核](#response-cleaning)，命中不会自动废卷。
## 与专业统计导出的区别
AI 分析中的统计导出会进行变量筛选、编码和缺失值处理，并提供变量字典；开放文本、联系方式或部分复杂结构不进入专业统计矩阵。需要保留完整原文时，使用原始答卷入口，不以专业分析文件代替全部原始记录。
## 文件交付
联系方式、开放意见可能含个人信息，导出后按项目范围保管。文件中的编码、时间与空值需在交付前核对。不要在表格里直接改几行结果再当作平台原记录；需要调整审核时回到平台按流程处理并保留原因。
---
# 数据概览、趋势、题目与交叉分析
按同一筛选口径观察回收效率、来源和问题分布。
## 分析入口
打开问卷的数据分析，可查看总体表现、回收趋势、填写漏斗、来源、质控、题目结果、交叉、NPS 和配额等视图。顶部可选择全部时间、近 7 天、近 30 天或近 90 天；切换前先确认需要回答的研究问题。
## 常见分析任务
| 任务 | 建议查看 |
| --- | --- |
| 回收是否顺畅 | 时间趋势、漏斗、结束状态 |
| 哪个渠道质量不同 | 来源与质控，再核对各自样本结构 |
| 某题选项如何分布 | 题目统计、有效样本数和未答情况 |
| 不同人群是否不同 | 交叉表，必要时使用专业统计检验 |
| 哪些人群还缺 | 配额视图与渠道进度 |
## 分母为什么不总一样
隐藏题、跳题、选答和动态候选会让每题实际可答人数不同。多选比例可能合计超过 100%；不同量表的分值范围也不同。先看题目有效回答数，再解释比例，不强行把所有题统一用问卷总提交作分母。
## 从图表到结论
图表显示差异并不自动证明显著，也不能证明原因。比较来源时，注意人群组成、投放时间和质量筛选是否一致。需要检验时进入 AI 分析选择适合变量的方法，并报告样本量、效应量与适用条件。
## 历史和当前
审核处理、补收和改卷都可能改变当前统计。保存报告时注明筛选口径和日期。报告中的“有效完成”是否含待复核，应和项目交付约定对齐；不得以图表漂亮代替样本代表性说明。
---
# 专业统计：如何选择 14 类方法
按研究问题、变量类型和样本关系选择检验或模型。
## 进入工作台
在数据分析中点击“AI 分析”，选择样本口径、来源和研究目标。可一键生成描述统计，或在左侧选择具体方法并配置变量。统计由计算引擎完成，AI 用于解释与建议。
| 方法 | 适用问题与主要输出 |
| --- | --- |
| 描述统计 | 分类频数、比例、均值、标准差、中位数和区间 |
| 交叉与卡方 | 类别关联，含适用的 Fisher 检验和 Cramér V |
| 独立样本 t | 两个独立群体均值，Welch 与均值差区间 |
| 配对样本 t | 同一受访者两次测量的差异 |
| 单因素方差分析 | 多组均值，含 Levene 与适用的 Tukey |
| Mann–Whitney U | 两个独立群体的秩比较 |
| Kruskal–Wallis | 多组秩比较 |
| Pearson 相关 | 数值变量的线性关联 |
| Spearman 相关 | 等级关联 |
| 线性回归 | 连续结果变量，系数、拟合与共线诊断 |
| 二元 Logistic | 两类结果的模型，OR 与诊断 |
| 量表信度 | Cronbach α、条目总分相关与删项诊断 |
| PCA | 主成分、解释方差、载荷与适用性检查 |
| 探索性因子分析 | 主轴提取、Varimax、载荷与共同度 |
## 配置与解释
置信水平可选 90%、95%、99%。先确定结果变量、分组变量及独立或配对关系，再选择方法。不将品牌编号等名义类别直接当连续数值，不将不同受访者的数据当配对样本。
## 运行失败如何处理
检查有效样本量、组别数量、变量是否常数、缺失值比例与完全共线。Logistic 完全分离或模型不收敛需要调整研究或变量，不反复重试直到出现想要的结果。页面提示和诊断应随报告一起解释。
## 结论边界
显著性不能补救便利抽样或渠道选择偏差；相关和回归不自动证明因果。当前模块不等同于商业统计软件的全部能力，复杂抽样权重、多重插补、结构方程等专门任务需另行处理。
---
# 统计样本范围、变量编码与缺失值
先核对进入分析的数据，再读显著性与模型结果。
## 样本范围
专业分析默认使用有效完成，包括待复核，排除甄别、满额和质控拒绝；可以切换为仅质控已通过。时间、来源和质量范围随报告保存，查看历史报告先读这些条件。
## 变量编码
| 数据结构 | 分析处理 |
| --- | --- |
| 单选、下拉 | 保留类别含义，不自动当连续数值 |
| 多选 | 按选项展开指示变量，未答与未选区分 |
| 矩阵 | 按条目展开，查看变量字典 |
| 数值、适用评分 | 结合范围和题意参与数值分析 |
| 开放文本、联系方式及部分复杂结构 | 不进入本统计矩阵，原文在原始答卷查看 |
## 缺失与反向计分
描述统计按变量排除缺失，其他方法通常使用完整案例删除，不自动插补或加权。信度分析的反向计分需要条目有固定范围，并确认方向正确。不能把空答案一律替换为 0，也不应将“未选”与“未作答”混为一类。
## 当前容量范围
长问卷的变量字典会完整加载，不再因整卷展开超过 250 个变量而无法打开。每次最多选择 40 个分析变量，单次计算最多 20,000 份有效答卷；超出时缩小时间或来源范围后分批分析。多选和矩阵会展开为多个变量，可按题目或变量编号搜索。
新生成的报告只计算和导出本次使用的变量，避免未参与分析的复杂矩阵占用资源。未选择报告时仍可导出全部统计变量，整卷导出最多 2,000,000 个数据单元格，超出时缩小样本范围或先运行指定变量的分析。升级前保存的报告保留原有整卷快照与导出口径。
## 数据变化后
新增答卷、人工审核或问卷编码发生变化，旧报告与当前数据可能不同。导出时如提示数据已变化，重新运行分析，而不是继续把旧结论配上新数据。保存交付包时保留对应字典、参数与结果。
---
# AI 解读、研究目标与历史报告
基于已计算统计生成摘要和下一步建议，保留明确的证据边界。
## 如何使用
输入具体研究目标，例如“比较不同购买渠道的满意度”，选择数据口径后点击“一键分析并生成 AI 解读”。系统保存描述统计报告，再生成解读。需要特定模型时先配置并运行对应统计方法。
## 报告内容
工作台包含统计结果、AI 解读和变量字典，历史报告可从上方列表重新打开。研究目标用于组织解释与后续建议；不是改写原始数据或自动证明业务原因的指令。
## 计算与解读的分工
摘要中的统计数字来自已保存的计算结果。当前 AI 解读采用受约束的轻量流程，围绕汇总证据提供最多几个后续研究方向，例如分组比较、质量复核、量表诊断或进一步访谈。它适合辅助梳理，不能当作开放式深度研究已被充分验证。
## 合理的提问方式
写清研究对象、比较人群、关心的指标和希望支持的业务决策。不要要求模型“证明某渠道一定更好”；先让它说明现有证据、局限和建议补充的验证。报告中没有采集的变量，不能被推断成已观察事实。
## 超时或暂不可用
模型未连接时，统计计算与导出仍可使用。模型响应超时不会把已经保存的统计报告删除，可以稍后重试解读。多人同时使用或数据较多时等待当前任务，不连续重复提交。
## 对外报告前
由研究人员检查样本范围、统计条件、数字和措辞。显著结果不自动具有商业重要性，非显著也不等于完全没有差异。将模型建议与已观察结论分清，并保留调查设计和样本代表性的说明。
---
# SPSS、Stata、Excel 与可复现分析包
在专业分析中导出编码数据、变量字典和对应计算材料。
## 导出流程
1. 先完成一份统计报告，确认时间、来源与质量口径。
2. 核对变量字典和报告中的排除说明。
3. 在导出菜单选择 SAV、DTA、XLSX、CSV 或可复现分析包。
4. 下载后回读文件，确认样本数、变量标签、取值标签和缺失值。
5. 将报告、字典和数据一起交付，避免接收方只拿到无说明的编码表。
## 各格式用途
| 格式 | 建议用途 |
| --- | --- |
| SPSS .sav | 在支持该格式的软件中继续分析 |
| Stata .dta | 在支持该格式的软件中继续分析 |
| Excel、CSV | 交接、核对与常规处理 |
| 可复现分析包 | 保留编码、字典、参数、结果和复算材料 |
分析包包含适用的 SPSS 脚本、Stata 脚本，以及本次 Python 引擎、输入和复现说明。专业统计导出的不是所有开放文本或联系方式，完整原始记录仍从原始答卷入口获取。
## 商业软件兼容边界
SAV、DTA 文件提供中文标签及缺失值等兼容信息，平台并未调用 SPSS 或 Stata 商业软件本体。运行相应脚本需要接收方的软件许可和版本环境；默认标准误、多重比较及缺失规则可能不同，精确复算可使用随包引擎说明。
## 为何不能导出旧报告
数据或结构变化后，系统会要求重新运行，避免报告和数据不一致。不要手动拼接旧报告与新数据。打印报告可保存为 PDF，但浏览器打印格式与数据文件职责不同，分析复核仍以参数、字典和对应数据为准。
---
# 原始数据多格式导出：文字、编码与变量字典
导出 Excel、CSV、SPSS、Stata 和完整数据包，核对样本口径、原始编码、缺失值及清洗记录。
## 入口与可选格式
在项目“分析”页面点击“导出数据”，选择文件格式与样本口径后下载；部分旧入口仍标为“导出 CSV”，点击后同样打开格式选择窗口。所有者、管理员、编辑者、分析员可导出当前工作空间的答卷，只读成员不可导出。
| 格式 | 内容 |
| --- | --- |
| Excel | 同一文件包含文字版、编码版、变量字典三张表 |
| 文字版 CSV | 用题目标签和可映射的选项文字呈现数据 |
| 编码版 CSV | 使用变量名、选项码与展开后的零一值 |
| SPSS、Stata | 提供 SAV、DTA 兼容数据文件及相应标签 |
| 完整 ZIP | 含上述两种原生数据、两版 CSV、变量字典、打开脚本和说明 |
## 先确认样本口径
1. “全部答卷”包含完成、甄别、满额和废卷；“有效完成”只取已完成且未被拒绝的答卷，仍含待复核。
2. “仅质控已通过”限定完成且已通过的答卷；“仅人工或质控拒绝”也限定完成状态，不是全部终止记录。
3. 时间范围跟随分析页面的全部时间、近七天、三十天或九十天。原始表格中当前搜索和其他筛选不会自动全部带入导出。
### 编码、缺失与复杂题
原始题号与选项码存在时优先沿用，否则按题目顺序生成。单选、下拉、量表映射为选项码；多选按固定选项展开，选中为一、未选为零，整题未答留缺失。矩阵单选按行展开，矩阵多选按行与选项组合展开。
例如 Q7 的两个选项原码为三和九，变量可为 Q7_O3、Q7_O9，选择第一项得到一和零，不会补出不存在的中间选项。编码缺口应对照字典解释，不能把原码误当连续分数。
数值题保留数值，开放文本保留字符串；排序、比重分配、组合题等复杂答案保留字符串或 JSON，不保证全部拆成分析变量。数值缺失使用系统缺失，文本缺失为空，不应把缺失统一改成零。变量名最多三十二字符，截短或重名时自动区分，完整含义查变量字典。
## 清洗留痕与交付边界
文件包含答卷编号、结束状态、质控状态、提交时间、时长和来源，并附清洗命中、复核结果、人工原因。选择全部答卷可保留废卷用于追溯；导出不会删除或重新判定记录。表格文本以公式触发字符开头时会加文本保护前缀，避免作为公式执行。
单项目最多处理两万份答卷，题目展开最多五百个变量，并受两百万数据格等规模限制；仅选择近期不一定绕过项目整体限制。任务繁忙时应稍后重试。SAV、DTA 为兼容文件，打开脚本不代表平台调用商业软件验证过结果；本原始数据包也不附带统计模型报告。
### 常见错误
- 把“有效完成”当作全部已人工通过，或用当前搜索结果推断实际下载样本。
- 将未选零值与未答缺失混同，忽略[人工清洗](#response-cleaning)后的状态；统计报告与复算材料参阅[分析导出](#analysis-export)。
---
# 团队成员、邀请与角色管理
按工作职责授权，公开文档和填写链接不替代后台账号。
## 成员管理入口
由拥有团队管理权限的所有者或管理员进入团队页面，邀请成员、调整角色或停用。邀请有效期通常为七天，过期后重新发送有效链接；邀请链接应只交给对应人员。
## 分工建议
| 工作 | 推荐角色 |
| --- | --- |
| 企业管理、成员和集成 | 所有者或管理员 |
| 建卷、改卷、发布 | 编辑者 |
| 查看答卷、分析与对应审核 | 分析员 |
| 只需了解问卷内容 | 查看者 |
所有者负责更完整的空间管理。平台管理员用于跨企业平台管理，与企业内部管理员不同，不能凭工作空间角色推断平台级权限。
## 邀请步骤
填写真实工作邮箱，选择角色，生成邀请后交给对应成员。成员注册或登录并接受邀请，进入指定工作空间。完成后核对成员列表与角色，再让成员用自己的账号检查可见项目和操作。
## 变更与离职
职责变化时及时调整角色或停用，不只是把项目负责人名字改掉。授权以服务端当前结果为准；被撤销的权限不能通过旧页面继续操作。共同使用同一个管理员账号会让责任和审计难以区分。
## 空间与文件交接
切换空间时数据和权限随之变化。导出的答卷文件已离开后台控制范围，应独立管理交接。文档中心公开可读，因此不要在产品文档里填入客户名单、API 密钥或受访者信息；此类内容只能在有权限的业务页面处理。
---
# 企业设置与免费使用
管理空间品牌、域名和使用情况，了解免费开放范围与角色权限。
## 企业设置
拥有空间管理权限的成员可修改企业名称、品牌说明和适用设置。空间标识用于识别，创建后不作为普通名称随意修改。保存后检查公开问卷的品牌展示，不只核对后台表单。
## 自定义域名
输入格式正确且未绑定其他企业的域名可以保存绑定信息，但真正可访问还需要完成域名解析、HTTPS 证书与服务配置。只在后台保存域名不代表已完成上线，联系平台管理员实施并从公网验收后再发给受访者。
## 免费使用
问卷系统统一免费开放。新注册账号、管理员创建的账号和已有账号都可直接使用问卷设计、逻辑配额、发布分享、分析导出、版本管理、团队协作及 API 集成，无需购买、开通试用或续期。平台不再按付费版本限制问卷数、团队成员数、版本数或月答卷量；工作台继续显示实际用量，便于管理项目。
## 权限与历史记录
免费使用仍按空间和成员角色授权。编辑者、分析员、查看者各自只能操作已授权的功能，客户账号不能访问平台管理员后台。项目的样本配额、限填规则、质控、文件大小校验等按项目设置和服务规则执行。历史订单留存供管理员核对，不能再通过旧购买链接创建订单或续期。现有账号、问卷和答卷继续保留。
## 审计与变更
空间配置、成员和集成等操作应由各自账号完成，重要变更前记录原因。配置错误时先恢复正确参数并检查功能，不直接删除业务数据。域名、API 和回调属于不同配置，修改其中一个不代表其他接入已同步改变。
---
# 问卷开放 API：密钥与只读数据接入
用独立授权读取当前工作空间问卷和答卷。
## 适用范围
在“API 与集成”创建密钥，按需要授权问卷读取 surveys:read、答卷读取 responses:read。密钥只在创建时显示一次，复制后保存到接收系统的安全配置中，不放在网页脚本、公开文档或浏览器地址栏。
## 正式站点的路径
外部调用使用正式站点的 /survey-api/v1 前缀。下面是接口范围，实际域名使用当前平台域名。
```text
GET /survey-api/v1/surveys
GET /survey-api/v1/surveys/{surveyId}
GET /survey-api/v1/surveys/{surveyId}/responses
Authorization: Bearer
```
## 最小接入步骤
1. 由有集成权限的成员新建只包含必要范围的密钥。
2. 先读取问卷列表，确认返回的是当前空间项目。
3. 选择测试问卷读取详情和答卷，核对题目、状态和数据结构。
4. 建立接收端同步与错误记录，再接入正式业务。
5. 密钥疑似泄露或不再使用时撤销，并更新对应接收系统。
## 权限与错误
无效或已撤销密钥不能使用，缺少答卷范围不能读取答卷。返回范围由密钥绑定空间决定，不能改问卷编号读取其他企业数据。接入失败先核对正式前缀、Bearer 头、密钥状态和授权范围。
## 与代理商 API 不同
这里是问卷平台的只读集成，不是样本运营台为代理商提供的接项目、生成会员入口接口。此处也不提供任意写入答卷的通用授权。需要事件通知时配置问卷 Webhook，并分别管理其签名密钥。
---
# 问卷 Webhook：可靠投递、自动重试与补发
从创建端点到验证签名、查看失败原因和补发事件，完成可追踪的答卷通知。
## 创建和验证端点
工作空间所有者或有集成管理权限的管理员进入“API 与集成”，填写端点名称与公网 HTTPS 地址。创建后签名密钥只完整展示一次，请妥善保管。配置接收端后点击“发送测试”，测试事件为 webhook.test，不生成正式答卷或占用样本量。
## 事件正文与签名
正常事件类型为 response.completed，与旧接口保持兼容，正文中的 response.status 区分 complete、screenout 和 quota_full，请勿把所有通知都当成有效完成。正文包含稳定的 id、事件名、创建时间及问卷和结果信息。X-Laishu-Event 为事件类型；X-Laishu-Delivery 为稳定投递 ID；X-Laishu-Attempt 为请求序号。使用签名密钥对原始 JSON 正文计算 HMAC-SHA256，再与 X-Laishu-Signature 中的十六进制值比较。不要先解析再重新序列化正文后验签。
## 失败处理
答卷与事件队列在同一事务保存。投递失败按 30 秒、2 分钟、10 分钟、1 小时、6 小时间隔退避，最多共 6 次。DNS 查询与 HTTP 请求分别最多等待 5 秒，接收端返回 HTTP 2xx 视为确认接收；重定向不会自动跟随。接收端应按投递 ID 去重，先可靠保存再返回成功，避免重试重复写入业务数据。服务重启后继续处理持久队列。
## 日志与人工补发
下方“投递记录”可按状态筛选、翻页，查看关联答卷、最近请求、HTTP 状态、错误、次数与下次重试时间。核对接收方后点击“立即重推”，原 ID 和正文不变。成功记录不能再次重推；旧版未保存正文的历史失败记录不能自动重建，需核对原答卷后另行处理。
## 暂停与权限
暂停端点会保留配置和投递历史，停止发起新请求；已在途请求可以完成。重新启用后继续处理未完成队列。仅当前工作空间具有集成权限的成员能查看和操作，其他团队不能访问记录。只允许公网地址，并检查 DNS 解析结果，不能配置到服务器内网或元数据服务。
---
# 官网需求表单：收件与跟进
用户在官网提交调研需求后，在问卷平台查看并管理跟进。
## 数据流转
官网的需求表单连接到指定工作空间，在问卷平台“官网需求”入口集中查看。用户填写姓名、公司、联系方式、需求、预算及同意说明等内容，提交成功后形成需求记录；并不自动变成一份新研究项目。
## 接收与处理
1. 进入配置了官网接入的工作空间，打开“官网需求”。
2. 按姓名、公司、需求或状态查找，展开原始需求。
3. 联系客户后修改为跟进中，记录内部跟进备注。
4. 达成合作或结束沟通后，按实际情况标记已结束。
5. 需要汇总交接时导出并核对范围，保管好联系方式。
## 权限分工
查看需求需要答卷查看权限；修改跟进信息需要问卷编辑权限。查看者不会因为能看问卷列表就获得需求详情。官网提交者只提交自己的需求，不获得后台记录或其他客户信息。
## 专用表单的维护
专用需求表单承担固定字段映射，关键结构受到保护。需要改官网字段、状态或路由时，由管理员核对前后端映射；不要把专用表单当普通问卷随意删除字段。暂停接收后官网应显示对应状态，恢复前重新核对。
## 成功、失败与通知
提交失败时先看页面提示，避免把未成功的内容误当作后台已收到。重试机制会处理适用的重复请求，但业务跟进仍要人工完成。当前没有默认自动短信或邮件通知功能，不能仅等短信来判断是否有新需求。
---
# 统计日期与免费使用说明
北京时间的统计口径，以及问卷平台免费开放后的账号、用量和历史数据处理。
## 时间与统计
工作台近七日回收、本月答卷和平台月度统计按北京时间（UTC+8）归日或归月。数据库保存原始 UTC 时间；统计口径不会修改历史答卷的提交时间。答题用时以时:分:秒展示，原始秒值继续用于导出和质控。跨月对比时应保持相同的筛选条件和业务口径，避免将不同范围的数据直接比较。
## 免费开放
问卷平台的功能统一免费使用，新账号无需试用开通，已有账号无需续期。问卷数量、成员数量、保存版本和月答卷量不再设付费额度。发布前仍应检查题目、甄别、配额、访问方式及质控设置；免费政策不会改变研究项目主动设置的样本条件。
## 数据、权限与历史记录
平台继续隔离不同企业的数据，按成员角色检查管理、编辑和查看权限。原有账号、问卷、答卷、审计和历史订单保留；历史订单不会被自动扣款，也不会再次用于付费开通或延长使用期。旧收藏中的账单页会返回工作台，旧购买接口不再创建订单。需要排查无法操作的问题时，先确认当前工作空间、账号状态和角色权限，再联系管理员核对服务情况。
---
# 常见问题与排查顺序
从权限、入口、配额和数据口径快速定位常见情况。
## 发布后还不能填
先确认正式链接而不是后台编辑地址，再看发布状态、开始截止时间、渠道暂停、访问方式与邀请凭证。仅电脑或仅移动的规则也可能拦截。截图应包含结果提示，不要只截空白区域。
## 明明有总剩余却提示满额
可能某个性别、年龄、地区或渠道分项已满。总量与每条命中的分项同时约束，其他渠道也会消耗项目名额。查看所有命中条件，不直接把项目总量上调解决一个分项问题。
## 选择答案后为什么没立即甄别
流程通常在下一页或提交时判断。需要早筛时，将筛选题必答并在后面加分页；显示条件只控制题目可见，不自动记录甄别结束。
## 为什么预览没有答卷
测试预览不保存正式答卷、不占配额。查看真实回收应使用正式入口并遵守测试安排。不要用反复正式提交调试必答逻辑，这会影响重复限制和业务数据。
## 为什么分析与报量不同
对齐问卷、时间、来源和质量范围，明确是否含待复核。专业分析还可能排除不适用题型和缺失案例，模型有效样本数不必等于有效完成总数。
## 图片或功能按钮没出现
图片先查地址是否公开可达，不能使用本机路径。按钮先查角色、空间和授权范围，再刷新页面确认资源。仅访问公开文档不会获得编辑或答卷权限。
## 联系管理员需要提供什么
提供问卷名称或编号、问题时间、入口类型、设备浏览器、复现步骤、预期与实际提示。用脱敏截图说明，不发送密码、密钥、专属链接凭证或完整个人信息到公共渠道。
---
# 当前功能范围与上线核对
清楚区分已可操作功能、需配置能力和仍待建设的需求。
## 本手册范围
本手册面向当前问卷系统的真实使用，覆盖题目设计、组合结构、逻辑、配额、发布回收、质控、渠道、分析和团队集成。页面文案和功能可能随更新变化，以实际角色可用入口和服务端提示为准。
## 需要额外配置的能力
自定义域名需要 DNS、证书和服务配置；Webhook 需要接收方服务可达；问卷与其他业务系统联通需要对应的凭据、协议映射和实际链路验收。保存配置不能证明第三方完成接入。
## 不应误认的能力
| 页面能力 | 当前边界 |
| --- | --- |
| 手机号、身份证格式题 | 格式校验，不是短信或实名验证 |
| 图片选项 | 公共图片地址展示，不是受访者文件上传 |
| 测验与解析 | 自动判分，不是监考或身份认证 |
| 研究助手建卷 | 规则模板草稿，不是开放大模型研究 |
| AI 统计解读 | 汇总证据与建议，不能证明因果 |
| 免费使用 | 无付费版本或试用到期；功能按角色授权 |
文件上传、手写笔迹采集和服务器限时自动交卷已接入编辑、填写和结果查看；具体限制见对应说明。微信/QQ 身份登录、短信验证、周期频率策略仍需建设或服务商接入，图片或文字题不能替代这些专门服务。
## 正式项目检查
确认角色和工作空间、内容与路径、各层配额、真实设备与网络、状态口径、数据导出和第三方通知。涉及客户协议时先用受控项目核对，不因界面按钮可点击就宣布整条商业流程已验收。
## 维护方式
重要需求应描述具体触发、期望结果和适用角色，再决定实现与验收范围。平台升级后阅读产品更新，并重新测试受影响的正式项目配置，保留持续研究的结构与口径说明。
---
# 产品更新与文档使用说明
了解当前版本覆盖的重点能力，以及搜索、链接、下载和打印方法。
## 2026 年 10 月功能梳理
当前文档覆盖 32 种题型与组合题、团队题库、标准答案计分、编辑大纲与依赖保护、显示条件组、标题答案和动态选项引用、逻辑预览、配额批量配置、渠道按比例分配、渠道与项目进度分享、设备限制、IP 地区质控及专业统计分析。最新补充电子问卷导入、最低样本目标、回收后清洗与原始数据多格式导出说明。
## 本次文档中心
问卷产品文档独立放在问卷系统，无需登录可访问。左侧按功能分类，中间为步骤与规则，右侧为本篇目录；手机使用目录按钮。搜索可用按钮或 Ctrl/Cmd K，并按功能、操作名称或问题关键词查找。
## 链接、下载与打印
文章支持复制链接，可定位到具体章节。下载完整手册得到本问卷系统的 Markdown 文件；打印本篇或完整手册可使用浏览器另存 PDF。完整手册只含问卷系统内容，不包含样本总后台内部说明。
## 反馈按钮
文章底部“有帮助 / 还需说明”只在当前浏览器保存反馈，不会自动生成客服工单或发送给员工。需要实际协助时，通过既有服务渠道联系管理员，并提供脱敏问题描述。
## 阅读顺序建议
新成员先看快速上手、工作空间和编辑器；设计者重点看题型、逻辑和预览；项目人员看配额、渠道和质控；研究人员看状态口径、变量编码与专业统计；管理员再看成员、域名、API 和官网需求接入。
## 更新原则
文档说明已确认的操作和边界，第三方接入以实际协议和验收结果为准。后续新增功能同步补充对应文章；阅读下载的离线副本时，留意更新时间，并优先以在线最新说明核对。