perceptkit 0.2.3__tar.gz → 0.2.4__tar.gz

{perceptkit-0.2.3 → perceptkit-0.2.4}/CHANGELOG.md

@@ -1,6 +1,20 @@
 # 变更记录
 
-## 0.2.3 — 未发布
+## 0.2.4 — 未发布
+
+**第一批真机数据跑出来的。** 4052 次比对里三处不一致，这是其中属于内核的那一处。
+
+### 修复
+
+- **「音乐停了」这个状态进不了系统。** `track_key` 声明成必填，而播放器停着的
+  时候没有曲目 —— 于是那条观测因「缺必填字段」被**整条拒掉**：在放什么记得住，
+  停了永远记不住。而「他刚把音乐关了」恰恰是这个信号最有用的那一半。
+  真机上 83 次上报，83 次都是这个。
+
+  规范 §5.3 把 `track_id` 列为字段，没说它任何时候都必须有值。
+
+
+## 0.2.3 — 2026-09-01
 
 **七个「声明了、但没有代码做」的修复。** 都是拿规范逐条跑代码跑出来的，
 不是照着清单打勾 —— 清单把这七条全判成了成立，因为它核的是 manifest 怎么写的。

{perceptkit-0.2.3 → perceptkit-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: perceptkit
-Version: 0.2.3
+Version: 0.2.4
 Summary: 从设备信号判断:有没有发生值得留意的事、值不值得叫醒一次 agent、以及该怎么把此刻的状况讲给它听。不采集数据、不碰存储、不调模型。
 License: 
                                          Apache License

{perceptkit-0.2.3 → perceptkit-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "perceptkit"
-version = "0.2.3"
+version = "0.2.4"
 description = "从设备信号判断:有没有发生值得留意的事、值不值得叫醒一次 agent、以及该怎么把此刻的状况讲给它听。不采集数据、不碰存储、不调模型。"
 readme = "README.md"
 requires-python = ">=3.10"

{perceptkit-0.2.3 → perceptkit-0.2.4}/src/perceptkit/manifest/minimal.py

@@ -1093,7 +1093,15 @@ MUSIC_PLAYBACK = SignalDefinition(
             key="track_key",
             value_type="string",
             privacy_class="sensitive",
-            nullable=False,
+            nullable=True,
+            # ★ 「什么都没在放」是一个**正常状态**，而它没有曲目。
+            #
+            #   非空的话，播放器停着的那条观测因为缺必填字段被整条拒掉 ——
+            #   于是 kit 永远不知道「音乐停了」，只知道「在放什么」。
+            #   真机上这条占了 83 次差异里的 83 次：老路记着 stopped，
+            #   kit 那边一片空白。
+            #
+            #   规范 §5.3 把 track_id 列为字段，没说它任何时候都必须有值。,
             comparison_strategy="exact",
             wake_eligible=True,
             query_visibility="on_demand",

{perceptkit-0.2.3 → perceptkit-0.2.4}/tests/test_regressions.py

@@ -823,3 +823,34 @@ def test_every_signal_with_a_permanent_aggregate_marks_its_identity():
                if s.keeps_aggregates_forever and not s.keeps_history_forever]
     assert set(at_risk) == {"focus_state", "motion_state",
                             "music_playback", "photo_library_added"}
+
+
+# ---------------------------------------------------------------------------
+# I11 —— 「音乐停了」这个状态进不了系统
+#
+# 真机上跑出来的：老路 83 次记着 stopped，kit 那边一片空白。
+# ---------------------------------------------------------------------------
+
+def test_a_stopped_player_is_a_state_the_system_can_hold():
+    """播放器停着的时候没有曲目 —— 那是正常的，不是数据缺失。
+
+    `track_key` 非空的话，这条观测因为缺必填字段被**整条拒掉**：于是
+    「在放什么」记得住，「停了」永远记不住。而「他刚把音乐关了」恰恰是
+    这个信号最有用的那一半。
+    """
+    storage = InMemoryStorage()
+    kit = PerceptionKit(storage=storage, signals=MINIMAL_SIGNALS)
+    at = datetime(2026, 9, 1, 9, 0, tzinfo=timezone.utc)
+    outcome = kit.ingest({
+        "schema_version": 1, "report_id": "m1", "producer": "ios",
+        "observations": [{
+            "signal": "music_playback", "signal_schema_version": 1,
+            "occurred_at": at.isoformat(), "availability": "observed",
+            "timezone": "Asia/Shanghai",
+            "value": {"playback_state": "stopped", "edge_quality": "estimated"},
+        }],
+    }, context=IngestContext("u", at))
+    assert not outcome.rejected, list(outcome.rejected)
+    current = storage.get_current(subject_id="u", signals=["music_playback"]
+                                  )["music_playback"][0]
+    assert current.typed_value["playback_state"] == "stopped"

{perceptkit-0.2.3 → perceptkit-0.2.4}/uv.lock

@@ -43,7 +43,7 @@ wheels = [
 
 [[package]]
 name = "perceptkit"
-version = "0.2.3"
+version = "0.2.4"
 source = { editable = "." }
 
 [package.optional-dependencies]