Skip to content

MuMuManager CLI Menu v1.22.49

Choose a tag to compare

View all tags
@genrihx2 genrihx2 released this 29 Sep 04:02
· 21 commits to main since this release
v1.22.49
cfbe7c1

MuMuManager CLI Menu v1.22.49

Интерактивное PowerShell-меню для управления MuMu Emulator через MuMuManager.exe.

Что нового

v1.22.49 (29.09.2026)

  • README: раздел про Mark-of-the-Web — почему ручная распаковка ZIP Проводником блокирует скрипты (not digitally signed) и три способа лечения: [U]/bootstrap (сами скачивают, снимают метки и подписывают), Unblock-File, распаковка tar -xf/7-Zip. Плюс строка-симптом в таблицу восстановления.
  • CI: CodeQL Advanced — анализ файлов воркфлоу (язык actions), пины по SHA, weekly-расписание; .ps1-код остаётся под DevSkim + PSScriptAnalyzer.
  • Харденинг Test-ReleaseZip — повреждённый ZIP больше не роняет [F]/-VerifyZip исключением: любое повреждение архива даёт archive: corrupt (...) и Ok=$false; новый Pester-тест фиксирует контракт «никогда не бросает», tampered-тест стал детерминированным.
    EN summary: Docs-only release: README gains a Mark-of-the-Web section (why Explorer-extracted ZIP files are blocked and the three fixes: [U]/bootstrap, Unblock-File, tar/7-Zip extraction). CI adds CodeQL Advanced over workflow files. Test-ReleaseZip hardened in both updaters to never throw on corrupt archives (Ok=$false with an "archive: corrupt" check line; new never-throws Pester test, deterministic tamper fixture).

v1.22.48 (28.09.2026)

  • Фикс self-update: [U] снова доставляет полный комплект — список загрузки в Update-FromGitHub остался на до-троичном составе из 4 файлов (v1.22.46 расширила ZIP до 8, но [U] — нет), поэтому файлы, добавленные после v1.22.45, не доходили до существующих инсталляций через [U]. Список приведён к контракту 8 файлов; дефолты rollback-функций (Build-RollbackPlan/Invoke-Rollback) расширены до того же сета — валидация бэкапов честно перечисляет недостающие файлы старых бэкапов. Новый Pester-тест фиксирует список [U] на контракте.
  • [WN] Watch MuMu network + updater — новый read-only пункт меню (секция Info): каждые 5 с логирует НОВЫЕ внешние TCP :443 подключения MuMu*-процессов, запуски MuMuNxUpdater (время, PID, имя), смену EXE-идентичности апдейтера (FileVersion / ProductVersion / LastWriteTime / полный путь) и его удалённые IP во время обновления; дедуп по PID+локальный порт+удалённый кортеж; лог C:\test\mumu-network-update.txt; выход по Q/Ctrl+C. Ничего не меняет: ни firewall, ни прокси, ни DNS, ни маршруты.
  • Фикс Diag-MumuNx (uint32) — разделы «Listening endpoints / TCP connections / UDP endpoints» были пустыми при работающем MuMu: ключи $procRows — [int] PID, OwningProcess — [uint32], хэш-таблица молча не совпадала по типу ключа. Подтверждено живым elevated-снимком (11 слушателей, ADB — только loopback).
  • Дружелюбный pre-flight в Diag-MumuNx — вместо жёсткого #requires -RunAsAdministrator (не поймать) — runtime-проверка с готовой командой запуска от администратора.
    EN summary: [U] self-update downloads the full 8-file deployed set again (the list was stuck on the pre-trio 4 files), rollback defaults widened to match, new contract test pins the list. New read-only menu entry [WN]: MuMu network + updater watcher (new external :443 connections, updater launches/EXE versions/remote IPs, PID+port dedup, Q/Ctrl+C to stop). Diag-MumuNx uint32 key-type fix (socket sections were silently empty while MuMu ran) and a friendly elevation pre-flight.

v1.22.47 (27.09.2026)

  • Version bump: $scriptVer in mumu-menu.ps1, .version, README and relnotes synchronized to 1.22.47.
  • No code changes: this release only synchronizes the version markers after v1.22.46.

