学情分析模板定制指南（教师版）

宁创教学智能体（QuickClass Agent）· 常州市天宁区人工智能教育研究中心设计、开发

适用场景：你想让 AI 学情分析报告更贴合自己学科、自己班级的评价体系。
阅读时间：10 分钟。第二章用 AI 帮你写、第三章照着例子改，10 分钟就能做出自己的第一份模板；第五章是完整的"改前 → 改后 → 报告效果"对比，想看清楚改动会带来什么，再细读。

一、先放心：你能改坏什么？

模板分两层，你只碰得到安全的那层：

图表画歪、格式错乱这类问题，从设计上就与你无关——系统负责画图，你负责定标准。你改模板只会影响"分析什么、怎么评"，改坏了最多是内容不合心意，恢复一下就行。

重要变化（新版）

以前模板里需要写一段"图表协议"和 chart 示例块，现在完全不需要了。你只要用自然语言描述"想要什么图、展示什么维度"，系统会自动把图表格式规范补全给 AI。AI 按你的描述生成 chart 数据块，系统再渲染成图。

二、AI 帮我写模板（最快起步，10 分钟出一份新模板）

不想从默认模板复制后逐行改？可以直接让 AI 帮你写一份全新模板，写出来再按第三章微调。

入口

打开「模板管理」页面 → 新建模板 → 选择「AI 帮我写」→ 填选项、写一句话意图 → 生成。

支持的模板类型

AI 能帮你写 6 类模板：对话设计、课堂作业设计、学生个人学情、全班学情、课堂作业分析、互动探究分析。

两种用法

1. 生成模式：手里还没有模板，只写一句话意图，AI 从零生成完整模板。

例：请写一个信息科技课的学生个人学情模板，重点看计算思维和信息社会责任。

1. 优化模式：已有一版初稿，把初稿内容填进去，AI 在保留你原有设计的基础上改写，不推翻重来。

三个选项

生成后要检查

AI 生成的模板不是终点，建议重点看三处：

1. 变量是否合理：系统会自动校验模板里的 {变量}，清单外的变量会提示你修正（运行时会被替换成空串）。
2. 图表描述是否符合预期：用自然语言描述"要什么图、展示什么维度"即可，不用写任何协议（见第一章"重要变化"）。
3. 报告板块是否符合你的评价体系：板块名、顺序、口吻都还能在编辑器里手动调整。

生成后随时手动微调——就是下一章讲的"你能改的三样东西"。

三、你能改的三样东西

打开「模板管理」页面，复制一份默认模板开始改。所有可改项就三类：

1. 维度清单（雷达图分析哪几项）

默认模板用五个维度：课堂参与、知识掌握、思维深度、作业表现、学习态度。

你觉得不合适？直接改名字、增删条目。写几项，雷达图就画几边形，3 项到 12 项都行。

2. 等级标准（每项怎么算好、算差）

默认是 0-100 分。你可以换成等级制（优/良/合格/待改进），并写清每个等级的判定标准。

3. 报告板块（报告里写什么、顺序如何）

增删"报告要求"里的编号条目，比如加一段「家校沟通建议」、去掉「学生排名」。图表也算板块：「报告要求"里每一条"插入/展示……图" = 报告里的一张图，几条就画几张（详见例子 4）。

四、三个照抄就能用的例子

例子 1：换维度（最常见，2 分钟）

信息科技老师觉得默认五维不贴合，改成学科核心素养四维。

找到模板里的维度清单，替换成：

3. 用雷达图展示信息科技核心素养（维度：信息意识、计算思维、数字化学习与创新、信息社会责任，共 4 维，按此顺序）

保存 → 用一份作业试跑 → 雷达图自动变成四边形。

例子 2：百分制换等级制（5 分钟）

找到（或新增）"维度与等级体系"段。「维度 → 等级 → 分值"的映射用表格或纯文本都行——模板最终是整段文本喂给 AI，AI 两种都读得懂、效果一样，选你顺手的写法即可。

写法 A：表格（直观，推荐维度多、等级细时用）

## 维度与等级体系

雷达图维度及评分标准（按此表判定等级，填入对应分值）：

| 维度 | 优(90) | 良(75) | 合格(60) | 待改进(40) |
|---|---|---|---|---|
| 课堂参与 | 主动发言≥3次 | 有发言 | 仅应答 | 未参与 |
| 知识掌握 | 全对 | 错1题 | 错2题 | 错3题及以上 |

- 每个维度先按上表判定等级，再取括号里的分值填入图表。
- 图表旁的表格同时展示"等级 + 分值"，方便核对判定依据。

