fq CLI
CLI разбирает двоичные форматы и дает запросы в стиле jq, чтобы агент исследовал структуру файла и извлекал нужные поля.
- 10 626 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- CLI читает выбранные локальные файлы; извлеченные поля могут содержать чувствительные сведения, которые затем увидит агент.
Установка
Ручная установка
brew install wader/tap/fqПервый пакетный метод Install для macOS. Перед ним README также предлагает ручную загрузку официального бинарного релиза.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- CLI читает выбранные локальные файлы; извлеченные поля могут содержать чувствительные сведения, которые затем увидит агент.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
fq делает двоичные файлы доступными для запросов из терминала. Пользователь открывает файл, просматривает его структуру и выбирает поля выражениями, похожими на jq. Для сложных контейнеров можно исследовать вложенные форматы и участки байтов. Агент может использовать fq при диагностике разрешенного файла: найти метаданные, сопоставить поля и подготовить понятный вывод. Кроме пакетного запуска есть интерактивный режим с автодополнением и просмотром байтов, связанных с разобранной структурой.
Для кого. Аналитикам файловых форматов, которым нужно исследовать двоичные данные без написания отдельного декодера для каждого запроса.
Подходит, если
- В медиаконтейнере нужно найти технические поля и метаданные.
- Агент сравнивает структуру двух разрешенных двоичных файлов.
- Из вложенного формата требуется извлечь конкретный участок.
- Для повторного анализа нужен короткий сохраненный запрос к файлу.
Не подходит, если
- Нужна автоматическая декомпиляция логики программы.
- Формат отсутствует среди доступных декодеров.
- Извлеченные секреты нельзя передавать модели или сохранять в отчете.
Пример запроса к агенту
Исследуй структуру копии этого файла через fq и выведи только технические метаданные без встроенного содержимого.Ограничения
Разбор зависит от поддерживаемого формата, поэтому проверьте список декодеров до анализа. Выражения основаны на языке jq; для сложных запросов придется изучить его правила и руководство fq. Вывод может содержать метаданные и приватные поля исходного файла, поэтому выбирайте только нужные значения перед передачей агенту. Срезы и преобразования данных требуют проверки границ и результата: сохраните оригинал и не заменяйте его полученным фрагментом без отдельной проверки.
Как отключить. Завершите fq и уберите команду из сценария анализа. Исходные файлы остаются, если вы отдельно не перенаправляли вывод поверх них.
Частые вопросы
Как посмотреть разобранный файл?
Выполните `fq . file`, заменив `file` путем к исследуемому файлу.
Можно ли смотреть байты со структурой?
Да. У fq есть структурный шестнадцатеричный просмотрщик.
Где читать руководство без сайта?
Доступна локальная справка `man fq`.
Поддерживаются ли вложенные контейнеры?
Да, декодеры умеют работать с вложенными форматами; результат зависит от конкретного поддерживаемого типа.
Нужно ли знать jq?
Для простого просмотра нет, но сложные выражения удобнее писать после знакомства с его языком.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI на Go читает и изменяет YAML, JSON и другие форматы, чтобы агент делал точечные преобразования конфигурации.
jnv, интерактивный просмотрщик JSON, копирует проверенный фильтр или его результат, чтобы перенести ручную проверку в скрипт.
Интерактивный просмотрщик помогает углубляться в JSON с подсказками полей и проверять выражения, подготовленные агентом.
CLI выбирает и меняет значения в JSON, YAML и других форматах, чтобы агент преобразовывал данные единым языком запросов.
CLI импортирует CSV и JSON в SQLite, выполняет SQL и меняет схему, чтобы агент готовил локальные наборы данных для анализа.
CLI выполняет SQL над CSV, JSON и другими табличными файлами, чтобы агент объединял выгрузки и менял формат результата.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| fq (эта карточка) | нет | 10 626 | ||
| Binary Ninja MCP | нет | не нужна | 456 | дает агенту декомпиляцию и исследование исполняемого кода внутри Binary Ninja |
| yq | нет | 16 229 | CLI на Go читает и изменяет YAML, JSON и другие форматы, чтобы агент делал точечные преобразования конфигурации. |
Коротко о README
Среди декодеров есть форматы изображений, аудио, архивов и сетевых данных. Инструмент также поддерживает побитовый разбор и объединение данных.