study-workbench
学习工作台模板生成技能。基于已验证的引擎模板,一句话生成学生每日学习工作台(按开学日进度排课、每日知识点+讲解+练习、每日积累、每日任务、单元复习、考试倒计时),默认内置八年级上册语数英(人教版·英语2024)。支持换年级/学科/教材版本——提供 content-pack JSON 即可裂变出任意学习台。单文件 HTML、手机电脑通用、localStorage 存储、可部署。触发词:学习台、学生台、做个学习台、每日学习、按进度排课、备考台、课程表、xx年级、xx科、人教版。
学习工作台模板(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 · 默认生成(最常见)
- 复制
assets/study-workbench-engine.html到用户目标路径(如学习台.html)。 - 连同
assets/目录一起保留(图标subj-*.png、头图hero-banner.jpg为相对路径引用;部署时一并带上)。 present_files呈现 HTML,告知用户:浏览器打开即用,数据存本地。- 提醒:定期到「我的」导出备份;开学日 / 四场考试日期在「我的」改(已预填建议值,以学校实际为准)。
Phase 2 · 换年级 / 学科 / 教材(模板裂变)
- 用户给目标(如「七年级数学人教版」「高一物理」)。
- 按
references/content-pack-schema.md写新 content-pack JSON(可让 AI 辅助生成课程数据,务必符合 schema 字段、合法 JSON)。 - 注入(二选一):
- 脚本:
node references/inject_pack.js <引擎模板> <新内容包.json> <输出.html> - 手动:用 Edit 把引擎顶部
const CONTENT_PACK = {...};整段替换为新包 JSON,保留其后四行重导出(const SUBJECTS = CONTENT_PACK.subjects;等)不变。
- 脚本:
- 同步更新
<title>与品牌名(如「七年级学习台」)。 - 校验(必做):
node <workbench-builder>/references/verify_static.js <输出.html>应 17/17;node --check提取脚本语法;桩 DOM 跑六页渲染冒烟。 - 呈现产物(HTML + assets 目录)。
Phase 3 · 部署(按需)
用户要手机用 / 分享 → 把 HTML + assets/ 一起部署(参考 workbench-builder 部署流程),拿到链接后教「手机浏览器打开 → 分享 → 加到主屏幕」。注意 CloudStudio 部署目录路径不能含空格。
八项铁律(已落实;生成 / 改内容仍需保持)
- localStorage:数据存浏览器本地,key 前缀
wb_stu_,刷新关闭不丢。 - 备份必须有:首屏「导出 JSON / 导出 CSV / 导入恢复」;导入不限条数;清空二次确认;积累 30 条温和提示。
- 全内联零外链:系统字体栈,无 CDN / 框架 / 字体外链;内容包可选
bookUrl(电子课本)除外。 - 移动适配:窄屏单列;按钮 ≥44px;输入框 ≥16px;PC 左栏 / 移动底 Tab;适配安全区。
- 今天要处理置顶:逾期标红 + 一键完成;昨天未做完自动顺延到今天。
- 预置示例数据:首次打开即有内容(含示例任务),不空白。
- 首版 ≤3-4 模块:今日 / 课程进度 / 积累 / 复习 / 倒计时 / 我的,聚焦学习主线。
- 国内习惯:日期
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 后续演进,不在本模板技能范围。
Related skills
- Downloads
- Security audit
- Review
- Last updated
- 3mo ago
- Current version
- v0.1.0
- License
- MIT-0
