使用指南

从安装到进阶的完整教程

按照以下步骤,10 分钟即可配置出最适合你的亮度方案。

步骤 1

安装 Twinkle Tray

1. 下载安装包

前往 下载中心,根据需要选择官网直链、Microsoft Store 或 winget 安装包。

2. 运行安装程序

双击 exe,默认选项完成安装。程序会自动加入开机自启,托盘图标秒级出现。

3. 等待 DDC 识别

首次启动会扫描所有显示器,3-5 秒后托盘图标变亮,点击即看到每台显示器的滑块。

步骤 2

首次使用:调节亮度

点击托盘图标

在系统托盘(任务栏右下角时钟旁边)找到 Twinkle Tray 图标,单击弹出调节浮层。浮层会列出当前所有被识别的显示器。

拖动滑块

每台显示器下方都有一条独立的亮度滑块,从 0 到 100。可同时调整多台,或独立互不干扰。

"全部同步"模式

想要所有显示器同步?点击滑块上的"同步"按钮(或在设置里启用),即可一键同步多台。

右键设置

右键托盘图标可以进入"设置":调节 DDC/CI 行为、归一化、开自启、切换主题、绑定热键等。

步骤 3

配置亮度热键

为每台显示器绑定全局快捷键,键盘即可调光。

打开设置 → 热键

右键 Twinkle Tray 托盘图标 → Settings → 顶部 Hotkeys 标签。

添加绑定

点击 Add hotkey,选择目标显示器、调节动作(增大 / 减小 / 设为 X%),按下希望使用的组合键。

推荐组合

Ctrl + Alt + [         全部同步 -10
Ctrl + Alt + ]         全部同步 +10
Ctrl + Alt + 1         显示器 1 亮
Ctrl + Alt + 2         显示器 2 亮

与系统冲突

若组合键已被其它程序占用,请换一组,或在 Twinkle Tray 设置中开启系统级热键选项。

步骤 4

命令行参数

Twinkle Tray 提供完整的命令行控制,方便脚本或第三方工具调用。

参数说明示例
--List列出所有显示器 (v1.14.0+)TwinkleTray.exe --List
--MonitorNum按编号选择显示器(从 1 开始)--MonitorNum=2
--MonitorID按内部 ID 选择(支持部分匹配)--MonitorID="UID2353"
--All对所有显示器生效--All
--Set设置亮度百分比--Set=95
--Offset在当前值基础上偏移--Offset=-20
--VCP发送 DDC/CI VCP 指令 (v1.14.4+)--VCP="0xD6:5"
--Overlay显示屏幕中央的覆盖层--Overlay
--Panel显示托盘调节面板--Panel

示例:把第二台显示器的亮度设置为 75%,并显示屏幕中央覆盖层:

TwinkleTray.exe --MonitorNum=2 --Set=75 --Overlay
步骤 5

DDC/CI 兼容性排查

如果某台显示器的亮度滑块不出现,按以下顺序排查。

① 显示器 OSD

打开显示器自带的 OSD 菜单 → 系统 / 高级 → 找到 DDC/CI 选项,开启它(部分品牌默认是关闭的)。

② 线材接口

务必使用 DisplayPort、HDMI 或 USB-C(Alt Mode) 直连;VGA / DVI 转换链路通常不支持 DDC/CI。

③ 软件冲突

关闭可能占用 DDC/CI 的程序,如 Monitorian、f.lux、显卡官方控制中心 等。

④ 管理员模式

仍不能识别?在 Twinkle Tray 设置 → 通用 → 勾选"以管理员模式运行",重启程序。

⑤ 查看日志

设置 → 关于 → 打开日志文件,把日志附在 GitHub Issue 提交。

⑥ 内置屏幕

笔记本内置屏幕通常无需 DDC/CI 即可调节;若仍然不显示,请检查显卡驱动是否最新。

FAQ

常见问题

使用过程中最常被问到的问题。

Twinkle Tray 支持哪些 Windows 版本?
支持 Windows 10 1809 及以上、以及 Windows 11 的所有 64 位版本。Windows 8.1 及更早系统不再受官方支持。
我的外接显示器亮度无法调节,怎么办?
请按顺序排查:
  1. 打开显示器 OSD 菜单,确认 DDC/CI 已开启;
  2. 使用 DisplayPort / HDMI / USB-C 直连(不要用 VGA 转接);
  3. 关闭 f.lux、Monitorian、显卡自带控制中心等可能争抢 DDC 控制的程序;
  4. 在 Twinkle Tray 设置里启用"以管理员身份运行";
  5. 若仍不显示,到 GitHub Issue 提交日志反馈。
Twinkle Tray 是免费的吗?有广告吗?
完全免费,且没有任何广告或追踪代码。项目采用 MIT 协议开源,源码公开可审查。
能否在脚本里调用 Twinkle Tray?
可以。它支持 --Set--Offset--MonitorNum--MonitorID--VCP 等参数,能与 PowerShell、Python、AutoHotKey 等脚本语言配合使用。从 Microsoft Store 安装的版本可执行名为 Twinkle-Tray.exe
与显卡自带控制中心冲突怎么办?
例如 NVIDIA Control Panel、AMD Radeon Settings 会接管 DDC/CI。建议关闭它们的"显示器色彩管理"功能,让 Twinkle Tray 独占控制。
能否调对比度、音量、电源状态?
可以。使用 --VCP="0xD6:5" 等 DDC/CI 指令(VCP code 0xD6 即"电源状态"),或在设置里调用预设的对比度 / 音量动作。注意需要显示器支持对应 VCP 指令。
如何完全卸载?
Windows 设置 → 应用 → 已安装的应用 → 搜索 "Twinkle Tray" → 卸载。配置会保留在用户目录里,下次安装可继续使用。
中文翻译不准确或缺失,如何提交?
项目使用 Weblate 进行协作翻译。注册账号后即可在线编辑,无需提交 PR。
它是病毒或间谍软件吗?
不是。Twinkle Tray 的源代码完全公开(MIT),可在 GitHub 审查。Microsoft Store 版本经微软审核签名,未收集任何用户数据。
替代方案有哪些?
常见替代品包括 MonitorianWin10 Brightness Sliderf.lux 等。Twinkle Tray 的差异化在于:原生 Windows 体验、DDC/CI 深度支持、完整 CLI 与定时调光,并仍持续维护。

开始你的调光之旅

下载安装并完成以上设置,你就能体验完整的 Twinkle Tray。

立即下载 Twinkle Tray