@dongfangw/prep-kit

中文文档
0.3.2发布于 2026/11/09AGPL-3.0-or-laterTypeScriptES Module近 30 天下载 4386

备课套件:知识库/教案/课件三件套的门禁引擎 + AI 便签闭环 + B 站视频链接检索/嵌入 + 10 个备课技能

原始使用文档
文档目录5 节
  1. 组成
  2. B 站视频(2026-11 新增)
  3. 设计约束
  4. 状态
  5. 许可

@dongfangw/prep-kit · 备课套件

从"写一节知识库"到"出一套课上得下来的课件",带门禁与 AI 便签闭环。

组成

块内容
gates/门禁引擎:教案预检、课件静态 lint、渲染门禁(溢出/字号/遮挡)、教案↔课件覆盖差集
policy/可插拔课程规则(阈值、布局值域来源、术语表);默认 examples/policy/generic.yaml
skills/10 个技能:写知识库、写教案、做 PPT、审 PPT、导出 PDF、素材检索、素材下载、B 站视频检索/片段、备课总流程、教学同步
插件「备课工作台」页 + 便签台(tweak-bench,含 Codex 无人值守执行器)+ 「上课模式」按钮
工具prep_doctor prep_ppt_lint prep_ppt_gate prep_sync_check prep_lesson_gate prep_kb_lint prep_tweak_list prep_tweak_done prep_capture prep_vision prep_bili_search prep_bili_analyze

B 站视频(2026-11 新增)

按老师意图检索 B 站视频 → 给证据支撑的播放区间(起–止)→ 产出知识库/教案 adoc 媒体卡与 Slidev iframe,只嵌 B 站官方播放器链接(不下载、不剪本地片段)。匿名可用(章节/简介/评论/弹幕), 配置 BILI_SESSDATA 后解锁逐句字幕与 AI 大纲。说明见 skills/bili-video/SKILL.md、docs/bili-video.md, GitHub 调研见 docs/bili-video-research.md。

设计约束

  • 不认磁盘布局:内容路径只从 library.yaml 来;prep_doctor 打印解析结果。
  • 不写死布局值域:读主题的 layouts.manifest.json;没有清单的主题只跑通用检查。
  • 不含任何课程内容:技能只讲方法,示例用自造素材。

状态

施工中(阶段 5)。从 student-pack/ext/* + PrepWorkspace 拆出。

许可

MIT。

版本与发布记录

@dongfangw/prep-kit 共发布 23 个版本,首次发布于 2026/11/01;过去 12 个月发布了 23 个版本。

版本发布日期距今
0.3.2latest2026/11/094 天前
0.3.12026/11/067 天前
0.3.02026/11/058 天前
0.2.92026/11/058 天前
0.2.82026/11/049 天前
0.2.72026/11/0310 天前

关于 @dongfangw/prep-kit 的常见问题

@dongfangw/prep-kit 是什么?

备课套件:知识库/教案/课件三件套的门禁引擎 + AI 便签闭环 + B 站视频链接检索/嵌入 + 10 个备课技能

如何安装 @dongfangw/prep-kit?

在项目目录运行 npm install @dongfangw/prep-kit,或使用 pnpm add / yarn add / bun add。

@dongfangw/prep-kit 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dongfangw/prep-kit 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dongfangw/prep-kit 可以商用吗?

@dongfangw/prep-kit 使用 AGPL-3.0-or-later 许可。最严格的 Copyleft:除分发外,通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括,不构成法律意见,请以许可原文为准。

@dongfangw/prep-kit 的下载量有多少?

根据 npm 官方下载统计,@dongfangw/prep-kit 在 2026/10/13 – 2026/11/11 这 30 天内被下载 4,386 次,日均约 146 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dongfangw/prep-kit 还在维护吗?

最新版本 0.3.2 发布于 2026/11/09(4 天前);至今共发布 23 个版本,其中过去 12 个月发布了 23 个;首次发布于 2026/11/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。