班主任AI班级管理工作台生成器

概述

班主任工作台

概述

本技能帮助班主任（或辅导员）快速生成一个数字化、可视化的班级管理工作台。只需导入班级名单，即可生成一个单文件 HTML 工作台，在电脑和手机浏览器中直接打开使用，无需安装任何 App 或依赖服务器。

工作台包含 19 个主模块（含「导出中心」）+ 左侧「核心管理」分组下 9 个可配置子模块，覆盖从早自习考勤到期末评语、从安全特异体质管控到控辍保学跟踪的全部日常事务。

三个设计重点：

1. 按学段聚焦 —— 传 --grade 自动套用该学段推荐配置（模块显隐 / 字段 / 快捷操作），不做"所有模块全开"的堆砌。
2. 高频动作一步直达 —— 首页快捷操作条 + 模块可置顶 / 排序 / 隐藏，解决"功能多但常用的找不到、调顺序麻烦"。
3. 数据能进能出 —— 导出中心支持 CSV（WPS / Excel / 飞书）与 Markdown（IMA / 飞书 / WPS），不做数据孤岛。

首次打开有新手引导，所有数据存储在浏览器本地（localStorage），刷新不丢失，支持 JSON 导入导出备份。

⚡ 30 秒快速上手

1. 告诉我班级信息：直接说"帮我生成班主任工作台"，并给出学段（如高职）、班级名、人数、名单文件（Excel/CSV/文本均可）。
2. 我生成并交付：产出 一个 HTML 文件，双击用浏览器打开即用——无需安装、无需联网、无服务器。
3. 三步开始用：
   • 🖥️ 电脑：左侧导航点模块；手机：底部导航。
   • 💡 第一次打开看弹出的"新手引导"（6 条提示）。
   • 💾 定期到「设置 → 导出 JSON」备份，换电脑用「导入数据」恢复。

完整工作流见下文「工作流程」；新手最常问的问题见文末「FAQ」。

⚠️ 重要限制（使用前必读）

本工具是单文件 HTML + 浏览器本地存储，无服务器，有以下硬性边界，请务必了解，避免数据事故：

关键点：换电脑 ≠ 复制文件，而是"导出 JSON → 新电脑导入"。

🎯 差异化定位：和普通 AI 生成的班主任页面有什么不同

用豆包或其他通用 AI 一句话生成的班主任页面，通常是"演示级"的：功能写死、数据不落地、录 50 人要点 50 次、数据导不出来、清缓存就没了。

本 skill 的定位是"班主任的本地数据中枢"——日常录入在这里，产出（表格 / 文档 / 汇报材料）从这里出去。六个具体差异：

一句话：别人做的是"能看的页面"，这里做的是"能长期用、数据能进出"的工具。

📚 按学段聚焦：开局就给对的配置

生成时传入 --grade，脚本自动套用该学段的推荐配置（模块显隐、核心子模块、自定义字段、快捷操作）。用户可在「设置」里随时改——预设只是"开局就对"，不锁死。

用法：--grade 高职 自动套用；--field 政治面貌 追加字段（与预设自动去重合并）。

触发条件

当用户出现以下意图时触发本技能：

工作台生成类:

• "帮我生成一个班主任工作台" / "班级管理工作台" / "班主任数字化工具"
• "班级数字化管理" / "班级管理可视化"
• "homeroom workbench" / "class management dashboard"

单点功能类（先询问是否需要完整工作台，或直接生成对应模块）:

• "请假管理" / "请假审批" / "批量审批请假条"
• "收作业" / "作业收交统计" / "催交作业"
• "点名工具" / "随机点名" / "课堂点名"
• "班会策划" / "班会方案" / "防诈骗班会" / "主题班会"
• "班级积分" / "操行分管理"
• "期末评语" / "学生评语生成"
• "座位表" / "值日表" / "成绩分析" / "宿舍管理"

工作流程

第一步：收集班级信息

主动向用户询问以下信息（可一次性问，也可分步问）：

