笔记本电池体检
把 Windows 已生成的电池报告变成容易理解的容量记录，并明确还需哪些信息才能讨论续航或耗电。容量比例只是系统报告读数，不能单独定位耗电程序或证明硬件故障。
环境与首用
- Python 3.8+ 标准库。生成原始报告需要目标 Windows 10/11；分析现成 HTML/JSON 和固定
demo可在其他系统运行。有文件工具的 AI 可分析，没有工具时可解读用户粘贴的相关表格。 demo是固定合成数据，不读取本机电池。有真实报告时直接分析，不强制先演示。- 首版自动提取安装电池表格的设计容量、满充容量、循环数，支持常见英文字段和本文列明的中文字段。不同语言或页面结构未识别时返回未知，可改用规范 JSON；不把“没解析到”写成“没有电池”。
工作流程
- 使用用户提供的
battery-report.html；如果要在目标 Windows 上新生成，先核对工具确实在目标电脑。生成报告仅写新文件，不改变电源计划；已有文件不能覆盖。按照微软 powercfg 说明使用powercfg /batteryreport /output "新路径.html"。遇到权限失败保留原错误，不擅自提权。 - 原报告可能含机器名、序列号和使用记录，保留在本机。脚本只读取 HTML 文本、不执行脚本、不加载外部资源；输出不转存序列号。
- 设计容量为正且满充容量有效时计算
满充/设计×100%。缺失、零、负数、非数字保持未知；大于设计容量不强行裁为 100%，明显超出时提示核对报告和校准情况。多块电池逐块列出，合计比例按容量加权而不是平均百分数。 - 循环数未知不能填 0。是否换电池不能由本工具阈值决定。若用户描述鼓包、变形、异常发热等，应按厂商说明处理并停止充电使用，而不是继续做放电测试。
- 讨论耗电时另看用户给出的实际场景、屏幕亮度、电源模式和报告使用记录。首版不自动解析耗电程序或预测续航小时；相近条件下复查趋势，再提出具体下一步。护理建议查微软电池说明。
命令
python "{baseDir}/scripts/battery_report.py" demo
python "{baseDir}/scripts/battery_report.py" analyze --input "D:/体检/battery-report.html" --out "D:/体检/电池解读-新建"
python "{baseDir}/scripts/battery_report.py" analyze --input "D:/体检/battery-input.json" --out "D:/体检/电池解读-json-新建"
规范 JSON 见 assets/battery-input.sample.json，全部为合成数据。实际输入用 schema: satloot-battery-input/1、batteries 列表，每条含 id、design_mwh、full_charge_mwh 和可选 cycle_count；容量单位必须是 mWh，未知用 null。输出新目录内 report.json 和 report.md。本技能不修改电源、固件、BIOS 或电池校准设置。
