# RustText (Illson/RustText)

> This project has not provided a description yet.

- GitHub: https://github.com/Illson/RustText
- GitHub.Locker page: https://github.locker/Illson/RustText
- Stars: 614
- Language: Rust
- Last push: 2026-11-18

---

## README (checked against GitHub 2026-11-19)

Source: https://github.com/Illson/RustText/blob/main/README.md

# RustText

Текстовый редактор и просмотрщик больших логов для Windows x64 на Rust и GPUI Kit.

## Запуск

Для переносимой сборки распакуйте архив и запустите `rusttext.exe`. Отладочная и релизная сборки запускаются без отдельного окна консоли. Повторный запуск передаёт файлы открытому RustText. Сборка проверена на Windows 11 x64. Для Windows 10 x64 нужна отдельная проверка.

### Сборка из исходников

Нужны Rust с целью `x86_64-pc-windows-msvc`, инструменты C++ и Windows SDK из Visual Studio, а также CMake в `PATH`. Локальная сборка проверена с Rust 1.100.0 и CMake 4.5.0. Версия Rust закреплена в `rust-toolchain.toml`; Cargo по умолчанию собирает не более двух пакетов одновременно.

```powershell
cargo run --locked
cargo run --locked -- "C:\путь\к\файлу.txt"
```

- Верхнее меню содержит «Файл», «Инструменты» и «Поиск». Открытие и сохранение собраны в меню «Файл»; отдельной панели этих команд нет.
- Кнопка «+», двойной щелчок по свободному месту на полосе вкладок или `Ctrl+N` создают пустую вкладку. Пока вкладка не привязана к файлу, её заголовок повторяет первую строку текста в пределах настраиваемого лимита (по умолчанию 10 символов, для пустой строки – «Без имени»). «Файл → Открыть…» или `Ctrl+O` открывает файлы. Файлы также можно передать аргументами запуска или перетащить в окно.
- «Файл → Сохранить» (`Ctrl+S`) сохраняет документ, «Файл → Сохранить как…» (`Ctrl+Shift+S`) открывает диалог выбора пути. Для логов эти команды недоступны.
- Двойной щелчок по вкладке или `Ctrl+W` закрывает её. `Ctrl+Shift+T` или кнопка «↶» восстанавливают последнюю закрытую вкладку с её позицией и выделением в редакторе либо позицией и настройками просмотра лога. В меню «Файл → Закрытые вкладки» можно выбрать любую из последних 100 закрытых вкладок. История и текст вкладок «Без имени» сохраняются между запусками.
- Вкладки из сессии и закрытые черновики загружаются в фоне. Можно переключиться на другую вкладку или нажать «Отменить загрузку». Черновик остаётся в истории для повторного открытия. При восстановлении черновика размером свыше 8 МиБ, с более чем 50 000 строками или со строкой длиннее 64 КиБ RustText открывает постраничный просмотр. «Сохранить копию…» выгружает весь черновик в UTF-8.
- Нижняя строка состояния показывает путь или уведомление, состояние сохранения документа, позицию курсора (`Ctrl+G` открывает переход к строке), кодировку и переводы строк.
- «Файл → Недавние файлы» показывает 16 последних открытых или сохранённых файлов. После закрытия всех вкладок либо по нажатию на «RustText» в левом верхнем углу открывается полная история с поиском и страницами. В истории и меню «Недавние файлы» и «Закрытые вкладки» отображаются доступные количество строк и время последней работы. За последние сутки время указано в минутах или часах, для более старых записей показаны местные дата и время. На открытой странице истории относительное время обновляется автоматически. Если есть записи младше часа, обновления происходят не чаще раза в 10 секунд, а если остались только подписи в часах — не чаще раза в минуту. Повторное открытие восстанавливает выделение и прокрутку. История сохраняется между запусками в `%LOCALAPPDATA%\RustText\recent-files.json`.
- Редактор открывает UTF-8 и UTF-16 с BOM автоматически. «Файл → Открыть в Windows-1251…» явно выбирает Windows-1251. Повторное открытие в другой кодировке перечитывает файл, если во вкладке нет несохранённых изменений.
- Чтобы открывать файлы двойным щелчком, выберите «Файл → Настроить открытие файлов в Windows…». В параметрах Windows назначьте RustText приложением по умолчанию для выбранных расширений .log, .txt, .json и .xml. Если переместите переносимый RustText, выполните настройку ещё раз.
- Правый щелчок по вкладке открытого файла позволяет показать его в Проводнике, скопировать путь или закрыть вкладку.
- Справа в редакторе и логах находится широкая полоса прокрутки с миникартой. Для больших логов миникарта читает небольшие выборки.
- Кнопки разделения на полосе вкладок создают горизонтальные и вертикальные группы. Перетаскивайте вкладки между группами и меняйте размеры разделителем. Сессия сохраняет раскладку и активные вкладки групп.