v1.22.46 (27.09.2026)

  • Диагностическая троица в комплекте — release ZIP теперь несёт 8 файлов: добавлены read-only инструменты сетевой диагностики MuMu. Watch-MumuConnections.ps1 — опрос TCP-таблицы раз в 5 с, в лог только НОВЫЕ установленные подключения MuMu*-процессов (дедуп по 5-tuple+PID — кто, куда и когда, без дублей по долгоживущим сессиям). Test-MumuTunnelAB.ps1 — снимки сети A/B с diff: подключения, source-адреса, default/fake-IP маршруты, route-lookup по каждому адресату, адаптеры, прокси; режим -Watch сам ловит исчезновение/появление 198.18.* (переключение туннеля) и снимает B + отчёт без ручного вызова. Diag-MumuNx.ps1 — запуск от администратора: сервисы и процессы MuMu с командными строками, слушатели, TCP/UDP с DNS-резолвингом адресатов, firewall-правила MuMu → лог MuMuNx-*.txt. Ни один скрипт не меняет VPN, маршрутизацию или прокси.
  • Контракт файла-сета: 5 → 8 файлов — синхронно обновлены: Test-ReleaseZip в обоих апдейтерах (строгая проверка missing/extras), списки самобновления [U] и bootstrap-update (новые файлы доставляются на существующие инсталляции), fixture deployed-layout ноги CI (tests/test-deployed-layout.ps1), недельный zipcheck в release-guard (EXPECTED_COUNT=8), T7/T8 тесты (stub-фикстуры и «file set: OK (8 files)»). Старые инсталляции (список из 5) по-прежнему обновляются без ошибок: их списки — подмножество.
  • Проверено на живой системе: вотчер поймал «Network error»-фон MuMuPlayer 6.8.0 — циклический рестарт MuMuNxUpdater (новый PID каждые 30–60 с), fake-IP туннель (198.18.0.1, Wintun, default route) и периодические 10-секундные ступоры HTTPS до api.mumuglobal.com при полностью живом хосте; elevated-снимок выявил две параллельные инсталляции MuMu (Netease\MuMuPlayer + Netease1\MuMu) и отсутствие MuMuNxService.exe (реальные сервисы: MuMuPlayerRemoteService, MuMuRemoteService).
    EN summary: Diagnostics trio ships in the ZIP: Watch-MumuConnections.ps1 (dedup log of NEW MuMu TCP connections), Test-MumuTunnelAB.ps1 (A/B network snapshots with diff + -Watch auto-trigger on fake-IP route change), Diag-MumuNx.ps1 (elevated read-only services/processes/connections/firewall snapshot). Release file-set contract widened 5 → 8 files; Test-ReleaseZip, [U]/bootstrap file lists, CI deployed fixture, release-guard zipcheck and T7/T8 tests updated in lockstep.

