教师智能工作台（Teacher Smart Workbench）
概述
一套面向中小学教师的个人智能工作台：单个 HTML 文件 + 9 个课时数据文件，零依赖、零构建，数据全部存在浏览器 localStorage。内置北师大版六年级上册整册 31 课时教案数据库（每课时含师生对话详案、9 道三档分层题、7-8 页课件预设）。标题下方可选年级/科目/教材版本，三大内容模块（教案室/课件工坊/作业生成器）按选择智能匹配同一份教材目录并实时共用；目录与课时内容支持按需生成，默认「助手代写」——复制指令粘贴到用户自己的 WorkBuddy 助手，助手用该账号的模型与额度生成并直接写进工作台 data/ai/ 目录，用户点「同步 AI 生成结果」即用，全程在一个 WorkBuddy 内完成，不下载工单、不导入回执（也可选直连模式由工作台直接调模型接口）；无本地登记表时可下载《班级作业登记表》模板。配合 scripts/ 下的四个 Python 脚本，可打通「出作业 → 登记 → 写回 Excel → 更新学生档案 → 周一自动周报」的完整数据闭环。
何时使用
- 用户说想要「教学工作台 / 备课工作台 / 教师助手页面」，或列出一串需求（写教案、做课件、出分层作业、登记作业、记学情、看学情）
- 用户已有一份本地 HTML 工作台，要求适配、修改或重新发布
- 用户要求把工作台分享给其他老师（打包/发链接）
两条使用路径
路径 A：在线版（最快，30 秒可用）
直接把在线链接给用户，浏览器打开即用，数据存在用户自己浏览器的 localStorage 里，互不干扰。适合「先试试」和其他老师快速上手。
路径 B：本地版（可深度定制）
把 assets/workbench/ 整个目录复制到用户的工作区（建议目录名 teacher-workbench/），保持 index.html 与 data/db/ 的相对位置不变，双击 index.html 即可用。之后按需适配（见下节）。
本地版适配清单
按顺序完成，每步都在告诉用户「改哪里」：
- 教学配置（年级/科目/教材版本）：打开工作台 → 左侧「教师智能工作台」标题下方的三个下拉菜单，选好自己的年级、科目、教材版本。该选择驱动教案室/课件工坊/分层作业生成器三大模块的教材目录匹配。
- 班级信息：打开工作台 → 系统设置 → 填学校/班级/任课教师/学生人数/知识库名称/登记表路径 → 保存。
- 学生名单：系统设置 → 学生名单文本框，每行一条「学号 姓名」，保存。也可用脚本批量替换：
bash python scripts/set_roster.py <index.html路径> <名单.txt路径>
名单.txt 每行「学号 姓名」或「学号,姓名」。 - 难度标准：系统设置 → 分层难度标准（基础/提升/拓展说明 + 每次题量，默认 5 题 = 基础2+提升2+拓展1）。
- 教材与课题：选择「六年级 · 数学 · 北师大版」时直接用内置整册 31 课时教案库；其他配置点「AI 生成教材目录」按需生成（见下节）。如需固化成本地数据，再改
data/db/u*.js，结构见 references/setup-guide.md 的「课时数据库结构」。 - 本地情境：题库和教案里的「铜川」元素（樱桃、耀州窑、药王山等）是本地化示例，引导用户替换成自己所在地区的元素，学生代入感更强。
模块地图
工作台共 9 个模块，详细功能与数据位置见 references/modules.md：
首页驾驶舱（待办/学情快照/快捷入口）· 电子教案室（整册课时树→详案→导出打印）· 课件工坊（一键生成可播放课件）· 分层作业生成器（按课时/按知识点，三档难度，A4打印）· 作业统计台（逐人标记√○×→登记工单）· 学情速记（自然语言→自动识别学号/姓名/日期/类型→存档）· 学情分析中心（周报结构/红榜/预警）· 日历与提醒 · 系统设置。
年级 / 科目 / 教材版本：目录匹配 + 按需生成
工作台标题下方有三个下拉菜单（年级 × 科目 × 教材版本），驱动三大内容模块：
- 先匹配教材目录：选「六年级 · 数学 · 北师大版」→ 直接用内置整册 31 课时教案库（教案/课件/题目齐全）。选其他配置 → 模块顶部显示「尚未生成该教材目录」，点「AI 生成教材目录」先拿目录。目录一经生成，三个模块实时共用：教案室的课时树、课件工坊的单元/课时下拉框、作业生成器的课时卡片都直接引用它，切配置或同步新目录后立即刷新。
- 内容按需生成：目录里的课时默认只有课题。点某个课时（教案室）/ 选课时生成（课件工坊）/ 选课时出题（作业生成器）时才生成该课时的教案详案、9 道三档题、7-8 页课件预设，生成后存入本机浏览器，可继续编辑、打印、播放，不重复生成。
- 生成调用使用者自己的模型与额度，两种方式（系统设置 → AI 生成服务）：
- 助手代写（默认 · 免配置）：点生成 → 弹窗给出现成指令 → 用户复制后粘贴到自己的 WorkBuddy 助手聊天窗口 → 助手用该账号下的模型与额度生成，并直接写进工作台assets/workbench/data/ai/目录、更新manifest.js→ 用户回工作台点「同步 AI 生成结果」（或刷新页面，启动时自动同步）。全程在一个 WorkBuddy 内完成，不下载工单、不导入回执。弹窗里的「下载工单 JSON / 导入回执」保留为备用通道。文件约定见 references/ai-collaboration.md 第 6 节。
- 直连模式：配置 WorkBuddy 云服务（endpoint + publishableKey，免密钥大模型）或任意 OpenAI 兼容接口（baseUrl + Key + 模型ID），点「立即生成」由工作台直接调用。 - 登记表模板：作业统计台/系统设置提供《班级作业登记表》模板下载（Excel .xls 与 .csv 两种，14 次作业块、55 人标记区、表扬/反馈/特别提醒栏），没有本地登记表的老师可直接下载按结构填写。
存储键：wt_teach（教学配置）、wt_cat_<年级|科目|版本>（生成的目录）、wt_gen_<年级|科目|版本>（按需生成的课时内容）、wt_ai（AI 生成服务配置）。详见 references/modules.md。
数据闭环（按需启用）
当用户说「要把作业写回 Excel」「更新学生档案」「每周自动出周报」时，加载 references/ai-collaboration.md，按其中的脚本契约执行。四个脚本：
| 脚本 | 作用 |
|---|---|
scripts/process_hw_record.py |
登记工单 JSON → 写回 Excel 登记表（自动找空白块、写前备份） |
scripts/update_archives.py |
登记工单 JSON → 逐人更新学生档案 md |
scripts/generate_weekly_report.py |
解析登记表 → 增值/预警/星级 → 周报 md |
scripts/ima_upload.py |
文件 → COS → 知识库入库（配 ima 连接器使用） |
发布与分享
- 更新在线链接：修改本地
assets/workbench/或用户工作区副本后，用发布工具重新部署。发布目录里只放 index.html 和 data/db/，不要把登记表、档案等含学生数据的文件放进去。 - 分享给其他老师：优先给在线链接；对方要深度定制再给本地版 + 本技能的适配清单。
- 打包技能分发：用技能打包工具把本技能目录打成 zip，其他老师安装后，其 AI 助手即具备完整的部署适配能力。
隐私红线（必须遵守）
- 学生姓名、成绩、基准分等个人数据一律不进入发布目录和技能包——技能包里的名单是通用示例名，基准分通过
scripts/baseline.json外置（该文件不随技能分发）。 - 注册表 xlsx、学生档案目录只放用户本地，不上传、不外发。
- 周报脚本无
baseline.json时自动降级（Δ 留空），不会报错，可安全演示。
常见问题
- 打开页面空白：检查 index.html 与 data/db/ 的相对位置；用浏览器直接打开（file://）即可，不需要服务器。
- 换课时后教案树不变：data/db/ 下的文件名与 index.html 里的
<script src>标签一一对应，增删文件要同步改标签。 - 数据丢了：localStorage 按域名/目录隔离，换浏览器或清缓存会丢；提醒用户定期用各模块的导出功能备份。
