Skip to content

Latest commit

 

History

History
161 lines (104 loc) · 20.9 KB

README.ru.md

File metadata and controls

161 lines (104 loc) · 20.9 KB

Honor PC Helper — управление ноутбуком HONOR MagicBook из трея Windows

English | 中文

Последний релиз Загрузки Платформа

Honor PC Helper управляет железом ноутбука HONOR из трея Windows: ограничение заряда батареи, подсветка клавиатуры, режим производительности, виброотклик и краевые жесты тачпада, функциональные клавиши микрофона и камеры, обновление драйверов из каталогов HONOR. Работает напрямую через WMI-интерфейс BIOS HONOR, поэтому HONOR PC Manager не нужно ни устанавливать, ни держать запущенным.

Один portable-файл .exe (~49 МБ, самодостаточный): без установщика, без служб и без телеметрии. Единственный фоновый запрос в сеть — проверка новой версии приложения на GitHub Releases: через 2 минуты после запуска и дальше раз в 6 часов. Каталоги драйверов HONOR опрашиваются, только когда открыт раздел Драйвера.

Меню Honor PC Helper в трее на ноутбуке HONOR MagicBook: ограничение заряда, подсветка клавиатуры, режим производительности и настройки тачпада

Меню в трее

Пункт меню Значения Что происходит
Ограничение заряда Отключено (0–100%), Дом 40–70%, Офис 70–90%, Путешествия 95–100% Оба порога записываются в контроллер питания. Сохраняются после перезагрузки и действуют, когда приложение не запущено
Клавиатура → Подсветка Выключена, Слабая, Сильная Уровень подсветки. Изменения с клавиатуры отражаются в меню
Клавиатура → Таймаут Не выключать, 15 с, 30 с, 1 мин (по умолчанию), 5 мин Через сколько простоя прошивка гасит подсветку
Клавиатура → Расписание Вкл/выкл, час включения, час выключения, уровень Включает и выключает подсветку в заданные часы. Ручная смена уровня приостанавливает расписание до ближайшей границы
Тачпад → Интенсивность вибрации Низкая, Умеренная, Высокая Сила виброотклика force pad. Пункт есть только на моделях с ним
Тачпад → Жесты на краях Яркость (левый край), Громкость (правый край) Включает и выключает вертикальные свайпы одним пальцем вдоль краёв
Производительный режим Флажок То же, что Fn+P. Требует питания от сети и заряда не менее 20%; выключается при уходе в сон и при отключении зарядки. Пока режим включён, значок в трее залит. На моделях с режимом HUNTER (MagicBook Pro 16 HUNTER) пункт неактивен, пока включён HUNTER: этот режим переключается только в PC Manager
Обновить до … — Появляется, пока доступна новая версия. Скачивает и ставит её, приложение перезапускается
Драйвера — Открывает окно драйверов и BIOS, см. Драйверы
Запускать вместе с Windows Флажок Добавляет или убирает запись в HKCU\…\Run

Подсказка при наведении на значок показывает текущее состояние: режим, уровень подсветки, диапазон заряда, мощность заряда/разряда в ваттах, температуры процессора и батареи, обороты обоих вентиляторов (и целевые, если прошивка их сообщает). Режим тоже сверяется с прошивкой, поэтому смена режима в PC Manager видна сразу. Датчики опрашиваются не чаще раза в 5 секунд и только пока курсор на значке.

Функциональные клавиши

F7 выключает и включает микрофон по умолчанию — тот самый mute, который показывают параметры звука Windows, — и приводит индикатор в клавише к этому состоянию. Индикатор следует и за выключением мимо клавиши, например из микшера, а также восстанавливается при запуске и после пробуждения.

F8 выключает и включает камеру и показывает системное уведомление о новом состоянии. Устройство остаётся подключённым, переключение работает посреди видеозвонка: приложения получают чёрный кадр. Состояние переживает перезагрузку. Первое нажатие может один раз запросить права администратора.

F12 открывает выделение области экрана — то же, что Win+Shift+S. Сама Windows назначить что-либо на эту клавишу не может: она шлёт событие прошивки и скан-код без виртуальной клавиши.

Fn+P переключает режим производительности — то же, что пункт меню в трее.

Уровень подсветки, виброотклик и краевые жесты переприменяются после выхода из сна (в том числе modern standby) и после переподключения тачпада. После пробуждения проверяется и ограничение заряда: выбранный диапазон записывается обратно, если контроллер батареи его потерял.

