wjw-cli 0.1.0

package/references/project_json_structure_guide.md

@@ -0,0 +1,910 @@
+# 问卷网项目 JSON 结构生成指南
+
+> 本文档用于指导 AI 生成符合问卷网 API 要求的 `project_json` 数据结构
+
+---
+## 说明（wjw-cli 精简版）
+
+本文件从完整《问卷网项目 JSON 结构生成指南》中**仅保留与「每道题目 / 各题型」相关的章节**：题目通用字段、各 `en_name` 题型规则、预设信息题、考试测评题、题型速查、`option_list` 全局规则及线上下落对照。
+
+**项目级字段**（`title`、`type_id`、`p_type`、`welcome`、`survey_result` 等）与**完整问卷示例**请用 `wjw project create` 时由 CLI 组装或参考原 wenjuan-survey 仓库完整版文档。
+
+正文内原「见第十二节」等指代仍对应下文 **「线上下落 question_type 与 option_list 对照」** 一节。
+
+---
+
+## 三、题目通用结构
+
+每道题必须包含以下字段：
+
+```json
+{
+  "title": "题目文本",
+  "en_name": "QUESTION_TYPE_XXX",
+  "custom_attr": {},
+  "option_list": [
+    {"title": "占位选项", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `title` | string | ✅ | 题目内容 |
+| `en_name` | string | ✅ | 题型标识（见题型对照表） |
+| `custom_attr` | object | ✅ | 自定义属性（可为空对象 `{}`） |
+| `option_list` | array | ✅ | **非空**选项列表（**禁止** `[]`）；条数下限见第四节、第五章、第十一节、第十二节；**矩阵类题型**另有 **`matrixrow_list`**（见 §6 / §7） |
+
+### 选项结构 (option_list 元素)
+
+```json
+{
+  "title": "选项文本",
+  "is_open": false,
+  "custom_attr": {}
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `title` | string | ✅ | 选项内容 |
+| `is_open` | boolean | 否 | 是否允许填空（默认 false） |
+| `custom_attr` | object | 否 | 选项自定义属性 |
+
+---
+## 四、题型对照表及生成规则
+
+> **参考样例项目（线上下落）**：以下「`edit_project` 返回」字段来自问卷网编辑接口实测，用于与本地导入 JSON 的 **`option_list` 非空结构** 对照。  
+> - 普通问卷：`project_id` **`69d257be4d1e8d523899937b`**（`survey`，14 题）  
+> - 考试测评：`project_id` **`69d2570bef3af30a3376fd24`**（`assess`，15 题）  
+> - **矩阵评价（矩阵单选 + `matrixrow_list`）**：`project_id` **`69e4d0a6ef3af30a18db16c3`** — 请在本机登录后执行 `fetch_project` 拉取该题完整字段（行/列与 `question_type`）  
+> 汇总表见 **第十二节**。
+
+### 1. 单选题 (QUESTION_TYPE_SINGLE)
+
+**适用场景**：单选、下拉单选、判断题
+
+**规则**：
+- 必须有 2 个及以上选项
+- 选项存于 `option_list`
+
+**变体设置**：
+- 下拉单选：`custom_attr.disp_type = "dropdown"`
+- **判断题**：`custom_attr.disp_type = "judge"`。**须** `option_list` **2 条**（如「是」「否」）；**线上下落**为单选题 `question_type: 2`；测评需在选项上标 **`is_correct` / `score`**（与项目 `69d2570b…` 一致）。
+
+**线上下落（判断题，测评）**：`question_type: 2`，`custom_attr.disp_type: "judge"`，`option_list` 长度 **2**；正确项 `custom_attr.is_correct: "1"` 与分值，错误项可 `score: 0`。
+
+**导入 JSON 推荐（判断题 · 测评）**：
+```json
+{
+  "title": "判断题",
+  "en_name": "QUESTION_TYPE_SINGLE",
+  "custom_attr": {
+    "disp_type": "judge",
+    "show_seq": "on",
+    "total_score": 5
+  },
+  "option_list": [
+    {"title": "是", "is_open": false, "custom_attr": {"is_correct": "1", "score": 5}},
+    {"title": "否", "is_open": false, "custom_attr": {"score": 0}}
+  ]
+}
+```
+
+**示例（普通单选）**：
+```json
+{
+  "title": "您的性别是？",
+  "en_name": "QUESTION_TYPE_SINGLE",
+  "custom_attr": {},
+  "option_list": [
+    {"title": "男", "is_open": false, "custom_attr": {}},
+    {"title": "女", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+### 2. 多选题 (QUESTION_TYPE_MULTIPLE)
+
+**适用场景**：可多选的选择题
+
+**规则**：
+- 必须有 2 个及以上选项
+- 可通过 `custom_attr` 设置最少/最多选择数
+
+**custom_attr 可选值**：
+- `min_answer_num`: 最少选择数量
+- `max_answer_num`: 最多选择数量
+
+**示例**：
+```json
+{
+  "title": "您喜欢哪些颜色？（可多选）",
+  "en_name": "QUESTION_TYPE_MULTIPLE",
+  "custom_attr": {
+    "min_answer_num": 1,
+    "max_answer_num": 3
+  },
+  "option_list": [
+    {"title": "红色", "is_open": false, "custom_attr": {}},
+    {"title": "蓝色", "is_open": false, "custom_attr": {}},
+    {"title": "绿色", "is_open": false, "custom_attr": {}},
+    {"title": "其他", "is_open": true, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+### 3. 填空题 (QUESTION_TYPE_BLANK)
+
+**适用场景**：单行文本、多行文本输入
+
+**规则**：
+- **`option_list` 禁止为空数组 `[]`**：单行/多行填空均须 **至少 1 条**占位选项（常见 `title`「填空1」），并设置 `text_row`、`text_col`；**测评**中该选项常带 **`score`**（与项目 `69d2570b…` 一致）。
+- 通过 `custom_attr.blank_type` 区分单行/多行
+
+**custom_attr 可选值**：
+- `blank_type`: `"single"` (单行) | `"multiple"` (多行)
+
+**导入 JSON 推荐（与线上一致）**：单行/多行均带 **1 项** `option_list`，并设置 `text_row` / `text_col`；测评再加选项级 `score`。
+
+**示例**：
+```json
+// 单行填空（问卷）
+{
+  "title": "填空题",
+  "en_name": "QUESTION_TYPE_BLANK",
+  "custom_attr": {"blank_type": "single", "show_seq": "on"},
+  "option_list": [
+    {"title": "填空1", "is_open": false, "custom_attr": {"text_row": 1, "text_col": 20}}
+  ]
+}
+
+// 多行填空（须 1 项占位 + 行列）
+{
+  "title": "请留下您的建议：",
+  "en_name": "QUESTION_TYPE_BLANK",
+  "custom_attr": {"blank_type": "multiple", "show_seq": "on"},
+  "option_list": [
+    {"title": "填空1", "is_open": false, "custom_attr": {"text_row": 4, "text_col": 40}}
+  ]
+}
+
+// 测评填空（单空 + 分值）
+{
+  "title": "填空",
+  "en_name": "QUESTION_TYPE_BLANK",
+  "custom_attr": {"blank_type": "single", "show_seq": "on", "total_score": 5},
+  "option_list": [
+    {"title": "填空1", "is_open": false, "custom_attr": {"score": 5, "text_row": 1, "text_col": 20}}
+  ]
+}
+```
+
+---
+
+### 4. 多项填空题 (QUESTION_TYPE_MULTIPLE_BLANK)
+
+**适用场景**：多个填空项（如联系方式各字段）
+
+**规则**：
+- **`option_list` 禁止为 `[]`**；每个填空项作为 `option_list` 的一个元素（多项时通常 **≥2** 项）
+- 每个选项的 `title` 为填空项标签
+
+**示例**：
+```json
+{
+  "title": "请填写您的联系方式",
+  "en_name": "QUESTION_TYPE_MULTIPLE_BLANK",
+  "custom_attr": {},
+  "option_list": [
+    {"title": "手机号码", "is_open": false, "custom_attr": {}},
+    {"title": "电子邮箱", "is_open": false, "custom_attr": {}},
+    {"title": "微信号", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+### 5. 量表类题目 (`question_type: 50`，QUESTION_TYPE_SCORE)
+
+**适用场景**：普通打分、量表（两端文案/圆点等）、评价（星级+标签）、NPS 等。接口层 **`question_type` 均为 `50`**，靠 **`custom_attr.disp_type`**（或**不写** `disp_type`）、**`option_list` 条数**区分形态。
+
+**线上下证实例**（同一页三题对照）：项目 **`69fb1eb5ef3af3a7745c0e6b`** 的 `project_structure` 中「打分题 / 量表题 / 评价题」——创建新题时建议先 `project_structure` 拉该页再改文案与分值。
+
+#### 形态速查（创建 `question_struct` 时先选行）
+
+| 产品称呼 | `question_type` | 题目 `custom_attr` 要点 | `option_list` 条数 |
+|----------|-----------------|---------------------------|-------------------|
+| **普通打分题** | `50` | **不设** `disp_type`；`min_answer_num` / `max_answer_num` + **`magnitude_scale`**（常见 `1`） | **1** 占位（如「选项1」） |
+| **量表题** | `50` | **`disp_type: "scale"`**；`score_display`（如 `circle`）、`desc_left` / `desc_right`、`scale_tag`、`magnitude_scale` 等 | **1** 占位 |
+| **评价题**（星级+标签） | `50` | **`disp_type: "evaluation"`**；`open_eval: "on"`、`score_display`（如 `star`）、`base_on` 等 | **2**（见下文「评价题」小节） |
+| **NPS** | `50` | **`disp_type: "nps_score"`**；`min_answer_num: 0`、`max_answer_num: 10` 等 | **1** 占位 |
+
+> **勿与矩阵混淆**：下文 **§6 矩阵单选**是「多行×多列」的矩阵题（`question_type: 4`）；本节 **「评价题」** 指 **`disp_type: "evaluation"` 的单列星级+标签题**（`question_type: 50`），二者不同。
+
+#### 普通打分题（无 `disp_type`，`magnitude_scale`）
+
+刻度由 **`min_answer_num` / `max_answer_num` + `magnitude_scale`** 控制，**不写** `disp_type`；**`option_list` 仅 1 条占位**。
+
+```json
+{
+  "title": "打分题",
+  "question_type": 50,
+  "custom_attr": {
+    "min_answer_num": 1,
+    "show_seq": "on",
+    "max_answer_num": 5,
+    "magnitude_scale": 1
+  },
+  "option_list": [
+    {"title": "选项1", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+#### 量表题（`disp_type: "scale"`）
+
+典型字段：**`disp_type: "scale"`**、`score_display`（如 `circle`）、**`desc_left` / `desc_right`**（两端锚点文案）、`scale_tag`、`magnitude_scale`、`min_answer_num` / `max_answer_num`、`answer_score`（如 `off`）、`show_seq`。**`option_list` 仍 1 条占位**。
+
+```json
+{
+  "title": "量表题",
+  "question_type": 50,
+  "custom_attr": {
+    "scale_tag": 2,
+    "score_display": "circle",
+    "min_answer_num": 1,
+    "max_answer_num": 5,
+    "answer_score": "off",
+    "disp_type": "scale",
+    "desc_left": "非常不满意",
+    "magnitude_scale": 1,
+    "show_seq": "on",
+    "desc_right": "非常满意"
+  },
+  "option_list": [
+    {"title": "选项1", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+#### 评价题（`disp_type: "evaluation"`，星级 + 标签）
+
+- **`option_list` 固定 2 条**：第 1 条 **`title` 多为「分数」**，`custom_attr` 可为 `{}`；第 2 条 **`title` 多为「标签」**，在 **`custom_attr.label_data`** 内按分值 **`"1"`～`"5"`**（字符串键）配置每档的 **`label_list`**（可选标签文案数组）与 **`score_desc`**（该档简述）。
+- 题目 **`custom_attr`** 常见：`disp_type: "evaluation"`、`open_eval: "on"`、`score_display: "star"`、`base_on`（如 `service`）、`min_answer_num` / `max_answer_num`、`show_seq`。
+
+```json
+{
+  "title": "评价题",
+  "question_type": 50,
+  "custom_attr": {
+    "score_display": "star",
+    "max_answer_num": 5,
+    "base_on": "service",
+    "open_eval": "on",
+    "disp_type": "evaluation",
+    "show_seq": "on",
+    "min_answer_num": 1
+  },
+  "option_list": [
+    {"title": "分数", "is_open": false, "custom_attr": {}},
+    {
+      "title": "标签",
+      "is_open": false,
+      "custom_attr": {
+        "label_data": {
+          "1": {"label_list": ["态度冷淡", "推销多", "技术差"], "score_desc": "非常不满意"},
+          "2": {"label_list": ["速度慢", "仪表乱", "不专业"], "score_desc": "比较不满意"},
+          "3": {"label_list": ["无互动", "不积极", "业务不精"], "score_desc": "一般"},
+          "4": {"label_list": ["文明礼貌", "速度快", "较专业"], "score_desc": "比较满意"},
+          "5": {"label_list": ["热情好客", "敬业精神", "技能专业"], "score_desc": "非常满意"}
+        }
+      }
+    }
+  ]
+}
+```
+
+#### NPS（`disp_type: "nps_score"`）
+
+```json
+{
+  "title": "您向朋友或同事推荐我们的可能性有多大？",
+  "question_type": 50,
+  "custom_attr": {
+    "disp_type": "nps_score",
+    "show_seq": "on",
+    "min_answer_num": 0,
+    "max_answer_num": 10
+  },
+  "option_list": [
+    {"title": "选项1", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+**本指南要求**：`question_type: 50` 各形态 **`option_list` 不得为 `[]`**，条数见上文「形态速查」表。
+
+**如何避免「结构不准 / 与线不一致」**（自己拼 `question_create` / 导入 JSON 时）：
+
+1. **以线上回包为真**：同一环境下，**`project_structure` 或 `fetch_project` 里已有题目的 `question_struct`** 优于任何口头模板；新建或改题后若表现不对，**再拉一次结构**，对照 `custom_attr`、`option_list` 条数与字段名逐项对齐。  
+2. **先查本节「形态速查」表选对子类**：普通打分 / 量表 `scale` / 评价 `evaluation` / NPS 四选一，**不要混用**「无 `disp_type` 的多条分档 `option_list`」与线上下证结构。  
+3. **慎用「多条 1 分～5 分」式 `option_list` 代替量表**：与本节线上下证**不一致**；若答题页或统计异常，改回本节「普通打分 / 量表 / 评价」各小节推荐形态，或**在同一项目内复制已验证的一题**再改文案。  
+4. **文档滞后于产品**：若接口升级，仍以 **第 1 条** 拉回 JSON 为准。  
+5. **`option_list` 禁止 `[]`**：与本指南其它题型一致，量表类也必须带足占位条数。
+
+---
+
+### 6. 矩阵单选题 (QUESTION_TYPE_MATRIX_SINGLE)
+
+**适用场景**：矩阵单选（典型「满意度评价」：多**行**维度 × 多**列**等级）
+
+**规则（与编辑接口 / `fetch_project` 一致）**：
+- **`matrixrow_list`**：**矩阵行** = 评价维度（如「服务态度」「产品质量」），每项一条，**至少 1 行**；行内字段与 `option_list` 元素相同（`title`、`is_open`、`custom_attr`）。
+- **`option_list`**：**矩阵列** = 评价等级/刻度（如「非常不满意」～「非常满意」），**至少 2 列**。
+- **常见错误**：只写 `option_list`、不写 **`matrixrow_list`** —— 导入后往往只有「列」没有「行」，题面不完整或不符合预期；**矩阵满意度类题必须同时提供行、列两组列表**（参考项目 **`69e4d0a6ef3af30a18db16c3`**，请 `fetch_project` 对照）。**注意**：这与 **第四节 · 量表类 · `disp_type: "evaluation"` 的单列评价题**（`question_type: 50`、见上文）不是同一题型。
+- **线上下落**：`question_type: **4**`（见 `references/fetch_project.md`「题目类型代码」）。
+
+**示例**：
+```json
+{
+  "title": "请对以下方面进行满意度评价",
+  "en_name": "QUESTION_TYPE_MATRIX_SINGLE",
+  "custom_attr": { "show_seq": "on" },
+  "matrixrow_list": [
+    {"title": "服务态度", "is_open": false, "custom_attr": {}},
+    {"title": "产品质量", "is_open": false, "custom_attr": {}},
+    {"title": "物流速度", "is_open": false, "custom_attr": {}}
+  ],
+  "option_list": [
+    {"title": "非常不满意", "is_open": false, "custom_attr": {}},
+    {"title": "不满意", "is_open": false, "custom_attr": {}},
+    {"title": "一般", "is_open": false, "custom_attr": {}},
+    {"title": "满意", "is_open": false, "custom_attr": {}},
+    {"title": "非常满意", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+### 7. 矩阵多选题 (QUESTION_TYPE_MATRIX_MULTIPLE)
+
+**适用场景**：矩阵多选（行 × 列，每格可多选列）
+
+**规则**：
+- 与矩阵单选相同：**必须同时提供 `matrixrow_list`（行）与 `option_list`（列）**，语义同上。
+- **线上下落**：`question_type: **7**`（矩阵多选 / 部分场景下称矩阵打分，仍以接口返回为准）。
+
+**示例**：
+```json
+{
+  "title": "以下方面中，您使用过哪些？（可多选）",
+  "en_name": "QUESTION_TYPE_MATRIX_MULTIPLE",
+  "custom_attr": { "show_seq": "on" },
+  "matrixrow_list": [
+    {"title": "功能A", "is_open": false, "custom_attr": {}},
+    {"title": "功能B", "is_open": false, "custom_attr": {}},
+    {"title": "功能C", "is_open": false, "custom_attr": {}}
+  ],
+  "option_list": [
+    {"title": "从未使用", "is_open": false, "custom_attr": {}},
+    {"title": "偶尔使用", "is_open": false, "custom_attr": {}},
+    {"title": "经常使用", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+### 8. 排序题 (QUESTION_TYPE_SORT)
+
+**适用场景**：拖拽排序
+
+**规则**：
+- 选项为待排序项
+- 答题时用户拖拽调整顺序
+
+**示例**：
+```json
+{
+  "title": "请按喜好程度排序",
+  "en_name": "QUESTION_TYPE_SORT",
+  "custom_attr": {},
+  "option_list": [
+    {"title": "选项A", "is_open": false, "custom_attr": {}},
+    {"title": "选项B", "is_open": false, "custom_attr": {}},
+    {"title": "选项C", "is_open": false, "custom_attr": {}},
+    {"title": "选项D", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+### 9. 文字说明题 (QUESTION_TYPE_DESC)
+
+**适用场景**：问卷说明、段落文字
+
+**规则**：
+- 只显示文字，无需作答，但 **`option_list` 仍不得为 `[]`**
+- 使用 **至少 1 条**占位选项（与线上下落一致；`title` 可与说明文案一致或由后台展示逻辑决定）
+
+**示例**：
+```json
+{
+  "title": "以下是问卷说明，请注意阅读...",
+  "en_name": "QUESTION_TYPE_DESC",
+  "custom_attr": {},
+  "option_list": [
+    {"title": "说明", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+### 10. 下拉级联题 (QUESTION_TYPE_CASCADE)
+
+**适用场景**：省市区三级联动等
+
+**规则**：
+- `custom_attr.disp_type = "cascader"`
+- **`option_list` 禁止为 `[]`**：至少 **1 条**占位选项；级联选项数据多由平台加载，占位用于满足结构与编辑器一致。
+
+**注意（textproject 导入）**：占位过少或结构不完整时，实测可能落为 **`question_type: 8` 且无有效级联数据**，答题端出现「未找到结果」。**无官方级联数据源时**，不要用本题型凑「两个下拉」——应改为 **两道 `QUESTION_TYPE_SINGLE` + `disp_type: dropdown`**（见 `examples/template_survey_uzbzjvlxdv_clone.json` 修正方式）。
+
+**示例**：
+```json
+{
+  "title": "请选择您的地址",
+  "en_name": "QUESTION_TYPE_CASCADE",
+  "custom_attr": {"disp_type": "cascader"},
+  "option_list": [
+    {"title": "级联占位", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+### 11. 上传题 (QUESTION_TYPE_UPLOAD)
+
+**适用场景**：文件上传、图片上传
+
+**规则**：
+- 文件上传：`custom_attr.disp_type = "upload_file"`
+- 图片上传：使用 `QUESTION_TYPE_IMAGE_UPLOAD`，`custom_attr.disp_type = "image_upload"`
+- **线上下落**：`question_type: 95`，**各 1 条**选项；文件常见 `title`「选择文件上传」，图片常见「请上传图片」。测评场景题目上可有 `answer_score: "on"`、`upload_num`、`upload_size` 等（项目 `69d257be…`）。
+
+**导入 JSON 推荐**：
+```json
+// 文件上传
+{
+  "title": "请上传文件",
+  "en_name": "QUESTION_TYPE_UPLOAD",
+  "custom_attr": {"disp_type": "upload_file", "show_seq": "on"},
+  "option_list": [
+    {"title": "选择文件上传", "is_open": false, "custom_attr": {}}
+  ]
+}
+
+// 图片上传
+{
+  "title": "请上传图片",
+  "en_name": "QUESTION_TYPE_IMAGE_UPLOAD",
+  "custom_attr": {"disp_type": "image_upload", "show_seq": "on"},
+  "option_list": [
+    {"title": "请上传图片", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+### 12. 地址题 (QUESTION_TYPE_ADDRESS)
+
+**适用场景**：地址填写
+
+**规则**：
+- `custom_attr.disp_type = "address"`
+- **线上下落**：`question_type: 8`（与普通填空 6 不同），常见 **`drop_type: "address"`**，**固定 4 条**选项：`省份`、`城市`、`区/县`、`详细地址`（项目 `69d2570b…`）。
+
+**导入 JSON 推荐**：
+```json
+{
+  "title": "地址",
+  "en_name": "QUESTION_TYPE_ADDRESS",
+  "custom_attr": {"disp_type": "address", "drop_type": "address"},
+  "option_list": [
+    {"title": "省份", "is_open": false, "custom_attr": {}},
+    {"title": "城市", "is_open": false, "custom_attr": {}},
+    {"title": "区/县", "is_open": false, "custom_attr": {}},
+    {"title": "详细地址", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+**本指南要求**：地址题 **`option_list` 须为上述 4 项**，不得省略为 `[]`。
+
+---
+
+### 13. 手写签名题 (QUESTION_TYPE_SIGNATURE)
+
+**适用场景**：电子签名
+
+**规则**：
+- `custom_attr.disp_type = "signature"`
+- **线上下落**：`question_type: 95`，**1 条**选项（常见 `title`「填空1」）（项目 `69d257be…`）。
+
+**导入 JSON 推荐**：
+```json
+{
+  "title": "签名",
+  "en_name": "QUESTION_TYPE_SIGNATURE",
+  "custom_attr": {"disp_type": "signature", "show_seq": "on"},
+  "option_list": [
+    {"title": "填空1", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+### 14. 分页题 (QUESTION_TYPE_SPLIT_PAGE)
+
+**适用场景**：问卷分页
+
+**规则**：
+- `custom_attr.disp_type = "page_break"`
+- **`option_list` 禁止为 `[]`**：至少 **1 条**占位选项（常见 `title` 与线上一致即可）
+
+**示例**：
+```json
+{
+  "title": "分页",
+  "en_name": "QUESTION_TYPE_SPLIT_PAGE",
+  "custom_attr": {"disp_type": "page_break"},
+  "option_list": [
+    {"title": "分页", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+## 五、预设信息题（自动验证格式）
+
+| 题型 | en_name | 说明 |
+|------|---------|------|
+| 性别 | `QUESTION_TYPE_SEX` | 线上下落多为单选 `question_type: 2`，**2 项** 男/女 |
+| 手机 | `QUESTION_TYPE_MOBILE` | 常为填空 `6` + **1 项** + `checkmethod: mobile` |
+| 邮箱 | `QUESTION_TYPE_EMAIL` | 常为填空 `6` + **1 项** + `checkmethod: email` |
+| 日期 | `QUESTION_TYPE_DATE` | 线上下落多为 `question_type: 95` + **1 项** |
+| 时间 | 编辑器中的时间题 | 线上下落 `question_type: 95` + **2 项**（时/分），见 §5.2 |
+| 姓名 | `QUESTION_TYPE_NAME` | 填空 `6` + **1 项** |
+| 年龄 / 学历 | 编辑器预设 | 多为单选 `2` + **多条** 固定选项，见 §5.2 |
+| 学号 / 班级 / 部门 | 多用 `QUESTION_TYPE_BLANK` + `content_type` | 见 §5.3 |
+| 工号 | `QUESTION_TYPE_BLANK` + `disp_type: employee_id` 等 | 见 §5.3 |
+| 身份证 | `QUESTION_TYPE_ID_CARD` 或见 §5.1 推荐 | 身份证号格式校验 |
+
+**通用规则（导入 JSON）**：
+- **禁止** `option_list: []`；预设题须按 **§5.1～§5.4** 与 **第十二节** 使用**非空** `option_list`。
+- 手机/邮箱等须设置 `custom_attr.disp_type` 或选项级 `checkmethod`（见 §5.2）。
+
+### 5.1 身份证：线上下落结构（`edit_project` 返回）
+
+导入成功后，在编辑接口中「身份证号」题常见结构为 **填空题骨架 + 身份证校验**，而非单独枚举题型：
+
+| 位置 | 字段 | 典型值 | 说明 |
+|------|------|--------|------|
+| 题目 | `question_type` | `6` | 与填空题一致 |
+| 题目 | `custom_attr.content_type` | `"id_card"` | 标记为身份证控件 |
+| 题目 | `custom_attr.show_seq` / `total_score` | 视项目而定 | 与其它题一致 |
+| 选项（1 条） | `title` | 如 `"填空1"` | 占位展示文案，后台可改 |
+| 选项 | `custom_attr.checkmethod` | `"id_num"` | 触发身份证号校验 |
+| 选项 | `custom_attr.text_row` / `text_col` | 如 `1` / `10` | 输入框行列 |
+
+**导入 JSON 推荐写法（与线上一致）**：使用 **`QUESTION_TYPE_BLANK`**，并带上 **`content_type` + 单选项 + `checkmethod`**：
+
+```json
+{
+  "title": "身份证号",
+  "en_name": "QUESTION_TYPE_BLANK",
+  "custom_attr": {
+    "show_seq": "on",
+    "content_type": "id_card"
+  },
+  "option_list": [
+    {
+      "title": "身份证号",
+      "is_open": false,
+      "custom_attr": {
+        "checkmethod": "id_num",
+        "text_row": 1,
+        "text_col": 10
+      }
+    }
+  ]
+}
+```
+
+**关于 `QUESTION_TYPE_ID_CARD`**：不推荐单独依赖该枚举；若使用，**仍须**带 **至少 1 项** `option_list`（结构以 `fetch_project` 回包为准）。**表单类项目优先采用上一段 `QUESTION_TYPE_BLANK` 写法**。
+
+### 5.2 姓名 / 手机 / 邮箱 / 日期 / 时间 / 性别 / 年龄 / 学历（线上下落与推荐导入）
+
+以下线上下落字段来自项目 **`69d257be…`（问卷）**、**`69d2570b…`（测评）** 的 `edit_project` 实测。
+
+| 预设能力 | 典型 `question_type` | `option_list` 条数 | 题目 `custom_attr` 要点 | 选项 `custom_attr` 要点 |
+|----------|---------------------|-------------------|---------------------------|---------------------------|
+| 姓名 | `6`（填空） | **1** | `disp_type: "name"` | `text_row` / `text_col`；测评可加 **`score`** |
+| 手机 | `6` | **1** | `disp_type: "mobile"`，常配合 `blank_type: "single"` | **`checkmethod: "mobile"`** + 行列 |
+| 邮箱 | `6` | **1** | `disp_type: "email"` | **`checkmethod: "email"`** + 行列 |
+| 日期 | `95` | **1** | `disp_type: "date"` | 常为 `{}`；测评选项可带 **`score: 0`** |
+| 时间 | `95` | **2** | `disp_type: "time"` | 两条分别为「时」「分」，测评可各带 **`score`** |
+| 性别 | `2`（单选） | **2** | `disp_type: "sex"`，`content_type: "sex"` | 男/女；测评选项可带 **`score`** |
+| 年龄 | `2` | **多条**（如 7 档） | `disp_type: "age"`，`content_type: "age"` | 各档文案 + 测评 **`score`** |
+| 学历 | `2` | **多条**（如 6 档） | `disp_type: "education"`，`content_type: "education"` | 各档文案 + 测评 **`score`** |
+
+**导入 JSON 推荐示例（手机 · 单选项）**：
+```json
+{
+  "title": "手机",
+  "en_name": "QUESTION_TYPE_MOBILE",
+  "custom_attr": {"disp_type": "mobile", "blank_type": "single", "show_seq": "on"},
+  "option_list": [
+    {
+      "title": "填空1",
+      "is_open": false,
+      "custom_attr": {"checkmethod": "mobile", "text_row": 1, "text_col": 20}
+    }
+  ]
+}
+```
+
+**日期 / 时间（`QUESTION_TYPE_DATE` 等，线上下落为 `question_type: 95`）**：
+```json
+{
+  "title": "日期",
+  "en_name": "QUESTION_TYPE_DATE",
+  "custom_attr": {"disp_type": "date", "show_seq": "on"},
+  "option_list": [
+    {"title": "日期", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+时间题须 **2 项**：`{"title": "时", ...}`、`{"title": "分", ...}`（与样例项目一致）。
+
+### 5.3 学号 / 工号 / 班级 / 部门（测评常见，`question_type: 6`）
+
+线上下落均为 **1 条**占位选项，`title` 多为「填空1」，题目侧用 **`content_type`** 或 **`disp_type`** 区分（项目 **`69d2570b…`**）：
+
+| 题干场景 | 题目 `custom_attr` | 选项 `custom_attr`（测评） |
+|----------|-------------------|---------------------------|
+| 学号 | `content_type: "student_id"` | `score`、`text_row`、`text_col` |
+| 工号 | `disp_type: "employee_id"`，可配合 `blank_type: "single"` | 同上 |
+| 班级 | `content_type: "classes"` | 同上 |
+| 部门 | `content_type: "department"` | 同上 |
+
+**导入 JSON 推荐（学号示例）**：
+```json
+{
+  "title": "学号",
+  "en_name": "QUESTION_TYPE_BLANK",
+  "custom_attr": {"content_type": "student_id", "total_score": 0},
+  "option_list": [
+    {"title": "填空1", "is_open": false, "custom_attr": {"score": 0, "text_row": 1, "text_col": 10}}
+  ]
+}
+```
+
+### 5.4 地理位置多格（`disp_type: geographical_multiple_blank`）
+
+测评样例「所在位置」：**`question_type: 95`**，`custom_attr.disp_type: "geographical_multiple_blank"`，**3 条**选项，常见 `name_en` 为 **`address` / `longitude` / `latitude`**（项目 **`69d2570b…`**）。导入时宜按三格分别建 `option_list` 三项并在 `custom_attr` 中携带对应 `name_en`（若导入接口支持）。
+
+**示例**：
+```json
+{
+  "title": "所在位置",
+  "en_name": "QUESTION_TYPE_MULTIPLE_BLANK",
+  "custom_attr": {"disp_type": "geographical_multiple_blank", "total_score": 0},
+  "option_list": [
+    {"title": "填空1", "is_open": false, "custom_attr": {"name_en": "address"}},
+    {"title": "填空2", "is_open": false, "custom_attr": {"name_en": "longitude"}},
+    {"title": "填空3", "is_open": false, "custom_attr": {"name_en": "latitude"}}
+  ]
+}
+```
+
+**注意**：`edit_project` 中该题 `question_type` 为 **95**，与 `QUESTION_TYPE_MULTIPLE_BLANK` 的导入映射未必一致；若导入失败，以 **`fetch_project` 回包** 或官方模板为准调整 `en_name`。
+
+**预设题须非空 `option_list`（与 §5.2 一致）**：
+```json
+// 手机号（1 项 + checkmethod）
+{
+  "title": "您的手机号码",
+  "en_name": "QUESTION_TYPE_MOBILE",
+  "custom_attr": {"disp_type": "mobile", "blank_type": "single", "show_seq": "on"},
+  "option_list": [
+    {"title": "手机号", "is_open": false, "custom_attr": {"checkmethod": "mobile", "text_row": 1, "text_col": 20}}
+  ]
+}
+
+// 日期（1 项占位）
+{
+  "title": "请选择日期",
+  "en_name": "QUESTION_TYPE_DATE",
+  "custom_attr": {"disp_type": "date", "show_seq": "on"},
+  "option_list": [
+    {"title": "日期", "is_open": false, "custom_attr": {}}
+  ]
+}
+```
+
+---
+
+## 六、考试测评题（带正确答案）
+
+**适用场景**：考试、测验、知识竞赛
+
+**规则**：
+- `p_type` 必须为 `2`
+- `type_id` 使用考试测评类型
+- 每题设置 `custom_attr`：
+  - `calculation`: `"auto_score"` (自动计分)
+  - `answer_analysis`: 答案解析文本
+  - `answer_score`: `"on"` (开启计分)
+  - `total_score`: 题目总分
+- 选项设置 `custom_attr.is_correct`: `"1"` (正确) / `"0"` (错误)
+- 选项设置 `custom_attr.score`: 选项分值
+
+**单选题示例**：
+```json
+{
+  "title": "Python的创建者是？",
+  "en_name": "QUESTION_TYPE_SINGLE",
+  "custom_attr": {
+    "calculation": "auto_score",
+    "answer_analysis": "Python由Guido van Rossum于1991年创建",
+    "answer_score": "on",
+    "total_score": 10
+  },
+  "option_list": [
+    {"title": "Guido van Rossum", "is_open": false, "custom_attr": {"is_correct": "1", "score": "10"}},
+    {"title": "James Gosling", "is_open": false, "custom_attr": {"is_correct": "0"}},
+    {"title": "Brendan Eich", "is_open": false, "custom_attr": {"is_correct": "0"}},
+    {"title": "Dennis Ritchie", "is_open": false, "custom_attr": {"is_correct": "0"}}
+  ]
+}
+```
+
+**多选题示例**：
+```json
+{
+  "title": "以下哪些是Python的数据类型？",
+  "en_name": "QUESTION_TYPE_MULTIPLE",
+  "custom_attr": {
+    "calculation": "auto_score",
+    "answer_analysis": "list、dict、tuple是Python基础数据类型",
+    "answer_score": "on",
+    "total_score": 10
+  },
+  "option_list": [
+    {"title": "list", "is_open": false, "custom_attr": {"is_correct": "1", "score": "5"}},
+    {"title": "dict", "is_open": false, "custom_attr": {"is_correct": "1", "score": "5"}},
+    {"title": "tuple", "is_open": false, "custom_attr": {"is_correct": "1", "score": "5"}},
+    {"title": "array", "is_open": false, "custom_attr": {"is_correct": "0"}}
+  ]
+}
+```
+
+**填空题示例**：
+```json
+{
+  "title": "Python的输出函数是______",
+  "en_name": "QUESTION_TYPE_BLANK",
+  "custom_attr": {
+    "blank_type": "single",
+    "calculation": "auto_score",
+    "answer_analysis": "print是Python的输出函数",
+    "answer_score": "on",
+    "total_score": 5
+  },
+  "option_list": [
+    {"title": "print", "is_open": false, "custom_attr": {"is_correct": "1"}}
+  ]
+}
+```
+
+---
+
+---
+
+## 十、题型选择速查表
+
+| 需求描述 | en_name |
+|---------|---------|
+| 单选（圆点） | QUESTION_TYPE_SINGLE |
+| 下拉单选 | QUESTION_TYPE_SINGLE + disp_type: dropdown |
+| 判断题 | QUESTION_TYPE_SINGLE + disp_type: judge + **2 项**选项（是/否，测评带 `is_correct`/`score`） |
+| 多选（方框） | QUESTION_TYPE_MULTIPLE |
+| 单行填空 | QUESTION_TYPE_BLANK + blank_type: single |
+| 多行填空 | QUESTION_TYPE_BLANK + blank_type: multiple |
+| 多项填空（多个输入框） | QUESTION_TYPE_MULTIPLE_BLANK |
+| 普通打分（1～N 刻度） | QUESTION_TYPE_SCORE + **无** `disp_type` + **1 项**占位 + `magnitude_scale`（见 **第四节 ·5 量表类**） |
+| 量表题（圆点/两端文案） | QUESTION_TYPE_SCORE + `disp_type: scale` + **1 项**占位（见 **第四节 ·5**） |
+| 评价题（星级+标签） | QUESTION_TYPE_SCORE + `disp_type: evaluation` + **2 项**（分数+标签，`label_data`）（见 **第四节 ·5**） |
+| NPS评分（0-10） | QUESTION_TYPE_SCORE + disp_type: nps_score + **1 项** + min/max 0～10 |
+| 矩阵单选 | QUESTION_TYPE_MATRIX_SINGLE |
+| 矩阵多选 | QUESTION_TYPE_MATRIX_MULTIPLE |
+| 拖拽排序 | QUESTION_TYPE_SORT |
+| 文字说明 | QUESTION_TYPE_DESC |
+| 省市区级联 | QUESTION_TYPE_CASCADE + disp_type: cascader |
+| 文件上传 | QUESTION_TYPE_UPLOAD + disp_type: upload_file + **1 项** |
+| 图片上传 | QUESTION_TYPE_IMAGE_UPLOAD + disp_type: image_upload + **1 项** |
+| 地址填写 | QUESTION_TYPE_ADDRESS + disp_type: address + **4 项**（省/市/区/详细） |
+| 手写签名 | QUESTION_TYPE_SIGNATURE + disp_type: signature + **1 项** |
+| 日期 | QUESTION_TYPE_DATE + `disp_type: date` + **1 项**（见 §5.2） |
+| 时间 | 编辑器时间题 + `disp_type: time` + **2 项**（时/分，见 §5.2） |
+| 分页 | QUESTION_TYPE_SPLIT_PAGE + disp_type: page_break |
+| 性别 | QUESTION_TYPE_SEX + **2 项**（男/女，见 §5.2） |
+| 手机号 | QUESTION_TYPE_MOBILE + disp_type: mobile + **1 项** + `checkmethod: mobile` |
+| 邮箱 | QUESTION_TYPE_EMAIL + **1 项** + `checkmethod: email` |
+| 姓名 | QUESTION_TYPE_NAME + **1 项**占位（见 §5.2） |
+| 学号/工号/班级/部门 | 见 §5.3（多为 `QUESTION_TYPE_BLANK` + `content_type` / `disp_type`） |
+| 身份证 | **`QUESTION_TYPE_BLANK`** + `content_type: id_card` + **`option_list` 至少 1 项** + `checkmethod: id_num`（见 §5.1）；勿使用空 `option_list` |
+
+
+---
+
+## 十一、`option_list` 全局规则（禁止空数组）
+
+- **任何题目均不得使用 `option_list: []`**。须按题型填入第四节、第五章、第十二节规定的**最少条数**（单选/多选 ≥2、填空/上传/签名/日期等 ≥1、地址 4、量表见第四节 ·5、评价 2 项等）。
+- **文字说明、分页、级联**：虽不依赖选项答题，仍须 **至少 1 条**占位项以满足结构与线上下落一致（见 §9、§10、§14）。
+- 若对条数有疑问，以 **`project_structure` / `fetch_project` 回包** 为准复制再改文案。
+
+
+---
+
+## 十二、线上下落 `question_type` 与 `option_list` 对照（参考项目）
+
+以下为 **`GET …/edit_project/`** 返回中的典型形态，源项目：
+
+- **`69d257be4d1e8d523899937b`**（`survey`）
+- **`69d2570bef3af30a3376fd24`**（`assess`）
+- **`69fb1eb5ef3af3a7745c0e6b`**（`question_type: 50`：普通打分 / `scale` 量表 / `evaluation` 评价 三题对照）
+
+导入 JSON 的 `en_name` 与下列 **`question_type`（数字）** 为不同层级的标识，对照用于核对本地 **`option_list` 条数与字段** 是否与线上下落一致（**禁止**本地使用 `option_list: []`）。
+
+| 场景（题干示例） | `question_type` | `option_list` 条数 | 题目 `custom_attr` 要点 | 选项侧要点 |
+|------------------|-----------------|-------------------|---------------------------|------------|
+| 单行填空 | `6` | **1** | `blank_type: single` 等 | `text_row`、`text_col` |
+| 判断题 | `2` | **2** | `disp_type: judge` | `is_correct`、`score`（测评） |
+| 姓名 | `6` | **1** | `disp_type: name` | 行列；测评 `score` |
+| 手机 | `6` | **1** | `disp_type: mobile` | **`checkmethod: mobile`** |
+| 邮箱 | `6` | **1** | `disp_type: email` | **`checkmethod: email`** |
+| 学号 | `6` | **1** | `content_type: student_id` | 测评 `score` + 行列 |
+| 工号 | `6` | **1** | `disp_type: employee_id` | 同上 |
+| 班级 | `6` | **1** | `content_type: classes` | 同上 |
+| 部门 | `6` | **1** | `content_type: department` | 同上 |
+| 性别 | `2` | **2** | `disp_type: sex`，`content_type: sex` | 男/女；测评 `score` |
+| 年龄 | `2` | **多** | `disp_type: age`，`content_type: age` | 各档 + 测评 `score` |
+| 学历 | `2` | **多** | `disp_type: education` | 各档 + 测评 `score` |
+| NPS | `50` | **1** | `disp_type: nps_score`，`min/max_answer_num` | 占位项 |
+| 普通打分（如 1～5） | `50` | **1** | **无** `disp_type`；`min_answer_num` / `max_answer_num`，`magnitude_scale` 等 | 占位「选项1」 |
+| 量表题（`scale`） | `50` | **1** | `disp_type: "scale"`；`desc_left` / `desc_right`；`score_display` 等 | 占位项 |
+| 评价题（`evaluation`） | `50` | **2** | `disp_type: "evaluation"`；`open_eval`、`score_display` 等 | 第 2 项含 `label_data`（`"1"`～`"N"` 键） |
+| 文件上传 | `95` | **1** | `disp_type: upload_file` | `title` 如「选择文件上传」 |
+| 图片上传 | `95` | **1** | `disp_type: image_upload` | `title` 如「请上传图片」 |
+| 日期 | `95` | **1** | `disp_type: date` | 常为 `{}` |
+| 时间 | `95` | **2** | `disp_type: time` | 「时」「分」 |
+| 签名 | `95` | **1** | `disp_type: signature` | 占位「填空1」等 |
+| 地理三格 | `95` | **3** | `disp_type: geographical_multiple_blank` | `name_en`: address/longitude/latitude |
+| 地址（四级） | `8` | **4** | `disp_type: address`，`drop_type: address` | 省/市/区/详细地址 |
+
+**说明**：同一 `question_type: 95` 对应多种 UI，需以题目 **`custom_attr.disp_type`** 区分。同一 **`question_type: 50`** 对应多种量表 UI，需以 **`disp_type`（或省略）与 `option_list` 条数** 区分，详见 **第四节 · 题型表 · 第 5 类（量表类）**。身份证题见 **第五章 ·5.1**（`question_type: 6` + `content_type: id_card` + `checkmethod: id_num`）。