老师活动创建器

创建一次,用多种模板来教学。

从结构化课堂内容开始:题目、配对、分类、词汇、学习目标和老师备注。同一份已保存活动之后可以变成测验、配对游戏、分组分类、练习纸或作业。

练习纸入口连线

连线匹配 示例已加载

连线匹配 示例内容已加载到编辑器和预览中,你可以直接检查字段,而不是从空表单开始。

从练习纸入口进入,已加载练习纸风格内容,同时保留正常活动、作业和结果流程。

可玩项目
8 项
可复用模式
8 个可用

检查 连线 字段,然后把这份活动保存到活动库。

活动编辑器工作流交接

30 切片活动编辑器工作流交接,覆盖页面布局、流程导航、表单分段、AI 起草边界、来源素材安全、就绪检查、保存门槛和隐私防护。

工作流来源
editor.ts工作流步骤、锚点和隐私边界由活动编辑器领域统一负责。
步骤数量
5 个步骤工作流把老师编辑器保持为五个易扫读分段。
工作流顺序
frame -> ai-draft -> content -> source-materials -> review路由导航和表单分段使用同一个稳定步骤顺序。
创建页界面
创建页公开创建页从活动编辑器领域接收已准备好的工作流视图。
编辑页界面
创建/编辑表单拥有者重新打开活动编辑时复用同一套工作流分段。
流程导航
共享步骤导航流程导航使用与表单相同的步骤 id、锚点、标签和说明。
表单分段界面
ActivityCreateForm活动表单渲染已准备好的分段,而不是在组件里重新拼接步骤文案。
侧栏预览界面
模板 + 预览侧栏侧栏把模板入口上下文、输入结构帮助和实时预览放在编辑器旁边。
框架步骤
确定活动框架框架步骤确定标题、模板模式和示例起点。
主要字段
ActivityEditorPrimaryFields主要字段在脚手架、AI 或结构化内容编辑前让所选模板保持清晰。
模板交接
ActivityEditorTemplateHandoffView模板就绪证据会在框架步骤中作为隐藏语义交接继续可用。
脚手架面板
模板脚手架脚手架面板会把可复用课堂示例载入同一个编辑器合同。
AI 起草步骤
从素材起草AI 起草步骤把可选生成能力保留在普通活动编辑器内。
AI 来源状态
ActivityEditorAiDraftPanelViewAI 起草状态来自已准备好的面板视图,包含安全来源就绪状态和警告。
AI 来源同步
来源素材同步同步操作会把已附加素材引用转换成安全来源备注,不读取文件字节。
内容步骤
编辑可复用内容内容步骤在任何模板渲染前管理可复用课堂字段。
详情字段
ActivityEditorDetailsFields详情字段记录标题、描述、学科、年级、难度、语言、可见性和学习目标。
结构化内容字段
ActivityEditorStructuredContentFields结构化内容字段记录词汇、题目、配对、分组、来源摘要和老师备注。
来源素材步骤
附加来源素材来源素材步骤保留老师文件,作为来源记录和后续提取入口。
素材选择器
来源素材选择器来源素材选择器保持拥有者范围,只把安全素材引用传入编辑器。
检查步骤
保存前检查检查步骤把就绪检查放在最终保存动作旁边。
就绪面板
模板就绪状态就绪面板会在老师保存前确认哪些模板可游玩。
保存动作底栏底部保存栏仍然是活动编辑器唯一的持久化动作。
登录门槛
老师需登录未登录老师可以查看编辑器,但保存前必须先登录。
输入合同
CreateActivityInput所有保存和 AI 应用路径都继续经过共享的 CreateActivityInput 合同。
就绪合同
TemplateRemixPlan就绪检查使用与脚手架和兼容性视图相同的模板 remix 诊断。
AI 编辑器边界
草稿只填入编辑器AI 草稿可以填入编辑器供老师检查,但不能自行保存或发布。
来源隐私边界
私有素材隐藏已附加素材保留为私有来源记录,不会被编辑器工作流暴露给学生载荷。
发布边界
先保存再发布发布仍然是活动检查并保存之后的作业步骤。
隐私防护
私密课堂文本隐藏工作流交接只暴露结构、数量、分段名称和边界,不包含题干、答案、老师备注、原始输入、文件 id 或存储 key。
结构化编辑器连线匹配

