核心流程（四步）
- 第 1 步 · 准备数据：点击右侧「上传课堂录音」（MP3/WAV/M4A 等，自动转写）或「导入外部转写稿」（txt/srt/vtt/ass/json），也可以点「使用示例数据」快速体验。
- 第 2 步 · 填写课堂信息：弹出窗口里填写课题、课型、学段，确认后开始上传/转写。
- 第 3 步 · 文稿校对：核对转写文字。先确认说话人身份（SPEAKER_1/2 分别是谁——可一键「AI 预标」，也可手动逐组设置）；需要时合并/拆分段落、逐段试听、微调时间；对"提问后等待学生应答"的停顿，可把光标点到词间空隙点「候答标记」人工标注。
- 第 4 步 · 生成报告：点「完成校对」，系统做语义编码并生成话语分析报告；报告里标"存疑"的段落可一键回到校对页核对。
常见问题
- 复核要花多久？：取决于转写稿质量与你的精确度要求。自动转写稿需逐段核对说话人与文字（4 分钟音频约需 10 分钟，一整节课通常 20-40 分钟），可使用「AI 预标」加速说话人确认。相比传统人工逐句编码（数小时起步），已大幅缩短——但"快"的前提是文字尽量准确，报告才可信。
- 编码怎么这么快？：外部稿/示例数据走本地脚本规则（瞬时完成）；上传录音走云端 AI 语义编码（通常几秒到十几秒），编码期间请留意"语义编码中…"状态。
- 复核队列是什么？：AI 置信度 0.6-0.9 的编码条目会进入复核队列，建议教师确认后采纳，保证指标可信。
- 候答标记有什么用？：自动判定标不准的"等待学生回答"停顿，可由你手动标注，报告会同时给出自动判定与人工标记两个维度。
IRF 三话步结构
课堂话语分析经典框架：I 发起教师提问或指令 → R 回应学生应答 → F 反馈教师评价或修正。报告中的"发起/回应/发起+回应"即此结构，能快速看出对话的互动节奏。
提问类型
展示性问题有标准答案（如 what/when 事实题），多用于检测理解；参考性问题开放、无唯一答案（如 opinion/how about you），更促发学生思考与表达。参考性问题占比是衡量课堂开放度的重要指标。
反馈类型
- 明确纠正：直接指出错误并给正确说法；
- 重铸 recast：教师不评判，只是自然地复述学生的错误句为规范形式——是最隐性的纠错方式；
- 引导 elicitation：提示学生自己修正；
- 表扬鼓励、无反馈。
候答时长（wait time）
教师提问后到学生应答前的等待时间。研究（Rowe 1972）显示延长候答能显著提升应答质量；≥3 秒无应答会被标为"长沉默"提示，需回听确认是学生小声未识别还是无人回应。
其他指标
教师话语占比：教师说话时长占师生话语总时长比例（参考区间 45%-70%）；指令重复频次：同类指令重复次数，过多可能说明指令不够清晰；语速：教师英语语速（词/分钟）。
这些参考区间基于文献初值，可在 API 设置中按校本情况调整。