From 26a153bff986efe42958ae014b663749347718f7 Mon Sep 17 00:00:00 2001
From: akhmed <akhmed@statix.sbs>
Date: Tue, 15 Sep 2026 21:19:04 +0300
Subject: [PATCH] =?UTF-8?q?README:=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD?=
 =?UTF-8?q?=D0=B8=D0=B5=20=D0=B8=D0=B7=D0=BC=D0=B5=D0=BD=D0=B5=D0=BD=D0=B8?=
 =?UTF-8?q?=D0=B9,=20=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D0=B0=20=D0=BD=D0=B0?=
 =?UTF-8?q?=20=D0=9F=D0=A0=D0=90=D0=92=D0=9A=D0=98.md=20=D0=B8=20Issues?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 27 ++++++++++++++++++++-------
 1 file changed, 20 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index c297914..03e567d 100644
--- a/README.md
+++ b/README.md
@@ -4,14 +4,19 @@
 
 ## Возможности
 
-- Авторизация OAuth
-- Просмотр Диска: папки, файлы, «Недавние», «Корзина»
+- Авторизация OAuth (токен в Keychain)
+- Просмотр Диска: все файлы и папки, «Недавние», «Корзина», «Доступные мне» (в разработке)
 - Чтение / скачивание, загрузка (кнопка и drag-and-drop)
 - Копирование, перемещение, переименование, дублирование
 - Удаление в Корзину, восстановление, очистка Корзины
-- Синхронизация `~/Yandex.Disk`: **Везде** / **Только на компьютере** / **Только в облаке**
+- Синхронизация `~/Yandex.Disk`: **Везде** / **Только на компьютере** / **Только в облаке** (по умолчанию — «Только в облаке»)
 - Общий доступ: ссылка, права, пароль, срок действия
-- Иконка в меню-баре, светлая и тёмная темы
+- Иконка приложения подстраивается под тему системы (светлая/тёмная), иконка в меню-баре
+
+## План доработок
+
+Аудит кода, найденные неоптимальные места и порядок работ — в [ПРАВКИ.md](ПРАВКИ.md).
+Актуальные задачи также заведены в Issues Gitea: https://git.statix.sbs/akhmed/YanDisk/issues
 
 ## Сборка
 
@@ -29,12 +34,19 @@ cp -R .build/YanDisk.app /Applications/
 codesign --force --deep --sign - /Applications/YanDisk.app
 ```
 
+Smoke-тесты (сборка + проверка OAuth-парсинга, кодирования путей и бандла):
+
+```bash
+./smoke_test.sh
+```
+
 ## Иконка
 
 Исходники: `icons/Icon-iOS-*.png` (1024×1024).  
 Собранные ресурсы:
 
-- `Resources/AppIcon.icns` — Dock/Finder
+- `Resources/AppIcon.icns` — Dock/Finder (светлая тема)
+- `Resources/AppIconDark.icns` — Dock/Finder (тёмная тема)
 - `Resources/Assets.xcassets/AppIcon.appiconset` — варианты light/dark (HIG)
 
 Пересборка иконки:
@@ -46,7 +58,8 @@ codesign --force --deep --sign - /Applications/YanDisk.app
 ## Темы
 
 Настройки → Основные → **Тема**: Как в системе / Светлая / Тёмная.  
-Значение хранится в `AppStorage("Appearance")`.
+Значение хранится в `AppStorage("Appearance")`. Иконка Dock переключается автоматически
+по `effectiveAppearance` (`AppDelegate.updateAppIcon()`).
 
 ## Структура
 
@@ -57,7 +70,7 @@ Sources/YanDisk/
   Sync/    движок синхронизации
   UI/      меню-бар, браузер, шаринг, настройки, вход
 icons/     исходные PNG иконки
-Resources/ Info.plist, AppIcon.icns, Assets.xcassets
+Resources/ Info.plist, AppIcon.icns, AppIconDark.icns, Assets.xcassets
 ```
 
 ## Авторизация