Skip to content

OfficePeek v0.2.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 07:31
· 16 commits to main since this release

OfficePeek v0.2.0 发版说明 (Release Notes)

🎉 OfficePeek v0.2.0 正式发布!

OfficePeek 是一款专为 macOS 打造的轻量、极速、离线的原生 Office 文档查看器,支持 Word (.docx)、PowerPoint (.pptx) 与 Excel (.xlsx) 三大主流格式。底层基于 JZOffice(Rust 高性能解析核心 jz-office-core 与 Apple CoreGraphics / CoreText 矢量渲染引擎)构建,无 Electron、无 WebView、零多余后台依赖。

在 v0.2.0 版本中,OfficePeek 全面接入 JZOffice v0.12.0 最新核心引擎,带来原生的视口虚拟化裁剪渲染、OfficeImageLoader 异步按需解码与 LRU 内存预算管控,长文档与高清多图演示文稿的滚动流畅度与内存占用迎来跨越式优化!

应用完整体积依然保持在约 2.7 MB(压缩包仅 ~890 KB),冷启动毫秒级秒开!


🚀 v0.2.0 核心更新亮点

1. 视口虚拟化与裁剪渲染(性能飞跃)

  • 长文档绘制裁剪:DOCX 与 PPTX 视图全面接入滚动视口几何裁剪(Viewport Clipping),超出可视区域的文字、表格与图形元素在渲染管线中直接跳过 CoreGraphics 绘制。
  • 高帧率丝滑滚动:数十页甚至上百页的长文档在快速滑动与惯性抛掷时,CPU 与 GPU 负载显著降低,告别掉帧与卡顿。

2. OfficeImageLoader 异步解码与 LRU 内存预算管理

  • 解耦首屏加载:文档打开阶段彻底解耦整篇图片的同步预加载,仅按需异步解码当前可见视口与邻近页面的图片资源。
  • 像素预算淘汰机制:引入基于严格像素预算(Pixel Budget)的 LRU 缓存管理策略,离开视口的离屏图片受内存预算管控并优雅释放,大幅降低复杂多图 PPTX 与图文混排 DOCX 的内存峰值,彻底杜绝大文档内存溢出。
  • 重入队列与并发优化:优化快速连续来回翻页时的取消与请求队列复用,避免多线程竞态与重复无效解码。

3. 滚动页码动态感知与进度同步

  • 视口几何中心感知:引入视口几何中心动态页码检测算法,在自由连续滚动过程中实时精准感知当前停留页面,顶部状态栏与侧边栏定位实时同步更新。

4. DOCX 表格排版能力深度升级

  • 表格单元格内嵌图片排版:全面支持 DOCX 表格单元格内嵌图形(w:drawing / pic:pic)的解析与渲染,具备高宽比自适应计算与水平垂直居中排版能力,保持文字与表格内图片混排的稳定对齐。
  • 表格边框样式精细化呈现:支持 DOCX 表格各个方向边框(外框 top / bottom / left / right、内框 insideH / insideV)的线型、粗细与颜色高保真解析与矢量绘制。

5. 架构与生命周期加固

  • 生命周期安全加固:重构并加固 OfficePreviewView 视图销毁机制,避免 teardown 析构时越权关闭外部共享的图片加载器。
  • 测试覆盖与质量保证:补充并跑通针对 OfficeImageLoader 视口虚拟化、缓存淘汰机制以及 OfficePeek 集成场景的端到端测试。

⌨️ 常用快捷键速查

操作 快捷键
打开文档 ⌘ + O
返回欢迎主页 ⌘ + ⇧ + W
导出为矢量 PDF ⌘ + E
全文检索 ⌘ + F
查找下一个匹配项 ⌘ + G
查找上一个匹配项 ⌘ + ⇧ + G
关闭查找栏 Esc
复制选中文本 ⌘ + C
全选文档内容 ⌘ + A
上一页 / 上一个工作表 ⌘ + ←
下一页 / 下一个工作表 ⌘ + →
放大 / 缩小 / 实际大小 ⌘ + + / ⌘ + - / ⌘ + 0
切换显示侧边栏 ⌘ + ⌥ + S

📦 安装与运行

方式 1:直接下载使用预编译安装包(推荐)

  1. 从下方 Assets 列表中下载 OfficePeek-0.2.0-macOS.zip;
  2. 解压后将 OfficePeek.app 拖入 /Applications 应用程序文件夹;
  3. 双击即可极速启动。

Tip

温馨提示(macOS 安全拦截处理):
若初次打开时提示 “Apple无法验证‘OfficePeek’是否包含可能危害Mac安全或泄漏隐私的恶意软件”,这是 macOS 对未公证网络下载软件的 Gatekeeper 隔离保护。只需在终端执行以下命令即可彻底解除拦截:

xattr -cr /Applications/OfficePeek.app

(该命令用于递归移除文件的 com.apple.quarantine 隔离属性,执行后即可正常双击秒开)

方式 2:通过源码构建

git clone https://github.com/donglua/OfficePeek.git
cd OfficePeek
chmod +x scripts/build-app.sh
./scripts/build-app.sh
open build/OfficePeek.app

感谢关注与使用 OfficePeek!如有任何问题或改进建议,欢迎提交 Issue 与 PR 交流!