创建可复用活动

步骤 1

确定活动框架

先命名活动、选择课堂模式,需要时加载一份完整示例。

词汇翻译、术语定义、因果关系

模板设置交接

选中模板、示例覆盖度和当前字段准备度的语义交接。

主模板
连线匹配学生在练习纸式流程中,把提示与匹配答案连起来。
模板徽章
连线短模板名让编辑器中的徽章、卡片和准备度列表保持稳定。
课堂模式
个人练习选中的模板决定课堂互动方式,但不改变共享的活动输入契约。
必需内容
配对项这些字段类型是渲染选中模板前必须具备的内容。
选中模板准备度
连线已选中且可用。当前结构化编辑字段会通过与已保存活动相同的确定性改模板模型解析。
模板可用性
8 个可用保存后,同一份结构化内容可以变成多个 Wordwall 风格活动格式。
可复用模式
测验、配对、连线、分类、填空、听力、翻牌和开箱已可用模式可在保存后使用当前结构化内容。
建议改编
测验、配对、分类、填空、听力、翻牌和开箱建议改编会排除当前选中的模板,并可成为确定性草稿变体。
未解锁模板
0 个未解锁未解锁模式只列出缺少的结构化字段,不暴露老师草稿文本。
未解锁模板
添加题目、配对或分组,以解锁可玩的模板。未解锁模式只列出缺少的结构化字段,不暴露老师草稿文本。
测验选项准备情况
4/4 道题已准备每道测验题应有 4 个可玩的选项。AI 干扰项生成接入前,缺少的干扰项可以先从同组答案和词汇中确定性补齐。
加载示例内容
连线匹配 示例已加载。加载示例会填充结构化编辑字段,但保存前仍需要老师检查。
可玩项目
8 个可玩项目示例覆盖度
可复用模式
8 个模式可用示例覆盖度
可复用示例覆盖度
可用加载的示例应展示一个可复用活动跨所有模板族使用。
题目
4 道题每行一个题目。用竖线分隔题干、答案、可选选项和可选解析。答案字段内可用 / 或 ; 表示可接受答案变体。
配对项
8 个配对用于单词配对、连线和翻牌配对模板。
分组
3 个分组用于拖拽分类和类别排序。
词汇
8 个词汇用逗号、分号或换行分隔词汇。
老师备注
2 条备注每行一条备注。
共享编辑契约
共享结构化输入每个模板都使用同一套题目、配对、分组、词汇和备注结构化活动输入。
内容解析状态
结构化字段已解析编辑器会确认当前结构化字段能否被解析,再信任模板准备度。
题目
4 道题题目数量来自已解析的编辑器行,不暴露题干、答案、选项或解释。
配对项
8 个配对配对数量来自已解析的编辑器行,不暴露配对任一侧文本。
分组
3 个分组分组数量来自已解析的编辑器行,不暴露分类名或项目文本。
词汇
8 个词汇词汇数量来自已解析的编辑器行,不暴露词汇文本。
老师备注
2 条备注老师备注数量来自已解析的编辑器行,不暴露备注正文。
保存示例前
3 个检查步骤示例检查清单会让老师先完成编辑、准备度确认和保存,再用于课堂。
保存边界
先保存再发布学生链接仍然是保存可复用活动之后的发布步骤。
隐私保护
私有编辑文本隐藏交接只暴露标签、数量、状态和边界,不暴露老师草稿文本或答案。
连线连线匹配 设置

学生在练习纸式流程中,把提示与匹配答案连起来。

需要配对项
示例覆盖度8 个可玩项目8 个模式可用
4 道题8 个配对3 个分组8 个词汇2 条备注
测验配对连线分类填空听力翻牌开箱

保存示例前

  • 检查字段。保存前检查生成的题目、配对、分组、词汇、学习目标和老师备注。

    检查字段

    去检查字段

    保存前检查生成的题目、配对、分组、词汇、学习目标和老师备注。

  • 检查可用模式。使用准备度面板确认哪些模板已经可玩,哪些字段仍需补充内容。

    检查可用模式

    查看准备度

    使用准备度面板确认哪些模板已经可玩,哪些字段仍需补充内容。

  • 保存前编辑。把示例当作起点:先按自己的课堂编辑,再保存为可复用活动。

    保存前编辑

    继续编辑

    把示例当作起点:先按自己的课堂编辑,再保存为可复用活动。

