# Руководство пользователя HardwareFullReport

## 1. Скачивание

Скачайте один из вариантов:

- `HardwareFullReport.ps1` — готовый исходный скрипт;
- ZIP-архив исходников — скрипт, описание, руководство и история изменений.

Сохраните файлы в отдельную папку.

## 2. Проверка контрольной суммы

При необходимости вычислите SHA-256:

```powershell
Get-FileHash .\HardwareFullReport.ps1 -Algorithm SHA256
```

Сравните значение с опубликованной контрольной суммой.

## 3. Запуск

Откройте Windows PowerShell.

Если запуск локальных скриптов запрещён, разрешите его только для текущего
окна PowerShell:

```powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
```

Перейдите в папку со скриптом:

```powershell
cd "C:\Путь\к\папке"
```

Запустите:

```powershell
.\HardwareFullReport.ps1
```

Изменение политики с областью `Process` действует только до закрытия
текущего окна PowerShell и не меняет постоянные настройки Windows.

## 4. Работа с окном программы

### Регион поиска

Выберите регион, в котором планируется продажа. Он используется при
формировании поисковых ссылок Авито.

Для общего сравнения выберите «Все регионы».

### Папка для отчёта

По умолчанию используется системная папка рабочего стола. Кнопка
«Обзор...» позволяет выбрать другой каталог.

### Формирование отчёта

Нажмите «Сформировать отчёт».

Программа:

1. проверит возможность записи в выбранную папку;
2. запросит сведения через CIM/WMI;
3. отфильтрует некоторые виртуальные видеоустройства;
4. создаст HTML, CSV, JSON и текстовое пояснение;
5. покажет найденные компоненты в таблице.

### Работа с Авито

В столбце «Авито» можно открыть поиск по отдельному компоненту.

Кнопка «Открыть все поиски Авито» открывает несколько вкладок. Перед этим
программа показывает количество вкладок и просит подтверждение.

## 5. Как оценивать цену

Не следует использовать самую высокую цену в выдаче как рыночную.

Рекомендуемый порядок:

1. Найдите объявления с точно такой же моделью.
2. Исключите неисправные экземпляры и предложения «на запчасти», если ваш
   товар исправен.
3. Учитывайте комплект, документы, коробку и гарантию.
4. Сравните несколько объявлений в своём регионе.
5. Посмотрите, как долго размещены объявления.
6. Для быстрой продажи установите цену немного ниже среднего уровня
   сопоставимых предложений.
7. Для редкого оборудования расширьте поиск до всех регионов.

## 6. Возможные проблемы

### Окно сразу закрывается

Запускайте скрипт из уже открытого PowerShell, а не двойным щелчком.

### Появляется сообщение о запрете запуска

Используйте:

```powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
```

### Некоторые поля пустые

Производитель устройства или драйвер могут не предоставлять сведения через
WMI. Попробуйте запуск от имени администратора.

### Антивирус предупреждает о скрипте

PowerShell-скрипты могут проверяться особенно строго. Скачивайте файл с
официальной страницы, сверяйте SHA-256 и просматривайте исходный код.

### Ссылка Авито открывает слишком широкую выдачу

Уточните запрос вручную: добавьте объём памяти, ревизию, интерфейс или другие
характеристики.

### Нет доступа к Авито

Сам отчёт продолжит создаваться. Поисковые ссылки можно открыть позже из
HTML, CSV или JSON.

## 7. Удаление

Установка не выполняется. Для удаления достаточно удалить:

- файл `HardwareFullReport.ps1`;
- созданные папки отчётов.

## Самопроверка

```powershell
.\HardwareFullReport.ps1 -SelfTest
```

Команда проверяет формирование трёх региональных ссылок Авито без запуска
графического интерфейса. Успешный результат:

```text
HardwareFullReport 1.1.4 self-test passed: 8 checks.
```


## Как формируется поисковый запрос

Для компьютеров удаляются юридические части названия производителя, повторы и длинный служебный SKU в конце строки. Поисковый запрос отображается отдельной колонкой в программе.

Авито используется для сравнения предложений б/у. Яндекс Маркет полезен для сравнения новых товаров и текущих розничных цен.