Install
安装
Any M-series Mac on macOS 26 or later. Run end to end on an M1 and an M4 Max, across macOS 26.6.2 and 27 — and Settings carries a self-check that answers for your machine in five seconds.
全部 M 系列机型，macOS 26 或更新版本。M1 与 M4 Max 上都完整跑过， 横跨 macOS 26.6.2 与 27 —— 设置里还有一份自检，五秒钟给出你那台机器的真实答案。
Open the disk image, drag PWE Lumen Bar onto Applications, and launch it from there. It has no Dock icon — after launching, look for the display glyph in the menu bar near the clock. Nothing appearing in the Dock is the app working, not failing.
打开磁盘映像，把 PWE Lumen Bar 拖进「应用程序」，再从那里启动。 它没有 Dock 图标 —— 启动后请在时钟附近的菜单栏里找那个显示器字形。Dock 里什么都没出现， 是它在正常工作，不是失败。
A welcome window appears once. If you dismissed it and want it back, it is under the ⋯ menu at the bottom of the panel, as Tips….
欢迎窗只出现一次。关掉之后想再看，在面板底部 ⋯ 菜单里的「使用提示…」。
Three gestures on the icon
图标上的三个手势
Click
点击
Opens the panel: one card per display, the built-in panel included.
打开面板：一块屏一张卡片，包括内建屏。
Scroll
滚轮
Changes the brightness of whichever display the pointer is on, without opening anything. The fastest thing in the app, and the least discoverable.
直接调节光标所在那块屏的亮度，不用打开任何东西。全 app 最快的操作， 也是最不容易被发现的一个。
Right-click
右键
Jumps straight to a saved preset — a whole desk arrangement in one click.
直接切换到已保存的场景 —— 一整套桌面配置，一次点击。
The card
卡片
Each card carries what that display can actually do. Brightness, contrast, warmth and volume are sliders; resolution and orientation are menus; capture, turn-off and match-all are buttons. Anything the display cannot do is greyed out with the reason on hover — a monitor that ignores DDC says so, rather than accepting a change and doing nothing.
每张卡片上只有那块屏真正能做的事。亮度、对比度、色温、音量是滑块；分辨率和方向是菜单； 截图、熄屏、对齐全部是按钮。做不到的会灰掉，悬停有原因 —— 不响应 DDC 的显示器会直说，而不是接受了改动却什么都不做。
The ⋯ at the top right of a card is that display only: rename, colour profile, input source, force HiDPI, lock the configuration. The ⋯ at the bottom of the panel is global: presets, language, shortcuts, launch at login.
卡片右上角的 ⋯ 只作用于这块屏：重命名、颜色配置、输入源、强制 HiDPI、锁定配置。 面板底部的 ⋯ 是全局的：场景、语言、快捷键、开机启动。
Turn off, and why it is not the lid
「熄屏」，以及它和合盖的区别
Turn off is a software disconnect: the display leaves the desktop, windows move off it, and it comes back whenever you ask. On a MacBook that lives on a stand this is the thing to reach for — the built-in panel stops being driven without the lid being closed, so the machine keeps that surface for cooling. Settings can do it automatically whenever an external display connects.
「熄屏」是软件断开：那块屏离开桌面，窗口挪走，随时能回来。 挂在支架上的 MacBook 尤其该用它 —— 内建屏不再被驱动，而盖子不用合上，机器也就留住了那个散热面。 设置里可以让它在接上外接屏时自动发生。
A switched-off display keeps a row at the top of the panel saying which kind of off it is, with a green button to light it again. That row is the only way back, and it is always there — unlike cutting the monitor's power over DDC, which some monitors do not come back from without their own button, and which asks first for exactly that reason.
被熄掉的屏会在面板顶部留一行，写明它是哪一种「关」，右边一个绿色的重新点亮。 那一行是唯一的回来入口，而且一直在 —— 与之相对的是 DDC 断电：有些显示器断了就只能按自己的 物理按键回来，所以它会先问一次。
Sharpness: what HiDPI is, and when to force it
锐度：HiDPI 是什么，什么时候该强制开
macOS renders at 1× or 2×; there is no arbitrary scaling. A 27-inch 4K display is about 163 PPI — too coarse for 2× to be comfortable, too fine for 1× to look sharp — so macOS picks 1× and text loses its edge. Forced HiDPI writes the missing 2× modes into the system, and after a restart the resolution menu offers things like "looks like 2560×1440", rendered the way a Retina screen renders rather than stretched.
macOS 只有 1 倍和 2 倍两种渲染，没有任意比例缩放。27 吋 4K 约 163 PPI —— 2 倍下太大，1 倍下不够锐 —— 于是 macOS 选了 1 倍，文字就失去了边缘。强制 HiDPI 把缺失的 2 倍模式写进系统，重启后分辨率菜单里就会出现「看起来像 2560×1440」这样的选项， 按 Retina 屏那种方式渲染，而不是拉伸。
It is the one Pro feature. It writes a display override file into /Library,
so macOS asks for an administrator password — the app never sees it — and it needs a restart. Remove
it from the same menu it was installed from.
这是唯一的 Pro 功能。它往 /Library 写一个显示器覆盖文件，
所以 macOS 会索取管理员密码 —— 应用不接触它 —— 并且需要重启。
从安装它的同一个菜单里可以移除。
Activating Pro
激活 Pro
Your licence email carries a one-click link. Clicking it opens the app, activates, and tells you what happened. If you would rather do it by hand, open Settings (⌘,) and paste the key together with the email address the licence was issued to. "Unlocked" at the top of Settings is how you know it worked. The key is verified on your own machine — the app has no network code at all.
授权邮件里有一个一键激活链接。点它，应用会打开、激活，并告诉你结果。 想手动也行：打开设置（⌘,），把密钥和购买时使用的邮箱一起填进去。设置顶部出现「已解锁」 就说明成功了。密钥在你自己的机器上校验 —— 应用里根本没有网络代码。
Keys and shortcuts
按键与快捷键
Two switches in Settings, both off until you ask:
设置里的两个开关，默认都关着：
Global shortcuts
全局快捷键
⌃⌥↑↓ brightness, ⌃⌥←→ volume, ⌃⌥M mute,
⌃⌥S capture, ⌃⌥P off/on — all acting on the display under the pointer.
Rebindable, and they need no permission at all.
⌃⌥↑↓ 亮度、⌃⌥←→ 音量、⌃⌥M 静音、
⌃⌥S 截图、⌃⌥P 熄屏/唤醒 —— 全部作用于光标所在的那块屏。
可以改键，而且不需要任何权限。
The keyboard's own keys
键盘自带的那几个键
Makes F1/F2 act on an external display instead of the built-in one. This needs Accessibility permission, because taking a key over means intercepting it.
让 F1/F2 作用于外接屏而不是内建屏。这需要「辅助功能」权限 —— 接管一个按键就意味着拦截它。
The volume keys are different on purpose. They are taken over only when the system's audio output is an external display's own speakers. On AirPods, AirPlay, the built-in speakers or a USB interface, they are handed back to macOS — otherwise the keys would move a monitor's volume you cannot hear.
音量键是刻意区别对待的。只有当系统音频输出正是 某台外接显示器自己的扬声器时才接管。戴 AirPods、走 AirPlay、用内建扬声器或 USB 声卡时， 按键原样交还 macOS —— 否则你调的是一台自己听不到的显示器音量。
Presets, Shortcuts and the command line
场景、快捷指令与命令行
A preset stores every display's brightness, warmth, volume, resolution and orientation under a name. Save one from the panel's ⋯ menu; apply it from there, from a right-click on the menu bar icon, or from a URL.
场景把每块屏的亮度、色温、音量、分辨率和方向存成一个名字。 在面板的 ⋯ 菜单里保存；从那里、从菜单栏图标右键，或者用一条 URL 应用它。
Anything you can do in the panel, the Shortcuts app can do through the
pwelumen:// scheme using its "Open URLs" action:
面板里能做的事，「快捷指令」都能通过 pwelumen:// 用「打开 URL」做到：
pwelumen://brightness?display=cursor&value=60
pwelumen://volume?display=LG&value=30
pwelumen://preset?name=Evening
pwelumen://rotate?display=2&angle=90Screen capture is deliberately not exposed there: any web page can open a URL scheme, and the app holds Screen Recording permission. Display settings are visible and reversible, so they are safe to automate; silent screenshots are not.
截图刻意没有暴露在这里：任何网页都能打开一个 URL scheme， 而这个应用持有「屏幕录制」权限。显示设置是可见且可逆的，可以放心自动化；静默截图不是。
There is also a command line, pwelumenctl, inside the app bundle at
PWE Lumen Bar.app/Contents/Resources/pwelumenctl. It shares the engine and the settings
with the app, so anything it changes shows up in the panel immediately.
还有一个命令行 pwelumenctl，在应用包里的
PWE Lumen Bar.app/Contents/Resources/pwelumenctl。它和 app 共用引擎与设置，
所以它改的东西会立刻反映在面板上。
When something looks wrong
看起来不对劲的时候
A monitor offers no contrast, no input source, and brightness says "Software"
某台显示器没有对比度、没有输入源，亮度写着「软件」
That display is not answering DDC/CI. Apple's own displays never do — a Studio Display speaks Apple's protocol instead, and its brightness works through that. Third-party monitors usually need "DDC/CI" enabled in their own on-screen menu, and some USB-C docks and KVMs do not carry the channel at all.
那块屏没有应答 DDC/CI。Apple 自家的屏从来不会 —— Studio Display 用的是 Apple 自有协议， 它的亮度走那条通道。第三方显示器通常需要在自己的 OSD 菜单里打开「DDC/CI」； 有些 USB-C 扩展坞和 KVM 根本不传这条通道。
A display never came back after being powered down
显示器断电后再也没回来
DDC power-off is the one operation software cannot undo: on some monitors the display leaves the system entirely and only its physical power button brings it back. That is why the app confirms first and says so. Turn off in the menu is a different thing — a software disconnect, always reversible, and the display it switched off keeps its own row in the panel so you can bring it back.
DDC 断电是软件唯一撤不回来的操作：在有些显示器上，屏幕会整个离开系统， 只有物理电源键能让它回来。所以这个操作会先确认并说明。菜单里的「熄屏」是另一回事 —— 软件断开，永远可逆，被熄掉的屏在面板里保留自己的一行，随时能开回来。
Forced HiDPI is installed but nothing changed
强制 HiDPI 装了，但什么都没变
It needs a restart — the override is read when the system starts. After restarting, the new modes are in the card's resolution menu, marked with a sparkle.
它需要重启 —— 覆盖文件是在系统启动时读取的。重启之后，新模式会出现在卡片的 分辨率菜单里，带一个星芒标记。
The resolution or orientation went back on its own
分辨率或方向自己变回去了
By design. A change that could leave you looking at an unusable screen is applied with a 15-second confirmation: say nothing and it reverts. If it reverts on its own later, that display's configuration is locked — the padlock badge on the card — and outside changes are undone on purpose.
这是设计。可能让你面对一块没法用的屏幕的改动，都带 15 秒确认：不确认就回滚。 如果是之后自己变回去的，说明那块屏的配置被锁定了 —— 卡片上有「已锁定」标记 —— 外部改动会被有意还原。
Something is wrong and you want to send a log
出了问题，想把日志发过来
The app and the command line both write to
~/Library/Logs/PWE Lumen Bar/pwelumenbar.log. Reply to your licence email and attach
it, along with what the Settings window's System section reports.
应用和命令行都写同一个日志：
~/Library/Logs/PWE Lumen Bar/pwelumenbar.log。回复授权邮件把它附上，
再带上设置窗口「系统」一段里显示的自检结果。