# 互动组件内容库参考

> 来源：飞书知识库「互动内容库」43 个多维表格（bitable）
> Wiki 空间 ID: `7487521512283799556`
> 节点 token: `TbbGwZLIVizXeGkMEKQc2hKRnCc`
> 生成时间：2026-06-10

## 概述

互动内容库包含 **43 个多维表格**，覆盖全部 **42 种组件类型**（27 中互动 + 16 核心互动，写作互动与邮件组句共用 `core_writing_questionMakeSentence`）。

每个 bitable 按 Season/Unit 分表（L1-Demo、S0U0、S1U1~S1U12、S2、S3 等），包含实际生产数据。

### 数据读取方式

所有 bitable 通过飞书开放 API（Bot 身份）读取：
- API Base: `https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records`
- 需 tenant_access_token（有效期 2 小时）
- App ID: `cli_a931175d41799cc7`

---

## 一、中互动（27 种）

### 1.1 对话类（7 种）

| # | 名称 | cType | app_token | 字段数 |
|---|------|-------|-----------|--------|
| 1 | 对话互动 | `mid_sentence_dialogue` | `LhU4wpeNKi0uV0kPI8TclEpSnfd` | 20 |
| 2 | 对话朗读互动 | `mid_dialog_repeat` | `XOxewswJ4icydHk6ED8c8HOWnRb` | 18 |
| 3 | 对话表达互动 | `mid_dialog_express` | `BMyCwJDBvi4EckkkErFcQerrnOb` | 20 |
| 4 | 对话选择互动 | `mid_dialog_choose` | `Q8p2w8k0ui1DmikWiKYcYwGsnOd` | 18 |
| 5 | 对话选读互动 | `mid_dialog_select` | `R11ZwjwvOiLLxPkzYl6cD31fntz` | 18 |
| 6 | 对话挖空互动 | `mid_dialog_fillin` | `UoFdwE5BRiVZYUk3BdBcP1NPnWb` | 19 |
| 7 | 对话组句互动 | `mid_dialog_sentence` | `McS1wfB6UibdEVkKFZgceQl0nKb` | 19 |

**公共字段：**
```
ID, dataStatus, jsonData, kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 教研配置, 标题, 情境引入, 互动内容, 后置对话,
父记录, 角色物品配置, 隔离区
```

**差异字段：**
- 对话互动/表达/挖空/组句：额外有 `互动反馈`、`语音识别热词`
- 对话朗读/选择/选读：额外有 `资源配置`
- 对话互动独有：`学习意义构建`

**jsonData 结构示例（对话互动）：**
```json
{
  "cType": "mid_sentence_dialogue",
  "cId": "0500001",
  "title": "表达自己的感受",
  "sceneDesc": "...",
  "dialogList": [...],
  "feedback": {...},
  "postDialog": [...],
  "learningMeaning": "..."
}
```

---

### 1.2 信息类（6 种）

| # | 名称 | cType | app_token | 字段数 |
|---|------|-------|-----------|--------|
| 8 | 信息描写 | `mid_message_trace` | `UJq1wEn8pikOcpkWmHVcPbp3nrc` | 14 |
| 9 | 信息拼词 | `mid_message_spell` | `C7jnwPtShiaY74kZYgKcl5L7n6b` | 14 |
| 10 | 信息组句 | `mid_message_combine` | `T0mTwpwx8iBdA5k7CsYcnmLjndh` | 14 |
| 11 | 信息补词 | `mid_message_fillin` | `T1muwEylIiIjvBkU4fRc5dntnNt` | 14 |
| 12 | 信息填词 | `mid_message_word` | `RPI6wMCEribBuFkcQewcCavdnNf` | 14 |
| 13 | 信息填句 | `mid_message_sentence` | `HJ58wR5imixNBzkttticVYEanSb` | 14 |

**公共字段（14 个，完全统一）：**
```
ID, dataStatus, jsonData, kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 教研配置, 标题, 互动内容, 互动描述,
父记录, 角色物品配置, 隔离区
```

> ⚠️ 信息类 6 种目前数据均为"测试数据1"（ID: 0325001），尚未正式投产。

---

### 1.3 图片类（5 种）

