创建课件

本文基于悟榜板书当前 wbpkg 发布链路整理，重点说明“从已有 PDF 生成课件并发布到课程内容系统”的完整过程。后续仍需补齐真实界面截图、按钮名称和页面文案。

本文要解决什么问题

• 说明老师如何把正在讲解或备课的 PDF 整理成可发布的悟榜板书课件
• 说明“本地保存标注”和“正式发布课件”这两条流程的区别
• 说明发布后课件会如何生成 wbpkg 并上传到平台

适用场景

• 已经有 PDF 讲义，准备发布成可分享、可授权的课件
• 已经完成题目、导图、步骤、批注整理，准备正式上架或分发
• 已经打开过一个 wbpkg 课件，需要继续更新并重新发布

发布前准备

• 先登录悟榜账号。未登录时，无法生成和上传课件。
• 当前打开的源文件应为 PDF 或已有的 wbpkg 课件。
• 如果是从 PDF 发布，建议先完成题目、导图、步骤和批注整理。
• 如果当前还有正在编辑中的题目或未补全的步骤内容，系统会阻止继续发布。
• 发布流程依赖网络连接，因为最终需要把课件上传到课程内容系统。

先理解两种保存方式

简单理解：

• “保存”只是保留本地编辑结果。
• “发布”才会生成完整课件包，并把课件上传到服务器。

wbpkg 是什么

wbpkg 是悟榜板书的课件包格式，会把以下内容打包到一个文件中：

• 原始 PDF 内容
• 课件基础信息，如课件标题、作者、课件 ID、课件类型
• 页面上的批注、题目、导图、步骤等图元数据

发布完成后，平台侧保存的是可分发、可授权、可再次更新的课件版本。

标准发布流程

第一步：打开要发布的内容

• 打开一个待发布的 PDF 文件，或打开一个已有的 wbpkg 课件。
• 如果当前已经打开同名课件，系统可能要求先关闭已有课件，再继续生成新的课件包。
• 如果你只是刚导入 PDF，还没有整理结构，建议先完成批注和步骤编辑再发布。

第二步：检查课件内容是否已整理完成

发布前建议确认以下内容：

• 页面顺序已经整理好
• 需要保留的批注都已保存
• 题目对应的答案步骤和 markdown 已补全
• 没有关联到无效页面的旧标注

当前产品链路中，发布前会自动做两类检查：

• 检查是否存在仍在编辑中的题目
• 检查步骤内容是否缺失

如果检查不通过，系统会先提示你补全，再允许继续发布。

第三步：点击“发布课件”

• 从工具栏或功能区进入“发布课件”操作。
• 系统会打开一个发布对话框。
• 对话框内部承载的是课程内容页面，用户需要在这里填写发布信息。 这一阶段的核心作用不是导出文件，而是先收集发布所需的课件信息。

第四步：填写课程发布信息

在发布页面里，通常需要确认或填写以下信息：

• 课件标题
• 课程或课件唯一标识
• 发布类型
• 课程简介、标签、语言等附加信息

系统会根据当前场景自动区分两类动作：

• 新建课件：当前内容第一次发布到平台
• 更新课件：当前内容对应的平台课件已存在，本次是更新版本

这里最关键的是“课件 ID / UUID”要稳定。

• 新建时，系统会创建新的课件身份。
• 更新时，系统会沿用已有课件身份，避免把一次更新错误地发布成一个新课件。

第五步：关闭发布对话框并生成 wbpkg

当你在发布页面确认完成后，系统会进入真正的打包阶段：

1. 先清理无效页面上的标注
2. 导出当前课件里的图元数据
3. 写入课件元数据，包括：
   • 课件标题
   • 创建时间
   • 作者用户 ID
   • 课件类型
   • 课件唯一 ID
4. 读取当前 PDF 内容
5. 把 PDF、元数据和标注一起打包成 wbpkg

这个过程在后台线程执行，界面会显示进度状态。

第六步：自动上传到课程内容系统

wbpkg 生成成功后，客户端会继续发起上传，不需要用户再手动找文件上传。

上传请求通常会附带：

• 当前登录用户信息
• 课件标题
• 课件 UUID
• 发布类型
• 文件路径
• 文件大小
• 页数
• 文件类型 wbpkg

上传成功后，平台课程内容页会更新为新的课件版本。

第七步：确认发布结果

发布成功后，建议立即确认以下结果：

• 课程内容页中能看到最新课件
• 课件标题与发布信息一致
• 页数和内容完整
• 打开课件后批注、题目、导图、步骤都能正常恢复

如果这次是更新已有课件，还应额外确认：

• 平台中更新的是原课件，而不是重复生成了一个新课件
• 原有授权关系、购买关系或分享入口没有被打断

新建课件与更新课件的区别

发布失败时优先排查什么

提示未登录或无法获取用户信息

• 先重新登录账号
• 确认登录状态没有过期
• 再重新进入发布流程

提示当前文件不支持发布

• 当前打开的不是 PDF，也不是可更新的 wbpkg
• 先确认源文件类型，再重新打开正确文件

提示有未完成的步骤或题目仍在编辑

• 先保存并关闭正在编辑的题目
• 补全步骤页和 markdown 内容
• 再重新发布

生成 wbpkg 失败

• 先确认当前文件不是空文件
• 检查 PDF 是否能正常打开
• 检查是否存在异常页面或无效标注
• 关闭后重新进入发布流程再试一次

上传失败

• 先检查网络连接
• 再确认账号状态是否有效
• 如果是更新课件，确认当前账号仍然是课件作者

推荐的实际操作顺序

1. 先导入并整理 PDF 内容。
2. 再补齐批注、题目、导图和步骤。
3. 完成一次本地保存，确保编辑结果不丢失。
4. 最后执行“发布课件”，生成并上传正式 wbpkg。

这样做的好处是：

• 本地编辑和正式发布边界清晰
• 出问题时更容易判断是“保存问题”还是“发布问题”
• 更适合团队协作和课程迭代更新

常见问题

为什么我点了保存，但平台上没有出现课件

因为“保存”和“发布”不是同一件事。

• 保存只会写本地标注文件。
• 只有执行“发布课件”，系统才会生成 wbpkg 并上传到平台。

为什么更新课件时提示无权限

当前产品链路里，已发布课件的再次发布会校验作者身份。

• 如果当前登录账号不是原作者，系统会阻止继续发布。
• 需要使用原作者账号登录后再更新。

发布后用户拿到的到底是什么

用户最终访问的是平台上的课件内容；底层文件格式是 wbpkg。这个格式同时包含 PDF 内容和课件结构信息，便于后续授权、购买校验和再次更新。

人工补全清单

• 补齐“发布课件”真实入口名称
• 补齐发布页面中的真实字段名
• 替换为实际界面截图
• 增加一个“从 PDF 到发布成功”的完整示例
• 如果后续产品支持更多源文件类型，再补充支持范围说明