1. 学段: 幼儿园 / 小学 / 初中 / 高中 / 高职中职
2. 班级名称: 如 "24软件技术1班"、"三年二班"
3. 人数: 班级总人数
4. 常见管理场景: 询问用户日常最需要哪些管理功能（考勤？成绩？宿舍？家校沟通？）
   • 参照 references/classroom-scenarios.md 按学段推荐高频场景
5. 主题色偏好: 暖阳(米白浅黄·教育风) / 樱粉(浅红·教育风) / 蓝 / 绿 / 橙 / 紫 / 暗色（默认暖阳，前两款为淡雅教育配色）
6. 个性化需求: 主动引导用户提出具体要求——班级口号、学校名称、是否需要上传学校 Logo（生成后在"设置→班级信息"上传）等

注意：不要一次性问太多问题。先问学段和人数，再根据学段推荐场景。

如果用户已经提供了名单文件，可跳过部分问题。

用户说"随便/都行"时使用默认配置直接生成，不要反复追问。

第二步：获取班级名单

接受以下任一形式的名单输入：

• 文本列表: 用户直接粘贴名单（如 "张三、李四、王五"）
• CSV 文件: 姓名,学号,性别,电话,宿舍,家长姓名,家长电话
• Excel 文件: 读取表格数据
• JSON 文件: 已有结构化数据

对于文本列表（仅有姓名），自动补全其他字段为空。对于 CSV/Excel，按列解析。

第三步：构建数据 JSON（或使用名单直转）

方式 A – 名单直转（推荐，最快捷）:

将名单保存为文本文件，直接传给脚本的 --roster 参数，脚本自动解析并生成完整工作台：

python generate_workbench.py --roster 名单.txt 
  --name "24软件技术1班" --grade "高职" --teacher "汤老师" 
  --motto "班级口号" --field "宿舍号" --field "政治面貌" 
  --output "班主任工作台.html"

名单格式支持（自动跳过 CSV 表头）:

• 每行一个姓名: 张三 / 张三 李四 王五
• 顿号分隔: 张三、李四、王五
• CSV 多列: 姓名,学号,性别,电话,宿舍,家长姓名,家长电话

方式 B – 构建 JSON:

将名单转换为完整 JSON 结构（参照下文"数据格式"部分）：

{
  "meta": {
    "className": "24软件技术1班",
    "grade": "高职",
    "teacher": "汤老师",
    "motto": "班级口号",
    "createdAt": "2026-08-24",
    "studentCount": 56,
    "settings": {
      "theme": "blue",
      "widgets": ["stats", "attendance", "trend", "tasks", "schedule", "birthday", "announcements"],
      "customFields": ["社团", "政治面貌"]
    }
  },
  "students": [
    { "id": "s1", "name": "张三", "studentId": "20240101", "gender": "男", "birthday": "08-25", "phone": "138xxxx", "dorm": "3-201", "parentName": "张父", "parentPhone": "139xxxx", "notes": "" }
  ],
  "seating": { "rows": 6, "cols": 6, "map": {} },
  "attendance": {},
  "tasks": [],
  "communicationLog": [],
  "announcements": [],
  "activities": []
}

根据学段配置 customFields（参考 references/classroom-scenarios.md）：

建议: 询问用户学生生日（月-日格式），可激活概览页"近期生日提醒"功能。若用户能提供，建议以 birthday: "MM-DD" 字段填入。

第四步：生成工作台

将 JSON 数据写入临时文件，然后运行生成脚本：

# 方式 A: 名单直转（推荐）
python generate_workbench.py --roster roster.txt --name "24软件技术1班" --grade "高职" --motto "班级口号" --output "班主任工作台.html"

# 方式 B: JSON 数据
echo '<JSON数据>' > /tmp/class_data.json
python generate_workbench.py --data /tmp/class_data.json --output "班主任工作台.html"

脚本路径为: ~/.workbuddy/skills/homeroom-teacher-workbench/scripts/generate_workbench.py

Python 运行时使用: C:UsersStpt.workbuddybinariespythonversions3.13.12python.exe（Windows）或系统 Python（macOS/Linux）

第五步：交付与说明

生成 HTML 文件后，使用 present_files 向用户展示。

同时向用户说明：