步骤 2

从素材起草

粘贴课堂备注、同步安全来源素材,或生成一份可由老师检查的草稿。

AI 草稿边界交接

30 切片 AI 草稿边界交接,覆盖登录生成、安全来源凭证、编辑器复核、不自动持久化、草稿覆盖度和隐私守卫。

来源面板
AI 草稿面板可见 AI 来源面板是生成前的老师复核界面。
生成门禁
已阻止当前来源、登录状态和生成中状态共同决定生成操作是否就绪。
登录边界
已登录操作生成仍会先经过已登录的活动草稿 server function,然后才可能改变编辑器字段。
Server function
generateActivityDraft客户端只调用一个 server function,不会直接持久化活动行。
输入 schema
generateActivityDraftInputSchema草稿请求会通过共享 generateActivityDraft 输入 schema 校验。
题目数
5 个项目请求的项目数量会先被限制在允许范围内,再进入草稿服务。
生成目标
均衡活动选中的生成目标会随请求发送,并作为生成来源展示。
模板
连线匹配选中的主模板会保留在草稿请求和结果边界中。
来源净化
来源已净化老师来源备注会先规范化,素材备注内容也会先净化再组装 prompt。
安全来源
0 个安全来源只有安全的素材类型和文件名凭证可以进入 AI prompt。
已省略来源
已省略 0 个来源不安全、重复或不完整的素材备注只统计数量,具体内容保持隐藏。
文件字节守卫
字节已省略这个草稿生成边界不会读取已附加课堂文件的字节内容。
存储 key 守卫
存储已隐藏存储 key、URL、路径片段、查询令牌和权限元数据都不会进入草稿请求或交接值。
生成来源
等待草稿生成来源会区分 Workers AI 输出和确定性兜底草稿。
模型
@cf/meta/llama-3.2-3b-instruct模型来源会显示,但不展示原始供应商输出。
兜底路径
兜底可用缺少凭据、JSON 无效或输出不完整时,会先回退到确定性本地草稿,再进入编辑器复核。
JSON 边界
Schema 已约束供应商输出必须解析成预期草稿形状,否则回退到本地生成器。
本地补全
无提示供应商返回的部分草稿可以由本地补全,确保必需课堂结构仍然存在。
输入契约
CreateActivityInputAI 输出会转换成编辑器保存时使用的同一个 CreateActivityInput 契约。
复核模式
editor-review草稿应用模式保持为编辑器复核,不会直接持久化。
持久化
not-persisted生成草稿在老师保存活动前保持未持久化。
老师复核
必需老师必须检查生成内容、答案、解析和就绪度后再保存。
编辑器应用
等待中只有带有预期 review state 的可复核草稿结果,才能应用到编辑器字段。
保存边界
老师稍后保存草稿只会填充编辑器字段;保存仍是老师的显式操作。
发布边界
稍后发布生成不会发布作业链接;老师保存活动后再单独发布。
覆盖度
等待中覆盖度只汇总生成的题目、配对、分组、词汇和备注数量,不展示草稿文本。
模板就绪度
等待中可用与锁定模板数量来自确定性就绪度,不来自 AI 自称。
测验选项
等待中测验选项就绪度只做汇总,不展示题干、选项或答案。
生成提示
无提示兜底或本地补全提示只做汇总,不展示原始供应商错误。
隐私防护
已省略私密数据此交接会省略来源文本、草稿文本、题干、选项、答案、老师备注、文件 ID、存储 key、文件字节、被省略备注内容和原始供应商输出。
AI 草稿老师保存前先检查

AI 草稿只使用下方文本和安全的来源素材记录。

只添加素材类型和安全文件名。

来源已准备好

487/2000 字符

来源里已有老师提供的文本,可以用于生成 AI 草稿。

均衡生成题目、配对、分组、词汇和备注,方便复用。

选择草稿在保存活动前要生成多少个可由老师检查的题目。

登录后才能生成 AI 草稿。

步骤 3