v1.22.45 (26.09.2026)

  • CI: deployed-layout Pester leg — the suite runs inside a fixture holding only the deployed file set (mumu-menu.ps1, bootstrap-update.ps1, README.md, SKILL.md, .version); repo-only files excluded (relnotes.md, RELEASE-RUNBOOK.md, update-readme.ps1, tests/). Tests tagged RepoFiles are excluded (172 of 173); both engines — PowerShell 5.1 and pwsh 7 — against the SAME copy (tests/test-deployed-layout.ps1). CI job pester-unit (deployed layout / both engines); composite action gets a layout input (repo|deployed); run-matrix.ps1 replays the leg locally.
  • CI: release gate audits every Tests leg by exact name — dropping or renaming a leg from the matrix now blocks a release ("missing" instead of silently shrinking coverage). Last-row-wins re-run semantics kept (green→red blocks).
  • PSSA: присваивание сплат-переменной $args в tests/test-deployed-layout.ps1 переименовано в $exeArgs (PSAvoidAssignmentToAutomaticVariable, code-scanning #590/#591) — поведение идентично
  • SKILL.md: задокументирована deployed-layout нога — дерево tests/ (test-deployed-layout.ps1, тег RepoFiles в сьюте), состав матрицы tests.yml и локальный прогон через tests/run-matrix.ps1 / tests/test-deployed-layout.ps1

v1.22.44 (25.09.2026)

  • «Token rejected — retrying without auth...» на каждый запрос: отклонённый GitHub'ом сохранённый токен оставался активным до конца сессии — каждый запрос заново проходил цикл «с токеном → 401 → повтор без авторизации». Теперь токен отключается один раз на уровне script-scope с подсказкой «re-save via menu [K]», дальше всё анонимно (репозиторий публичный); централизованный guard добавлен и в Invoke-GitHubApiGet (releases/branches/tags/compare раньше не различали Bad credentials вовсе), и в bootstrap — где прежний сброс был переменной-тенью и не работал

v1.22.43 (25.09.2026)

  • Release-гейт стал самодостаточным: перед публикацией релиза workflow сам запускает Tests-матрицу на SHA тега — переиспользует уже идущий run, иначе диспетчеризует tests.yml по --ref <тег> и ждёт до 25 минут; после зелёного рана — аудит ног (bootstrap-detector + все pester-unit), fail-closed на red/missing/timeout
  • Еженедельная ZIP-проверка в release-guard: ZIP последнего релиза скачивается, .sha256-sidecar проверяется, SHA256 каждого из 5 файлов сверяется с git show <tag>:<file> — ловит подмену/обрезку/недозагрузку ассета даже после публикации; violations — в тот же marker-scoped issue
  • Фикс гейта — якорный regex отсекал ноги матрицы (найдено репетицией на живом теге): фильтр ^(bootstrap-detector|pester-unit)$ не совпадал с именами вида pester-unit (5.7.1 / powershell) — гейт блокировал бы каждый релиз; заменено на префиксное совпадение
  • Фикс дедупликации чек-ранов: прежний sort -u оставлял алфавитно-первую строку (failure) — тег после зелёного re-run блокировался бы ложно; теперь берётся последняя строка на имя

v1.22.42 (25.09.2026)

  • CI-матрица Pester: pester-unit в tests.yml теперь гоняет сьют на ОБОИХ движках — Windows PowerShell 5.1 и pwsh 7 — на закреплённом Pester 5.7.1 через композитный экшен .github/actions/pester-unit, плюс «канареечная» нога на предустановленном в раннере Pester (сегодня 6.x), которая ловит дрейф движка/Pester заранее, а не по репорту пользователя
  • Фикс из матрицы — Get-ReleaseInfo.PublishedAt: PS 5.1 ConvertFrom-Json оставляет ISO-даты строками, pwsh 7 конвертирует в [datetime] — свойство было движко-зависимым; явный каст [datetime] закрепил контракт для обоих движков (на 5.1 это был бы сырой string). Матрица поймала это на первом же прогоне: 1 тест из 170 красный на 5.1, зелёный на 7
  • Раннер tests/run-pester.ps1: новые параметры -PesterVersion / -ModuleDir (приватная копия Pester поверх PSModulePath) — CI и локальный прогон используют один и тот же скрипт; установка Pester движко-осведомлённая (PSResourceGet на Core, PowerShellGet + NuGet-провайдер на 5.1)

v1.22.41 (25.09.2026)

  • Get-ReleaseInfo — мёртвые заголовки: $headers (Accept / User-Agent / Authorization) собирались и игнорировались — транспорт Invoke-GitHubGet принимает только URL и таймаут
  • Update-FromGitHub — сбои снова различимы: причина приходит из Get-ReleaseInfo через -Failure, и [U]/[UP] рендерят прежние сообщения (подсказки по rate limit, текст ошибки API, «No releases found on remote») вместо одной общей строки
  • Тесты: контракт -Failure и запуск рендера по каждому виду сбоя; фикстура диагностики больше не показывает модальный диалог загрузчика Windows

v1.22.40 (24.09.2026)

Сравнение
Предыдущая версия v1.22.48
Текущая версия v1.22.49
Коммитов 4

Коммиты

cfbe7c1 fix(zip): Test-ReleaseZip never throws on corrupt archives; bump to v1.22.49
eb6ea4a chore(release): bump to v1.22.49 - MotW docs, CodeQL Advanced
2803701 docs(readme): Mark-of-the-Web section for manual ZIP extraction
463ec90 ci(codeql): CodeQL Advanced on workflow files (actions language)

Установка

Быстрый запуск (одна команда):

irm https://raw.githubusercontent.com/genrihx2/MuMuManager-CLI-Menu/main/mumu-menu.ps1 -OutFile $env:TEMP\mumu-menu.ps1; & $env:TEMP\mumu-menu.ps1

Git clone (с автообновлением через [U]):

git clone https://github.com/genrihx2/MuMuManager-CLI-Menu.git
cd MuMuManager-CLI-Menu
.\mumu-menu.ps1

Верификация

curl -sL https://github.com/genrihx2/MuMuManager-CLI-Menu/releases/download/v1.22.49/MuMuManager-CLI-Menu-v1.22.49.zip.sha256 -o MuMuManager-CLI-Menu-v1.22.49.zip.sha256
Get-FileHash MuMuManager-CLI-Menu-v1.22.49.zip -Algorithm SHA256 | Select -Expand Hash
# Сравнить с содержимым MuMuManager-CLI-Menu-v1.22.49.zip.sha256

Метрики
Размер ZIP 179 KB
Файлов 8
SHA256 a7a1fac1dc870a6b...

Требования: Windows 10/11 · PowerShell 5.1+ · MuMu Emulator 6.x

VirusTotal verdicts

File SHA-256 Malicious Suspicious Harmless Report
MuMuManager-CLI-Menu-v1.22.49.zip a7a1fac1dc870a6b72372568a2252c6dded4b139cbf4b0e1e10f14c0c30083e3 0 0 0 report
mumu-menu.ps1 (from ZIP) cf4465d01b2293e3713bed7f3643d7c609440ae5864ea3ce45a6094fb9ba4982 0 0 0 report
SKILL.md (from ZIP) b3e23bb1aa0c8206f47a046d46606347d6e63be63cf5ea06f7b2160a1a98bac9 0 0 0 report

Status: CLEAN - 0 malicious / 0 suspicious (CI scan 2026-09-29, scan run)

Verify the download yourself 
sha256sum -c MuMuManager-CLI-Menu-v1.22.49.zip.sha256
Assets 4
Loading