更新日志

• 2.0.3

  2.0.3.20261012

  • 添加 阅读中央菜单的“书籍详情”入口新增书籍图标，与“打赏”“听书”按钮保持统一的图标尺寸和上下排列。
  • 修复 修复 H5 阅读页进入书籍详情后全局 tabbar 遮挡底部操作按钮的问题，详情显示时隐藏导航，离开时按导航更新后的实际路由恢复；继续阅读保持隐藏，返回首页恢复导航，避免迟到的卸载回调覆盖新页面状态，App、小程序沿用原生行为。
  • 修复 修复 H5 导航恢复调用不存在的 uni.nextTick 导致阅读页 onHide、onUnload 抛错的问题，改用原生任务队列延后检查路由，保证查看详情和返回首页两条退出路径正常执行。

• 2.0.3

  2.0.3.20261010

  • 添加 新增宣纸暖色书籍详情封面，支持开始/继续阅读、听书、加书架和夜间配色；首次阅读进入封面，有有效历史时直接恢复正文，仅查看封面不生成阅读记录。
  • 添加 阅读菜单新增查看书籍详情入口，进入前立即保存阅读位置，详情与正文互相替换，避免叠加阅读器。
  • 添加 补齐定位失败后的“重新加载”入口，初始失败进入通用加载失败状态，已有正文时保留当前画面，正常阅读不显示技术性定位提示。
  • 优化 目录仅在打开且数据为空时显示加载提示，排序使用章节副本，分页按批追加；章节数据更新时重置列表和分页，保留排序方向。
  • 优化 防抖工具补充返回值、取消和 flush() 语义说明，新增函数参数校验；各组件独立管理防抖任务，销毁时取消，避免任务互相覆盖。
  • 优化 补齐小组件独立升级日志和组件日志索引，记录修复原因、兼容影响及验证范围。
  • 修复 修复滚动初始化提前保存阅读进度的问题，布局和原生位置确认成功后才同步实际进度，定位等待、超时及失败期间保留原阅读记录。
  • 修复 修复普通滚动布局定位失败后重试回到章首的问题，独立保存目标章节及章节内偏移，固定布局和 App/H5 普通布局均可恢复原目标。
  • 修复 修复横向跨章慢请求期间调整字号、行距后无法继续翻页的问题，重排释放旧翻页锁和触摸状态，迟到回调不再干扰新翻页。
  • 修复 修复邻章后台合并时当前广告页定位丢失的问题，保留广告及正文锚点，统一重建索引，避免继续翻页跳回较早正文，兼容重复合并及关闭广告。

• 2.0.3

  2.0.3.20261008

  • 添加 新增正文与图片合计的展示页码 displayPageIndex、displayPageNumber 和 displayTotalPage，广告不计入，原正文页码接口保持兼容。
  • 添加 图片页参与换页事件和阅读记录，初始化新增可选 pageAnchor 参数，支持退出后恢复图片位置，旧记录及已删除图片回退正文。
  • 优化 微信 iOS/Android 滚动阅读采用固定章节坐标，初始化时预留顶部空间，前章离屏测高后放入预留区，减少首次前插造成的正文跳位；App、H5 沿用原定位流程。
  • 优化 坐标窗口重建时保留当前可见正文，确认原生布局和目标位置后恢复阅读，覆盖连续顺读、缓存回读、字号重排及目录跳章；图片卡片占位参与首次章节测量。
  • 修复 修复平滑、覆盖模式切换后图片页回到正文末页的问题，按章节与图片 URL 恢复图片身份；字号重排保留图片列表及当前位置，剩余图片保持源顺序，邻章同 URL 图片互不影响。
  • 修复 修复微信系统信息缺失设备平台导致固定布局未启用的问题，组合设备、应用及窗口信息，旧基础库回退到完整系统信息接口。
  • 修复 修复延迟滚动回调触发连续回退跳章的问题，异常事件先核对原生位置，过滤迟到旧坐标，确认越界后恢复最后有效阅读位置，避免错误进度和连续加载前章。
  • 修复 修复持续下拉到第 1 章时反复上下跳动的问题，确认越过书首后一次性清理顶部预留区，支持反向继续阅读；忽略亚像素测量误差，减少多余定位。
  • 修复 修复手指按住时旧位置被误认为显式定位成功的问题，补齐原生查询、排版及定位失败重试，保留章节内相对位置，新跳章和退出时取消过期回调。