编辑可复用内容

整理题目、配对、分组、词汇和备注,让所有模板都读取同一份可复用内容。

用逗号、分号或换行分隔词汇。

每行一个题目。用竖线分隔题干、答案、可选选项和可选解析。答案字段内可用 / 或 ; 表示可接受答案变体。

用于单词配对、连线和翻牌配对模板。

用于拖拽分类和类别排序。

每行一条备注。

步骤 4

附加来源素材

附加私有课堂文件作为来源记录,后续可提取,但不会暴露给学生。

来源素材

把已上传的音频、练习纸图片、文档或表格关联到这份草稿,后续可用于 AI 提取和编辑。学生作业不会暴露这些文件引用。

已附加 0 个

来源素材选择器交接

来源素材选择器的 30 切片契约,覆盖归属范围、加载状态、附加上限、附加/移除控件、上传入口、元数据摘要、AI 提取就绪和私有文件边界。

归属范围
当前老师选择器只处理当前老师拥有的课堂文件。
存储加载门禁
需要登录加载门禁会把课堂文件查询限制在已登录老师工作区之后。
选择器状态
未登录选择器状态会在控件渲染前从登录、加载、错误、空列表和可用状态解析。
已选择数量
0已选择数量会先按来源素材 key 规范化、去重并裁剪,再进入编辑器。
可用数量
0可用数量来自当前选择器视图返回的老师自有课堂文件。
可见可用列表上限
有界列表可用文件列表会保持有界,避免大型来源素材库拖慢编辑器选择器。
附加数量上限
最多 12 个文件附加数量上限会让编辑器里的 ActivityContent 来源素材引用保持有界。
数量上限门禁
未达上限当活动达到来源素材上限后,限制门禁会禁用新的附加操作。
已附加摘要
0已附加摘要只报告提取能力家族,不暴露老师文件名或文件 ID。
已附加项目
0已附加项目数量来自规范化后的 ActivityContent 来源素材引用。
可用项目
0可用项目行始终是老师专用文件选择,不会复制进学生运行时载荷。
已选择状态
0已选择状态数量标记当前草稿已经附加的可用文件行。
附加操作
0附加操作只把来源素材引用加入草稿,不读取文件内容,也不会发布任何内容。
禁用的附加操作
0附加操作禁用只来自素材已选择或活动级附加数量上限。
移除操作
仅引用变更移除操作只会从活动草稿移除来源素材引用,不会删除已上传文件。
上传入口
上传文件上传入口会把老师带到来源素材库,而不是在活动编辑器里直接创建文件。
加载状态
未生效加载状态会在文件行渲染前描述正在等待的老师自有文件查询。
错误状态
未生效错误状态会说明文件加载失败,同时不泄露 provider 错误或存储细节。
空状态
未生效空状态会告诉老师当前还没有可用的自有课堂文件。
未登录状态
当前生效未登录状态会阻止文件加载,并引导老师登录后再附加课堂素材。
素材类型元数据
类型和 basename素材类型元数据会驱动音频、练习纸、表格和仅引用摘要。
Content-Type 元数据
已规范化 Content-TypeContent-Type 元数据用于素材分类规范化,而不是作为私有文件内容信任。
大小元数据
已舍入大小大小元数据会被四舍五入为仅显示摘要,并不代表读取文件内容。
来源素材引用
ActivityContent.sourceMaterials已附加项目会把紧凑引用写入 ActivityContent.sourceMaterials。
AI 提取就绪
0选择器会汇总已附加音频、练习纸和表格能力,供后续老师审核的 AI 提取使用。
学生载荷边界
运行时文件列表隐藏学生作业载荷只接收净化后的运行时题干和选项,而不是老师的来源素材列表。
文件 ID 边界
文件 ID 隐藏即使附加/移除操作内部使用文件 ID,语义交接也不会暴露文件 ID。
文件名显示边界
仅老师可见 basename老师可见 basename 可以显示在选择器行中,但交接本身只报告数量和边界。
存储键边界
存储信息隐藏存储键、URL、查询 token 和权限元数据都留在服务端,不进入选择器语义。
隐私边界
私有数据隐藏该交接隐藏文件内容、文件 ID、存储键、权限元数据、学生载荷文件引用和原始私有文件名。

