update README: custom files, file update, command hints, card reader section

README.md

@@ -371,6 +371,35 @@ Swaps nibble pairs of an even-length hex string.
 
 ---
 
+
+
+## Card Reader (pySim integration)
+
+Connects to a local [pysim-otaman-server](https://github.com/anttro/pysim-otaman-server) for live card operations.
+
+### File Browser
+
+Browse the UICC filesystem in a tree view. Files are shown with names, FIDs, and AIDs (for ADFs). Click to read contents.
+
+- **Read** — reads the selected file (auto-detects transparent vs record files)
+- **Edit** — switch to edit mode, modify hex data, click **Save** to write back
+- **Raw / Decoded** — toggle between hex dump and pysim-decoded JSON view
+
+### Custom Files
+
+Files not in pysim's model can be added manually:
+
+1. Switch to the **Custom files** sub-tab
+2. Enter the file path (e.g., `3F00/6F46`) and an alias (e.g., `EF.SPN`)
+3. Click **Add** — the file appears in the tree in italics (unverified)
+4. Click the file to verify existence — on success, it behaves like a model file
+
+Custom files persist in `localStorage` across sessions. Export/import as JSON for sharing.
+
+### Command Hints
+
+Type a command name in the **pySim command line** input. Usage hints appear as a tooltip after 300ms. Command autocomplete suggestions appear above the input.
+
 ## PWA
 
 OTAMan is a Progressive Web App and can be installed for offline use. Use the **INSTALL PWA** button in the header, or use the browser's install prompt.

README_RUS.md

@@ -368,4 +368,33 @@ OTAMan — Progressive Web App. Можно установить для offline-
 | 1.x.x | 0.x.x | ❌ Сервер устарел |
 | 1.x.x | 2.x.x+ | ⚠️ Сервер новее — обновите PWA |
 
-PWA проверяет версию сервера при подключении через `GET /api/version`.
+PWA проверяет версию сервера при подключении через `GET /api/version`.
+
+---
+
+## Card Reader (интеграция с pySim)
+
+Подключение к локальному [pysim-otaman-server](https://github.com/anttro/pysim-otaman-server) для работы с картой.
+
+### Файловый менеджер
+
+Дерево файлов UICC. Отображаются имена, FID и AID (для ADF). Клик для чтения содержимого.
+
+- **Read** — чтение файла (автоопределение transparent/record)
+- **Edit** — режим редактирования, измените hex-данные и нажмите **Save** для записи
+- **Raw / Decoded** — переключение между hex-дампом и декодированным JSON
+
+### Пользовательские файлы
+
+Файлы, отсутствующие в модели pysim, можно добавить вручную:
+
+1. Перейдите на вкладку **Custom files**
+2. Введите путь (например, `3F00/6F46`) и псевдоним (например, `EF.SPN`)
+3. Нажмите **Add** — файл появится в дереве курсивом (непроверенный)
+4. Кликните для проверки существования — при успехе работает как обычный файл
+
+Пользовательские файлы сохраняются в `localStorage`. Экспорт/импорт в JSON для обмена.
+
+### Подсказки команд
+
+Введите имя команды в **pySim command line**. Подсказки по использованию появляются через 300 мс. Автодополнение команд — над полем ввода.