1. 如何使用: 双击 HTML 文件用浏览器打开即可。电脑端左侧导航，手机端底部导航。
2. 手机访问: 将 HTML 文件发送到手机（微信/邮件/网盘），用手机浏览器打开。也可通过局域网 HTTP 服务共享。
3. 数据安全: 所有数据存储在浏览器本地，不上传任何服务器。清浏览器缓存会丢失数据，请定期用"设置 → 导出 JSON"备份。
4. 个性化设置: 进入"设置"页面可编辑班级信息(名称/班主任/口号)、切换主题色、开关概览模块、添加学生自定义字段。
5. 特色功能: 星标重点关注学生(⭐)、座位表可视化排座、近期生日提醒、7天出勤趋势图、一键生成周报。
6. 数据导入导出: 支持导出全部数据为 JSON，也支持从 JSON 文件导入恢复。

数据格式规范

完整的数据结构如下，所有字段均可选（缺失字段自动补全）：

{
  "meta": {
    "classId": "string - 班级唯一ID(多班管理用，生成脚本自动分配)",
    "className": "string - 班级名称",
    "grade": "string - 学段",
    "teacher": "string - 班主任姓名",
    "motto": "string - 班级口号(显示在概览页顶部横幅)",
    "createdAt": "string - 创建日期 YYYY-MM-DD",
    "studentCount": "number - 学生人数（自动计算）",
    "settings": {
      "theme": "string - warm|pink|blue|green|orange|purple|dark (warm=暖阳米白浅黄 pink=樱粉浅红)",
      "widgets": "string[] - stats|attendance|trend|tasks|schedule|birthday|announcements|duty",
      "customFields": "string[] - 自定义字段名列表"
    }
  },
  "students": [
    {
      "id": "string - 唯一ID（自动生成）",
      "name": "string - 姓名（必填）",
      "studentId": "string - 学号",
      "gender": "string - 男|女",
      "birthday": "string - 生日 MM-DD 格式(激活生日提醒)",
      "phone": "string - 学生电话",
      "dorm": "string - 宿舍号",
      "starred": "boolean - 是否重点关注学生(⭐)",
      "parentName": "string - 家长姓名",
      "parentJob": "string - 家长职业(如: 医生/个体经营)",
      "parentPhone": "string - 家长电话",
      "notes": "string - 备注",
      "customFields": "object - 自定义字段键值对"
    }
  ],
  "seating": {
    "rows": "number - 座位行数(默认6)",
    "cols": "number - 座位列数(默认6)",
    "map": { "0-0": "s1", "0-1": "s2" }
  },
  "exams": [
    {
      "id": "string",
      "name": "string - 考试名称(如: 第一次月考)",
      "date": "string - YYYY-MM-DD",
      "fullScore": "number - 满分(默认100)",
      "scores": { "s1": 85, "s2": 92 }
    }
  ],
  "attendance": {
    "2026-08-24": {
      "present": ["s1", "s2"],
      "absent": ["s3"],
      "late": ["s4"]
    }
  },
  "tasks": [
    {
      "id": "string",
      "title": "string - 任务标题",
      "priority": "string - high|medium|low",
      "deadline": "string - YYYY-MM-DD",
      "category": "string - 行政|教学|德育|安全|活动|其他",
      "note": "string - 备注说明",
      "status": "string - pending|done"
    }
  ],
  "communicationLog": [
    {
      "id": "string",
      "studentName": "string",
      "type": "string - 电话|面谈|微信|家访|其他",
      "date": "string - YYYY-MM-DD",
      "content": "string",
      "followUp": "boolean"
    }
  ],
  "announcements": [
    {
      "id": "string",
      "title": "string",
      "content": "string",
      "date": "string - YYYY-MM-DD"
    }
  ],
  "activities": [
    {
      "id": "string",
      "title": "string",
      "date": "string - YYYY-MM-DD",
      "description": "string"
    }
  ],
  "duty": {
    "groups": [
      { "id": "string", "name": "第一组", "members": ["s1", "s2"] }
    ],
    "startDate": "string - 轮换起始日期 YYYY-MM-DD",
    "content": "string - 值日内容(顿号分隔)",
    "overrides": { "0": "g2" }
  },
  "cadres": [
    {
      "id": "string",
      "title": "string - 职位(班长/学习委员等)",
      "studentId": "string - 学生ID",
      "electedDate": "string - YYYY-MM-DD",
      "note": "string - 推选备注(如: 全票通过)"
    }
  ],
  "honors": [
    {
      "id": "string",
      "title": "string - 荣誉名称",
      "level": "string - 班级|校级|区县级|市级|省级|国家级",
      "type": "string - 团体|个人",
      "date": "string - YYYY-MM-DD",
      "students": ["s1"],
      "description": "string"
    }
  ]
}

