From 1394b1442c5c0e0876f3c95b16ca4644ede7f116 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=90=D0=BD=D1=82=D0=BE=D0=BD=20=D0=A2=D1=80=D0=BE=D1=88?=
 =?UTF-8?q?=D0=B8=D0=BD?= <i@atroshin.ru>
Date: Fri, 7 Aug 2026 21:33:38 +0300
Subject: [PATCH] update README: custom files, file update, command hints, card
 reader section

---
 README.md     | 29 +++++++++++++++++++++++++++++
 README_RUS.md | 31 ++++++++++++++++++++++++++++++-
 2 files changed, 59 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b7b9d05..52e2788 100644
--- a/README.md
+++ b/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.
diff --git a/README_RUS.md b/README_RUS.md
index cf71290..bf96f87 100644
--- a/README_RUS.md
+++ b/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`.
\ No newline at end of file
+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 мс. Автодополнение команд — над полем ввода.
\ No newline at end of file