写法 B：纯文本（省事，适合维度少、手机编辑时）

## 维度与等级体系

雷达图维度及评分标准（先按下列标准判定等级，再取括号里的分值填入图表）：

- 课堂参与：优(90)=主动发言≥3次；良(75)=有发言；合格(60)=仅应答；待改进(40)=未参与
- 知识掌握：优(90)=全对；良(75)=错1题；合格(60)=错2题；待改进(40)=错3题及以上

两种写法对 AI 完全等价，唯一区别是你自己读起来哪个更清楚。

关键点：括号里的分值不要改（系统按 0-100 画图），要改的是每个等级的判定标准——那才是你的评价主张。

例子 3：加一个报告板块（3 分钟）

在"报告要求"清单末尾加一行：

11. 增加「家校沟通建议」板块：针对需关注学生，各写一条可直接发给家长的建议（50字内，具体可执行，不出现分数排名）

写清楚三件事：板块名、写什么、什么口吻。写得越具体，AI 越稳。

例子 4：增删图表（一份报告有好几张图，怎么改）

默认的「课堂作业分析模板（数据型）」报告里，本来就画了 3 张图：各题正确率柱状图、分数分布柱状图、班级掌握度进度条。这几张图不是系统写死的，而是「报告要求"里三条编号条目——一条 = 一张图。打开模板看这三条：

3. 用柱状图展示各题正确率（单位：%，低于 60% 标警示色），数据来源 {questionStats}
4. 用柱状图展示分数分布，数据来源 {scoreDistribution}
5. 用进度条展示班级整体掌握度（单位：%），数据来源 {questionStats}

想加图、删图、换图，就改这几条编号：

加图示例——想加一张「分数段构成饼图」，在末尾补：

6. 用饼图展示分数段人数构成，数据来源 {scoreDistribution}

最容易踩的坑：每张图都要写清「数据来源变量"，否则几张图会串成同一份数据。 上面三条里，第 3、5 条的数据来自 {questionStats}（各题正确率），第 4 条来自 {scoreDistribution}（分数段人数）——数据源不同，三张图才长得不一样。新加一张图却不写来源，AI 很可能把已有的数据再画一遍。

五、深度对比示例：改之前 → 改之后 → 报告效果

前面的例子告诉你"改哪一行"，这一章把完整过程摊开：原模板长什么样、改完长什么样、改完后 AI 生成的报告会发生什么变化。报告均为模拟数据，实际数值以你的班级数据为准。

以「学生个人学情分析模板（课堂·数据型）」为底本。打开「模板管理」→ 找到该模板 → 复制一份，跟着下面任一案例改即可。

案例 A：信息科技老师换维度（五维 → 四维核心素养）

① 改之前——模板里是这样的

模板「报告要求"第 3 条：

3. 用雷达图展示综合能力（维度：知识掌握、参与度、思维深度、作业表现、学习态度）

② 改之后——只动这一处

「报告要求"第 3 条改为：

3. 用雷达图展示信息科技核心素养（维度：信息意识、计算思维、数字化学习与创新、信息社会责任，共 4 维，按此顺序）

旧版指南要求"图表协议"里的示例块同步改，现在完全不需要。系统会自动把格式规范补全给 AI。

③ 新报告的效果（模拟数据）

AI 按新维度输出 chart 块，系统自动渲染成四边形雷达图：

图表下方的数据核对表（模拟）：

报告正文相应变化（模拟片段）：

优势：信息意识与信息社会责任突出，能主动甄别信息来源并规范引用。
薄弱：计算思维的"问题分解"环节表述不完整，建议用流程图模板练习把大问题拆成小步骤。

对比要点：维度名一换，雷达图形状、判定依据、优势/薄弱分析全部跟着换。你不需要碰任何画图代码，系统自动适配。

案例 B：数学老师把百分制换成等级制（换指标）

① 改之前——AI 按百分制"自由发挥"

3. 用雷达图展示综合能力（维度：知识掌握、参与度、思维深度、作业表现、学习态度）

模板没写判定标准，82 分还是 76 分全凭 AI 对数据的理解，同一学生两次生成的分数可能不一样。

② 改之后——在「报告要求"段之前新增一节

## 维度与等级体系

雷达图维度及评分标准（先按判定标准定等级，再取括号内分值填入图表）：

