如何打开课件
学习如何打开和加载现有的课件文件。
本文基于悟榜板书当前桌面端
wbpkg打开链路整理，重点说明“收到一个wbpkg课件后，如何在客户端中正确打开并查看”。后续仍需补齐真实界面截图、按钮名称和提示文案。
本文要解决什么问题
- 说明用户拿到
wbpkg课件后应该如何打开 - 说明为什么
wbpkg课件和普通 PDF 的打开方式不同 - 说明登录、授权、购买校验和离线访问对打开课件的影响
wbpkg 课件和普通 PDF 有什么不同
wbpkg 不是普通 PDF 文件，而是悟榜板书的课件包格式。它通常同时包含：
- PDF 原始内容
- 课件标题、作者、课件 ID 等元数据
- 课件中的批注、题目、导图、步骤等内容
因此，打开 wbpkg 不只是“把文件显示出来”，而是还要完成：
- 课件解密
- 身份校验
- 授权或购买状态检查
- 课件内容恢复
打开前需要确认
- 你使用的是悟榜板书桌面客户端。
- 当前账号已经登录。未登录时，不能打开
wbpkg课件。 - 如果你不是课件作者，通常还需要具备访问权限或购买记录。
- 首次打开某个课件时，建议保持网络可用，便于完成在线授权校验。
- 如果之前已经获取过离线授权，部分场景下可在弱网或短时断网环境下继续打开。
标准打开流程
第一步：在客户端中选择课件文件
你可以通过桌面客户端的打开入口，选择一个 .wbpkg 文件。
和普通 PDF 不同，系统识别到扩展名是 wbpkg 后，不会直接进入普通文档加载流程，而是会先进入课件专用打开流程。
第二步：系统先检查登录状态
当前产品链路中，wbpkg 打开前会先检查账号登录状态。
如果未登录：
- 系统会直接阻止打开。
- 用户需要先登录账号，再重新打开课件。
简单理解：
- 普通 PDF 可以直接打开。
wbpkg课件必须先通过账号体系校验。
第三步：系统后台解密课件
登录通过后，客户端会在后台线程中读取并解密 wbpkg：
- 校验文件头和基础格式
- 读取课件元数据
- 读取批注和图元数据
- 逐块解密 PDF 内容
- 校验文件完整性
这一阶段通常会显示“加载中”或类似进度状态。
如果文件损坏、格式不完整或解密失败，系统不会继续打开。
第四步：系统判断你是否有权打开
解密成功后，系统不会立刻显示课件，而是继续做授权决策。当前链路一般按以下顺序处理：
- 先判断当前登录账号是否就是课件作者
- 如果不是作者，先尝试本地离线授权
- 如果本地离线授权不满足，再发起在线购买或权限校验
只有校验通过后，系统才会真正打开课件。
第五步：进入课件阅读或讲解界面
授权通过后，客户端会把课件内容交给文档引擎加载，并恢复课件中的图元和结构信息。
这时你看到的通常包括：
- PDF 页面本体
- 课件中的批注和讲解标记
- 题目、导图、步骤等课件结构
- 与课件相关的工具区或侧边区状态
不同用户打开课件时会发生什么
课件作者打开自己的课件
如果当前登录账号就是课件作者，系统会优先走作者本人路径。
通常意味着：
- 不需要再走普通购买限制判断
- 更容易直接打开自己的课件
- 更适合继续备课、讲课和后续更新课件
已获得授权或已购买的用户打开课件
如果你不是作者，但已经获得权限，系统会继续检查：
- 本地是否已有有效离线授权
- 当前账号是否具备在线访问资格
校验通过后，可以正常进入课件。
未授权或未购买的用户打开课件
如果你既不是作者，也没有对应权限或购买记录，系统会阻止完整打开。
常见表现包括：
- 提示当前课件尚未购买
- 提示需要连接网络完成校验
- 提示无可用离线授权
为什么有时能离线打开，有时不能
当前 wbpkg 打开链路支持一定程度的离线授权能力，但不是完全无条件离线。
一般可以这样理解：
- 第一次打开某个课件时，建议联网完成校验。
- 如果系统已经为当前账号和设备保存了有效离线授权，后续在短时无网时仍可能打开。
- 如果本地没有可用离线授权，断网状态下就可能无法打开。
所以，是否能离线打开，取决于：
- 当前账号
- 当前设备
- 是否已经拿到过有效离线授权
- 离线授权是否仍在有效期内
打开后为什么还能看到本地修改
当前客户端除了读取 wbpkg 内嵌的基础课件内容，还会尝试读取同名的本地外挂标注文件：wbann。
这意味着：
wbpkg里保存的是基础课件内容wbann里可能保存了你后来在本地继续修改过的批注状态
如果同名 wbann 存在且格式有效，系统会把它叠加到当前课件显示中。
所以你看到的内容，可能是：
- 原始课件内容
- 再叠加本地最近一次保存过的编辑结果
打开后的典型状态
正常打开课件
说明以下环节都已通过：
- 登录状态有效
- 文件解密成功
- 授权校验通过
- 课件内容恢复成功
提示请先登录
说明当前账号未登录，或登录状态已经失效。
- 先重新登录
- 再重新打开课件
提示当前课件尚未购买或无权限
说明当前账号不是作者，且也没有通过购买或授权校验。
- 确认是否用了正确账号
- 确认是否已被授权或已完成购买
- 必要时联网后重试
提示网络不可用且本地无可用离线授权
说明系统尝试离线打开失败，同时也无法联网完成在线校验。
- 先连接网络
- 再重新打开课件
打开后内容不完整或标注异常
这类问题通常与以下几种情况有关：
- 本地外挂标注文件损坏
- 课件文件本身损坏
- 课件中的部分页面或标注数据异常
常见问题
为什么普通 PDF 能直接打开，wbpkg 却不能
因为 wbpkg 不只是文档文件，还带有课件身份信息和授权控制。
- 普通 PDF 主要是文件显示问题。
wbpkg还需要经过登录、解密和授权校验。
为什么我明明拿到了文件，还是打不开
拿到文件并不等于自动拥有访问权限。
常见原因包括：
- 当前没有登录
- 当前账号不是被授权账号
- 当前账号没有购买记录
- 当前设备上没有可用离线授权
- 当前网络不可用，导致无法完成在线校验
为什么作者能打开，学员却打不开
因为作者本人和普通访问用户走的是不同的判定路径。
- 作者通常可以优先走作者本人路径。
- 学员则需要依赖授权、购买记录或离线授权。
为什么我打开课件后，看到的是我本地改过的版本
因为客户端会尝试读取同名 wbann 本地标注文件。
- 如果本地存在这份文件，显示内容可能会覆盖或叠加到原始
wbpkg基础内容之上。 - 这通常是为了保留你本地最近一次保存的编辑结果。
推荐操作习惯
- 第一次打开新课件时，尽量保持联网。
- 使用你实际被授权或购买过的账号登录。
- 如果你是作者，尽量使用原作者账号打开和维护课件。
- 打开后如果发现内容和预期不一致，先检查本地是否存在同名
wbann文件。 - 如果用于课堂演示，建议提前完成一次打开测试，避免临上课时再处理授权问题。
人工补全清单
- 补齐客户端真实打开入口名称
- 补齐登录提示、购买提示和离线提示的真实文案
- 替换为实际界面截图
- 增加“作者打开”和“学员打开”两个完整示例
- 如果后续支持更多入口，再补充链接、二维码或其他打开方式说明