RustText README

项目的 README,来自 github.com/Illson/RustText。合并为一个 markdown 文件: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 по умолчанию собирает не более двух пакетов одновременно.

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

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

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

$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. Сначала зарегистрируйте RustText в каждом профиле, к которому применяется политика. В 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

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

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

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

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

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

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

Большие логи

Обновления

При запуске RustText проверяет новые стабильные выпуски на GitHub в фоне. Если новая версия доступна, приложение скачивает архив и сверяет его с SHA-256.

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

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

Выполните команды из корня репозитория в 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 находит файлы обновления. Замеры первого выпуска приведены в отчёте.

Проверка

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

.\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

Разработка

Порядок работы с LLM-агентами, Git worktree и GitHub описан в руководстве по разработке.

RustText (Illson/RustText)

正在搜索数据库…

这是什么?RustText 是一款在 Windows x64 上查看和编辑大型日志文件的文本编辑器与查看器,使用 Rust 编写,界面基于 GPUI Kit 工具包。它可以打开任意大小的文件,并内置搜索、JSON 校验和行生成工具。
这是便携版还是需要安装?这是便携版应用:解压压缩包后运行 rusttext.exe 即可。运行文件关联注册步骤是可选的,只有在希望双击打开 .log、.txt、.json 和 .xml 文件时才需要。
怎么让它运行起来?下载便携版压缩包,解压后运行 rusttext.exe。调试版和发布版都会在没有控制台窗口的情况下启动,再次启动时会把文件交给已打开的 RustText。
Windows 10 也能用吗?目前只在 Windows 11 x64 上验证过。Windows 10 x64 尚未测试,需要单独检查。
能在 macOS 或 Linux 上运行吗?不能,它只面向 Windows x64,这一点从标题和构建目标就能看出来。
这里如何处理大文件?超过 50 MiB 的文件会自动在日志查看器中打开,该查看器按需加载行,并提供索引、滚动条小地图和行号显示。
能同时搜索多个标签页吗?可以,搜索可以覆盖所有文本标签页,替换只作用于当前标签页。结果最多显示前 100 条匹配;如果有标签页无法加载,结果会标记为不完整。
关闭后会保留我的工作吗?会。打开的标签页、草稿、选中内容、滚动位置和窗口大小都会从会话中恢复,已关闭的标签页可以从最近关闭的 100 个中重新打开。
行生成器有什么用?它可以根据模板生成大量行,模板中可使用 {intfrom5}、{guid} 和 {randstring} 等占位符;生成大量结果时会写入文件,并显示进度,还可以取消。
作者
Illson
大小
5.2 MB
星标
614
时长
2天
提交 · 90 天