study-workbench

学习工作台模板（Study Workbench）

概述

为学生（默认初中语数英）生成「每日学习工作台」单文件 HTML：以开学日为起点按进度排课，每天列出各科知识点 + 讲解 + 练习题，并含每日积累、每日任务、单元复习、考试倒计时。手机电脑都能用，数据存浏览器本地不丢，可一键部署分享。

本技能把已验证成熟的学习台（v3，八年级上册语数英人教版·英语2024）抽象为「引擎 + 内容包」两层：

• 引擎（assets/study-workbench-engine.html）：排课/渲染/积累/任务/复习/倒计时/导出/localStorage/UI 全部逻辑，零外部依赖（系统字体、无 CDN、可选 bookUrl）。
• 内容包（references/sample-pack-8up-cme.json）：课程数据（年级/学科/教材），可替换。

默认生成 = 直接复制引擎（其顶部已内置八上语数英内容包）；换年级/学科/教材 = 写一份新 content-pack JSON，替换引擎顶部的 const CONTENT_PACK 即可裂变出全新学习台。

来源：本技能由 study-daily 项目（泽羚科技·冉兄）沉淀而来，是该学习台产品化的第一步（v1 单文件 → v2 发布 → v3 课程自学对齐 → 本技能模板化）。

---

触发场景与触发词

• 「做个学习台」「生成学生台」「每日学习工作台」「按进度排课」「备考台（学习）」「课程表」
• 「八年级/七年级/高一 + 语数英/某科 + 人教版/北师大版」
• 「以现在这个学习台为基础做个模板」「裂变出其他年级的学习台」
• 触发词：学习台、学生台、每日学习、课程表、按进度排课、备考、xx年级、xx科、人教版

未命中但用户想要「任意场景工作台」（记账/减脂/待办等非学习）→ 用 workbench-builder 技能，本技能只做学习场景。

---

核心设计：引擎 + 内容包分离

• 引擎顶部 const CONTENT_PACK = {...} 是全部课程数据；引擎其余代码只读取它来渲染，不写死任何课程/年级内容。
• 换内容 = 替换 CONTENT_PACK：默认内置八上语数英人教版（英语 2024 教材）；新包 = 新 JSON。
• 排课逻辑：以 startDate（开学日）为起点，在 maxDay() 个上学日内把各单元 lesson 均匀铺开，每天按 subjects_order 生成各科任务。内容包只需给全量课程，无需自己排到具体日期。

---

使用流程

Phase 1 · 默认生成（最常见）

1. 复制 assets/study-workbench-engine.html 到用户目标路径（如 学习台.html）。
2. 连同 assets/ 目录一起保留（图标 subj-*.png、头图 hero-banner.jpg 为相对路径引用；部署时一并带上）。
3. present_files 呈现 HTML，告知用户：浏览器打开即用，数据存本地。
4. 提醒：定期到「我的」导出备份；开学日 / 四场考试日期在「我的」改（已预填建议值，以学校实际为准）。

Phase 2 · 换年级 / 学科 / 教材（模板裂变）

1. 用户给目标（如「七年级数学人教版」「高一物理」）。
2. 按 references/content-pack-schema.md 写新 content-pack JSON（可让 AI 辅助生成课程数据，务必符合 schema 字段、合法 JSON）。
3. 注入（二选一）：
   • 脚本：node references/inject_pack.js <引擎模板> <新内容包.json> <输出.html>
   • 手动：用 Edit 把引擎顶部 const CONTENT_PACK = {...}; 整段替换为新包 JSON，保留其后四行重导出（const SUBJECTS = CONTENT_PACK.subjects; 等）不变。
4. 同步更新 `` 与品牌名（如「七年级学习台」）。
5. 校验（必做）：node /references/verify_static.js <输出.html> 应 17/17；node --check 提取脚本语法；桩 DOM 跑六页渲染冒烟。
6. 呈现产物（HTML + assets 目录）。

Phase 3 · 部署（按需）

用户要手机用 / 分享 → 把 HTML + assets/ 一起部署（参考 workbench-builder 部署流程），拿到链接后教「手机浏览器打开 → 分享 → 加到主屏幕」。注意 CloudStudio 部署目录路径不能含空格。

---

八项铁律（已落实；生成 / 改内容仍需保持）

1. localStorage：数据存浏览器本地，key 前缀 wb_stu_，刷新关闭不丢。
2. 备份必须有：首屏「导出 JSON / 导出 CSV / 导入恢复」；导入不限条数；清空二次确认；积累 30 条温和提示。
3. 全内联零外链：系统字体栈，无 CDN / 框架 / 字体外链；内容包可选 bookUrl（电子课本）除外。
4. 移动适配：窄屏单列；按钮 ≥44px；输入框 ≥16px；PC 左栏 / 移动底 Tab；适配安全区。
5. 今天要处理置顶：逾期标红 + 一键完成；昨天未做完自动顺延到今天。
6. 预置示例数据：首次打开即有内容（含示例任务），不空白。
7. 首版 ≤3-4 模块：今日 / 课程进度 / 积累 / 复习 / 倒计时 / 我的，聚焦学习主线。
8. 国内习惯：日期 YYYY-MM-DD；配色与表达符合国内学情。

---

内容包 Schema

完整字段规范 + 示例见 references/content-pack-schema.md。

---

资源

• assets/study-workbench-engine.html — 引擎模板（默认内置八上语数英人教版·英语2024 内容包，开箱即用）
• references/sample-pack-8up-cme.json — 示例内容包（八上语数英人教版·英语2024，含古诗文积累全文）
• references/content-pack-schema.md — 内容包字段规范与写法
• references/inject_pack.js — 内容包注入脚本（裂变新年级/学科一键产出）
• 校验：复用 workbench-builder 技能的 references/verify_static.js 对生成产物做 17 项铁律回归

自检约定：每次生成 / 用内容包裂变后，跑 verify_static.js 做静态铁律回归 + 语法校验 + 六页渲染冒烟。这是保证「拿到就能用」的生产底线。

---

不做清单（明确边界）

• 不做账号体系：靠导出 / 导入迁移数据。
• 不做后端 / 联网：纯前端，数据只在用户浏览器。
• 不把课程内容写死进引擎：永远走内容包（这是模板化的核心）。
• 智能体化（RAG 知识库 / AI 答疑 / 错题本 / 艾宾浩斯自适应）属 study-daily 后续演进，不在本模板技能范围。