Create README

README

@@ -0,0 +1,156 @@
+Войти
+Зарегистрироваться бесплатно
+Вы сказали:
+Инка твоя задача переписать после страты для людей на понятном нормальном языке
+
+# HuggingFaceDownloader 2.2.1
+
+**Дата:** 26.10.2026
+**Сборка:** portable single-file, win-x64, 152 MB
+**Файл:** `HuggingFaceDownloader.exe` (FileVersion 2.2.1.0)
+**Тесты:** 141/141 • **Сборка:** 0 ошибок / 0 предупреждений
+**Промежуточные версии:** 2.1.0 и 2.1.1 — отдельных release-notes не было; здесь собрано всё, что изменилось с 2.0.0.
+
+---
+
+## ✅ Добавлено
+
+- [ ] **Контроллер дисковой записи (IoThrottle)** — главная новая возможность. Раньше качание больших файлов (10–50 ГБ) забивало диск до 100% и Windows «вставала» (мышь, окна, антивирус). Теперь:
+  - [ ] запись идёт через «ведро токенов»: потоки ждут своей очереди, а не пишут кто во что горазд;
+  - [ ] цель — **80% занятости диска** (замер системным счётчиком `PhysicalDisk % Idle Time`), а не 100%;
+  - [ ] **автоматический потолок скорости**: при пустом диске скорость плавно растёт (20 → 40 → 80 → 160 MB/s), при загрузке диска так же быстро падает; верхняя граница авторежима 200 MB/s;
+  - [ ] короткий burst-запас 16 MB, чтобы мелкие файлы не тормозились;
+  - [ ] потоку скачивания ставится **низкий приоритет I/O** — Windows сам отдаёт диск системе, а не нам;
+  - [ ] если диск занят ≥95% — скорость режется пополам сразу (защита от «звонких» 100%);
+  - [ ] настраивается в `settings.json`: `IoThrottleEnabled` (по умолчанию `true`), `DiskBusyTargetPercent` (по умолчанию `80`), `MaxWriteRateMBps` (по умолчанию `0` = авторежим; например `30` = жёсткий потолок 30 MB/s);
+- [ ] **Запись в обход кэша ОС** (`FileOptions.WriteThrough`): раньше Windows накапливал грязные страницы в RAM и сбрасывал их на диск пачками — отсюда «горбы» 100% на ровном месте. Теперь байты уходят на диск сразу и ровно;
+- [ ] **Сохранение осколка при неудаче** (`KeepPartFileForResume`): если файл не докачался (связь легла, лимит попыток вышел) — `.download`-осколок **не удаляется**, следующий запуск докачает его с того же места. Раньше часы скачивания выбрасывались;
+- [ ] **Прогресс-бюджет попыток**: если попытка принесла хоть сколько-то байт, счётчик сетевых ретраев обнуляется (общий потолок — 100 попыток). Раньше 46-ГБ файл умирал на 8-й сетевой паузе, хотя реально докачивался;
+- [ ] **Проверка «SHA256 важнее размера»**: размер из API — метаданные, которым не всегда можно верить. Порядок теперь такой:
+  - [ ] хеш совпал → файл принят, даже если фактический размер отличается от заявленного API (в лог пишется предупреждение);
+  - [ ] хеш не совпал и файл короче ожидаемого → это не битый файл, а **недокачанный**: переименовывается в `.download` и докачивается;
+  - [ ] хеш не совпал и файл полного размера → файл действительно битый, удаляется;
+  - [ ] раньше при несовпадении хеша файл удалялся всегда — недокачанный гигант терялся навсегда;
+- [ ] **Честный итог скачивания**: в конце считается, сколько файлов было поставлено в очередь и сколько реально завершилось. Снятые/пропущенные файлы больше не считаются успехом — вместо «зелёного» сообщения показывается предупреждение;
+- [ ] **5 новых тест-кейсов** (141 против 136 �� 2.0.0): докачка осколков, отмена, возобновление, проверка целостности.
+
+## 🔧 Улучшено
+
+- [ ] Скачивание не морозит систему: диск держится около 80%, интерфейс и другие программы отвечают;
+- [ ] Сетевые ретраи стали умнее: пауза растёт ступенчато (2 s, 4 s, 6 s … максимум 15 s) и не «съедает» уже скачанные байты;
+- [ ] Для gated-моделей (401/403) по-прежнему запрашивается авторизация и повтор, но не более 2 раз на файл;
+- [ ] Логирование по умолчанию **выключено** (`EnableLogging = false`) — меньше мусора на диске и меньше самой записи; включается в `settings.json`;
+- [ ] Приложение: `.NET 10`, portable single-file, 141 тест-кейс.
+
+## 🎨 Изменено
+
+- [ ] Настройки по умолчанию: `DiskBusyTargetPercent` 75 → **80**, `EnableLogging` `true` → **`false`**;
+- [ ] В `settings.json` добавлены 3 ключа троттлинга;
+- [ ] Версия: `2.1.1` → **`2.2.1`**.
+
+## 🗑 Удалено
+
+- [ ] Слепое удаление файла при несовпадении SHA256 (заменено разбором «недокачан vs битый»);
+- [ ] Привязка `TotalSize` к размеру осколка на диске (ожидаемый размер берётся из API, фактический фиксируется только после проверки).
+
+## ⚠️ Известные особенности
+
+- [ ] Троттлинг измеряет загрузку диска целиком: если диск параллельно грузят другие программы, паузы будут длиннее — это ожидаемо;
+- [ ] `WriteThrough` даёт честную, но мелкую запись: на очень медленных USB-дисках можно поставить `MaxWriteRateMBps: 20`;
+- [ ] Значения в уже существующем `settings.json` **не обновляются автоматически**: у кого стоит `DiskBusyTargetPercent: 75`, править вручную или удалить файл настроек;
+- [ ] Portable-сборка при первом запуске распаковывает нативные библиотеки в `%TEMP%\.net\HuggingFaceDownloader` (нужен write-доступ к TEMP); старые папки самораспаковки не удаляются;
+- [ ] С выключенным логом строк вида `IoThrottle: диск X%, скорость записи → Y MB/s` нет — режим виден только по Диспетчеру задач.
+
+---
+
+**Скачать:** `HuggingFaceDownloader.exe` — один файл, ничего устанавливать не нужно.
+**Системные требования:** Windows 10/11 x64.
+
+ChatGPT сказал:
+Вот версия для обычных людей — без технического жаргона, но с сохранением всех важных изменений. Можно публиковать как описание релиза.
+
+Написание текста
+
+
+HuggingFaceDownloader 2.2.1 — что нового
+Дата выпуска: 26.10.2026
+Для Windows 10/11 (64-bit)
+Размер: 152 МБ
+Установка: не требуется — достаточно запустить один файл.
+
+В версии 2.2.1 мы сосредоточились на главном: скачивание больших моделей и файлов теперь меньше нагружает компьютер, а прерванные загрузки стало проще продолжить без потери уже скачанных данных.
+
+✅ Что нового
+💽 1. Компьютер больше не должен зависать при скачивании больших файлов
+Раньше при скачивании файлов размером 10–50 ГБ диск мог загружаться на 100%. Из-за этого Windows начинала тормозить: зависали окна, медленно двигалась мышь, другие программы и антивирус работали с задержками.
+
+Теперь программа автоматически регулирует скорость записи на диск, стараясь удерживать его загрузку примерно на уровне 80%.
+
+Если диск свободен, скорость записи постепенно увеличивается.
+Если диск занят, программа снижает скорость и даёт другим приложениям возможность работать.
+При критической нагрузке скорость автоматически уменьшается ещё сильнее.
+Небольшие файлы по-прежнему могут записываться быстро, без лишних задержек.
+Результат: можно скачивать большие файлы и одновременно пользоваться компьютером. Фактическая скорость зависит от диска и нагрузки со стороны других программ.
+
+🔄 2. Прерванные загрузки можно продолжить
+Если пропал интернет, произошёл сбой или программа исчерпала число попыток, частично скачанный файл теперь сохраняется.
+
+При следующем запуске программа сможет продолжить загрузку с того места, где она остановилась, вместо того чтобы начинать всё заново.
+
+Это особенно важно для моделей и других файлов размером в десятки гигабайт: часы скачивания не придётся тратить повторно.
+
+🛡️ 3. Более надёжная проверка скачанных файлов
+После загрузки программа проверяет целостность файла с помощью SHA-256 — специального контрольного кода, позволяющего обнаружить повреждения.
+
+Теперь программа различает три ситуации:
+
+Файл исправен. Проверка пройдена — файл принимается.
+Файл скачан не полностью. Он сохраняется для продолжения загрузки.
+Файл повреждён. Если размер полный, но проверка не пройдена, файл удаляется и может быть скачан заново.
+Раньше при неудачной проверке файл удалялся независимо от причины. Теперь частично скачанные большие файлы не теряются из-за временного обрыва соединения.
+
+Кроме того, если контрольная сумма совпадает, файл принимается даже в случае, когда API Hugging Face сообщает неточный размер.
+
+🌐 4. Умнее повторные попытки при сетевых сбоях
+Если соединение прерывается, программа повторяет попытку с постепенно увеличивающейся паузой: 2, 4, 6 секунд и далее, максимум до 15 секунд.
+
+Если очередная попытка принесла новые данные, счётчик сетевых ошибок сбрасывается. Поэтому длительная загрузка не должна прекращаться только из-за нескольких временных обрывов связи.
+
+Для моделей, требующих доступа через авторизацию, сохранена обработка ошибок доступа. Программа запрашивает повторную попытку, но не более двух раз на один файл.
+
+📊 5. Честный результат в конце загрузки
+Теперь программа отдельно учитывает файлы, которые были поставлены в очередь, и файлы, которые действительно скачаны до конца.
+
+Если часть файлов была пропущена или снята с загрузки, программа не будет выдавать это за полностью успешное завершение. Вместо этого она покажет предупреждение.
+
+🔧 Другие улучшения
+Меньше лишней нагрузки на диск. Изменён способ записи данных, чтобы Windows реже накапливала большие объёмы несохранённых данных и сбрасывала их на диск резкими скачками.
+Логирование выключено по умолчанию. Программа не создаёт лишние журналы и меньше записывает на диск. При необходимости журналирование можно включить в настройках.
+Больше автоматических проверок. Количество тестовых сцена��иев увеличено со 136 до 141. Дополнительно проверены продолжение загрузки, отмена операций и контроль целостности файлов.
+⚙️ Настройки
+При необходимости поведение программы можно настроить в файле settings.json.
+
+Добавлены параметры, позволяющие включать или выключать управление нагрузкой на диск, задавать желаемый уровень его занятости и ограничивать скорость записи.
+
+Например, на медленном USB-диске можно установить ограничение скорости записи в 20 МБ/с.
+
+Важно: если файл settings.json уже существует, программа не переписывает старые настройки автоматически. Чтобы применить новые значения по умолчанию, нужно вручную изменить настройки или удалить файл, чтобы он был создан заново.
+
+⚠️ Что нужно знать
+Если диск одновременно активно используют другие программы, скачивание может замедляться. Это нормальная работа защиты от перегрузки.
+На очень медленных USB-накопителях может потребоваться вручную ограничить скорость записи.
+При первом запуске portable-версии программа распаковывает служебные компоненты во временную папку Windows. Для этого необходим доступ на запись в %TEMP%.
+При выключенном журналировании подробные сообщения о регулировке скорости не сохраняются. Проверить нагрузку можно через Диспетчер задач Windows.
+📦 Скачать и запустить
+Файл: HuggingFaceDownloader.exe
+Версия: 2.2.1
+Размер: 152 МБ
+
+Устанавливать программу не нужно. Скачайте EXE-файл и запустите его.
+
+Системные требования: Windows 10 или Windows 11, 64-разрядная версия.
+
+Итог
+Главные изменения версии 2.2.1 — меньше зависаний при скачивании больших файлов, возможность продолжать прерванные загрузки и более надёжная проверка результата.
+
+Программа стала бережнее относиться к диску и лучше справляться с нестабильным интернет-соединением. Это особенно полезно при скачивании больших моделей с Hugging Face.