NVDABatteryReport (Отчет о состоянии батареи)

NVDA Battery Report — это открытое дополнение для NVDA, которое генерирует и читает официальный отчёт о батарее Windows (powercfg /batteryreport) полностью доступным способом. Оно озвучивает краткую сводку (состояние батареи и ёмкости), организует данные в чёткие разделы и ведёт локальную историю.

Функции

• Отчёт Windows в один клик, генерируется локально через powercfg.

• Озвученная сводка в конце (состояние батареи и ёмкости).

• Чёткие разделы:

  • Обзор
  • Установленная батарея
  • Недавнее использование (7 дней)
  • Разряд батареи (7 дней) — начало, состояние, продолжительность и потреблённая энергия
  • История ёмкости
  • История использования
  • Оценки времени работы батареи (со средними значениями)

• Удобные для скринридеров списки: каждая строка таблицы преобразуется в обычный текст с заголовками столбцов.

• Сортировка (сначала новые/старые) и ограничения строк (10, 20, 30…).

• Копирование выбранной строки в буфер обмена.

• Открытие исходного HTML отчёта для проверки.

• Многоязычная поддержка (.po/.mo).

Журнал изменений

1.01 (последняя версия)

• NVDA 2026.1

1.0 (последняя)

• Официальное формирование отчёта Windows.
• Разделы с заголовками столбцов, сортировкой и ограничением строк.
• Расчёт состояния здоровья с использованием Расчётной ёмкости (заводской) и Максимальной ёмкости заряда (текущей).
• Разряд батареи (7 дней) с чётким сообщением «нет записей».
• Оценки времени работы батареи со средними значениями.
• Интегрированная история, копирование в буфер обмена и открытие исходного HTML.

Установка

1. Установите через меню «Дополнения» NVDA (Магазин дополнений или локальный файл). NVDA → Сервис → Дополнения → выберите Магазин дополнений (Store) или Установить… и выберите файл .nvda-addon.
2. Перезапустите NVDA, когда будет предложено.

Как использовать

1. Откройте дополнение: Сервис → NVDA Battery Report. (Нет сочетания по умолчанию — см. «Сочетания клавиш», чтобы назначить.)

2. Нажмите Сформировать отчёт. Когда он завершится, NVDA объявит сводку, и элемент появится в Истории.

3. Выберите отчёт в Истории и нажмите Просмотреть детали.

4. В Детали:

   • Выберите Раздел.
   • Для больших таблиц настройте Строки и Порядок (Сначала новые/Сначала старые).
   • Список показывает каждую строку; Описание повторяет её как обычный текст с заголовками столбцов.

• Используйте Копировать выбранное, чтобы поместить строку в буфер обмена.
  • Открыть исходный HTML для просмотра оригинального отчёта Windows.

Сочетания клавиш (назначить в NVDA)

1. NVDA → Параметры → Жесты ввода
2. Найдите «NVDA Battery Report»
3. Назначьте предпочтительный жест (например, NVDA+Shift+B)

Ключевые понятия

• Расчётная ёмкость (заводская): энергия, которую батарея поддерживала в новом состоянии.
• Максимальная ёмкость заряда (текущая): энергия, которую она поддерживает сегодня, после износа.
• Состояние батареи = Максимальная ёмкость заряда ÷ Расчётная ёмкость × 100%.

Разряд батареи (7 дней) перечисляет случаи, когда устройство потребляло энергию от батареи: время начала, состояние, продолжительность и потреблённая энергия за этот интервал.

Где хранятся файлы

• HTML-отчёты: …\addons\NVDABatteryReport\globalPlugins\battery_reports\
• История (JSON): …\addons\NVDABatteryReport\globalPlugins\battery_history.json (Внутри профиля NVDA пользователя.)

Перевод и участие

• Файлы переводов находятся в addon/locale/ (.po/.mo).
• PR с исправлениями, функциями или переводами приветствуются!

Сборка из исходного кода (SCons)

git clone https://github.com/leoguimaoficial/NVDA-BatteryReport.git
cd NVDA-BatteryReport
pip install scons markdown
SCons   # или: python -m SCons

Часто задаваемые вопросы

• Нужен ли интернет? Нет. Отчёт генерируется локально (powercfg).
• В моём настольном ПК нет батареи — будет ли это работать? Отчёт может показать, что батарея отсутствует, и некоторые разделы будут пустыми.
• Почему некоторые поля показывают «–»? Windows не записала достаточно данных за этот период.
• Порядок отличается от HTML-файла. Дополнение сортирует по фактической дате (сначала новые). Вы можете переключить это в Порядок.
• Даты выглядят странно. Они следуют вашему региональному формату Windows.

Решение проблем

• «powercfg.exe не найден.» Проверьте Windows; powercfg.exe находится в System32/Sysnative.
• Ошибка открытия исходного HTML. Убедитесь, что файл существует в папке отчётов; при необходимости сгенерируйте новый отчёт.
• Пустые/«неизвестные» элементы. Сгенерируйте новый отчёт; разделы без данных показывают «Нет записей за последние 7 дней.»