DeckProbe CLI
CLI на Rust проверяет PDF, Office и iWork без открытия и возвращает JSON с числом страниц, слайдов и признаками безопасности.
- 112 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- CLI читает локальные файлы и работает с недоверенными документами, хотя и не отрисовывает их.
- Установочный скрипт `curl | sh` запускает чужой код, поэтому его проверяют по контрольным суммам.
Установка
- Работает в
Ручная установка
cargo install --git https://github.com/deckflow/deckprobe --locked deckprobeСборка из исходников, нужен Rust 1.88 или новее. Есть готовые архивы и пакет `@deckflow/deckprobe` в npm.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI читает локальные файлы и работает с недоверенными документами, хотя и не отрисовывает их.
- Установочный скрипт `curl | sh` запускает чужой код, поэтому его проверяют по контрольным суммам.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
DeckProbe выполняет дешевую предварительную проверку документов и отдает структурированный JSON с достоверностью, доказательствами и измеренной стоимостью чтения. Агент запрашивает только нужные факты, например `slide_count` или число страниц, а не разбирает файл целиком. Инструмент читает PDF, Word, Excel, PowerPoint, старые форматы `.doc`, `.xls`, `.ppt` и файлы iWork (`.key`, `.numbers`, `.pages`) без рендера и без офисных пакетов. Для чтения, распаковки, числа записей архива и времени действуют лимиты. Есть режим `--jsonl` для пакетов и браузерный SDK на WebAssembly, который не отправляет файлы на сервер.
Для кого. Разработчикам агентов и конвейеров документов, которым перед разбором, OCR или загрузкой в модель нужно быстро узнать размер и состав файла.
Подходит, если
- Перед отправкой презентации в модель надо узнать число слайдов и наличие заметок и скрытых слайдов.
- Пришедший PDF стоит проверить на подписи, вложения, JavaScript и формы до открытия.
- Сотни документов надо отсортировать по маршрутам обработки без дорогого разбора каждого.
- Страницу с загрузкой файлов делают в браузере, и данные не должны уходить с устройства.
Не подходит, если
- Нужно извлечь весь текст или структуру: DeckProbe не разбирает содержимое целиком.
- Требуется OCR, редактирование или отрисовка страниц в картинки.
- Нужна полноценная защита от вредоносных файлов: инструмент не заменяет антивирус.
Пример запроса к агенту
Сколько слайдов в `deck.pptx`, есть ли скрытые слайды и заметки? Проверь через DeckProbe, не открывая файл.Ограничения
Для установки из исходников нужен Rust 1.88 и новее, готовые архивы ставят скриптом `curl | sh` или `npm install @deckflow/deckprobe`. Релизы не имеют подписи Developer ID и Authenticode, поэтому macOS и Windows могут запросить подтверждение. Маршрут выбирается по расширению имени, затем проверяется контейнер. Глубокая оценка объема текста дает среднюю уверенность и включается отдельным запросом. Пакетный режим ждет по одной строке JSON на документ, а вызов `probeFile()` держит файл целиком в памяти.
Как отключить. Удалите бинарный файл `deckprobe` из каталога Cargo (`~/.cargo/bin`) либо выполните `npm uninstall @deckflow/deckprobe`. Скилл убирают из `~/.claude/skills/deckprobe`, плагин командой `/plugin`.
Частые вопросы
Как поставить DeckProbe в Claude Code?
Установите CLI и выполните `deckprobe install --skills --agent claude -g`, либо возьмите скилл через `npx skills add deckflow/deckprobe`. Есть и плагин: `/plugin marketplace add deckflow/deckprobe` и `/plugin install deckprobe@deckflow`.
Есть ли MCP-сервер у DeckProbe?
Да, это отдельный проект deckprobe-mcp-server: `claude mcp add deckprobe -- npx -y @deckflow/deckprobe-mcp`. Он дает четыре инструмента: `probe`, `probe_batch`, `list_formats` и `list_targets`.
Какие форматы читает DeckProbe?
PDF, Word, Excel, PowerPoint, старые `.doc`, `.xls`, `.ppt` и файлы Keynote, Numbers и Pages.
Нужен ли Microsoft Office для работы?
Нет. Нативному CLI не нужны Office, Python, JVM или внешние библиотеки для PDF.
Как обработать пачку документов?
Подайте строки JSON с полями `id` и `path` в `deckprobe --jsonl -t @summary`. На каждую непустую строку выходит отдельный компактный результат.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыDeckuse, CLI и скилл для агентов, правит PPTX и DOCX локально командами JSON с версиями рабочей папки, проверкой и откатом.
office-oxide-mcp — Office и PDF для ИИ-агентов
office-oxide-mcp
MCP-сервер на Rust читает и создает Excel, Word, PowerPoint и PDF локально и заполняет формы PDF с вашего подтверждения
Скилл и программа docx: агент заполняет формы, правит таблицы и ведет рецензирование Word с отслеживаемыми правками
Утилита создает презентации PPTX, документы DOCX, таблицы XLSX, отчеты и картинки по текстовому запросу из терминала или скрипта.
Порт docling на Rust превращает PDF, Office, HTML и сканы в Markdown и JSON одним бинарником, с режимом MCP-сервера
doc-cleaner переводит PDF, Office, Keynote, Numbers и EPUB в чистый Markdown: таблицы целы, кодировки Big5 и CP950 читаются.
Коротко о README
Сначала идут установка (из исходников, готовым архивом, через npm), быстрый старт и примеры целей. Затем описаны скилл для агента, MCP-сервер, браузерный SDK и таблица поддерживаемых форматов. DeckProbe входит в состав платформы DeckFlow как проверка перед разбором и отрисовкой.