| # | 名称 | cType | app_token | 字段数 |
|---|------|-------|-----------|--------|
| 14 | 图片互动 | `mid_vocab_image` | `QU1rwIIcgiucJjkq9TmcPZ1enSd` | 15 |
| 15 | 图片单选 | `mid_image_choose` | `EZ4Rw6kXeiVsTiko688cCMIkn3d` | 19 |
| 16 | 图片多选 | `mid_image_multiple` | `VqFcwLKa2iSbEFk2jZUceRtnnyf` | 18 |
| 17 | 图片有序 | `mid_image_sequence` | `K8CQwPudPiTccFkn76YcztEQnBg` | 18 |
| 18 | 图片拖拽 | `mid_image_drag` | `WfK6wRnKaiLcfUk41DgcAcnPnId` | 18 |

**公共字段：**
```
ID, dataStatus, jsonData, kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 教研配置, 任务标题, 情境引入, 互动内容,
互动反馈, 互动描述, 后置对话, 学习意义, 隔离区
```

**差异：**
- 图片互动独有：无 `角色物品配置`、`父记录`
- 图片单选独有：`角色物品配置`、`父记录`
- 图片多选/有序/拖拽：有 `角色物品配置`，无 `父记录`

---

### 1.4 其他中互动（9 种）

| # | 名称 | cType | app_token | 字段数 |
|---|------|-------|-----------|--------|
| 19 | 物品互动 | `mid_vocab_item` | `VkcIw2ajii87Z7kHKhEc443qnKe` | 13 |
| 20 | 材料互动 | `mid_sentence_material` | `NSjmwmASBiyPkBkdk2CcakKlnSd` | 16 |
| 21 | 指令互动 | `mid_vocab_instruction` | `YA8NwTcSbiR7yakFP4kcOmzbnlg` | 17 |
| 22 | 挖空互动 | `mid_grammar_cloze` | `GkzRwX4QGiAoZzkfiRrcV0svn1f` | 18 |
| 23 | 组句互动 | `mid_grammar_sentence` | `EJJiwsTQ7iYg0bkG2PEcjYfNnOd` | 17 |
| 24 | 填词互动 | `mid_vocab_fillBlank` | `UpSJwR6yJic8FTkn7b2chK4Nntc` | 15 |
| 25 | 语音互动 | `mid_sentence_voice` | `UMp0wGpruicY5skBAbrcC6Usnxc` | 19 |
| 26 | 造句互动 | `mid_sentence_makeSentence` | `I7mWwwWPVieCJLkhgU4cSr7XnPs` | 19 |
| 27 | 发音互动 | `mid_pron_pron` | `Zi9AwZb8LiMgtHk5xCXc0vuNnIb` | 15 |

**各类型特有字段：**

| 类型 | 特有字段 |
|------|---------|
| 物品互动 | `学习意义` |
| 材料互动 | `互动反馈`、`后置对话`、`学习意义构建`、`情境引入` |
| 指令互动 | `指令互动`、`指令反馈`、`后置对话`、`学习意义构建`、`情境引入` |
| 挖空互动 | `互动反馈`、`挖空整句`、`后置对话`、`学习意义构建`、`情境引入` |
| 组句互动 | `互动反馈`、`后置对话`、`学习意义构建`、`情境引入` |
| 填词互动 | `学习意义构建` |
| 语音互动 | `互动反馈`、`录音文本`、`后置对话`、`学习意义构建`、`情境引入` |
| 造句互动 | `互动反馈`、`后置对话`、`学习意义构建`、`情境引入` |
| 发音互动 | `学习意义构建`（注：kpListVoacb 拼写为 Voacb 非 Vocab） |

---

## 二、核心互动（16 种）

### 2.1 听力类（3 种）

| # | 名称 | cType | app_token | 字段数 |
|---|------|-------|-----------|--------|
| 28 | 听力拖拽 | `core_listening_drag` | `K3QrwQnWqiPBm1krhnNcWDTqnhe` | 28 |
| 29 | 听力选择 | `core_listening_choose` | `Kwrcw6A4jip2sxkdLn4czd1knvf` | 23 |
| 30 | 合作听力 | `core_listening_order` | `FrxtwNRQDizqiikPkATcBzTCnYe` | 24 |

**听力拖拽字段：**
```
ID, dataStatus, taskData, dialogList, questionList, learningData,
kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 专有名词, 互动描述,
听力材料, 学习过程, 学习过程配置, 开场语,
教研配置-互动配置, 教研配置-导览配置,
用户任务描述, 用户任务知识, 角色配置,
父记录, 隔离区, 题目
```

