+ 
+ 
+ 
+ 
+
+ Безопасная локальная очистка macOS с предварительным просмотром,
+ Safe Mode и удалением приложений через Корзину.
+
+
+
+ 
+
| 
|
+
+## Возможности
+
+- **Безопасное сканирование.** Кэши пользователя и браузеров, логи, временные файлы, Xcode Derived Data, кэши Node/SwiftPM, Загрузки, установщики и Корзина.
+- **Понятный просмотр результатов.** Категории, размер, риск, причина рекомендации, точный путь и недоступные для чтения области.
+- **Safe Mode.** Включён по умолчанию и блокирует выбор элементов, требующих ручной проверки.
+- **Очистка через Корзину.** Разрешённые пути повторно проверяются перед выполнением; постоянное удаление не используется.
+- **Восстановление.** Элементы, перемещённые в текущем сеансе, можно вернуть, если исходный путь свободен.
+- **Удаление приложений.** Поиск сторонних программ в `/Applications` и `~/Applications`, выбор нескольких приложений и необязательных точных остатков по bundle ID.
+- **Меню-бар и автоматическое сканирование.** Статус диска, последний результат, расписание безопасного сканирования и локальные уведомления, пока CleanMac запущен.
+- **Контроль разрешений.** Живой статус Full Disk Access и Finder Automation без автоматического запроса доступа.
+- **Русский и английский интерфейс.** Переключение языка и светлой/тёмной темы внутри приложения.
+
+## Модель безопасности
+
+1. Сканирование выполняется только для чтения.
+2. Каждый кандидат относится к известной категории и допустимому корневому пути.
+3. Очистка требует явного выбора и отдельного подтверждения.
+4. Перед выполнением пути проверяются повторно.
+5. Файлы перемещаются в Корзину, а не удаляются навсегда.
+6. При удалении приложения сначала перемещается сам `.app`; связанные остатки не затрагиваются, если этот шаг завершился ошибкой.
+7. CleanMac не повышает привилегии и не устанавливает системный helper.
+
+## Установка
+
+Готовые архивы находятся на странице [Releases](https://github.com/Dezoff-max/CleanMac/releases/latest). Вместе с ZIP публикуется файл `.sha256` для проверки загрузки:
```bash
-./script/build_and_run.sh
+shasum -a 256 CleanMac-*.zip
```
-Core package checks:
+Сравните полученный хеш с первым значением в приложенном файле `.sha256`, затем распакуйте архив и переместите `CleanMac.app` в `/Applications`.
+
+Актуальные ограничения готовой сборки:
+
+- macOS 14 или новее;
+- архитектура Apple Silicon (`arm64`);
+- релиз пока подписан только ad-hoc и не нотарифицирован Apple.
+
+## Разрешения macOS
+
+CleanMac запрашивает доступ только по действию пользователя:
+
+- **Файлы и папки** — для выбранных пользовательских областей;
+- **Полный доступ к диску** — опционально, для более глубокого чтения защищённых метаданных;
+- **Автоматизация Finder** — опционально, только чтобы показать выбранный элемент в Finder.
+
+Сканирование и очистка не требуют Finder Automation. Разрешения можно проверить на экране «Доступы» и изменить в системных настройках macOS.
+
+## Сборка из исходников
+
+Требуются macOS 14+ и Xcode 26+.
+
+```bash
+git clone https://github.com/Dezoff-max/CleanMac.git
+cd CleanMac
+./script/build_and_run.sh --verify
+```
+
+Тесты ядра:
```bash
-cd CleanMacCore
-swift test
+swift test --package-path CleanMacCore
```
-## Project
+Локальный Release ZIP и SHA-256:
+
+```bash
+./script/package_release.sh
+```
+
+Подписание Developer ID и нотарификация описаны в [docs/signing-notarization.md](docs/signing-notarization.md).
+
+## Структура проекта
+
+```text
+CleanMac/ SwiftUI-приложение для macOS
+CleanMacCore/ Тестируемое ядро сканирования и очистки
+script/ Сборка, запуск и упаковка релиза
+docs/ Документация и скриншоты
+.github/workflows/ CI и публикация GitHub Releases
+```
+
+## Участие в разработке
+
+1. Создайте отдельную ветку от `main`.
+2. Сохраняйте модель безопасности: scan → review → confirm → Trash.
+3. Добавляйте тесты для изменений путей, сканирования и удаления.
+4. Перед Pull Request выполните `swift test --package-path CleanMacCore` и `./script/build_and_run.sh --verify`.
-- `CleanMac/` contains the macOS SwiftUI app.
-- `CleanMacCore/` contains reusable core logic.
-- `script/build_and_run.sh` builds and launches the app from a local build folder.
+Сообщения об ошибках и предложения можно создавать через [GitHub Issues](https://github.com/Dezoff-max/CleanMac/issues).
-## License
+## Лицензия
-[MIT](LICENSE)
+Проект распространяется по лицензии [MIT](LICENSE).
diff --git a/docs/screenshots/applications-multiselect.png b/docs/screenshots/applications-multiselect.png
new file mode 100644
index 0000000..6819799
Binary files /dev/null and b/docs/screenshots/applications-multiselect.png differ
diff --git a/docs/screenshots/overview.png b/docs/screenshots/overview.png
new file mode 100644
index 0000000..400b1ae
Binary files /dev/null and b/docs/screenshots/overview.png differ
diff --git a/docs/screenshots/scan-areas.png b/docs/screenshots/scan-areas.png
new file mode 100644
index 0000000..18540f6
Binary files /dev/null and b/docs/screenshots/scan-areas.png differ
diff --git a/docs/signing-notarization.md b/docs/signing-notarization.md
index a3a62dd..f3f861d 100644
--- a/docs/signing-notarization.md
+++ b/docs/signing-notarization.md
@@ -43,7 +43,7 @@ CLEANMAC_NOTARY_ISSUER="ISSUER_UUID"
## GitHub Release Secrets
-For private GitHub Releases, add these repository secrets when signing is ready:
+For GitHub Releases, add these private repository secrets when signing is ready:
- `CLEANMAC_SIGN_IDENTITY`: Developer ID Application identity name.
- `CLEANMAC_CERTIFICATE_P12_BASE64`: base64-encoded `.p12` Developer ID certificate.
diff --git a/project-analysis.md b/project-analysis.md
index 2407def..57d2d15 100644
--- a/project-analysis.md
+++ b/project-analysis.md
@@ -10,7 +10,7 @@ CleanMac is a macOS menu bar and windowed system cleanup utility. The project wa
- `CleanMacCore/`: SwiftPM library for reusable cleanup/scanning logic.
- `script/build_and_run.sh`: local Debug build and launch entrypoint.
- `script/package_release.sh`: local Release `.app`, `.zip`, and `.sha256` packaging.
-- `.github/workflows/ci.yml`: private GitHub CI for core tests, Debug app build, and unsigned Release artifact.
+- `.github/workflows/ci.yml`: GitHub CI for core tests, Debug app build, and unsigned Release artifact.
- `.github/workflows/release.yml`: tag-driven GitHub Release workflow for unsigned/ad-hoc zip and sha256 assets, with optional Developer ID signing/notarization when private secrets are configured.
- `docs/` and `Design/`: icon and project assets.
@@ -35,7 +35,7 @@ CleanMac is a macOS menu bar and windowed system cleanup utility. The project wa
- Repository was cleaned and renamed to CleanMac.
- App icon, menu bar icon, Dashboard brand icon, status menu brand icon, design assets, and docs icon use the supplied detailed broom artwork from `Design/source-icon.png`.
-- Private GitHub repository and CI were configured.
+- Public GitHub repository and CI were configured.
- Local `dist/` packaging exists and is ignored by git.
- Main Dashboard/Scan/Results/Applications/Permissions/Settings window builds and launches.
- Main content pages use the supplied light technology background while preserving the native macOS sidebar.
@@ -61,7 +61,7 @@ CleanMac is a macOS menu bar and windowed system cleanup utility. The project wa
- The menu bar popover shows current disk usage, scan-in-progress state, last scan source/time, and last scan result summary with larger readable typography and rounded compact panels.
- Settings can enable read-only auto scan while the app is running; it supports daily, hourly, and every-two-hours frequencies, uses the currently selected scan areas, and updates menu bar status.
- Scheduled auto scan can show localized macOS completion notifications when the notification toggle is enabled and system permission allows it; Settings includes a test notification button to diagnose macOS permission/delivery state. Manual scans remain silent.
-- Private GitHub Release `v0.1.0` exists with unsigned zip and sha256 assets.
+- Public GitHub Release `v0.2.0` is the latest release and includes unsigned zip and sha256 assets.
- Release packaging creates a clean unsigned/ad-hoc local zip plus sha256, strips Finder/resource-fork metadata before archiving, strictly verifies a fresh ZIP extraction, and can optionally sign with Developer ID, enable hardened runtime, submit to Apple notary service, staple, and re-zip when credentials are configured.
## Unfinished Or Risky Parts