| 维度 | 优(90) | 良(75) | 合格(60) | 待改进(40) |
|---|---|---|---|---|
| 知识掌握 | 课堂检测全对 | 错1题 | 错2题 | 错3题及以上 |
| 参与度 | 主动发言≥3次 | 有发言 | 仅应答 | 未参与 |
| 思维深度 | 能提出新问题 | 能解释思路 | 能复述结论 | 无法复述 |
| 作业表现 | 全部完成且正确 | 完成有小错 | 部分完成 | 大量未完成 |
| 学习态度 | 主动预习复习 | 按要求完成 | 需催促 | 多次缺交 |

- 图表旁的核对表同时展示"等级 + 分值"，方便家长看懂判定依据。

③ 新报告的效果（模拟数据）

chart 块数值变成按你的标准换算出的分值：

核对表变成"等级 + 分值 + 依据"三列（模拟）：

对比要点：分数不再是 AI 拍脑袋，而是从你定的判定标准推出来的——同一份数据，每次生成分数一致。家长看到的也不再是干巴巴的 82 分，而是"优——课堂检测全对"。

案例 C：加「家校沟通建议」板块

① 改之前——报告要求共 9 条，报告只有学情分析，没有给家长的话。

② 改之后——末尾加一条

10. 增加「家校沟通建议」板块：针对待改进维度，写一条可直接发给家长的建议（50字内，具体可执行，不出现分数和排名）

③ 新报告的效果（模拟片段）

报告末尾多出一个板块：

家校沟通建议
思维深度为"合格"档，建议家长每周陪孩子玩一次"你说我猜"数学游戏：孩子用学过的概念描述、家长来猜，练习把思路讲清楚。

对比要点：加一条要求 = 报告多一个板块。写清板块名、写什么、字数、口吻，AI 就稳定输出；写得含糊（如"给家长提点建议"），输出质量就会飘。

六、改坏了怎么办

1. 报告内容不对 → 回模板管理页继续调，不影响历史报告。
2. 想推倒重来 → 找到默认模板，复制一份，重新开始。
3. 图表没显示 → 检查模板里是否还有图表意图词，如"柱状图""饼图""雷达图""chart""图表"等。只要有，系统就会自动注入图表协议；如果误删了这些词，补上即可。

七、上手路径建议

第 1 步：用默认模板跑一份报告，看看哪里不合心意
第 2 步：想要全新模板？用「AI 帮我写」（第二章），一句话意图直接生成
第 3 步：在编辑器里微调维度、等级、板块（第三章）
第 4 步：用同一份作业试跑，对比改动效果
第 5 步：定稿后导出，发到教研组共享（第八章）

每改一步，用同一份作业试跑对比一次——固定数据、只变模板，才能看出改动效果。

八、教研组共享

模板管理页支持导出/导入：

• 调好一份模板 → 导出为文件 → 发到教研组群
• 同事导入后即用，无需重复调

建议教研组共建一套学科模板（一人主笔、全组试用、迭代两轮定型），比每人各调一份效率高得多。

附录：图表类型速查

模板里的图表都由 AI 输出的 chart 数据块渲染而成，系统一共支持 6 种类型。你只需要在模板里用自然语言描述想要什么图，系统会自动把格式规范补全给 AI。

先说数据：图表靠什么画出来？

系统发给 AI 的是文本统计——模板里的 {变量} 会被替换成文字，例如 {questionStats} 变成「[基础] 分数的定义… 正确率92%」。AI 从这些文字里读出数值、写成 chart 块的 JSON，系统再照 JSON 确定性渲染成图。

所以一张图能不能画准，取决于模板变量里有没有显式数值，分三档：

• ✅ 有客观数值：各题正确率、分数分布、操作类型统计、个人作业明细——这些变量本身带数字，图能画准。
• ⚠️ AI 评估分：雷达图的「能力维度分值」（如「知识掌握 82 分"）没有现成变量，是 AI 从对话/报告文字里主观打的分，数值无出处、有编造风险。
• ❌ 无数据：课堂作业设计、学生对话设计 两类模板只有课题、年级等元信息，没有任何学情数据，画不了数据图。

下面每种类型都标注了它的数据来源，并给出示例块（展示 AI 最终会输出什么样的 JSON）。这些示例块不是让你抄进模板，只是给你核对格式用。

总览

雷达图 vs 其他图，改法不一样：雷达图的「维度"是你自由定义的——改维度时只需改报告要求里的自然语言描述。其余 5 种图的 name 不是"维度"，而是客观数据项，只能从对应变量里挑（bar/pie 取 {scoreDistribution}、bar/progress 取 {questionStats}、line 取 {personalQuizStats}、scatter 取 {submissionDetails}），不能凭空发明，数值 AI 直接照抄。改法更简单：只改报告要求那一条即可。