• 2.0.3

  2.0.3.20261007

  • 添加 阅读器新增可选属性 autoSpeed，取值范围为 10～99，值越大翻页越快，间隔为 100 - autoSpeed 秒；未传入时沿用设备保存的速度，无缓存时使用 80。
  • 添加 上一章增加不占正文空间的顶部加载提示，持续至布局和位置确认，快速完成时不闪现，失败或取消后清理。
  • 优化 当前章优先渲染，邻章后台预加载，预加载失败不阻止已缓存内容阅读；主动加载失败支持重试，重复初始化不再清空加载中的正文。
  • 优化 统一覆盖、平滑和滚动模式的自动翻页计时器，菜单、目录、触摸操作及页面隐藏时暂停，结束阅读时停止；组件销毁时清理监听和计时任务，兼容 Vue2/Vue3 生命周期。
  • 优化 横向分页与原文缓存最多保留 3 章，滚动窗口通常保留 5 章，短章节优先保留整屏可见正文及新章节；淘汰章节保留测量高度，重新访问时按需请求。
  • 优化 字符宽度改为测量实例内存查表、新字符集中写回并合并其他字号缓存，减少英文及中英混排分页中的同步读写；同页滚动不再反复更新翻页统计。
  • 优化 微信、QQ 小程序滚动正文直接随章节渲染，首次前插复用已测量节点及 key，减少逐段提交和删除重建造成的闪动，移除小程序不使用的重复正文传输。
  • 修复 修复阅读记录被第 0 页覆盖的问题，保存实际页码和章节内滚动位置，隐藏、退出页面时立即保存；恢复滚动阅读的章节标题、页码和阅读百分比。
  • 修复 修复弱网切章后旧翻页锁不释放及旧请求覆盖新章节的问题，快速切章以最后一次选择为准，相同初始化共享请求；滚动加载状态在失败后可靠恢复。
  • 修复 修复触摸取消、多指操作导致自动翻页一直暂停的问题，自动滚动追加章节保留新目标并等待新高度；到达书末停止本次计时，跳回章节后可重新开启。
  • 修复 修复字号、行高或阅读高度变化后滚动分页未更新的问题，恢复页码限制在正文范围内，广告和图片不再放大正文末页索引，首张正文后的广告可返回正文。
  • 修复 修复微信小程序滚动回跳、向前加载停滞和连续回读跳到书首的问题，分离实际位置与滚动指令，串行确认测量、正文提交和原生位置，补齐短章视口、超时重试及迟到回调处理。
  • 修复 修复滚动模式点击上一章、下一章或目录跳章后被邻章预加载拉回的问题，等待新布局并确认实际位置到达目标，同时保留真实拖动和惯性位移。
  • 修复 修复模拟接口预加载和目录重复调用 hideLoading 导致的小程序未处理 Promise 拒绝，加载提示按实际显示状态配对关闭。

• 2.0.2

  2.0.2.20261006

  • 添加 新增 uni.$miliqk.$version 获取正式版本号，保留 uni.$miliqk.$lastVersion 带 v 前缀的显示格式。
  • 添加 新增版本同步脚本，发布前执行 node scripts/sync-version.cjs，同步示例应用 manifest.json 的 versionName 和根 README.md 的版本标识。
  • 优化 正式版本号统一维护在 uni_modules/miliqk-app/package.json 的 version 字段，插件运行时从该字段读取。
  • 优化 主项目文档目录由 doc 更名为 docs，同步文档、图片引用和忽略规则，修复历史日志中的 mock 数据说明链接。

• 2.0.2

  2.0.2.20250308

  • 添加 新增合并数据页处理
  • 优化 暂时注释掉动态计算广告、图片间隔页方法
  • 优化 更改oldPages格式，分离大字段content 优化 `miliqk-scroll-x-list.vue` 组件，单项间距更加合理
  • 优化 优化 `miliqk-scroll-x-list.vue` 组件，单项间距更加合理
  • 修复 修复微信小程序平台端广告滑动时，下一页渲染错误的问题 修改在章节为单页的情况下 百分比计算失效的问题
  • 修复 修改在章节为单页的情况下 百分比计算失效的问题

• 2.0.1

  2.0.1.20250214

  • 添加 新增文中插入图片卡片的功能
  • 优化 其他的一些优化
  • 修复 修复在小程序端触发自带的左滑返回事件时，如果不返回，会导致触摸滑动事件不会触发

• 2.0.0

  2024-11-01

  • 添加 初始化插件的基础版本
  • 优化 优化主包体积
  • 修复 其他一些修复