工作台功能清单

外观与个性化:

• 7款主题，默认"暖阳"(米白+浅黄淡雅教育风)，另有"樱粉"(浅红)，以及蓝/绿/橙/紫/暗色，设置页一键切换
• 学校Logo上传: 设置页上传图片(自动压缩96×96)，显示在侧边栏顶部，可随时更换/恢复默认
• 班级口号: 显示在主页顶部渐变横幅
• 侧边栏可折叠: 桌面/平板端点击「折叠为图标模式，扩大内容区，状态记忆
• 全端适配: 电脑/平板(769-1024px专属断点)/手机，兼容 Windows/macOS/鸿蒙/iOS/Android 各系统浏览器

新手引导: 首次打开工作台自动弹出快速上手引导（6条核心操作提示+备份警告+手机使用说明），帮助新手班主任零门槛上手。

期末评语智能生成: 学生页"📝期末评语"按钮，基于学生的出勤统计(缺勤/迟到次数)、成绩水平与趋势(平均分/上升下降)、班干部职务、获奖荣誉、操行积分，从多套句式池随机组合生成个性化评语草稿（重点学生用关怀式结尾），支持单个重新生成、逐条编辑（自动保存）、一键导出全部。

多班管理: 点击侧边栏班级名称（或设置页"班级管理"）可打开班级切换器——切换已有班级、新建班级（从空白开始，可用"学生→导入名单"快速填充）、删除班级（二次确认）。每个班级数据独立存储，互不干扰。适合同时带多个班的班主任。

桌面端快捷键: 数字键 1-9、0 快速切换模块(输入框聚焦时自动忽略)。

个性化设置

用户可在工作台"设置"页面进行以下个性化操作（无需重新生成）：

• 班级信息: 编辑班级名称、班主任姓名、班级口号（实时生效）
• 主题色: 蓝 / 绿 / 橙 / 紫 / 暗色
• 概览模块开关: 统计卡片 / 今日考勤 / 出勤趋势图 / 近期生日提醒 / 待办任务 / 近期活动 / 最新公告
• 核心管理模块开关: 今日核心待办 / 重点事项跟进 / 安全·特异体质 / 控辍保学跟踪 / 学生成长档案 / 家校沟通中心 / 思政德育库 / 专项任务跟踪 / 学生征兵记录（可自由增删左侧栏显示项）
• 模块排序与显隐: ⭐置顶 / ↑上移 / ↓下移 / 显示隐藏开关——把常用的排前面、不用的收起来，左侧栏按需裁剪（「工作台」「设置」不可隐藏）
• 首页快捷操作: 一键全到校、随机点名、请假审批、作业收缴、记一笔积分、新建待办、记沟通、写日志、新增学生、导出周报、导出备份、导出中心——勾选后显示在首页，一步直达
• 学生自定义字段: 添加/删除自定义字段，添加后每个学生卡片可填写该字段
• 周报导出: 一键汇总最近7天考勤/任务/沟通/活动/生日，生成可打印页或文本
• 数据导出: 导出全部数据为 JSON 文件（备份用，同时记录备份时间）
• 数据导入: 从 JSON 文件恢复数据
• 清空数据: 清空所有数据（二次确认）

如用户提出新的个性化需求（如新增模块、修改布局），可根据需求直接修改模板文件后重新生成。

资源说明

scripts/generate_workbench.py

数据注入与 HTML 生成脚本。两种模式：已内置友好错误提示——JSON 格式错误会报具体行号、名单为空/文件不存在会给出修改建议，不会再"卡住不动"。遇到红色「❌ 生成失败」提示时，按 💡 建议修正即可，或改用 --roster 名单.txt 直转模式（最稳）。

