Bruce Doc Converter CLI
CLI bdc для агентов: Word, Excel, PowerPoint и PDF превращаются в Markdown, а Markdown с диаграммами Mermaid в документ Word.
- 60 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI читает и перезаписывает документы в указанных папках, а `bdc setup-node` ставит зависимости Node.js на машину.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/bruce-doc-converterОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI читает и перезаписывает документы в указанных папках, а `bdc setup-node` ставит зависимости Node.js на машину.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Bruce Doc Converter добавляет агенту двустороннее преобразование документов. Команда `bdc convert` превращает Word, Excel, PowerPoint и PDF в удобный модели Markdown, а Markdown экспортирует в Word и сама рисует диаграммы Mermaid. Пакетный режим `bdc batch` обходит целый каталог. Вывод по умолчанию идет в stdout как JSON, ход работы пишется в stderr. Режим `--strict` отвергает результат при потерях содержимого: пустых страницах, формулах без кеша, не встроенных картинках, сбое Mermaid. Параметр `--content` задает полный текст, предпросмотр или его отсутствие, а `--manifest` пишет построчные итоги в отдельный JSONL. В репозитории есть скилл `bruce-doc-converter-skill` с описанием диагностики и установки.
Для кого. Тем, кто готовит документы для агента: аналитикам и техписателям, которым нужно читать офисные файлы и выдавать отчеты в Word.
Подходит, если
- Отчет в PDF и таблица Excel должны превратиться в Markdown для разбора агентом.
- Заметки в Markdown с диаграммами Mermaid нужно выдать оформленным Word-документом.
- Папка из сотен файлов обходится одной командой с построчным манифестом.
- Потеря содержимого недопустима: `--strict` вернет ошибку вместо тихого пропуска.
Не подходит, если
- Нужен точный сложный макет: сканы без текстового слоя и формулы вытягиваются с предупреждениями.
- Среда без Node.js: экспорт Markdown в Word требует отдельных зависимостей Node.
- Нужен вывод в PDF или PowerPoint: поддерживается только Word.
Пример запроса к агенту
Конвертируй budget.xlsx и report.docx командой bdc с режимом --strict и покажи, какие части файлов пропущены.Ограничения
Нужен Python 3.8 или новее. Экспорт Markdown в Word требует Node.js и разовой команды `bdc setup-node`: она ставит зависимости через `npm ci --ignore-scripts`, чтобы не запускать сценарии сторонних пакетов. Диаграммы Mermaid рисует найденный на машине Chrome, Edge или Chromium, браузер не скачивается. Пустую страницу трудно отличить от скана, поэтому обе дают предупреждение, а `--strict` отвергает результат. Ограничение `--max-results` действует только вместе с `--manifest`.
Как отключить. Удалите пакет командой `pipx uninstall bruce-doc-converter` или `uv tool uninstall bruce-doc-converter`, а папку скилла уберите из каталога скиллов агента.
Частые вопросы
Как установить bdc?
Первым вариантом из README: `pipx install bruce-doc-converter`. Запасные: `uv tool install bruce-doc-converter`, `pip3 install --user bruce-doc-converter` или установка в `venv`.
Что нужно для экспорта в Word?
Выполните `bdc setup-node` один раз: команда ставит зависимости Node.js без запуска сторонних сценариев. Для Mermaid используется локальный Chrome, Edge или Chromium.
Как не потерять содержимое?
Добавьте `--strict`: пустые страницы, формулы без кеша, не встроенные картинки и сбои Mermaid превращаются в отказ вместо тихой потери.
Как обработать целую папку?
Командой `bdc batch /путь/к/папке`; с `--manifest` итоги по каждому файлу уходят в отдельный JSONL, а `--jsonl` печатает строку после каждого файла.
В каком виде приходит результат?
JSON в stdout. Параметр `--content` задает полный текст, предпросмотр или его отсутствие.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл и CLI от Firecrawl: агент переводит Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV и PDF в Markdown на вашей машине
Скилл и CLI превращают Markdown в DOCX, PDF, PPTX, XLSX, PNG и еще десяток форматов, все считается локально
doc-cleaner переводит PDF, Office, Keynote, Numbers и EPUB в чистый Markdown: таблицы целы, кодировки Big5 и CP950 читаются.
Скилл и программа docx: агент заполняет формы, правит таблицы и ведет рецензирование Word с отслеживаемыми правками
MCP-сервер Word to Markdown: агент превращает файл .docx в чистый Markdown локально, с картинками, таблицами и сносками.
CLI для создания и правки Word, Excel и PowerPoint агентом: один бинарник без установки Office и без сторонних библиотек
Коротко о README
README задает контракт для агента: один JSON-конверт на команду, предупреждения с кодами вроде `MATH_NOT_CONVERTED` и повторяемые ошибки с полем `next_command`.