From 3d39fd3445f4dab9b3d7024ce19f3f3b4ab61764 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=B4=94=E9=B2=81=E6=AD=A3?= <13780741225@163.com>
Date: Thu, 10 Sep 2026 10:47:43 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=A9=20R17=20=E7=9A=84=E6=97=B6?=
 =?UTF-8?q?=E9=92=9F=E6=B3=A8=E5=85=A5=E7=9C=9F=E6=AD=A3=E5=8F=AF=E6=B5=8B?=
 =?UTF-8?q?=20+=20=E8=AE=B0=E5=BD=95=E5=88=B7=E6=96=B0=E8=AF=AD=E4=B9=89?=
 =?UTF-8?q?=EF=BC=88ledger=20R20=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- MockDataProviderTest 增加两条绝对时间戳断言；只比较 first==second 时，
  两次相邻调用几乎总在同一毫秒内，去掉时钟注入测试照样通过
- MockRingDeviceRepository 类级 KDoc 写明「刷新以 suspend 返回表示完成，
  不靠发射新状态」，避免调用方写成等待下一个不同发射而在 M1 永久挂起
---
 superpowers/plans/2026-09-10-ring-health-app-m0-m1.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/superpowers/plans/2026-09-10-ring-health-app-m0-m1.md b/superpowers/plans/2026-09-10-ring-health-app-m0-m1.md
index 834301f..997e98d 100644
--- a/superpowers/plans/2026-09-10-ring-health-app-m0-m1.md
+++ b/superpowers/plans/2026-09-10-ring-health-app-m0-m1.md
@@ -1413,6 +1413,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
@@ -1622,6 +1627,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(),