防休眠常亮
阻止系统自动休眠、息屏与锁屏，支持定时倒计时自动恢复与一键常亮切换
插件界面截图
核心功能特性
无限期保持屏幕与系统常亮
直到用户手动关闭或退出 ZTools 前一直保持屏幕点亮与系统唤醒。
定时常亮模式
开启指定分钟数的防休眠倒计时，倒计时归零后宿主自动释放电源锁并发送系统通知提醒。
仅防系统睡眠但允许息屏
调用 prevent-app-suspension（ES_SYSTEM_REQUIRED），适合夜间挂机下载/跑脚本：屏幕可正常关闭省电，但 CPU 与网络绝不睡眠断连。
守护指定进程直到结束
从当前运行的高负载进程（如 python.exe、node.exe、ffmpeg.exe、aria2c.exe）中选择一个 PID，宿主每 5 秒检查该 PID 是否存活，进程退出后自动解除防休眠。
被监听的守护进程异常崩溃或提前退出
宿主定时器检测到目标 PID 已不存在（或进程名不匹配）时，立即释放 powerSaveBlocker 并记录上次结束原因。
重复开启幂等替换
已有防休眠会话激活时切换新时长，宿主先销毁旧 blockerId 与旧定时器，再创建新锁，严防多把 powerSaveBlocker 锁残留无法释放。
插件详细介绍与使用指南
功能概述
防休眠常亮（插件标识：caffeine）是 ZTools 极客桌面效率中枢面向 系统工具 场景打造的官方核心扩展。阻止系统自动休眠、息屏与锁屏，支持定时倒计时自动恢复与一键常亮切换。
- 底层核心痛点：用户在跑长耗时 AI 训练/编译打包、下载几百 GB 大文件、挂机上传、或向客户投屏演示汇报时，Windows 默认 5~10 分钟无鼠标操作就会自动息屏锁屏甚至进入睡眠断网，导致任务中断或演示尴尬；而每次去控制面板改电源计划又怕忘了改回来。
- 核心不变量：防休眠状态必须由宿主主进程（Main Process）托管并带倒计时/进程监听自动释放机制，即使关闭 ZTools 搜索框窗口，防休眠锁依然有效；到期或手动关闭时必须 100% 释放系统电源锁，绝不泄露锁导致电脑永远无法休眠。
- 最简收敛路径：提供「无限期常亮 / 30分钟 / 1小时 / 2小时 / 4小时 / 直到指定进程结束自动恢复」6 种模式，
Enter一键开启并显示剩余倒计时。
- 架构标准：
@ztools/declarative-ui声明式 UI 视图描述符 | 运行沙箱：Worker 隔离宿主 + 原生系统桥接 | 分类：系统工具
---
核心功能特性
- 无限期保持屏幕与系统常亮：直到用户手动关闭或退出 ZTools 前一直保持屏幕点亮与系统唤醒。
- 定时常亮模式：开启指定分钟数的防休眠倒计时，倒计时归零后宿主自动释放电源锁并发送系统通知提醒。
- 仅防系统睡眠但允许息屏：调用
prevent-app-suspension（ES_SYSTEM_REQUIRED），适合夜间挂机下载/跑脚本：屏幕可正常关闭省电，但 CPU 与网络绝不睡眠断连。 - 守护指定进程直到结束：从当前运行的高负载进程（如
python.exe、node.exe、ffmpeg.exe、aria2c.exe）中选择一个 PID，宿主每 5 秒检查该 PID 是否存活，进程退出后自动解除防休眠。 - 被监听的守护进程异常崩溃或提前退出：宿主定时器检测到目标 PID 已不存在（或进程名不匹配）时，立即释放
powerSaveBlocker并记录上次结束原因。 - 重复开启幂等替换：已有防休眠会话激活时切换新时长，宿主先销毁旧
blockerId与旧定时器，再创建新锁，严防多把powerSaveBlocker锁残留无法释放。
---
典型高频使用场景
- 场景 1：设置防休眠常亮时长（无限期 / 15分钟 / 30分钟 / 1小时 / 2小时 / 4小时） — 当你需要快速执行该任务时，按下
Alt+Space输入防休眠/常亮/不锁屏/caffeine/keep awake，回车即可直接进入caffeine-panel视图完成处理并一键复制或导出结果。 - 场景 2：一键切换防休眠开启与关闭状态 — 当你需要快速执行该任务时，按下
Alt+Space输入切换防休眠/caffeine toggle/开启防休眠/关闭防休眠，回车即可直接进入caffeine-toggle视图完成处理并一键复制或导出结果。 - 纯净替代传统臃肿单机小工具：以轻量声明式扩展替代动辄上百 MB、带开机自启与推广弹窗的传统共享软件，保持操作系统常驻进程极致清爽。
---
唤醒指令与全键盘快捷操作指南
在任何桌面窗口下按下 Alt + Space（macOS 为 Option + Space）呼出 ZTools 搜索框，输入以下指令词即可直达 防休眠常亮 的对应功能模块：
功能命令标识 (featureCode) |
功能说明 | 推荐触发词 / 唤醒指令 (cmds) |
|---|---|---|
caffeine-panel |
设置防休眠常亮时长（无限期 / 15分钟 / 30分钟 / 1小时 / 2小时 / 4小时） | 防休眠 / 常亮 / 不锁屏 / caffeine / keep awake |
caffeine-toggle |
一键切换防休眠开启与关闭状态 | 切换防休眠 / caffeine toggle / 开启防休眠 / 关闭防休眠 |
全局高频键盘快捷键
| 快捷键 (Windows / macOS) | 交互行为说明 |
|---|---|
Alt + Space / Option + Space |
呼出 ZTools 主搜索框，输入 防休眠 直达本插件 |
↑ / ↓ |
在列表项、分类树或操作结果之间平滑移动键盘焦点 |
Enter |
对当前选中项执行默认主动作（打开、复制、执行或查看详情） |
Ctrl + Enter / ⌘ + Enter |
执行次要高频动作（如在资源管理器/Finder 中定位、复制次要字段） |
Ctrl + K / ⌘ + K |
展开当前选中项的完整动作面板（Action Panel），支持模糊筛选全部操作 |
Ctrl + F / ⌘ + F |
快速将光标聚焦至顶部搜索/过滤输入框 |
Esc |
关闭当前弹窗/动作面板，或从二级子视图安全返回上一级 |
---
架构性能与安全隐私保障
- 声明式 UI 零闪烁渲染：界面严格采用
@ztools/declarative-ui的List/Detail/Form/ActionPanel语义组件声明，由 ZTools 宿主统一渲染并原生适配深色（Dark）与浅色（Light）双主题。 - 最小权限与沙箱隔离：本插件在清单（
plugin.json）中显式声明最小化权限集["system", "shell"]，所有系统调用均受 ZTools 宿主桥接层与 AST 静态安全门禁严格审计。 - Local-First 本地离线原则：所有配置项、历史记录与业务数据 100% 存储在用户本地（SQLite / LocalStorage），绝不向任何第三方服务器静默上传敏感信息。
---
延伸阅读与技术内链
关联技术与效率专栏文章
- C盘又红了别乱删！用这个清爽无捆绑的空间分析器，10秒揪出偷吃硬盘的元凶
- 电脑文件太多找半天？这款免费开源神器，100万个文件也能0.03秒瞬间搜出！
- 100 万文件检索仅需 0.035ms！基于 Rust 的 NTFS MFT 裸盘索引与 USN 增量追踪实战
- 卸载电脑里臃肿的广告软件吧！这一个不到100M的开源工具箱，顶替38款日常软件
同分类热门效率插件推荐（系统工具）
常见问题解答 (FAQ)
Q1: 如何最快唤醒并使用「防休眠常亮」插件？
安装并启动 ZTools 客户端后，在任意界面按下 Alt + Space（macOS 为 Option + Space），在搜索框中输入 防休眠 或 caffeine，按 Enter 即可在 0.1 秒内直达工作台。您也可以在 ZTools 设置中心为「防休眠常亮」绑定独立的全局一键呼出快捷键。
Q2: 「防休眠常亮」插件会将我的数据上传到云端服务器吗？
不会。ZTools 严格遵循 Local-First（本地优先）与隐私设计（Privacy by Design） 准则，「防休眠常亮」的核心处理流程完全在您的本机离线执行，零广告干扰、零用户行为监控。
Q3: 在「防休眠常亮」中如何不使用鼠标完成全部操作？
本插件针对全键盘流进行了深度优化：进入插件后可直接打字检索过滤，使用 ↑ / ↓ 键切换目标行，按 Enter 执行主操作，或按 Ctrl + K（macOS 为 ⌘ + K）呼出动作面板选择更多高级操作，按 Esc 即可逐级返回。
Q4: 插件支持哪些操作系统版本？是否开源免费？
完整支持 Windows 10 / Windows 11 (x64) 与 macOS 12+ 双平台（部分涉及 Windows 底层注册表或专属硬件驱动的特性在 macOS 下会自动适配原生等价实现）。本插件对个人用户 100% 永久免费开放，源码托管于 GitHub 官方仓库接受社区透明审计。 ---