用途
device_data 用于从 Muse 存储中直接读取缓存的联系人和日历事件，不联系设备本身。典型场景包括：设备离线无法实时读取，或设备不支持 contacts.search/calendar.search 接口。该工具不会联系或变更设备。它也支持在用户明确要求时，删除 Muse 本地存储的联系人或日历数据。
主要能力
联系人方面，支持查看状态、搜索、全部删除。搜索命令支持 --match-mode ranked，可附加 --query、--phone-label、--locale、--device、--limit、--offset。匹配方式结合显示名、电话、邮箱的子串匹配，词元级精确匹配，按区域设置的昵称匹配以及语音姓名匹配。无区域设置或英语区域时，在普通姓名匹配无结果后才应用模糊匹配，最多每个来源设备返回三个模糊候选。结果包含 selection_evidence，其中 spoken_name_collision_pairs 用于标识发音相近但拼写不同的候选，并设置 requires_spoken_name_clarification。联系人还包含 phone_selection，将安全等价的号码格式归组，并报告 distinct_usable_phone_count 与 requires_phone_clarification。组织与职位在可用时一并返回。结果支持分页，has_more 为真时可增大 offset 继续读取；search_complete 为假时可通过 corpus_overflow、preprocessing_overflow、result_overflow 排查原因。
日历方面，支持按 --query、--device、--start-date、--end-date 搜索，以及全部删除。日期边界为包含式 YYYY-MM-DD，单日查询起止相同；全天事件的 end_date 同样包含。事件时间在带标签的 time 对象中读取：timed 含本地化的 start_at/end_at、UTC 形式及 user_timezone；all_day 仅含日期，不做时区偏移。两者均提供已解析的 start_weekday/end_weekday。
使用方式
命令示例：device-data --help；device-data contacts status；device-data contacts --delete-all；device-data contacts search --match-mode ranked [--query <text> [--phone-label <text>] [--locale <bcp-47>]] [--device <node_id>] [--limit <n>] [--offset <n>]；device-data calendar search [--query <text>] [--device <node_id>] [--start-date <YYYY-MM-DD>] [--end-date <YYYY-MM-DD>]；device-data calendar --delete-all。两种搜索默认覆盖所有符合条件且已配对的设备，使用 --device 限定单台；省略 --query 即列出。
适用场景
设备离线或不支持实时搜索时的联系人和日历查询；按姓名、电话、邮箱查找联系人；按日期区间查看日历事件；在用户明确要求下清理 Muse 本地缓存数据。
限制与注意事项
每次都应重新读取，不能凭记忆回答联系人或日历问题。设备数据视为用户隐私，只展示请求所需字段，不得从联系人、位置、设备名或通信元数据推断敏感属性。空日历结果仅在 cache.coverage 完整时才具权威性；联系人的 search_complete 只涵盖有限语料与结果集，不反映来源新鲜度，需要时应查看 contacts status 并报告部分或截断结果。若不存在记录应如实说明；设备日历只是该手机的视图，相关时应检查其他已连接日历。用户未指明删除目标时不得推断；删除前须确认用户指的是 Muse 本地存储副本。两个 --delete-all 命令会删除所选来源在所有设备上的 Muse 存储数据，包括缓存记录、来源账本负载、上传暂存及同步状态，但保留设备配对和其他数据源；此后设备同步可能重新存入新记录。不要枚举记录 ID。