update at 2026-03-16 09:00:35

dash/src/local/env.sh

@@ -13,6 +13,37 @@ export CLOCK_REGION_WIDTH=${CLOCK_REGION_WIDTH:-220}
 export CLOCK_REGION_HEIGHT=${CLOCK_REGION_HEIGHT:-220}
 export CLOCK_FULL_REFRESH_INTERVAL_MINUTES=${CLOCK_FULL_REFRESH_INTERVAL_MINUTES:-15}
 
+# 本机时钟外观参数：
+# 页面改版导致时钟区域尺寸变化时，通常只需要改 CLOCK_REGION_*，
+# 这组比例参数会随新的宽高自动缩放。
+# 如果只是想微调指针长短、粗细或刻度长度，再改下面这些值即可，不用改 Lua 代码。
+export CLOCK_FACE_RADIUS_RATIO=${CLOCK_FACE_RADIUS_RATIO:-0.47}
+export CLOCK_FACE_STROKE=${CLOCK_FACE_STROKE:-3}
+export CLOCK_TICK_OUTER_INSET=${CLOCK_TICK_OUTER_INSET:-6}
+export CLOCK_MAJOR_TICK_LENGTH=${CLOCK_MAJOR_TICK_LENGTH:-14}
+export CLOCK_MINOR_TICK_LENGTH=${CLOCK_MINOR_TICK_LENGTH:-7}
+export CLOCK_MAJOR_TICK_THICKNESS=${CLOCK_MAJOR_TICK_THICKNESS:-4}
+export CLOCK_MINOR_TICK_THICKNESS=${CLOCK_MINOR_TICK_THICKNESS:-2}
+export CLOCK_HOUR_LENGTH_RATIO=${CLOCK_HOUR_LENGTH_RATIO:-0.48}
+export CLOCK_MINUTE_LENGTH_RATIO=${CLOCK_MINUTE_LENGTH_RATIO:-0.72}
+export CLOCK_HOUR_THICKNESS=${CLOCK_HOUR_THICKNESS:-9}
+export CLOCK_MINUTE_THICKNESS=${CLOCK_MINUTE_THICKNESS:-5}
+export CLOCK_CENTER_RADIUS=${CLOCK_CENTER_RADIUS:-7}
+
+# 进入 rtc suspend 前预留的可中断窗口，方便在调试时及时停止进程。
+# 这段时间会从真正的休眠时长里扣掉，避免分钟刷新慢一拍。
+export PRE_SLEEP_GRACE_SECONDS=${PRE_SLEEP_GRACE_SECONDS:-10}
+
+# Voyage 顶部状态栏遮罩：用于压住系统偶尔重画出来的时间、Wi-Fi、电池图标。
+# 当前坐标只覆盖页面顶部空白带，不会擦到天气卡上边框。
+export STATUS_MASK_ENABLED=${STATUS_MASK_ENABLED:-true}
+export STATUS_MASK_LEFT=${STATUS_MASK_LEFT:-700}
+export STATUS_MASK_TOP=${STATUS_MASK_TOP:-0}
+export STATUS_MASK_WIDTH=${STATUS_MASK_WIDTH:-372}
+export STATUS_MASK_HEIGHT=${STATUS_MASK_HEIGHT:-24}
+export STATUS_MASK_PASSES=${STATUS_MASK_PASSES:-3}
+export STATUS_MASK_DELAY_SECONDS=${STATUS_MASK_DELAY_SECONDS:-1}
+
 # By default, partial screen updates are used to update the screen,
 # to prevent the screen from flashing. After a few partial updates,
 # the screen will start to look a bit distorted (due to e-ink ghosting).
@@ -21,7 +52,7 @@ export CLOCK_FULL_REFRESH_INTERVAL_MINUTES=${CLOCK_FULL_REFRESH_INTERVAL_MINUTES
 export FULL_DISPLAY_REFRESH_RATE=${FULL_DISPLAY_REFRESH_RATE:-0}
 
 # 调试开关：设为 true 后，主循环仍会按计划拉图和刷新屏幕，
-# 但不会把 Kindle 写入 /sys/power/state 进入系统挂起。
+# 不会进入 sleeping.png 分支，也不会把 Kindle 写入 /sys/power/state 进入系统挂起。
 # 适合通过 KUAL 或普通 start.sh 连续观察效果，调试结束后再改回 false。
 export DISABLE_SYSTEM_SUSPEND=${DISABLE_SYSTEM_SUSPEND:-false}