沉浸式专注阅读模式 (Zen Mode)
现代工程技术专栏、架构白皮书与长篇教程通常需要读者高度聚焦于长段落与代码推演。然而，屏幕两侧充斥的目录树、大纲导航以及顶部常驻工具栏常会带来无形的视觉噪点与心理压力。
VitePress Zenith 独家研发了一体化纯粹专注阅读系统（Zen Mode）与顶部智能感应控制胶囊。
核心体验与设计哲学
1. 极致纯粹视野 (Distraction-Free)
- 彻底隐去外围一切干扰：顶栏导航、双侧边栏、底栏、公告通知与浮动工具全部隐去，100% 视口留给正文；
- 舒适加宽阅读版心 (1240px)：正文以舒展的 1240px 居中排布，行高提升至
1.95，字号调至1.05rem，为复杂架构图、宽幅 API 参数表与成段代码推演提供从容呼吸感； - 双键别名快捷键：同时监听 Alt + Z（Zen 经典肌肉记忆）与 Alt + F（Fullscreen 直觉映射），macOS 用户对应 ⌥ Option + Z / F；
- 多元呼出入口：亦可通过正文元数据栏（DocMeta）的「专注阅读」胶囊按钮、全局命令中心（Ctrl+K）随时一键启闭。
2. 顶部智能感应滑出胶囊 (Smart Hover Bar)
在专注阅读模式下，顶部没有常驻导航栏。Zenith 贴心内置了顶部边缘智能感应胶囊：
- 无感唤出：当鼠标靠近屏幕顶部边缘（
）或初次切换进入模式时，毛玻璃控制胶囊自动自顶端平滑滑入； - 实时认知度量：胶囊内置当前文章标题、实时阅读百分比与流动微进度条；
- 微交互集成：胶囊右侧集成了瞬时深浅换肤按钮与退出专注按键，移开鼠标后自动隐形，绝不侵扰阅读心流。
3. 多重极速退出保障
为了避免读者“困在全屏中”，Zenith 提供了多重直觉式的复原方式：
- 按下键盘 Esc 键即刻复原（当有活动模态框时优先关闭模态框，确保分层退出）；
- 再次按下快捷键 Alt + Z 或 Alt + F；
- 鼠标移至顶部点击悬浮胶囊的「退出专注」按钮；
- 本地历史记忆：读者的偏好会自动持久化存储于浏览器的
localStorage中。
顶部阅读进度条
在长文滚动过程中，页面顶端呈现极细的品牌渐变进度指示条：
- 实时计算视口已阅读百分比；
- 滚动至页面最顶端时自动隐藏；
- 硬件加速
transform: scaleX(...)驱动，60fps 丝滑不引起重排。
状态钩子 API (useZenMode)
如果您需要在自定义组件或业务逻辑中读取或控制专注阅读模式，可以直接引入响应式状态钩子：
ts
import { useZenMode } from '../composables/useZenMode'
const { isZenMode, toggleZenMode, applyZenMode, exitZenMode } = useZenMode()