1. radar —— 雷达图

图形：一个顶点代表一个维度，值越大越靠外；中心是 0，外圈默认 100 分。写几项就画几边形（3～12 项）。

数据来源：⚠️ 没有现成变量。模板变量里只有各题正确率、分数分布等客观统计，以及对话/报告文本，没有「能力维度分值"。图上的每个分值（如「知识掌握 82"）是 AI 根据对话和作业表现主观评估打的分，在数据段里找不到出处。

适合场景：同一学生在多个维度上的能力对比。若坚持用，维度应选能从数据段推断的（如作业正确率、参与度），并在模板里写清打分依据；否则宁可用 bar / progress 展示客观数据。

模板里怎么写：

3. 用雷达图展示综合能力（维度：知识掌握、参与度、思维深度、作业表现、学习态度，按此顺序）

AI 输出长这样（无需写进模板）：

可选样式："style":{"max":100} 改满分刻度；"style":{"theme":"green"} 换配色。

2. bar —— 柱状图

图形：一根柱子一个项目，柱子越高数值越大。10 项以内竖排，超过 10 项自动横排（防止标签挤在一起）。

数据来源：✅ 有客观数值。{questionStats}（各题正确率）、{scoreDistribution}（分数段人数）都自带显式数字，AI 直接照抄即可，图能画准。

适合场景：多个项目放一起比数值，如各题的正确率、各分数段的人数。

模板里怎么写：

3. 用柱状图展示各知识点掌握度（单位：分）

AI 输出长这样（无需写进模板）：

可选样式："style":{"warnBelow":60} 让低于 60 分的柱子变红提醒。

3. line —— 折线图

图形：折线连起各数据点，最大值用主色加粗、最小值用红色标注。只有 1 个点时只画点不画线。

数据来源：✅ 有客观数值，但只在学生个人场景有。{personalQuizStats} 记录该学生各次作业的得分，多次作业就能连成趋势；只有一次作业时只画一个点。班级场景的 {classQuizStats} 也能画「各次作业平均分"趋势。

适合场景：同一维度随时间或次数变化，如某学生的多次测试成绩趋势。

模板里怎么写：

3. 用折线图展示本单元四次测试成绩趋势

AI 输出长这样（无需写进模板）：

可选样式："style":{"unit":"分"} 给数值加单位。

4. pie —— 饼图 / 环形图

图形：按数值比例切分。只有两块、或某块占比超过 60% 时自动变成环形图，圆心显示核心数值；加了 warn 标记的块用红色。

数据来源：✅ 有客观数值。{scoreDistribution}（各分数段人数）、{actionTypeStats}（点击/拖拽等操作次数，仅互动探究）都是显式占比数据。

适合场景：展示构成占比，如分数段人数构成、操作类型占比。

模板里怎么写：

3. 用饼图展示作业完成情况构成

AI 输出长这样（无需写进模板）：

说明：给需要提醒的块加 "warn":true，它会显示为红色。

5. progress —— 进度条

图形：一条横向进度条，左边名称、右边数值，进度按 0～100 填满。它不是图片，是网页原生样式，最省空间。

数据来源：✅ 有客观数值（首选）。{questionStats} 的各题正确率本身就是 0-100，最适合进度条。若从对话报告里提炼「知识点掌握度"，则属于 ⚠️ AI 评估分。

适合场景：展示单个维度的达成进度，如各题正确率、班级整体掌握度。

模板里怎么写：

3. 用进度条展示各知识点达成进度（单位：%）

AI 输出长这样（无需写进模板）：

可选样式："style":{"warnBelow":60} 让低于 60 的进度条变红。

6. scatter —— 散点图

图形：二维坐标上的散点，横轴一个变量、纵轴一个变量，每个点可带名字（鼠标悬停显示）。

数据来源：✅ 有客观数值，但只在互动探究场景有。{submissionDetails} 含每个学生的得分和操作次数（如「张三：85分，操作12次"），可组成 x=操作次数、y=得分 的散点。其他场景没有二维配对数据，慎用。

适合场景：看两个变量之间的关系，如操作次数与得分、投入与成绩。

模板里怎么写：

3. 用散点图展示投入时间与测验成绩的关系

AI 输出长这样（无需写进模板）：

说明：横轴、纵轴的含义用 "style":{"xLabel":..., "yLabel":...} 标注。

一句话总结：系统管画图，你管标准。改维度、定等级、调板块——三件事，三个例子，照抄起步。图表用自然语言描述，协议交给系统自动注入。