# Audion Get Tools

[English](README_EN.md) · [Руководство](USER_GUIDE_RU.md)

**Содержание**

- [Зачем это сделано](#зачем-это-сделано)
- [Что умеет](#что-умеет)
  - [Наборы WinGet: каталог по группам](#наборы-winget-каталог-по-группам)
  - [Установить, обновить, закрепить, удалить](#установить-обновить-закрепить-удалить)
  - [Скачать без установки: установщик или portable, свежее у авторов](#скачать-без-установки-установщик-или-portable-свежее-у-авторов)
  - [Поиск и работа по ID](#поиск-и-работа-по-id)
  - [AI Package Planner](#ai-package-planner)
  - [Portable-браузеры](#portable-браузеры)
  - [Загрузки от вендоров](#загрузки-от-вендоров)
  - [Рантаймы Visual C++](#рантаймы-visual-c)
  - [Импорт и экспорт](#импорт-и-экспорт)
  - [Служебные процедуры](#служебные-процедуры)
  - [Рабочее окно](#рабочее-окно)
- [Принципы](#принципы)
- [Дальше](#дальше)
- [Техническая часть](#техническая-часть)
  - [Запуск](#запуск)
  - [Наборы](#наборы)
  - [Устройство раздела загрузок](#устройство-раздела-загрузок)
    - [Наборы установки Windows](#наборы-установки-windows)
    - [Группы приложений Windows](#группы-приложений-windows)

Установка, обновление, проверка, выгрузка и загрузка наборов программ через
системный менеджер пакетов Windows. Рядом с ним: дистрибутивы прямо от
производителей, включая образы Windows с обновлениями внутри, и подбор пакетов
с помощью LLM.

## Зачем это сделано

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

Windows умеет ставить пакеты сам, командой. Но список того, что нужно ставить,
всё равно приходится держать в голове.

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

## Что умеет

Одно окно, слева список операций, справа журнал и терминал. Каждая операция это
форма с переключателями и карточками, внизу одна кнопка запуска. Все подписи и
подсказки на русском и английском, язык переключается кнопкой в шапке. Ниже
каждая способность в один абзац, подробности по ссылкам в руководство.

### Наборы WinGet: каталог по группам

Каталог программы — 126 пакетов в двенадцати блоках: Система, Разработка, AI,
PKMS и заметки, Office и документы, Медиа (изображения, звук, видео), Браузеры,
VPN и связь, Железо и утилиты, рантаймы MSVC и старые MSVC 2005–2013. Блок это
карточки с галочками; у списка есть фильтр по имени и ID, кнопки «Отметить
блок» и «Снять блок», а ряд профилей сверху (Минимум, Dev, Медиа, Сеть) отмечает
типовой набор одним нажатием, после чего правится любая карточка. Выбор
галочек можно сохранить в YAML и загрузить на другой машине.

Каждый блок это обычный список ID в настройках. Своя программа добавляется
строкой или кнопкой «Добавить ID в список» прямо из окна поиска.

### Установить, обновить, закрепить, удалить

`Установить выбранные` сначала сканирует систему и показывает только то, чего
ещё нет, потом ставит отмеченное без вопросов Y/N, с живым прогрессом в журнале.
`Обновить выбранные`, `Обновить доступные` и `Обновить всё доступное` работают
от списка `winget upgrade`; `Предпросмотр обновлений` только показывает его в
виде «имя, ID, текущая, доступная». `Закрепить выбранные` ведёт `config\pins.txt`:
отмеченные пакеты получают blocking-pin и перестают обновляться, пока вы сами не
снимете закрепление. `Удалить выбранные ID` показывает установленное по тем же
блокам; системные и рантаймовые ID защищены отдельной галочкой. `Обновить
WinGet` обновляет сам менеджер.

### Скачать без установки: установщик или portable, свежее у авторов

У каждой карточки три маленькие кнопки, и это половина смысла программы.
Зелёная стрелка скачивает установщик в `output\Downloads`, не запуская его.
Малиновая коробка скачивает zip или standalone-сборку в `output\Portable`, ту,
что не требует установки; она есть у 29 программ каталога, среди них Notepad++,
Everything, OBS Studio, VLC, Telegram, FFmpeg, Node.js, MKVToolNix, Audacity,
Sysinternals, Rufus, yt-dlp, SumatraPDF, Rclone, и показывается только там, где
такая сборка действительно существует. Синяя стрелка открывает страницу загрузки
в браузере: раздел релизов на GitHub, страницу TechPowerUp или сайт
разработчика, чтобы выбрать сборку самому — другую архитектуру, старую версию.

Файлы берутся напрямую от авторов, а не из чужих зеркал: у проектов на GitHub
программа читает последний релиз и сама выбирает нужный файл среди
приложенных, x64 и portable вперёд; у остальных — страницу производителя.
Поэтому в `output` ложится самая свежая версия, даже когда каталог WinGet
отстаёт: у Tabby и RClone Manager сборка берётся со страницы выпусков раньше,
чем она доедет до каталога, а установщик и portable всегда одной версии.
Подробнее: [руководство](USER_GUIDE_RU.md#скачивание-без-установки).

### Поиск и работа по ID

Для программ вне каталога: `winget search` по названию из окна программы,
установка и удаление по введённому ID, добавление найденного ID в один из
блоков каталога, чтобы в следующий раз он был карточкой.

### AI Package Planner

Описываете задачу словами, «рабочее место видеомонтажёра с Resolve и
FFmpeg», и LLM (OpenAI или Gemini) предлагает пакеты. Каждый кандидат
проверяется через `winget search`, в план попадают только точные ID, и только
их вы отмечаете для установки. Ключи и модели живут во вкладке `Models`, шаблоны
инструкций закрепляются и переиспользуются. Установка идёт обычным защищённым
путём, LLM ничего не запускает. Подробнее:
[руководство](USER_GUIDE_RU.md#ai-package-planner).

### Portable-браузеры

Скачивание portable-архивов браузеров в `output\Portable` (Ungoogled Chromium,
Zen, Cent и другие), веб-установщик Google Chrome без запуска, portable 7-Zip.
Отдельно: сборка и обновление Google Chrome Portable на оболочке Chrome++ из
официального standalone-установщика, с выбором архитектуры и упаковкой в ZIP
или 7Z.

### Загрузки от вендоров

Второй источник рядом с WinGet: каталоги самих производителей со всеми
выпущенными версиями, а не только текущей. Вкладки вверху, ниже платформы и
продукты, затем карточки версий с датами; каждую можно скачать или получить
только ссылку. Скачивание докачивается после обрыва, zip распаковывается,
единственная корневая папка архива отбрасывается.

- **Windows через UUP dump**: любая сборка Windows 11 и 10 из каталога
  Microsoft с накопительным обновлением внутри, ISO собирается на месте. Вид
  образа Business, Consumer или Только Pro; набор Store-приложений (Минимум,
  Работа, Всё) и кнопки групп балласта; без браузера Edge, при этом среда
  Edge WebView2 не затрагивается и остаётся для приложений; драйверы этой машины
  вшиваются в образ через `input`. Сборка идёт в
  `UUP` в корне диска программы, образ ложится в папку назначения.
- **TechPowerUp**: каталог сайта со всей историей версий каждой записи, по
  разделам. Драйверы: AMD Radeon и чипсет Ryzen, Intel графика, Wi-Fi,
  Bluetooth, Ethernet и NPU, Qualcomm Snapdragon X. Утилиты: DDU, NVCleanstall,
  NVIDIA Profile Inspector, ThrottleStop, DRAM Calculator, Samsung Magician,
  Visual C++ Runtimes AIO, MemTest64. Мониторинг: GPU-Z, CPU-Z, AIDA64,
  ZenTimings, Real Temp. Бенчмарки: 3DMark, PCMark 10, Cinebench, FurMark,
  Prime95, Unigine, GravityMark, Linpack Xtreme, ATTO. BIOS видеокарт: NVFlash,
  AMDVBFlash. Файл идёт по подписанной ссылке самого TechPowerUp. Версия это
  одна карточка с двумя стрелками, как в карточках WinGet: зелёная качает
  установщик, багровый значок архива качает портативную сборку той же версии,
  которая работает без установки; кнопка «Портативные» переводит весь список
  на портативные файлы. Часть этих утилит есть и в WinGet-каталоге: там
  установка в систему, здесь любая версия файлом.
- **NVIDIA**: драйверы Game Ready и Studio по поколениям чипов, `Мои карты`
  для одного драйвера на все карты в доме; у каждой версии отметки NVENC SDK,
  совместимый FFmpeg, потолок CUDA и ★ «золотые» версии. Плюс NVIDIA App,
  Broadcast, CUDA Toolkit и три библиотеки DLSS.
- **Blackmagic Design**: DaVinci Resolve и Resolve Studio, Fusion, Blackmagic
  RAW, Desktop Video, Camera Setup и весь каталог, 45 продуктов. Studio
  отдаётся без регистрации, бесплатная Resolve только по анкете, форма в окне.
- **Affinity**: единая Affinity 3 (exe, msix, dmg) и Photo, Designer,
  Publisher 2.

Подробнее: [руководство](USER_GUIDE_RU.md#загрузки-от-вендоров),
таблицы составов ниже в [технической части](#наборы-установки-windows).

### Рантаймы Visual C++

Блок MSVC 2015+ в каталоге, старые 2005–2013 отдельным блоком, и два
сборника All-in-One (TechPowerUp и abbodi1406), которые одним проходом ставят
все рантаймы, включая 2012, которого в WinGet нет. `Проверить рантаймы MSVC`
показывает, что стоит и что доступно. Классические CMD-скрипты проекта
доступны как кнопки. Подробнее:
[руководство](USER_GUIDE_RU.md#наборы-visual-c-msvc).

### Импорт и экспорт

`winget export` в JSON с настроенной машины и `winget import` на новой, с
галочками «игнорировать версии», «не обновлять установленные», «игнорировать
недоступные».

### Служебные процедуры

Кнопки без формы: состояние лицензии Windows через slmgr, Health / Doctor,
проверка рантаймов MSVC, проверка наличия ID в источнике, проверка списков
конфигурации, очистка `input`/`output` и очистка логов.

### Рабочее окно

Сверху пути `Источник` и `Назначение` с историей и закреплением, кнопки
добавить файлы или папку, список файлов, сброс и удаление содержимого I/O.
Справа журнал операции с кнопками Logs, Report и Config и терминал: PowerShell
или cmd, история команд, закреплённые команды, рабочая папка с выбором папки и
файла. Опасные операции перед запуском спрашивают подтверждение. Тема и язык
переключаются в шапке. Каждый контрол и каждая подсказка описаны в
[справочнике руководства](USER_GUIDE_RU.md#справочник-каждое-окно-каждый-контрол-каждая-подсказка).

## Принципы

**Набор — это список имён.** Обычный текстовый файл, куда пакет добавляется
строкой. Никакого своего формата и своей базы.

**Выгрузка и загрузка.** С настроенной машины список снимается, на новой —
применяется.

**Проверка отдельно от установки.** Сначала видно, что установится и чего нет в
источнике, — потом ставится.

**Ничего не делается молча.** Установка, удаление и всё, что меняет систему,
спрашивает подтверждение; скачивание и проверки идут сразу.

**Два языка везде.** У каждой подписи, подсказки и сообщения есть русская и
английская версия.

## Дальше

* [Руководство](USER_GUIDE_RU.md) — работа по шагам и справочник всех контролов.

---

## Техническая часть

### Запуск

```cmd
Launcher-Audion-Get.cmd      командная строка
Launcher-Audion-Get-RU.cmd   она же по-русски
launcher_gui.cmd             окно
```

### Наборы

Списки пакетов лежат в настройках отдельными файлами — по одному на назначение
машины. Окна, поля и подсказки описаны в `config\tool_manifest.yaml`;
справочник контролов в руководстве собирается из него скриптом
`tools\docs\build_control_reference.py`.

### Устройство раздела загрузок

Провайдер описывает один каталог (`system_core\vendors\`:
Blackmagic Design, Affinity, NVIDIA и Windows через UUP dump; отметки драйверов NVIDIA в
`config\vendor_nvidia.yaml`), общий сервис `vendor_service` качает выбранные
сборки с докачкой в папку на сборку и распаковывает zip, а экран
`Загрузки от вендоров` описан в `tool_manifest.yaml` одной группой полей:
вкладки производителя и поля, видимые по `visible_when`. Новый
производитель — это один файл провайдера, его переключатели платформы и
продукта в манифесте и пара строк в `vendor_service.VENDOR_FIELDS`.

#### Наборы установки Windows

Наборы установки, кнопки ряда `Набор приложений`; каждая просто заполняет список карточек, а дальше его можно править руками или кнопками групп:

| Набор | Пакетов | Что ставится | Для кого |
|---|---|---|---|
| `Минимум` | 4 | только системные: Магазин, Покупки Store, Безопасность Windows, Установщик приложений | образ под сервер приложений или киоск, где ничего из Store не нужно, а WinGet и обновления Магазина остаются |
| `Работа` | 27 | системные, тринадцать инструментов (Блокнот, Windows Terminal, Калькулятор, Ножницы, Paint, Камера, Диктофон, Связь с телефоном, Часы, Записки, To Do, Погода, Power Automate) и десять кодеков | рабочая машина без развлечений и рекламы; это выбор по умолчанию, с ним собран эталонный образ |
| `Всё` | 59 | весь каталог, как у Microsoft, только список открыт для правки | когда нужно всё штатное, но с возможностью снять пару карточек |

Ряд `Вид образа` выше отвечает за редакции, а не за приложения: `Business` это Pro плюс Enterprise, Education, Pro Education и Pro for Workstations, `Consumer` это Home и Pro плюс Education, Pro Education и Pro for Workstations, `Только Pro` одна редакция. Наборы и вид образа сочетаются свободно.

#### Группы приложений Windows

Весь каталог Store-пакетов, как его делит программа: набор `Работа` и семь кнопок ряда `Включать в сборку дистрибутива`. Всего 59 пакетов плюс Edge, вне групп ничего нет.

| Группа | Сколько | Что внутри | По умолчанию |
|---|---|---|---|
| Системные | 4 | Microsoft Store, Покупки Store, Безопасность Windows, Установщик приложений (WinGet) | в образе, набор `Работа` |
| Инструменты | 13 | Блокнот, Windows Terminal, Калькулятор, Ножницы, Paint, Камера, Диктофон, Связь с телефоном, Часы, Записки, To Do, Погода, Power Automate | в образе, набор `Работа` |
| Кодеки | 10 | Web Media, RAW-снимки, HEIF, HEVC, VP9, WebP, AV1, MPEG-2, AVC encoder, Dolby Audio | в образе, набор `Работа` |
| Медиа-стек | 4 | Media Player, Кино и ТВ, Фотографии, Clipchamp | выключен |
| Edge | 1 | только браузер Edge; среда Edge WebView2 не затрагивается и остаётся, на ней работают и собираются приложения | выключен |
| Xbox | 6 | Xbox, Xbox Game Bar, Xbox Game overlay, Xbox speech overlay, Xbox identity, Xbox TCUI | выключен |
| Teams и почта | 6 | Teams, Outlook (новый), Почта и Календарь, Люди, Office hub (M365), Семья | выключен |
| Bing и виджеты | 6 | Поиск Bing, Новости, Виджеты (web experience), Widgets runtime, Start experiences, Cortana | выключен |
| Промо и помощники | 8 | Пасьянсы, Советы, Техподдержка, Центр отзывов, Быстрая помощь, Dev Home, PC Manager, App compatibility enhancements | выключен |
| Мелкие инструменты | 2 | Карты, Cross Device | выключен |

Набор `Минимум` это четыре системных пакета без инструментов и кодеков, `Всё` включает все группы разом. OneDrive и Copilot в каталоге нет: это не Store-пакеты, они убираются уже после установки.
