教师工作台生成器
直接交付内置的成品工作台并发布为可分享链接。没有代码生成步骤:学段、科目、角色、风格全部由教师在页面内选择,选完即用。
工作流程
按顺序执行,不要跳步。
Step 1 — 确认发布名称
只确认一件事:工作台的发布名称。
- 用户已给出名称(或上下文可推断,如"给初三物理王老师做一个工作台"→
物理教师王老师工作台)则直接使用。 - 否则用 AskUserQuestion 问一次名称,提供默认选项「教师一体化工作台」。
- 不要询问学段、科目、角色、风格——这些由教师在页面内自选;问了反而拖慢交付。
Step 2 — 校验预置工作台
对内置成品执行静态校验(执行,不是阅读):
python3 scripts/verify.py workbench/index.html
应输出 VERIFY OK。出现 FAIL 必须停止并如实上报,不得带病发布。
Step 3 — 发布(QW Pages)
遵循 qw-pages 发布契约,要点如下(完整规则见 reference.md):
- 该工作台为静态页面。新建独立发布目录,把
workbench/index.html复制为发布目录下的index.html(发布目录与技能目录分开,不要把技能目录整个发布出去)。 - 调用内置工具
qwenwork_pages_publish恰好一次:file_path为发布目录绝对路径,category: "static",name用 Step 1 确认的中文名称。 - 不自行执行 Page/Barn HTTP 调用、不索取 token、不 curl 公开 URL 验证;以工具返回的结构化结果为准。
- 更新场景:
- 教师想改自己的偏好(学段/科目/角色/风格/学期设置)→ 直接告知其在页面右上角「设置」或首次弹窗中修改,不需要重新发布。
- 需要改工作台本身的功能/文案 → 对workbench/index.html做最小 Edit,重新执行 Step 2-3(同一域名新版本)。
- 桌面端在同一域名创建新版本,不要发布到新域名。 - 部署成功后,向用户返回最终公开 URL。
Step 4 — 交付
返回发布链接 + 一段简短说明:
- 首次打开按弹窗选择学段、科目、角色、风格与学期信息(年级/学期/周数/开学日期),保存后工作台按选择即时适配并载入演示数据,开箱即用。
- 数据只保存在教师自己浏览器的 localStorage,随时可用右上角「备份」导出 JSON、「恢复」导入。
- 不要输出冗长的功能清单复述。
预置工作台说明(agent 须知)
workbench/index.html是通用成品:三大板块、20 个模块,全部真实可用(列表/新增/删除 + localStorage 持久化,键前缀wb_,wb_seeded防止演示数据复活),详细规格见 reference.md。- 页内选择与运行时适配:
- 科目:自由输入,工作区命名、模块文案、课表与成绩上下文自动跟随。
- 学段:小学 = 课堂表现 + 习惯养成打卡、无升学专项、明黄默认主题;初中 = 中考专项、青春期谈话、蓝色默认主题;高中 = 高考专项、选科与志愿跟踪、月考排名、灰蓝默认主题。
- 角色:仅科任教师自动隐藏班主任工作区与「班级全局课表」(班主任视角)。
- 风格:6 套预设主题一键切换(明黄活泼/蓝色简约/灰蓝专业/粉色可爱/清新薄荷/优雅紫罗兰)。
- 上传类素材只存元数据 + 缩略图(单文件 ≤500KB),超限降级为记录来源链接并在 UI 提示——这是 localStorage 容量约束,勿当作 bug 修改。
回退:自定义生成(legacy)
仅当用户明确提出预置无法满足的需求(如:指定风格主题之外的 UI 定制、增删模块、按特定教材版本预置章节内容)时启用:
- 先向用户说明:预置工作台可秒级交付且后续免维护,定制生成耗时较长;确认用户仍要定制后再继续。
- 读取
legacy/prompts/:按「学段 + 科目 + 角色」模糊匹配文件名(教师班主任与教师+班主任等价,教师表示仅科任,忽略+、兼等字符差异)。命中 → 严格按该提示词全文执行。 - 未命中 → 读取
legacy/prompts/_template.md,按其文件头的占位符映射表替换,并按学段做模块适配(小学弱化成绩分析、强化课堂表现/家校联系/习惯养成/作业打卡;初中保留分层题库、中考专项、青春期谈话;高中增加选科指导、高考专项、月考排名、志愿/学考跟踪)。非班主任角色的裁剪:删「三、班主任工作区」整节 + 课表区「所带班级全局课表」条目 + 排座位删「综合表现」表述。 - 生成策略沿用旧约定:分轮写入(先骨架后模块,每轮 2-4 个模块);每个模块必须真实可用(列表+新增+删除+持久化);仪表盘统计必须来自真实数据聚合;源文件落盘命名
workbench-学段科目-角色.html。 - 生成后执行
python3 scripts/verify.py <文件>,通过后按 Step 3 契约发布(发布名称同样先与用户确认)。
维护
- 预置工作台的功能/主题增改:直接修改
workbench/index.html→ 跑scripts/verify.py→ 升 version → 重新打包发布。 legacy/prompts/已冻结:不新增、不修改,除非用户要求扩充生成路径。