diff --git a/app/src/main/java/com/placeholder/ringhealth/data/mock/MockRingDeviceRepository.kt b/app/src/main/java/com/placeholder/ringhealth/data/mock/MockRingDeviceRepository.kt
index aa917c1..c4f1b3e 100644
--- a/app/src/main/java/com/placeholder/ringhealth/data/mock/MockRingDeviceRepository.kt
+++ b/app/src/main/java/com/placeholder/ringhealth/data/mock/MockRingDeviceRepository.kt
@@ -11,6 +11,12 @@ import kotlinx.coroutines.flow.update
 
 /**
  * Mock 设备仓库。开关状态保存在内存中，进程重启后重置（阶段一不做持久化）。
+ *
+ * 注意 [refreshDeviceState] 的语义：它以 **suspend 函数正常返回**表示刷新完成，
+ * 而**不是**靠发射新状态。`MutableStateFlow` 会抑制相等值，M1 的设备状态是常量，
+ * 因此刷新不会产生任何可观察的发射。调用方要展示刷新反馈，应当
+ * `launch { repo.refreshDeviceState(); isRefreshing = false }`，
+ * **不要**写成「等待下一个不同的 deviceState 发射」（那样在 M1 会永远等不到）。
  */
 class MockRingDeviceRepository(
     private val provider: MockDataProvider = MockDataProvider(),
diff --git a/app/src/test/java/com/placeholder/ringhealth/data/mock/MockDataProviderTest.kt b/app/src/test/java/com/placeholder/ringhealth/data/mock/MockDataProviderTest.kt
index 106bdba..ac96e31 100644
--- a/app/src/test/java/com/placeholder/ringhealth/data/mock/MockDataProviderTest.kt
+++ b/app/src/test/java/com/placeholder/ringhealth/data/mock/MockDataProviderTest.kt
@@ -45,6 +45,11 @@ class MockDataProviderTest {
         assertTrue(first.all { it.value > 40.0 && it.value < 180.0 })
         // 时间戳须严格递增（“每点间隔一天”倒推，最早的在最前）
         assertTrue(first.zipWithNext().all { (a, b) -> b.timestamp > a.timestamp })
+        // 断言绝对时间戳，让注入的时钟真正成为被测对象：若退回 System.currentTimeMillis()，
+        // 这两条会立刻失败（ledger R17 / R20）。只比较 first == second 是不够的 ——
+        // 两次相邻调用几乎总落在同一毫秒，那时去掉时钟注入测试照样通过。
+        assertEquals(FIXED_NOW, first.last().timestamp)
+        assertEquals(FIXED_NOW - 6L * 24 * 60 * 60 * 1000, first.first().timestamp)
     }
 
     @Test