已附加素材

最多 12 个文件

这份活动还没有附加课堂文件。

可用课堂文件

上传文件

登录后可把课堂文件附加到已保存活动。

步骤 5

保存前检查

检查可游玩的模板模式,确认结构准备好后再保存给学生使用。

模板可用性

保存后,同一份结构化内容可以变成多个 Wordwall 风格活动格式。

8 个可用
测验配对连线分类填空听力翻牌开箱

测验选项准备情况

每道测验题应有 4 个可玩的选项。AI 干扰项生成接入前,缺少的干扰项可以先从同组答案和词汇中确定性补齐。

4/4 道题已准备

1. 哪个词表示红色或绿色水果?

显式选项充足

题目行里已经写好 4/4 个选项。

候选来源:2 个同组答案,2 个词汇。

2. 哪种饮品是白色的?

显式选项充足

题目行里已经写好 4/4 个选项。

候选来源:2 个同组答案,2 个词汇。

3. 哪种食物常从碗里吃?

显式选项充足

题目行里已经写好 4/4 个选项。

候选来源:1 个同组答案,3 个词汇。

4. 哪个物品可以装饮品?

显式选项充足

题目行里已经写好 4/4 个选项。

候选来源:2 个同组答案,2 个词汇。

测验选项生成交接

用于补齐测验干扰项的老师审核交接,确保不脱离共享题目选项结构。

适用范围
保存前编辑器
该交接用于老师保存活动前的编辑器和 AI 草稿检查。
目标选项
4
测验运行时和准备度检查使用的每题可玩选项目标数。
题目
4
进入选项补齐契约的测验题数量。
已就绪题目
4
确定性补齐后已经拥有足够可玩选项的题目。
显式已就绪
4
无需本地补齐就已经具备足够显式选项的题目。
本地可补齐
0
可通过本地确定性候选补齐到目标选项数的题目。
需要候选项
0
仍需要更多显式选项、词汇或老师认可的 AI 干扰项的题目。
显式选项
16
老师编写或 AI 草稿题目行中已经存在的选项数。
本地选项
0
未来接入 AI 干扰项前,由同组答案或词汇确定性补入的选项数。
缺少选项
0
所有测验题达到目标选项数前仍缺少的选项数。
同组候选项
7
从其他题目答案中收集的候选干扰项数量;这里不暴露答案文本。
词汇候选项
9
从课堂词汇中收集的候选干扰项数量;这里不暴露词汇文本。
候选来源
16
从同组答案和词汇中统计到的安全候选选项总数。
答案已覆盖
4
已完成的可玩选项中包含规范化答案的题目数。
缺少答案
0
完成后的选项列表仍未包含规范化答案的题目数。
选项结构
ActivityQuestionOption[]
生成的干扰项必须规范化为老师手写选项所使用的同一组选项对象。
生成模式
当前确定性,后续 AI
当前补齐是确定性的;后续 AI 干扰项也必须写入同一个目标。
写入目标
题目选项
AI 干扰项输出必须写回已有题目选项数组。
老师检查
保存前检查
老师仍需在编辑器中检查选项后才能保存或发布。
发布边界
保存后发布
发布仍需要先保存已检查活动,再创建作业快照。
已完成选项
16
显式选项和本地确定性补齐后可用的可玩选项总数。
显式答案
4
本地补齐前,显式选项种子中已经包含规范化答案的题目数。
有候选项题目
4
至少拥有一个确定性的同组答案或词汇候选项的题目数。
候选去重
唯一候选项
同组答案和词汇候选项会先去重,再成为可玩选项。
候选规范化
共享选项规范化
候选文本使用与老师手写选项相同的显示和键值规范化规则。
稳定排序
题目种子排序
本地干扰项会按题目种子稳定排序,让重复渲染保持同一组选项。
运行时选项来源
buildQuestionChoices
测验运行时和准备度检查会在任何未来 AI 层介入前使用同一个确定性补齐 helper。
答案保护
答案已保留
添加任何干扰项前,每个已完成选项列表都会先放入规范化答案。
空内容保护
已有题目
空内容或非测验编辑器内容仍输出安全的零数量交接,不暴露草稿文本。
隐私保护
选项文本隐藏
交接只暴露数量和边界,不暴露题干、选项、答案、词汇文本或未来原始 AI 输出。

