iPhone 上最详细的电池报告并不在“设置” → “电池”中。它隐藏在 iOS 每天生成的一个文件里——但几乎没有人会去读它。

一旦你启用了共享 iPhone 分析，系统就会每天生成一个 Analytics-YYYY-MM-DD-….ips.ca.synced 日志。打开它，你会发现一连串的 JSON 数据行，其中悄悄包含着完整的电池化学状况体检报告：循环次数、容量、内阻、温度暴露情况、屏幕开启时间、充电时间以及各 App 的卡顿次数。Apple 会在内部使用这些数据，但对于其他人来说，这完全如同天书。

Device Status⁺ 内置了 Battery Log Analyzer（电池日志分析器），能在完全脱离网络的设备本地，将每天的数据流转化为一份带有单一评分的健康报告。本指南将介绍该日志是什么、如何获取它，以及分析器究竟从中提取了哪些具体数据。

什么是 Device Status⁺？

Device Status⁺ 是由时空转换科技有限公司（Space-Time Transformation Technology Co., Ltd.）开发的一款免费系统监控应用（需 iOS 17.0+；支持 iPhone、iPad、M 系列芯片 Mac、Apple Vision Pro、Apple Watch）。其配套的 Diagnostic Log Analyzer（诊断日志分析器） 用于读取某一时间点的 sysdiagnose（系统诊断）快照；而本文介绍的 Battery Log Analyzer（电池日志分析器） 则用于读取追踪电池长期健康状况的每日 Analytics（分析）日志。

所有处理均在本地完成。不会上传任何数据。

什么是电池分析日志？

每个每日文件都是一个 JSON 对象流，每行一个，混合了多种消息类型。其中隐藏着描述你电池状态的消息：

• BatteryConfigValueHistogram — 容量、循环次数、温度、电压、电流、Qmax、FCC、首次使用日期、运行时间
• DailyWirelessUsageAgg — 亮屏时间
• aggregate_chargetime — 充电时间
• HangTracerHangsByApp — 各 App 的卡顿次数

与 sysdiagnose（对硬件、存储和崩溃状况的一次性全面快照）不同，电池分析日志是一种每日自动记录的趋势。两者相辅相成：一个告诉你硬件当前的状态，另一个告诉你电池老化的趋势。

第 1 步：开启分析功能并获取日志

1. 打开 设置 → 隐私与安全性 → 分析与改进。
2. 启用 共享 iPhone 分析（如果处于关闭状态，首个每日文件将于次日生成）。
3. 打开 分析数据 并搜索 Analytics。
4. 选取最新的 Analytics-…-….ips.ca.synced 文件 → 共享 → 保存，然后将其导入到 Device Status⁺ 中。

单个文件虽然很小，但仍会以数据流的方式进行解析——绝不会整个加载到内存中。

第 2 步：流式解析，无需全盘加载

BatteryLogParser 使用 InputStream 逐行读取文件，并将每个 JSON 对象路由到匹配的提取器。由于它从不在内存中保存整个文件，因此在旧型号设备上，即便是异常庞大的每日日志也能顺利完成解析。

提取的指标

基于上述四类消息族，分析器重构出了原始的电池画像：

• 容量与循环次数 — 标称容量与原始最大容量、设计容量、循环次数、首次使用日期。
• 电气参数 — 电压范围、电流范围、Qmax（当前条件下的最大容量）、FCC（满充容量）。
• 环境状况 — 全天的温度情况摘要。
• 使用情况 — 亮屏时间（来自 DailyWirelessUsageAgg）和充电时间（来自 aggregate_chargetime）。
• App 卡顿 — 来自 HangTracerHangsByApp 的各 App 卡顿次数，能正确区分“附加调试器”状态下的卡顿和“运行时”的卡顿，从而避免重复计算。

这些原始字段是基础素材，而分析器据此计算出的结果才是让报告发挥价值的关键。

你真正关心的数字

BatteryLogReport 推导出了一系列能够解答实际问题的指标：

• 计算健康度 = NominalChargeCapacity ÷ AppleRawMaxCapacity — 这是实际的可用容量比率，不受 iOS 自身报告数据的影响。
• 系统健康度 = MaximumCapacityPercent — iOS 自身在“设置”中报告的数值，用于进行直观对比。
• 每日充电区间 = DailyMinSoc – DailyMaxSoc — 勾勒出你的日常充电习惯画像。
• 电池健康评分 (0–100) = screen-on-time ÷ 10800 × 60 + health × 40 — 这是一个直观的单一分数，将“续航时间长短”与“健康度好坏”融为一体。
• 此外还包括：满电续航区间、Qmax 区间、电压/电流频段、温度摘要、容量稳定性以及电芯一致性。

将计算出的健康度与系统报告的健康度同时并排显示，正是其核心意义所在：当 iOS 显示健康度为 90%，而底层化学数据反映为 84% 时，你能立刻看出其中的偏差。

界面外观

界面上最醒目的数字是一个用于表示电池健康度的 进度环，它 按层级着色（绿色/黄色/红色），让你对电池状态一目了然。其下方的每个指标都是以卡片形式呈现的，并且只需轻点一下，即可将整份报告 导出为纯文本 ——这对于与维修技术人员分享或保留个人的历史记录来说非常方便。

诊断日志 vs 电池日志：该选哪一个？

它们解答的是不同的问题，你可能两者都需要：

如果你的手机昨晚崩溃了，请查看 sysdiagnose 日志；如果你想知道这个月的电池是否老化得更快，请查看 Analytics 分析日志。

通过共享扩展一键导入

在“分析数据”列表中，打开一个 .ips 文件并轻点“共享”。sharelog 扩展会自动检测类型 —— .ips 会路由至 Battery Log Analyzer（电池日志分析器），而 sysdiagnose_*.tar.gz 会路由至 Diagnostic Log Analyzer（诊断日志分析器）——接着会显示一张简短的确认卡片，确认后便会交接数据。

与处理 sysdiagnose 一样，扩展程序本身不进行任何解析工作。 它会将文件复制到 App Group 容器（ShareInbox/）中，向 App Group UserDefaults 写入一个待处理信号，并通过 devicestatus URL scheme 唤醒主 App。当主 App 重新回到前台时，其内部的 ShareImportCoordinator 会处理该队列、清除信号，随后真正的分析器便会在内存充裕的环境下运行——最后弹出报告表单并为其提供深层链接。对用户而言只需轻点一下；而在后台则是一系列严谨的数据交接。

隐私与稳健性

与 Diagnostic Log Analyzer（诊断日志分析器）一样，这里同样遵循以下三项承诺：

1. 完全离线，在设备端处理 — 在任何阶段都不会发起网络请求。
2. 可读性优先 — 每次解析的最终结果都会呈现为卡片；原始字段会被保留，但默认情况下不会直接展示。
3. 生产级别的稳健性 — 具备路径遍历防护机制、文件渲染防护栏（文本上限为 512 KB / 4,000 行，CSV 上限为 1,000 行），并提供通俗易懂的错误提示信息，而非晦涩难懂的内部代码。

总结

你的 iPhone 每天都在撰写一本详细的电池日记；你只是苦于没有读取它的方法。Battery Log Analyzer（电池日志分析器）能够将这本日记转化为一份健康报告——涵盖循环次数、真实容量、日常使用情况以及一个 0 到 100 的单一评分——而无需将任何数据发送到设备之外。

将其与用于检测硬件状况的 Diagnostic Log Analyzer（诊断日志分析器） 配合使用，你就能获得一份全面且完全私密的设备体检报告：既了解设备今日的状态，又掌握电池随着时间推移的趋势。