update at 2026-03-21 18:44:12

dash/README.md

@@ -59,6 +59,15 @@ If you're using KUAL you can use simple extension to start this Dashboard
 For on-device debugging without suspending the Kindle, set `DISABLE_SYSTEM_SUSPEND=true` in `local/env.sh`.
 The dashboard loop will keep running, skip the `sleeping.png` branch, and use a normal `sleep` between refreshes instead of writing to `/sys/power/state`.
 
+运行规则：
+
+* 无论 `debug on` 还是 `debug off`，设备侧时钟都按分钟调度刷新一次。
+* `DEBUG=true` 或 `DISABLE_SYSTEM_SUSPEND=true` 时，设备不进入真 suspend，dashboard 保持可见，并持续按分钟刷新。
+* 普通低功耗模式下，设备仍会按分钟唤醒并刷新时钟，但常规分钟刷新只更新后台缓存，不主动把时钟刷到可视屏幕。
+* 手动短按 `power` 的行为单独处理：dashboard 会保持 5 分钟可视窗口，并在窗口内继续按分钟刷新，窗口结束后回到普通低功耗循环。
+* 通过 KUAL 启动 dashboard 或切换主题后回到 calendar，也会给同样的 5 分钟可视窗口。
+* 分钟级时钟刷新完全在本机完成；背景图和主题资源同步仍保持低频。
+
 If you're connected over SSH you can also run `DEBUG=true ./start.sh` to keep the process in the foreground with shell tracing enabled.
 If you're launching from KUAL, `Dashboard Debug On` now persists `DISABLE_SYSTEM_SUSPEND=true` and immediately restarts the dashboard in one tap. `Dashboard Debug Off` restores the normal low-power behavior and also restarts the dashboard immediately.
 If you're connected over SSH and only want a one-off foreground session, you can still run `/mnt/us/dashboard/start-debug.sh`.
@@ -70,6 +79,7 @@ On Voyage 5.13.6, if `stop.sh` finishes but the home UI is still missing, the cu
 * This code periodically downloads a dashboard background image from an HTTP(s) endpoint.
 * The interval can be configured in `dist/local/env.sh` using a cron expression.
 * When the layered clock renderer is enabled, the Kindle re-renders the clock region locally every minute.
+* 普通模式下，常规分钟刷新只更新后台缓存，不主动把时钟刷到可视屏幕；手动短按 `power` 或从 KUAL 回到 calendar，会打开一个 5 分钟的可视窗口，结束后再回到普通循环。
 * During the update intervals the device is suspended to RAM to save power.
 
 ## Notes