屏幕亮度与控制
免按显示器物理按键，通过 DDC/CI 与 WMI 调节外接与内置显示器硬件亮度、对比度，支持多屏同步与一键熄屏
插件界面截图
核心功能特性
控制通道类型
DDC/CI 硬件直控、WMI 内屏直控、Gamma 软件调光（回退）
预设档位一键直达
提供 100%（全亮）、75%（日常办公）、50%（柔和）、25%（暗室）、10%（深夜极暗） 五档预设，以及针对每块独立屏幕的微调动作。
步进调节
支持通过动作面板或快捷键将选中显示器（或全部显示器）亮度 +10% / -10%。
一键息屏
触发后延迟 300ms（避免松开回车键唤醒）发送系统级显示器休眠指令，关闭屏幕背光但保持后台程序运行。
DDC/CI I2C 总线响应慢或超时
外接显示器 DDC/CI 读取偶发耗时 200~400ms，宿主侧缓存物理句柄并设置 1500ms 超时保护；写入采用去抖合并（Debounce 80ms），防止连续快速调节阻塞总线。
显示器 OSD 禁用了 DDC/CI
当硬件返回不支持时，自动标记为 [需开启显示器 DDC/CI 或使用软调光]，不抛崩溃错误。
插件详细介绍与使用指南
功能概述
屏幕亮度与控制（插件标识：monitor-control）是 ZTools 极客桌面效率中枢面向 系统工具 场景打造的官方核心扩展。免按显示器物理按键，通过 DDC/CI 与 WMI 调节外接与内置显示器硬件亮度、对比度，支持多屏同步与一键熄屏。
- 底层核心痛点：笔记本内屏可以用键盘调亮度，但台式机或笔记本外接的 27 寸/32 寸独立显示器，Windows 系统设置里根本没有亮度滑块！用户昼夜办公切换时，不得不伸手去显示器背后盲摸极其难按的物理 OSD 摇杆。
- 核心不变量与约束：必须同时兼容「笔记本内屏（WMI）」与「独立外接显示器（DDC/CI VCP Code
0x10亮度、0x12对比度、0x62音量）」；对于不支持硬件 DDC/CI 的老旧屏幕，提供 Gamma 软遮罩降级调光，绝不报错白屏。 - 最简收敛路径：呼出插件列出所有已连接显示器及档位预设（100% / 75% / 50% / 25% / 夜间护眼 10% / 一键黑屏休息），
Enter秒切亮度，←/→或快捷动作步进±10%。
- 架构标准：
@ztools/declarative-ui声明式 UI 视图描述符 | 运行沙箱：Worker 隔离宿主 + 原生系统桥接 | 分类：系统工具
---
核心功能特性
- 控制通道类型：
DDC/CI 硬件直控、WMI 内屏直控、Gamma 软件调光（回退） - 预设档位一键直达：提供
100%（全亮）、75%（日常办公）、50%（柔和）、25%（暗室）、10%（深夜极暗）五档预设，以及针对每块独立屏幕的微调动作。 - 步进调节：支持通过动作面板或快捷键将选中显示器（或全部显示器）亮度
+10%/-10%。 - 一键息屏：触发后延迟 300ms（避免松开回车键唤醒）发送系统级显示器休眠指令，关闭屏幕背光但保持后台程序运行。
- DDC/CI I2C 总线响应慢或超时：外接显示器 DDC/CI 读取偶发耗时
200~400ms，宿主侧缓存物理句柄并设置1500ms超时保护；写入采用去抖合并（Debounce 80ms），防止连续快速调节阻塞总线。 - 显示器 OSD 禁用了 DDC/CI：当硬件返回不支持时，自动标记为
[需开启显示器 DDC/CI 或使用软调光]，不抛崩溃错误。
---
典型高频使用场景
- 场景 1：调节内置与外接显示器硬件亮度、对比度与一键熄屏 — 当你需要快速执行该任务时，按下
Alt+Space输入亮度/显示器/屏幕亮度/brightness/monitor，回车即可直接进入monitor-brightness视图完成处理并一键复制或导出结果。 - 场景 2：立即关闭所有显示器背光进入省电状态（不锁机、不断后台任务） — 当你需要快速执行该任务时，按下
Alt+Space输入熄屏/关闭屏幕/关屏/sleep monitor/turn off screen，回车即可直接进入monitor-sleep视图完成处理并一键复制或导出结果。 - 纯净替代传统臃肿单机小工具：以轻量声明式扩展替代动辄上百 MB、带开机自启与推广弹窗的传统共享软件，保持操作系统常驻进程极致清爽。
---
唤醒指令与全键盘快捷操作指南
在任何桌面窗口下按下 Alt + Space（macOS 为 Option + Space）呼出 ZTools 搜索框，输入以下指令词即可直达 屏幕亮度与控制 的对应功能模块：
功能命令标识 (featureCode) |
功能说明 | 推荐触发词 / 唤醒指令 (cmds) |
|---|---|---|
monitor-brightness |
调节内置与外接显示器硬件亮度、对比度与一键熄屏 | 亮度 / 显示器 / 屏幕亮度 / brightness / monitor |
monitor-sleep |
立即关闭所有显示器背光进入省电状态（不锁机、不断后台任务） | 熄屏 / 关闭屏幕 / 关屏 / sleep monitor / turn off screen |
全局高频键盘快捷键
| 快捷键 (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）中显式声明最小化权限集["screen", "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），在搜索框中输入 亮度 或 monitor-control，按 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 官方仓库接受社区透明审计。 ---