• JSON 模式: --data <json文件> --output <输出路径>
• 名单直转模式(推荐): --roster <名单.txt> --name <班级名> --grade <学段> --teacher <姓名> --motto <口号> --field <自定义字段> --theme <主题> --output <输出>
• 也支持 stdin 管道输入（自动识别 JSON 或纯文本名单）: cat 名单.txt | python generate_workbench.py --name "班级"
• 按学段自动聚焦：--grade（幼儿园/小学/初中/高中/高职，支持"中职""大专""中学"等别名）自动套用 GRADE_PRESETS——模块显隐、核心子模块、自定义字段、快捷操作一次配好；--field 追加字段会与预设自动去重合并。JSON 模式下只补充用户没设置过的项，不覆盖已有配置。

references/classroom-scenarios.md

按学段整理的班主任常见管理场景参考文档。在询问用户需求时参照推荐。

references/class-meeting-topics.md

班会主题资源库，按八大类（思政/安全教育/防诈骗/德育/学习动员/人生启迪/心理健康/班级建设）整理主题清单、流程框架和互动建议。当用户请求策划班会、班会方案时参考此文档生成，方案可填入工作台"活动→班会计划"。

assets/workbench-template/

工作台 HTML 模板文件:

• index.html – HTML 结构模板，含 {{STYLES}}、{{JS}}、{{CLASS_DATA}} 占位符
• styles.css – 完整响应式样式（桌面端侧边栏 + 移动端底部导航）
• app.js – 应用核心逻辑（数据管理、视图渲染、导航路由、CRUD 操作）

示例对话

用户: 帮我生成一个班主任工作台

AI: 好的！请先告诉我几个信息：

1. 您的班级是什么学段？（幼儿园/小学/初中/高中/高职中职）
2. 班级名称是什么？
3. 大概有多少学生？

用户: 高职，24软件技术1班，56人

AI: 了解。高职班级通常需要考勤管理、宿舍管理、家校沟通等。请问：

1. 您有没有现成的班级名单文件？（Excel/CSV/文本均可）
2. 学生需要记录哪些额外信息？（如宿舍号、政治面貌、实习单位等）
3. 主题色有偏好吗？（蓝/绿/橙/紫/暗色，默认蓝）

用户: 我把名单发给你，帮我加上宿舍号和政治面貌字段，主题用蓝色

(AI 解析名单 → 构建 JSON → 运行生成脚本 → 展示 HTML 文件)

使用案例

案例 1：新手班主任第一次用

用户： 我是新接手一个班的班主任，平时请假审批、收作业、写评语这些杂事特别多，有没有什么工具能帮我？

处理： 触发本技能 → 询问学段/人数/名单 → 生成工作台 → 交付时重点介绍：请假模块（批量审批）、作业模块（一键催交）、期末评语（智能生成）三大高频痛点功能，并提醒首次打开有新手引导。

案例 2：双班班主任

用户： 我带两个班（24软件1班和2班），想做成绩对比分析。

处理： 生成工作台 → 指导用户在"设置→班级管理"新建第二个班，用"学生→导入名单"填充2班名单 → 两个班各自录入同一场考试（同名同日期）→ 成绩页"班级对比"即可查看平均分/及格率对比表。

案例 3：期末季救急

用户： 马上要交56个学生的期末评语了，头疼，能帮忙吗？

处理： 若用户已有工作台 → 指导打开"学生→📝期末评语"→ 一键全部生成（基于学生本学期真实考勤/成绩/职务/荣誉数据）→ 逐条微调 → 导出 TXT。若没有工作台 → 先按流程生成，再引导使用评语功能。

案例 4：策划一节防诈骗班会

用户： 下周要开一节防诈骗主题班会，帮我策划一下。

处理： 参考 references/class-meeting-topics.md 防诈骗专题 → 生成完整班会方案（流程框架+互动建议）→ 若用户有工作台，将方案要点填入"活动→班会计划"对应周次的 content 字段。

🔄 长期使用与生态适配

这个工作台是一次性的吗？

