Skip to content

v1.6.1

Choose a tag to compare

@steven-ld steven-ld released this 10 Nov 01:35
· 3 commits to master since this release

✨ 新功能

  • 原地沉浸式阅读:HTML 文章的「全屏」不再跳转 /full/ 新页面,而是在当前页把正文画布展开到整屏。桌面端保留左侧目录,移动端收紧留白;右上角提供「退出全屏」,Esc 也可退出。iframe 不重新加载,页面内部的滚动位置与状态都会保留。
  • HTML 首页沉浸态:配置为 .html 的首页自动铺满视口打开;退出后回到带站点外壳的常规阅读视图。
  • 沙箱高度自适应:沙箱页面通过 postMessage 上报内容高度,iframe 按内容高度展开(限制在 240–20000px)。退出沉浸态后不再出现内部第二根滚动条或大片空白。

⚡ 性能优化

  • Mermaid 改为按需加载:首页与普通文章不再下载约 3MB 的图表库,只有正文里存在图表时才拉取。
  • highlight.js 主题样式改为非阻塞加载,不再拖住首次绘制;保留 <noscript> 回退。
  • 服务端已渲染的首页与正文不再被前端清空重建,消除 HTML iframe 的二次请求和一次白屏。
  • HTML 首页与 HTML 文章由服务端直接输出沉浸布局,首帧就是最终宽度,不再出现「先窄后宽」的跳变。

🐛 问题修复

  • 修复 HTML 文章切换时「先退出沉浸态、再重新进入」造成的布局抖动。
  • 修复沉浸式阅读接入后客户端单元测试的 mock 缺失,测试套件恢复全绿。

✅ 验证

  • npm test:21 项全部通过。
  • 本地实测:首页 FCP 约 28ms、DCL 约 20ms;/full/ 首屏请求由 2 次降为 1 次,首页不再加载 Mermaid。