### Регистрация типов файлов для установки

Распакуйте RustText в постоянную папку и запустите команду из этой папки от имени пользователя, который будет работать с программой.

```powershell
$registration = Start-Process -FilePath (Resolve-Path '.\rusttext.exe').Path -ArgumentList '--register-file-associations' -Wait -PassThru
if ($registration.ExitCode -ne 0) { throw 'Не удалось зарегистрировать RustText в Windows' }
```

Команда добавляет RustText в список приложений и пункт «Открыть в RustText» в Проводнике для .txt, .json, .xml и .log. На обычном компьютере назначение подтверждается в «Параметры → Приложения → Приложения по умолчанию». Команда «Файл → Настроить открытие файлов в Windows…» открывает эту страницу.

Для управляемых компьютеров используйте XML в [политике ассоциаций Windows](https://learn.microsoft.com/en-us/windows/client-management/mdm/policy-csp-applicationdefaults). Сначала зарегистрируйте RustText в каждом профиле, к которому применяется политика. В XML укажите следующие типы.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<DefaultAssociations>
  <Association Identifier=".txt" ProgId="RustText.Text" ApplicationName="RustText" />
  <Association Identifier=".json" ProgId="RustText.Json" ApplicationName="RustText" />
  <Association Identifier=".xml" ProgId="RustText.Xml" ApplicationName="RustText" />
  <Association Identifier=".log" ProgId="RustText.Log" ApplicationName="RustText" />
</DefaultAssociations>
```

## Сессия, поиск и JSON

- RustText восстанавливает открытые вкладки, черновики, выделение, прокрутку и размер окна. Снимки и две последние завершённые записи журнала находятся в `%LOCALAPPDATA%\RustText\session`. При закрытии окна редактор дожидается записи.
- «Поиск» или `Ctrl+F` открывает нижнюю панель поиска. «Найти» или `Enter` показывает первые 100 совпадений и общее количество. Если истёк лимит времени, панель показывает, сколько совпадений успела найти. Нажатие на результат переводит к совпадению. Оно ненадолго подсвечивается, затем остаётся обведено. `F3` и `Shift+F3` переходят между совпадениями. Если переход по `F3` приостановлен по лимиту времени, нажмите `F3` ещё раз.
- Кнопка «Замена» или `Ctrl+H` показывает поле замены. Поиск может охватывать все текстовые вкладки, замена применяется к текущей. В «Заменить все» нет ограничения по количеству совпадений. На операцию отводится до 400 мс. В регулярном выражении доступны подстановки групп, например `$1`.
- Поиск по всем вкладкам загружает ожидающие текстовые вкладки по очереди. Черновики свыше 8 МиБ ждут выбора вкладки. Если часть текстовых вкладок недоступна, панель отмечает результаты как неполные.
- «Только текущее» оставляет подсветку текущего совпадения. Снимите флаг для подсветки всех видимых совпадений, включая результаты за пределами первых 100. Текущее совпадение сохраняется при прокрутке.
- RustText проверяет JSON в файлах .json и в тексте, который начинается с `{` или `[` после пробелов и BOM. При ошибке красное предупреждение показывает строку и столбец. «Перейти к ошибке» ставит курсор на нужное место. Проверку можно отключить для документа в предупреждении и снова включить в меню «Инструменты»; выбор сохраняется в сессии.
- «Инструменты → Форматировать JSON» (`Ctrl+Shift+J`) форматирует выделенный JSON или весь документ. Входной и форматированный JSON ограничены 64 МиБ каждый. `Ctrl+Z` отменяет форматирование. В меню «Инструменты» также находятся замена, переход к строке, перенос строк, масштаб текста и «Настройки…» (включая лимит символов названия пустой вкладки).

## Генератор строк

Откройте «Инструменты → Генератор строк…», введите шаблон и количество строк. Небольшой результат откроется в новой вкладке. Если оценка размера превышает 8 МиБ, генератор предложит файл. Кнопка «В файл…» доступна и для небольшого результата.

- `{int_from_5}` подставляет 5 в первую строку, 6 во вторую и так далее. Можно выбрать другое начальное число, включая отрицательное.
- `{guid}` создаёт GUID v4 при каждой подстановке.
- `{rand_string}` создаёт строку из 12 латинских букв и цифр. Формат `{rand_string_24}` задаёт свою длину.

Например, шаблон `strokna {int_from_5} {guid} {rand_string_8}` использует три правила в каждой строке. Лимитов в миллион строк и 8 МиБ нет: запись в файл идёт частями, с прогрессом и отменой. Отмена сохраняет прежний файл назначения.

В «Инструменты → Сравнить списки…» вставьте два списка. Результаты показывают общие строки, только слева и только справа. Сравнение учитывает регистр и пробелы, исключает повторы и сохраняет порядок первого появления строк. Результат можно скопировать или открыть в новой вкладке.

«Инструменты → Версии файла…» показывает снимки небольшого текстового файла и их содержимое. По умолчанию снимки ограничены 5 МиБ на файл и 100 МиБ суммарно; лимиты меняются в панели версий. Снимок создаётся после успешного сохранения и перед восстановлением. Восстановление меняет текст в редакторе: `Ctrl+Z` отменяет замену текста, `Ctrl+S` сохраняет в файл с обычной проверкой внешних изменений.

«Инструменты → Вывести окно на передний план…» ищет видимые верхнеуровневые окна Windows, включая свёрнутые. Выберите точный PID процесса или поиск по части заголовка без учёта регистра, затем нажмите «Найти» или `Enter`. У нужного результата нажмите «Вывести». RustText восстановит свёрнутое окно и сообщит, если Windows отклонит переключение.

## Большие логи

- Файлы размером больше 50 МиБ автоматически открываются для просмотра. Для меньших используйте «Файл → Открыть как лог…». Там же можно открыть лог в Windows-1251.
- Колёсико прокручивает лог и подгружает соседние строки у границы загруженной области. Ползунок показывает положение по всему доступному участку файла. Его можно перетащить или щёлкнуть по дорожке для перехода к нужной части лога. Длинные строки переносятся по ширине окна. Перенос можно отключить в меню «Инструменты → Перенос строк».
- «Начало», «Назад», «Дальше», «Конец» и поле «Перейти, %» перемещают область просмотра. В логе работают `Ctrl+Home`, `Ctrl+End`, `Page Up`, `Page Down` и копирование выделенного текста через `Ctrl+C`.
- Слева от текста отображаются номера строк исходного файла. Строка состояния показывает диапазон загруженных строк и итоговое количество после индексации. При переходе далеко вперёд номера появляются, когда индекс доходит до выбранной позиции.
- Нижняя панель «Поиск в логе» ищет по строкам и выдаёт результаты порциями. Доступны регулярные выражения, поиск с учётом регистра и целого слова. Результаты показывают номер строки, когда он известен. При переходе совпадение ненадолго подсвечивается, затем остаётся обведено. Если строка превышает предельный размер, поиск сообщает об этом. Если файл обрывается посреди символа UTF‑8, после дописывания кнопка «Ещё» проверяет эту строку заново.
- Для лога, упорядоченного по времени, введите дату и время в поле поиска, например 2026-11-17 01:30:20.0850, и нажмите «Ко времени». RustText откроет первую запись с указанным или более поздним временем. Если ввести только время, например 01:33:42.8750, используется дата просматриваемой записи. «Найти» выполняет обычный текстовый поиск.
- Имя файла, режим просмотра, «Пауза»/«Продолжить», «Следовать за концом» и состояние автообновления находятся в одной строке под вкладками. Пауза останавливает чтение новых данных; следование независимо перемещает видимую область при дописывании. Навигация по файлу находится снизу. При ротации или очистке файла RustText сообщает об изменении и сбрасывает старую границу и индекс.
- В меню «Инструменты» доступны обновление содержимого лога, управление индексированием и операции с началом лога. «Скрыть начало» ограничивает просмотр и поиск. «Удалить начало…» меняет исходный файл после подтверждения. Перед подтверждением RustText подсчитывает удаляемые строки. Для записи нужен эксклюзивный доступ и свободное место под полную резервную копию рядом с исходником. RustText выводит путь к копии после обрезки.
- Сессия восстанавливает вкладку, позицию, скрытую границу и переключатели. Если прежнее содержимое по закладке не удаётся подтвердить, лог открывается с начала. Для лога в сессию записываются только метаданные.

## Обновления

При запуске RustText проверяет новые стабильные [выпуски на GitHub](https://github.com/Illson/RustText/releases) в фоне. Если новая версия доступна, приложение скачивает архив и сверяет его с SHA-256.

Когда обновление готово, «Перезапустить» сохраняет сессию, устанавливает обновление и снова открывает окно. «Позже» скрывает уведомление до следующего запуска.

## Подготовка архива

Выполните команды из корня репозитория в PowerShell.

```powershell
$env:CARGO_TARGET_X86_64_PC_WINDOWS_MSVC_RUSTFLAGS = '-C target-feature=+crt-static'
cargo build --release --locked --target x86_64-pc-windows-msvc
.\tools\Package-RustText.ps1 -ExecutablePath 'target\x86_64-pc-windows-msvc\release\rusttext.exe' -OutputDirectory 'target\distribution\v0.1.1'
```

Для стабильного релиза с тегом вида `v0.1.1` прикрепите к выпуску `RustText.zip` и `RustText.zip.sha256`. По этим именам RustText находит файлы обновления. Замеры первого выпуска приведены в [отчёте](docs/verification.md).

## Проверка

Модульные тесты лежат в `tests/unit/`. Имя файла соответствует модулю, например `session.rs`, `search.rs` или `json_format.rs`. Для локальных проверок используйте PowerShell 7 и `tools/Check.ps1`: по умолчанию два логических CPU, два процесса Cargo, два потока тестов и приоритет BelowNormal. Скрипт восстанавливает настройки после завершения, в том числе при ошибке.

```powershell
.\tools\Check.ps1 -Mode Targeted -TestFilter 'session::'
.\tools\Check.ps1 -Mode Full
```

`Full` последовательно запускает проверку форматирования, все тесты с `--locked` и Clippy для всех целей с `-D warnings`. Во время правок запускайте целевые тесты; полный прогон выполняйте после законченного изменения. `Build` собирает Debug, `Release` собирает Release для Windows x64. Параметры `-Jobs` и `-CpuCount` меняют ограничения; сам скрипт кэш не очищает.

Для последовательной работы в нескольких worktree можно передать один абсолютный путь к каталогу сборки через `-CacheDirectory`. Cargo использует этот каталог вместо локального `target` и блокирует одновременные записи. Одинаковые toolchain и флаги позволяют повторно использовать зависимости. [Настройки Cargo](https://doc.rust-lang.org/cargo/reference/config.html)

## Разработка

Порядок работы с LLM-агентами, Git worktree и GitHub описан в [руководстве по разработке](docs/development.md).

