更新课件

本文基于悟榜板书当前 wbpkg 更新链路整理，重点说明“打开已有课件后，如何继续修改并重新发布到课程内容系统”。文档模板沿用《创建并发布课件》的写法，后续仍需补齐真实界面截图、按钮名称和页面文案。

本文要解决什么问题

• 说明老师如何对已经发布过的 wbpkg 课件继续更新
• 说明“本地保存编辑结果”和“重新发布更新版本”的区别
• 说明什么情况下可以直接更新，什么情况下需要先生成新的可发布课件

适用场景

• 已经发布过一个课件，现在要修改标题页、批注、题目、导图或步骤
• 已经打开一个 wbpkg 课件，需要把最新内容同步回平台
• 需要对原有课件做版本迭代，但不希望在平台上生成重复的新课件

更新前准备

• 先登录悟榜账号。未登录时，无法更新课件。
• 建议直接打开原来的 wbpkg 课件，再进行修改和发布。
• 当前登录账号应为课件原作者，否则系统会拒绝更新。
• 如果本地已经产生了未整理完的编辑结果，先确认是否已经保存成可发布状态。
• 更新流程依赖网络连接，因为最终需要把更新后的课件同步到课程内容系统。

先理解三种状态

简单理解：

• 平台更新依赖的是“可直接上传的完整 wbpkg”。
• 如果你当前手里的只是本地编辑结果，系统会要求你先整理成可发布课件，再执行更新。

为什么“保存”不等于“更新课件”

简单理解：

• “保存”只影响本地文件。
• “更新课件”才会把新版本上传到平台，并覆盖原来的课件内容版本。

更新课件的核心规则

当前 wbpkg 更新链路里，有三条规则最重要：

• 只能更新已有课件，不能把一次更新误变成新建课件。
• 只有原课件作者才能继续发布更新。
• 只有当本地课件已经处于“可直接上传”的完整状态时，系统才允许直接更新。

这里最关键的是课件身份信息保持稳定：

• 课件标题可以更新。
• 课件内容可以更新。
• 但课件 ID / UUID 必须保持与原课件一致，否则会有“更新错对象”或“误发布成新课件”的风险。

标准更新流程

第一步：打开要更新的 wbpkg 课件

• 打开之前已经发布过的 wbpkg 课件。
• 建议直接从原始课件文件进入，而不是从一份临时导出的副本进入。
• 如果你更新的是平台已有课件，优先确认当前打开的就是那份对应课件。

第二步：完成需要修改的内容

常见可更新内容包括：

• 批注和讲解标记
• 题目内容
• 导图结构
• 答案步骤和 markdown
• 课件封面页或说明页

建议在更新前先确认：

• 当前没有仍在编辑中的题目
• 步骤内容已经补全
• 不再保留无效页面上的旧标注

如果这些内容没有整理好，后续更新流程仍可能失败。

第三步：判断当前课件是否可以直接更新

当前产品链路里，已打开 wbpkg 想直接更新平台，需要同时满足：

• 当前账号是原作者
• 课件元数据完整，能识别出原课件 ID
• 当前没有未保存编辑内容
• 本地不存在单独的 wbann 外挂标注文件

其中后两项很关键：

• 如果检测到未保存编辑内容，系统会提示你先生成可发布课件后再发布。
• 如果检测到本地存在 wbann，说明你目前手上的修改还只是本地附加标注，不能直接拿来覆盖平台课件。

第四步：点击“发布课件”并进入更新模式

• 从工具栏或功能区进入“发布课件”操作。
• 系统会打开发布对话框。
• 对于已有 wbpkg，系统会优先走“更新课件”链路，而不是“新建课件”链路。

这一阶段的核心作用，是让前端页面把“当前要更新的是哪一个课件”这件事确认下来。

第五步：确认更新信息

在更新课件页面里，系统通常会带回原课件的基础信息，并继续确认：

• 当前课件 ID / UUID
• 当前标题
• 当前发布类型
• 课程内容页上的文档信息

这一步会做一致性校验，避免出现以下问题：

• 页面里选中的课件 ID 和本地打开课件的 ID 不一致
• 返回的文档数据不完整
• 当前更新请求对应错了课件对象

一旦课件 ID 不匹配，系统会直接阻止更新。