不是，可以长期用。 同一台设备、同一个浏览器不清缓存，数据一直都在，可以用满一整个学期甚至一学年。关键只有三点：

1. 别清浏览器缓存（清了就没了，且无云端）
2. 定期导出 JSON 备份（工作台自带"超 7 天未备份"提醒）
3. 换设备靠"导出 → 导入"迁移，不是复制 HTML 文件

多班 / 多学期场景：用「多班管理」为不同班级分别建班；学期末导出全套 CSV 存档 + JSON 备份，新学期新建班级重新导入名单即可。

能和飞书 / 腾讯 IMA / WPS / 百度网盘配合吗？

能配合，但这是"文件级"配合，不是"云端自动同步"（工作台没有服务器，不会、也不能自动上传任何数据——这既是限制，也是隐私优势）。

为什么不做"自动云同步 / 账号登录"？

这是主动取舍，不是技术做不到：一旦引入服务器或账号，就必须上传学生姓名、家长电话、家庭情况、特异体质等敏感信息，隐私与合规风险远大于便利。班主任手上的学生数据，留在自己电脑上是更负责任的做法。需要"云"的场景，用上面的导出 → 放网盘方案即可，数据始终在自己手里。

常见操作示例（复制即用）

① 一行命令生成（名单直转 + 按学段自动聚焦，最省事）

python generate_workbench.py --roster 名单.txt --name "24软件1班" --grade 高职 --teacher 汤老师 --output 班主任工作台.html

--grade 高职 会自动套用高职配置：隐藏值日表、开启控辍保学+征兵等 9 个核心子模块、预置"宿舍号/实习单位/政治面貌/建档立卡"字段。换成 --grade 幼儿园 则自动变成"过敏源/接送人/情绪状态"并隐藏成绩、宿舍、课表等。

② 批量审批请假：工作台「请假审批」勾选多条 → 点「批量通过 / 驳回」。

③ 一键催交作业：工作台「作业收缴」某科未交名单 → 点「一键催交」自动复制催交文本，粘贴到班级群即可。

④ 换电脑迁移数据：旧电脑「设置 → 导出 JSON」→ 新电脑打开工作台「设置 → 导入数据」选该文件。

⑤ 自定义字段（高职示例）：生成时加 --field 宿舍号 --field 政治面貌，或在工作台「设置 → 自定义字段」里增删。

FAQ 常见问题

Q1: 数据会丢失吗？存在哪里？A: 所有数据存在浏览器本地（localStorage），不上传任何服务器。清浏览器缓存/换电脑会丢失。工作台有"超7天未备份"提醒，请定期到"设置→导出JSON"备份；恢复时用"设置→导入数据"。

Q2: 手机上怎么用？A: 把 HTML 文件发到手机（微信文件传输助手/邮件/网盘均可），用手机浏览器打开。界面自动切换为底部导航的移动版。注意：微信内置浏览器可能功能受限，建议用 Safari/Chrome 打开。

Q3: 换了电脑/浏览器，数据怎么迁移？A: 旧电脑上"设置→导出JSON"，新电脑打开工作台后"设置→导入数据"即可完整恢复。

Q4: Excel 名单导入失败？A: ① 确认文件是 .xlsx/.xls 格式且能正常打开；② Excel 解析库需联网加载，离线时请把文件"另存为CSV"再导入；③ 确认第一个工作表里有学生数据。生成工作台时也可以直接把名单发给 AI 处理。

Q5: 多个班数据会混在一起吗？A: 不会。每个班独立存储，切换班级时数据完整隔离。点击侧边栏班级名称即可切换/新建班级。

Q6: 期末评语生成后可以修改吗？A: 可以。评语基于学生数据自动生成草稿，支持逐条编辑（自动保存）、单个/全部重新生成，最后导出 TXT。评语是"草稿助手"，建议人工润色后使用。

Q7: 请假批准后考勤会自动标记吗？A: 不会自动联动。审批通过时会提示"记得在考勤页标记缺勤"，请手动到考勤页操作（保持数据可控性）。

Q8: 随机点名会重复点到同一个学生吗？A: 默认可能重复。开启"排除本次已点"后，本次会话内不会重复；页面刷新后重置；也可点"重置已点"重新开始。

