Mac 上按時段調暗螢幕，以及那個會把螢幕一路調成全黑的陷阱

按時段調暗螢幕聽起來是兩行程式的事：看錶、設亮度。陷阱在「設」這個字上。如果你要設的值是從目前已有的值推算出來的，那麼每複查一次螢幕就更暗一點——到早上它就全黑了。

這個功能，從使用者角度看

一天被分成幾個時段——工作時段、傍晚時段、夜間時段——每一段各自帶白點與亮度。沒有全域開關；改 21:00 的行為不會影響 14:00。

時間以距本地午夜的分鐘數儲存。這帶來一個漂亮的結果：結束時間早於開始時間就自動跨越午夜，所以「夜間 20:00 到 08:00」完全不需要特例——它和別的時段是同一套算術。

下面這種寫法看起來完全合理：

let current = display.brightness
let dimmed  = current * 0.6      // 錯的
apply(dimmed)

把它掛在 60 秒一次的心跳上，面板就會被反覆乘以 0.6：0.6、0.36、0.22、0.13……螢幕會自己走向全黑，而使用者的說法是「這個應用程式一夜之間把我螢幕弄壞了」。

解法是把值做成絕對量——按滿量程的比例，而不是即時值的倍數：

let target = 0.6               // 滿量程的比例
apply(target)

現在套用兩次和套用一次的結果相同。用一個詞說：這個排程器是幂等的。反覆求值不等於空操作的排程器，不是幂等的——而它會漂移。

第二個陷阱更安靜。掛在預設 run loop 模式上的計時器，在使用者拖動滑桿時不會觸發——因為拖動會把 run loop 按在事件追蹤模式裡。於是那個本該在 21:00 落下的複查，悄無聲息地沒落下。

把心跳註冊在 .common 模式下，它就仍然會落下——而那恰恰是使用者最容易注意到的時刻。

值變成絕對量之後，緊接著的問題是：排程器對同一個時段做了兩次決定會怎樣？如果每次決定都重啟淡入淡出，螢幕就會每分鐘可見地脈衝一次。正確答案是：已經生效的時段是空操作，所以心跳不會重啟一段已經在往正確目標走的過渡。

關掉排程時，把面板交還給開啟排程之前的狀態——不是交還給某個預設值。使用者原本設的是 80%，就拿回 80%，而不是 100%。