**听力选择字段：**
```
ID, dataStatus, taskData, questionGroup, learningData,
kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 专有名词, 互动描述,
学习过程, 学习过程配置,
教研配置-互动配置, 教研配置-导览配置,
用户任务描述, 用户任务知识, 角色配置,
父记录, 隔离区, 题目组
```

**合作听力字段：**
```
ID, dataStatus, taskData, textData, sequenceData, learningData,
kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 互动描述,
听力材料, 学习过程, 学习过程配置,
教研配置-任务, 教研配置-材料, 流程编排,
用户任务描述, 用户任务知识, 角色配置,
隔离区, 题目
```

**taskData 结构示例（听力拖拽）：**
```json
{
  "cType": "core_listening_drag",
  "cId": "1000113",
  "title": "收拾书包",
  "sceneDesc": "上学前，爸爸要和你一起收拾书包...",
  "key": [{"desc": "", "keyList": [{"type": "default", "content": "red", "desc": "adj. 红色的"}]}],
  "resourceMapping": {"Dad": 648},
  "cDesc": "You listened to Dad's instructions..."
}
```

---

### 2.2 阅读类（2 种）

| # | 名称 | cType | app_token | 字段数 |
|---|------|-------|-----------|--------|
| 31 | 合作阅读 | `core_reading_order` | `H6DJweNkpigCbak2Y5LcTZ8Vnfb` | 29 |
| 32 | 看图选词 | `core_reading_imageDrag` | `MVo7wugWfimJPIkxhJCcqppFnyf` | 20 |

**合作阅读字段：**
```
ID, dataStatus, taskData, textData, sequenceData, learningData,
kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 互动描述, 互动题目, 任务信息,
分界线, 学习材料, 学习材料格式化, 学习过程配置,
教研配置-任务, 教研配置-材料, 流程编排,
角色配置, 通关知识, 阅读材料, 阅读材料格式化
```

**看图选词字段：**
```
ID, dataStatus, taskInfo, questionGroup, studyInfo,
kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 专有名词, 互动描述,
分界线, 学习流程配置,
教研-互动配置, 教研-导览配置,
用户任务描述, 用户任务知识, 角色配置
```

---

### 2.3 口语类（6 种）

| # | 名称 | cType | app_token | 字段数 |
|---|------|-------|-----------|--------|
| 33 | 口语快答 | `core_speaking_reply` | `TSwcw0nFmi21khkpUndchNMsn6f` | 30 |
| 34 | 口语独白 | `core_speaking_monologue` | `G20HwcF1uideNokLsHWcBs3znvg` | 28 |
| 35 | 口语妙问 | `core_speaking_inquiry` | `GJUVwNSEkis3EXkrVj0ccbqdn8c` | 29 |
| 36 | 看图说话 | `core_speaking_image` | `KBOXwzVHfin6ORkKbA3c3eWEnoh` | 29 |
| 37 | 口语探讨 | `core_speaking_explore` | `HoidwhEBWiWjaokQnz0cHbhTn6e` | 27 |

**口语类公共字段：**
```
ID, dataStatus, taskData, configData, settingData, learningData,
kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 分界线,
用户任务描述, 用户任务知识, 角色配置,
语音识别热词, 通过规则
```

**各类型特有字段：**

| 类型 | 特有字段 |
|------|---------|
| 口语快答 | `exampleDialog`、`promptInfo配置`、`专有名词`、`任务背景`、`任务设定`、`学习流程配置`、`对话角色及回合设定`、`教研-任务规则与NPC设定`、`教研-用户视角任务信息`、`示例对话` |
| 口语独白 | `npclistData`、`npc站位列表`、`专有名词`、`互动描述`、`切分句数`、`学习流程配置`、`教研-任务信息`、`教研-独白配置`、`示例独白` |
| 口语妙问 | `exampleDialog`、`promptInfo配置`、`任务背景`、`任务设定`、`学习流程配置`、`对话角色及回合设定`、`教研-任务规则与NPC设定`、`教研-用户视角任务信息`、`知识库`、`示例对话`、`角色物品配置`、`隔离区` |
| 看图说话 | `imageInfo`、`optionList`、`questionList`、`专有名词`、`互动问题`、`学习流程配置`、`对话信息`、`教研-对话配置`、`教研-导览配置`、`示例对话` |
| 口语探讨 | `exampleDialog`、`promptInfo配置`、`任务背景`、`任务设定`、`学习内容`、`对话角色及回合设定`、`教研-任务规则与NPC设定`、`教研-用户视角任务信息`、`示例对话`、`角色物品配置`、`隔离区` |

