ai_member_xiaoyan/business_knowledge/interactive_component_reference.md

互动组件内容库参考

来源：飞书知识库「互动内容库」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 结构示例（对话互动）：

{
  "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 结构示例（听力拖拽）：

{
  "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. 核心互动需按子类处理：口语/听力/阅读/写作各有不同结构体

读取接口

# 获取表列表
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}"