保存后的活动会出现在老师工作台,之后可以发布为作业。

登录后保存

课堂控件语义交接

课堂控件语义的 30 切片契约,覆盖准备好的帮助文本、路由状态控件、结果范围、打印控件、学生提交控件和隐私边界。

AI 来源文本框
已准备控件
来源文本框在生成前关联安全、就绪、素材能力和已同步来源说明。
AI 安全来源说明
已准备说明
AI 来源文本框由安全来源说明描述,老师可知道只会使用已审核笔记和安全来源信息。
AI 来源就绪
已准备说明
来源就绪状态说明示例文本、老师提供的笔记、已同步素材来源信息和文本长度状态。
AI 素材安全
已准备说明
来源素材安全指标说明安全和已省略的来源信息,同时不暴露省略内容。
AI 来源能力
已准备说明
已附加素材能力卡片根据安全素材元数据说明音频、练习纸和表格就绪状态。
AI 已同步来源
已准备说明
已同步素材笔记被描述为安全类型和文件 basename 来源信息,而不是文件 ID、存储键或文件内容。
AI 焦点控件
已准备控件
AI 草稿焦点选择器关联当前焦点说明,让老师知道草稿会如何成形。
AI 生成操作
已准备控件
生成操作在发起 AI 草稿请求前由来源就绪状态和任何禁用原因描述。
AI 草稿摘要
语义区域
草稿摘要会在持久化前把 provider、model、审核门禁、覆盖情况、来源安全和保存边界作为语义输出。
活动来源筛选
路由状态
活动来源素材筛选使用准备好的筛选说明和 URL 状态,让老师在列表更新前理解来源范围。
作业状态筛选
路由状态
作业状态筛选在路由状态变化前由当前生命周期范围和准备好的数量说明描述。
发布标题字段
已准备控件
作业标题字段被描述为课堂链接、结果和导出的上下文,但不暴露已输入标题。
发布说明字段
已准备控件
说明字段被描述为冻结到学生 runner 和可打印练习纸中的学生可见指引。
发布尝试次数字段
已准备控件
最大尝试次数字段由共享尝试次数解析器和不限次数说明描述。
发布计时字段
已准备控件
计时字段在保存设置前由共享计时解析器和无时间限制说明描述。
发布关闭时间字段
已准备控件
关闭时间字段由共享关闭时间解析器和开放链接说明描述。
发布投放开关
已准备控件
收集姓名、显示答案和打乱题目开关都关联准备好的投放规则说明。
发布预览区域
语义区域
发布预览会在创建快照前组合投放状态、规则统计、设置摘要和审核清单。
结果学生搜索
路由状态
学生搜索控件由搜索规则、匹配记录摘要和已调整状态描述。
结果学生排序
路由状态
学生摘要排序控件由当前扫描顺序说明和已调整状态徽章描述。
结果题目排序
路由状态
题目表现排序控件由当前排序说明和已调整状态徽章描述。
结果答案复盘筛选
路由状态
答案复盘筛选由当前复盘模式和默认或已调整状态描述。
结果复盘范围
语义区域
复盘范围面板把搜索、排序、筛选、匹配记录和复制范围摘要组合为语义输出。
结果复制范围
语义区域
复制预览和复制操作在复制材料前关联当前复盘范围摘要。
结果 CSV 覆盖
语义区域
CSV 导出覆盖范围独立于当前结果筛选,说明整份作业导出范围。
打印答案开关
已准备控件
可打印答案开关在附加答案前关联答案权限状态、老师专用说明和 URL 状态。
打印操作
已准备控件
打印操作由准备好的打印摘要描述,让讲义边界在打印前保持清楚。
学生身份输入
已准备控件
学生身份输入框在提交前由归一化姓名或匿名浏览器身份说明描述。
学生提交按钮
已准备状态
提交按钮在发送任何尝试前由就绪状态、载荷摘要和部分提交提示描述。
隐私边界
私有数据隐藏
该交接绝不序列化题干、答案、学生姓名、原始匿名 token、CSV 数据 URL、作业标题文本或私有活动内容。