第六步：关闭对话框并执行上传

与“从 PDF 新建课件”不同，wbpkg 更新流程通常不需要重新生成一个新的课件身份，而是优先复用当前可上传的课件包。

如果当前课件已经满足可直接更新条件，系统会：

1. 保留原课件 ID
2. 复用当前课件标题和类型等元数据
3. 直接把当前 wbpkg 作为上传源文件
4. 调用课件上传接口，把新版本同步到平台

也就是说，wbpkg 更新的重点不是“创建一门新课”，而是“把原课件替换成最新版本”。

第七步：确认更新结果

更新成功后，建议立即确认以下结果：

• 平台课程内容页中，看到的是原课件被更新，而不是新生成了一个重复课件
• 标题、页数和内容与本次修改一致
• 重新打开课件后，批注、题目、导图和步骤恢复正常
• 原有授权关系、购买关系和分享入口仍然有效

什么情况下不能直接更新

当前登录账号不是课件作者

系统会直接拒绝更新。

• 需要切回原作者账号登录。
• 当前链路下，非作者不能替代原作者发布更新版本。

课件元数据缺失

如果当前课件里无法识别出原课件 ID，系统无法确定你要更新哪一个平台课件。

• 这类情况通常不能直接更新。
• 需要先确认课件来源是否正确，或重新从正确的原课件开始。

检测到未保存编辑内容

这说明当前本地状态和可上传课件包不一致。

• 系统会提示你先生成可发布课件后再发布。
• 先把本地编辑结果整理完成，再重新进入更新流程。

检测到本地 wbann 外挂标注

这说明修改还停留在“本地附加标注”层，没有回到完整 wbpkg 课件包。

• 系统不会直接拿 wbann 去覆盖平台课件。
• 需要先生成一份可发布的完整课件，再继续更新。

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

更新失败时优先排查什么

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

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

提示非课件作者无法发布

• 当前登录账号不是原作者
• 切换回原作者账号后再试

提示课件元数据缺失，无法发布

• 当前打开的文件可能不是原始可更新课件
• 先确认是否打开了正确的 wbpkg

提示数据 ID 不匹配

• 平台页面选中的课件，与本地打开课件不是同一个对象
• 不要继续强行更新，先确认课件来源和平台记录是否一致

提示检测到未保存编辑内容

• 当前编辑结果还没有整理为可直接上传的课件状态
• 先完成整理，再重新更新

提示检测到本地外挂标注

• 当前修改还停留在 wbann 层
• 先生成可发布课件，再执行更新

上传失败

• 先检查网络连接
• 再确认当前账号状态是否有效
• 确认待上传的 wbpkg 文件确实存在且没有被移动或删除

推荐的实际操作顺序

1. 先打开原始 wbpkg 课件。
2. 完成本次需要更新的批注、题目、导图和步骤修改。
3. 确认没有编辑中的题目、没有遗漏步骤、没有脏数据。
4. 再执行“发布课件”，进入更新课件流程。
5. 发布成功后，回到平台确认原课件已被更新。

这样做的好处是：

• 能最大程度避免把“更新”误做成“新建”
• 更容易定位是本地编辑问题、元数据问题还是上传问题
• 更适合长期维护同一套课程内容

常见问题

为什么我已经改了内容，但平台上还是旧版本

常见原因有两种：

• 你只做了本地保存，没有执行“更新课件”上传流程。
• 当前修改还停留在未保存状态或 wbann 状态，系统并没有拿它直接更新平台。

为什么更新时比新建限制更多

因为更新课件不是单纯上传文件，而是要覆盖平台上一份已经存在的课件记录。

• 系统必须确认作者身份。
• 系统必须确认课件 ID 一致。
• 系统必须确认当前文件是可直接上传的完整课件包。

为什么平台上不能把这次更新变成一个新课件

因为更新链路的目标就是“沿用原课件身份，上传新版本”。如果系统发现课件 ID 不一致，就会优先拦截，而不是默默帮你新建一份重复课件。

人工补全清单

• 补齐“更新课件”真实入口名称
• 补齐更新页面中的真实字段名
• 替换为实际界面截图
• 增加一个“打开旧课件 -> 修改 -> 更新成功”的完整示例
• 如果后续产品支持更清晰的版本历史，再补充版本记录说明