大型项目与缓存
PageFlow 不会同时把所有路由渲染为实时文档。渲染与缓存都采用有界策略,使大型关系图仍可浏览。
可视区域渲染
只挂载附近的 DOM 预览和 LeaferJS 场景对象。远处页面使用紧凑表示,只有当前选中页面升级为实时 iframe。
缩略图分层
附近页面可以使用详细预览,远处页面使用紧凑 WebP。长页面可以拆分成按视口挂载的切片。旧缩略图会显示到新版本捕获完成。
捕获队列
PageFlow 会等待字体、图片和 DOM 稳定后再捕获。队列一次处理一个页面,并优先选择当前页面和可见页面。
布局与查找
超过 1000 个页面的关系图可把布局工作移到 Worker。空间索引用于查找可见页面,避免每次视口更新都扫描完整关系图。
缓存位置
持久化缩略图位于:
text
.unplugin-pageflow/cache内存和磁盘缓存都使用固定 LRU 预算。它是可删除的开发产物,需要完全重新捕获时可以清理。
实践建议
- 使用有意义的路径层级组织路由。
- 为动态参数提供稳定示例值。
- 使用 Fixture 数据保持预览结果稳定。
- 长时间异步页面应发送就绪信号。