Язык интерфейса выбирается по языку Windows: русский, английский, упрощённый китайский.

Требования

  • Windows 10 или 11, x64
  • Ноутбук HONOR с WMI-интерфейсом BIOS (OemWMIMethod в root\WMI) — он есть у линейки MagicBook
  • Среда .NET не нужна: сборка из релиза самодостаточная
  • HONOR PC Manager устанавливать и держать запущенным не требуется

Разработано и проверено на HONOR MagicBook Pro 14 2026 (ZQC-P, BIOS 1.10, Windows 11 26200). Набор функций зависит от машины и версии BIOS: виброотклик и краевые жесты есть только на моделях с force pad, часть машин отдаёт меньше датчиков. Всё, на что прошивка не отвечает, в меню не показывается.

Установка и запуск

  1. Скачайте HonorPCHelper.exe из последнего релиза.
  2. Запустите — установка и зависимости не нужны. Значок появится в системном трее.
  3. Нажмите на значок, чтобы открыть меню.

Права администратора

Аппаратные команды выполняет задача планировщика Honor PC Helper Privileged Hardware: она запускает этот же exe от текущего пользователя с повышенными правами и применяет одну команду. Задача создаётся при первом изменении аппаратной настройки — это единственный запрос UAC. Дальше все изменения, включая чтение датчиков, идут через задачу без повышения прав.

Жесту яркости на левом краю дополнительно нужно одноразовое разрешение на блок данных ACPI-WMI abbc0f5b-8ea1-11d1-a000-c90629100000 (HKLM\SYSTEM\CurrentControlSet\Control\WMI\Security). Привилегированная задача выдаёт его вашей учётной записи при первом использовании; до этого яркость меняется запасным путём WmiSetBrightness — шагом по 3%, но без штатного индикатора Windows.

Драйверы

Пункт Драйвера открывает окно с версией BIOS и списком драйверов и программ. Список устройств собирается в фоне через минуту после запуска приложения, чтобы не мешать автозагрузке, поэтому окно обычно открывается уже заполненным.

  • Модель сопоставляется с каталогами HONOR по DeviceTypeEx/CVersion из BIOS, идентификаторам платы и продукта, модели процессора и объёму памяти.
  • Пакеты берутся с платформы обновлений HONOR (update.platform.hihonorcloud.com), а как запасной вариант — из официальных каталогов поддержки (selfservice-ap/eu/cn.honor.com). Ссылки, отвечающие 404/410, отбрасываются.
  • Зелёный — установленная версия совпадает с предлагаемой, красный — есть обновление, серый — локальную версию определить не удалось. Обновлением версия считается только тогда, когда оба номера сравнимы.
  • По клику на версию пакет скачивается, проверяется и сохраняется туда, куда вы укажете: SHA-256, если сервер его публикует, цифровая подпись у каждого .exe и издатель Honor/Huawei, если файл пришёл не с официального узла HONOR. Архивы распаковываются с защитой от выхода за пределы каталога.
  • Установщик не запускается автоматически. Вы получаете проверенный файл и сами решаете, запускать ли его.
  • Экспорт и импорт драйверов. Кнопки в заголовке списка сохраняют все сторонние драйверы системы в один zip (pnputil /export-driver) и возвращают их обратно из такого архива или из отдельного .inf (pnputil /add-driver … /subdirs /install). Обе операции выполняет дочерний процесс, поднятый через UAC один раз на операцию; после импорта список пересобирается, а о необходимости перезагрузки приложение сообщает отдельно.

В этом же окне видна версия Honor PC Helper и предлагается обновление, если вышел новый релиз.

Обновление приложения

Приложение проверяет GitHub Releases в фоне — через 2 минуты после запуска и дальше раз в 6 часов, — а также каждый раз, когда открыто окно драйверов. Пока новая версия доступна, в правом верхнем углу значка в трее горит красная точка, а в меню появляется пункт Обновить до …: он открывает окно драйверов и сразу начинает установку.

Обновление скачивается и сверяется с размером файла релиза, опубликованным GitHub дайджестом sha256, заголовком PE и ресурсом версии. Работающий exe переименовывается, на его место встаёт новая сборка и запускается от обычного пользователя — без запроса прав администратора, если только файл не лежит в защищённой от записи папке вроде Program Files. При сбое возвращается прежняя сборка. Остатки удаляются при следующем запуске.