---

### 2.4 写作类（5 种）

| # | 名称 | cType | app_token | 字段数 |
|---|------|-------|-----------|--------|
| 38 | 写作互动 | `core_writing_questionMakeSentence` | `DVkcwVr2giswTckcgD0cpHwNnv2` | 23 |
| 39 | 看图组句 | `core_writing_imgMakeSentence` | `BkmtwUBwMiHd5Ak7VS6ccE9SnHd` | 23 |
| 40 | 看图撰写 | `core_writing_imgWrite` | `KwPHwnaqdiWlvNkDm5fcFreDnQh` | 24 |
| 41 | 邮件组句 | `core_writing_questionMakeSentence` | `M5oTwUP6wiImC4kVJU8cRYnfnyf` | 23 |
| 42 | 邮件撰写 | `core_writing_questionWrite` | `Brn0wldKYizsLZkBqK6clp1tnKd` | 23 |
| 43 | 看图拼词 | `core_writing_imgMakeWord` | `QDyhwiY7PiSER8kHGZncDsrinde` | 17 |

**写作类公共字段（38-42）：**
```
ID, dataStatus, taskInfo, textInfo, studyInfo, evalInfo,
kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 分界线,
任务信息, 写作材料, 学习内容, 学习流程配置,
教研配置 - 任务信息, 教研配置 - 全文信息,
知识, 通过规则, 题目类型
```

**看图拼词字段（43，结构不同）：**
```
ID, dataStatus, taskInfo, imageInfo, questionList, preDialog, studyInfo,
kpInfo, kpListSentence, kpListVocab, kpStatus,
单元 Unit, 关联知识点, 分界线, 互动描述,
学习流程配置,
教研配置 - 任务信息, 教研配置-互动配置, 角色配置
```

> ⚠️ 写作互动（38）和邮件组句（41）共用 `core_writing_questionMakeSentence`，通过不同 app_token 区分。

---

## 三、数据覆盖情况

| 分类 | 数量 | 数据状态 |
|------|------|---------|
| 中互动-对话 | 7 | ✅ 全部有正式数据 |
| 中互动-信息 | 6 | ⚠️ 仅测试数据（ID: 0325001） |
| 中互动-图片 | 5 | ✅ 全部有正式数据 |
| 中互动-其他 | 9 | ✅ 全部有正式数据 |
| 核心互动-听力 | 3 | ✅ 全部有正式数据 |
| 核心互动-阅读 | 2 | ✅ 全部有正式数据 |
| 核心互动-口语 | 6 | ✅ 全部有正式数据 |
| 核心互动-写作 | 5 | ✅ 全部有正式数据 |
| **合计** | **43** | **37 有正式数据，6 仅测试数据** |

---

## 四、关键发现

1. **双轨数据**：每条记录同时有「教研配置」（人工可读 markdown）和结构化 JSON（`jsonData`/`taskData`/`textData`），内容一致格式不同
2. **中互动字段较统一**：14-20 个字段，`jsonData` 为核心结构体
3. **核心互动字段高度定制**：17-30 个字段，按类型有 `taskData`、`textData`、`configData`、`learningData` 等多个结构体
4. **信息类 6 种未正式投产**：仅有测试数据，字段结构已就绪
5. **写作/邮件共用 cType**：写作互动和邮件组句共用 `core_writing_questionMakeSentence`，通过不同 app_token 区分场景
6. **发音互动拼写异常**：`kpListVoacb`（应为 Vocab），可能是历史遗留

---

## 五、使用建议

### 作为 LLM 生成规范的 few-shot 源

1. **按 cType 匹配**：根据目标组件类型，从对应 bitable 取 1-2 条样例
2. **优先用 jsonData/taskData**：结构化 JSON 比教研配置更适合 LLM 理解
3. **中互动模板化程度高**：字段统一，few-shot 效果好
4. **核心互动需按子类处理**：口语/听力/阅读/写作各有不同结构体

### 读取接口

```bash
# 获取表列表
curl -s "https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/tables" \
  -H "Authorization: Bearer {tenant_access_token}"

# 获取记录（page_size 建议 1-3 条做 few-shot）
curl -s "https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records?page_size=3" \
  -H "Authorization: Bearer {tenant_access_token}"
```
