用途:device_data 用于从 Muse 存储中直接读取缓存好的联系人与日历事件,无需联系设备本身。适合设备离线、或设备端不提供 contacts.search/calendar.search 的场景;也可在用户明确要求时删除 Muse 本地存储的联系人或日历数据。该工具不会联系或改动设备。
主要能力:联系人搜索可结合显示名、电话、邮件的字符串匹配,以及词级精确匹配、按语言的昵称匹配和语音姓名匹配;日历搜索支持按查询词与日期范围筛选。两类搜索默认覆盖所有符合条件的已配对设备,可用 --device 限定单一设备,省略 --query 则列出记录。结果包含 phone_selection、spoken_name_collision_pairs、selection_evidence 等辅助信息。日历日期用闭区间 YYYY-MM-DD,全天事件日期不做时区偏移,星期字段直接采用返回值。
使用方式:常用命令包括 device-data --help、device-data contacts status、device-data contacts --delete-all、device-data contacts search --match-mode ranked、device-data calendar search、device-data calendar --delete-all。联系人可用 --query、--phone-label、--locale、--limit、--offset 等参数;日历可用 --query、--start-date、--end-date。分页时在 has_more 为真时按返回数量推进 offset。
限制与规则:联系人/日历问题须当轮重新读取,不得凭记忆回答;只展示请求所需字段,不推断敏感属性。空日历结果仅在 cache.coverage 完整时视为权威;search_complete 不覆盖数据新鲜度,需新鲜度时查阅 contacts status。模糊、部分、语音匹配须通过校验,弱或歧义匹配仍需确认;字面匹配不自动拨号。删除前必须确认用户指的是 Muse 本地副本,且不枚举记录 ID;--delete-all 会删除所选来源在所有设备上的缓存记录、账本、上传暂存与同步状态,但保留设备配对与其他数据源,之后同步仍可能写入新记录。