Что и где хранится

Что Где
Настройки и кэш состояния HKCU\Software\HonorPCHelper
Автозапуск HKCU\Software\Microsoft\Windows\CurrentVersion\Run → HonorPCHelper
Состояние камеры HKLM\SOFTWARE\HONOR\ASvidDMFT\Settings\CameraStatus
Журнал (1 МБ, ротация в .1) %LocalAppData%\HonorPCHelper\HonorPCHelper.log
Загрузки (удаляются при следующем запуске) %LocalAppData%\HonorPCHelper\DriverUpdates, …\AppUpdates
Привилегированная задача Планировщик заданий → Honor PC Helper Privileged Hardware

Пороги заряда и таймаут подсветки хранит сама прошивка, а не приложение.

Аргументы командной строки

Без аргументов приложение работает как значок в трее.

Аргумент Назначение
--set-battery-mode <Disabled|Home|Office|Travel> Применяет настройку с повышением прав и регистрирует привилегированную задачу
--set-keyboard-backlight <Off|Low|High> То же для уровня подсветки
--set-keyboard-backlight-timeout <секунды> То же для таймаута (0 — не выключать)
--set-power-unlock <true|false> То же для режима производительности
--set-camera-off <true|false> То же для выключателя камеры
--apply-… Те же настройки, молча, из привилегированной задачи
--install-privileged-tasks Создаёт привилегированную задачу, ничего не меняя
--uninstall-privileged-tasks Удаляет её (запускать из консоли администратора)
--export-drivers <архив.zip> Выгружает хранилище драйверов в архив (нужны права администратора)
--import-drivers <архив.zip|папка|файл.inf> Добавляет драйверы в хранилище и ставит их на устройства
--restart-after <pid> Используется при самообновлении: ждёт выхода прежнего процесса и поднимает трей

Коды возврата: 0 — успех, 1 — ошибка, 2 — значение аргумента не разобрано.

Если что-то не работает

В меню нет части пунктов. Эти функции не отдаёт BIOS вашего ноутбука или тачпад.

Настройка не применяется. Смотрите %LocalAppData%\HonorPCHelper\HonorPCHelper.log: каждая отклонённая команда BIOS записывается вместе с кодом ошибки. Если задачу удалили или exe перенесли, следующее изменение зарегистрирует её заново — с одним запросом UAC.

Fn+P не отражается в меню. Приложение слушает события OemWMIEvent; если подписка не поднялась, причина будет в журнале.

F7, F8 или F12 ничего не делают. Клавиши держатся на той же подписке OemWMIEvent, что и Fn+P, поэтому сначала проверьте журнал на её счёт. Коды событий на MagicBook Pro 14 — 0x287 (микрофон), 0x288 (камера) и 0x28E (скриншот); если ваша машина шлёт другие, заведите issue с этими кодами.

F8 показывает уведомление, но камера продолжает снимать. На вашей модели стоит камера без Device MFT, который читает CameraStatus. Заведите issue с моделью ноутбука и идентификатором камеры из диспетчера устройств.

Свайп по левому краю меняет яркость, но без индикатора. Разрешение на ACPI-WMI ещё не выдано: измените любую аппаратную настройку, чтобы появилась привилегированная задача, и повторите жест.

Проверка драйверов ничего не находит. Приложение игнорирует системный прокси, но брандмауэр всё ещё может блокировать hihonorcloud.com и honor.com.

Удаление

  1. Снимите Запускать вместе с Windows, затем Выход.
  2. Из консоли администратора: HonorPCHelper.exe --uninstall-privileged-tasks.
  3. Удалите HKCU\Software\HonorPCHelper, %LocalAppData%\HonorPCHelper и сам exe.

Если хотите вернуть зарядку до 100%, перед удалением выберите Ограничение заряда → Отключено: пороги живут в контроллере питания и останутся там.

Сборка из исходников

Требуется .NET 10 SDK:

.\build.ps1

Результат — один самодостаточный сжатый файл dist\HonorPCHelper.exe.

Донаты (поддержка проекта)

Honor PC Helper бесплатен, с открытым исходным кодом, без рекламы и телеметрии. Если программа вам пригодилась, вы можете поддержать её развитие — любая сумма помогает, но это добровольно.

Support me on Ko-fi


Проект не связан с HONOR и не поддерживается компанией. HONOR и MagicBook — товарные знаки соответствующих владельцев.