Q9: 工作台能多人同时使用吗？A: 不能实时协作（无服务器）。建议班主任主用；若课代需要协助录入，可轮流使用同一浏览器，或导出JSON后由班主任导入合并。

Q10: 想要新功能/改布局怎么办？A: 直接告诉 AI 需求（如"加一个班级相册模块"），AI 可以修改模板后重新生成；已有数据可用"导出JSON→导入"迁移到新版。

Q11: 左侧「核心管理」分组是什么？子模块能自己选吗？A: 核心管理是左侧栏一个可折叠分组，下挂 9 个班主任高频管理子模块（今日核心待办、重点事项跟进、学生安全与特异体质、控辍保学跟踪、学生成长档案、家校沟通中心、思政德育活动库、学校专项任务跟踪、学生征兵记录）。进分组仪表盘可一屏看到各模块完成度、进度条与风险提醒横幅。不需要的子模块可在"设置→核心管理模块"里用开关自由增删，左侧栏只显示你勾选的。

Q12: 核心管理里的图表需要联网吗？A: 图表由 Chart.js（CDN）绘制，联网时自动渲染；离线打开时图表区域留空，但进度条、风险标签、列表数据均不受影响，仍可正常使用。

Q13: 多人能同时编辑同一个工作台吗？会冲突吗？A: 不能实时协作。本地 HTML 无服务器，两台设备打开同一文件数据不互通，后保存覆盖先保存。解决：班主任主用；需协助时轮流用同一浏览器，或导出 JSON 由班主任合并导入。

Q14: 班级人数太多会卡吗？上限多少？A: 单文件在约 300 人内流畅；超过后花名册、成绩页滚动/渲染变慢，但功能正常。大班级建议按行政班拆多个工作台，或用「多班管理」分班。

Q15: 清了浏览器缓存 / 换电脑，数据还在吗？A: 不在。数据在浏览器 localStorage，清缓存、换浏览器、换电脑、无痕模式都会丢，且无云端。务必定期「设置 → 导出 JSON」备份；换设备先导出再导入。

Q16: 生成脚本报错 / 卡住怎么办？A: 新版已做友好报错，不会再静默卡死。常见：① JSON 格式错 → 提示具体行号，用 JSON 校验工具修；② 名单为空 → 提示检查格式；③ 文件不存在 → 提示检查路径。仍不行可把红色「❌ 生成失败」提示发给我，或改用 --roster 名单.txt 直转模式（最稳）。

Q17: 模块太多用不过来，能只留常用的吗？顺序能改吗？A: 能。「设置 → 模块排序与显隐」里每行有 ⭐置顶 / ↑上移 / ↓下移 / 显示隐藏开关：把常用的置顶、用不上的隐藏，左侧栏立刻清爽；「恢复默认顺序」一键还原。首页还有「快捷操作」条（设置里增删），高频动作一步直达，不用层层翻菜单。注意「工作台」和「设置」两个模块不可隐藏，避免把自己锁死。

Q18: 工作台能长期用吗？会过期吗？A: 能长期用，不过期。同一设备同一浏览器不清缓存，数据一直在，可用满一学期甚至一学年。关键是定期「设置 → 导出 JSON」备份；换设备靠"导出 → 导入"迁移（不是复制 HTML 文件）。详见「长期使用与生态适配」。

Q19: 能和 WPS / 飞书 / 腾讯 IMA / 百度网盘配合吗？A: 能，文件级配合：CSV 给 WPS/Excel/飞书多维表格；Markdown 给 IMA 知识库/飞书文档/WPS 智能文档；JSON 备份放任意网盘做异地保存。但没有云端自动同步（无服务器，也不会自动上传数据，这是隐私取舍）。详见「长期使用与生态适配」表格。

Q20: 按学段生成的配置是什么？能改吗？A: 生成时传 --grade（幼儿园/小学/初中/高中/高职）会自动套用该学段推荐配置：隐藏不适用模块、开启对口核心子模块、预置常用字段（幼儿园"过敏源/接送人"，高职"实习单位/政治面貌/建档立卡"）。全部可在「设置」里随时改，预设只保证"开局就对"。