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
 ```
 
 ## Авторизация