# Файлы на диске — интеграция для Buff

> Папки на сервере и сетевые папки SMB как контекст: Word, Excel, PowerPoint — новые и старые форматы, — PDF и текст. Только чтение, без индекса.

[Маркетплейс](https://buff.systems/marketplace) Файлы на диске

# Файлы на диске

Документы компании · издатель buff · версия 1.0.3

Папки на сервере и сетевые папки SMB как контекст: Word, Excel, PowerPoint — новые и старые форматы, — PDF и текст. Только чтение, без индекса.

[Скачать коннектор](https://buff.systems/downloads) [Как установить](https://buff.systems/#usage) 3 из 3 инструментов только читают

- Ответ в Buff опирается на PDF с сетевой папки — с именем файла и папкой.
- Форма настройки: папки — в том числе сетевые — и исключения.
- Подключение работает: три инструмента, все только читают; рядом — сетевая папка, к которой оно ходит по SMB.
- Проверка связи: сколько отмеченных папок доступно и под какой учётной записью читается сетевая папка.
- Что интеграция получит, видно в каталоге до установки — включая то, что пароль передаётся ей самой.

Нажмите на снимок, чтобы открыть его целиком. Все снимки — с работающей установки.

## Обзор

У команды есть папка — на сервере, на общем диске отдела, на NAS, — где лежит то, чего нет ни в задаче, ни в коде: регламенты в Word, бюджеты и реестры в Excel, планы в PowerPoint, договоры в PDF, заметки в текстовых файлах. Интеграция даёт Buff читать эту папку так, как читает человек, — теми же тремя инструментами, которыми модель работает с файлами проекта: найти по имени, найти по содержимому, прочитать. Локальная папка или сетевая по SMB, форматы Office 2007+ и 97–2003, PDF. Только чтение; ничего не индексируется и не копируется — файл читается в момент вопроса.

## Сценарии

Ситуации, ради которых его ставят.

- ### Договор лежит в PDF на общем диске Аналитика спрашивают, какие сроки и суммы зафиксированы в договоре с подрядчиком. Договор — PDF в папке «Юристы/2026» на сетевом диске; в трекере его нет, в код он не попадёт никогда. Результат. Бот находит файл по слову «договор» в содержимом, читает PDF постранично и отвечает по нему — с полным путём к файлу, чтобы ответ можно было проверить.
- ### Регламент в Word 2003, который никто не переводил Инструкция по восстановлению из архива написана в 2019 году в .doc и с тех пор лежит в папке «old». Спросить некого: автор ушёл, а открывать старый формат лень. Результат. Старый формат читается так же, как новый: интеграция разбирает бинарный документ Word 97–2003 и отдаёт текст — абзацы, списки, ячейки таблиц.
- ### Лимиты записаны в таблице Разработчик пишет интеграцию с Jira и хочет знать лимит запросов в минуту, который согласовали с безопасностью. Лимиты ведут в Excel — лист «Лимиты», строка на систему. Результат. Бот ищет «Jira» по содержимому, находит строку на листе «Лимиты» и отвечает числом из таблицы. Даты в таблице приходят датами, а не числом дней с 1900 года.

## Примеры

Что написать и что придёт в ответ. Обращение к боту задаётся в настройках подключения — здесь это «@buff».

1. Какой номер у договора оказания услуг с ИП Кунгур и до какого срока он действует? Найди в файлах. «Спросить» в Buff инструмент: `grep → read` Договор № 77-АБ/2026, срок действия — до 31 декабря 2026 года. Источник: smb://nas/docs/2026/contracts/contract.pdf, страница 1.
2. Какие презентации по дорожной карте есть за 2026 год? комментарий в задаче инструмент: `glob` В /srv/docs/2026 две презентации: roadmap.pptx (обновлена 12 сентября) и roadmap-q3.pptx (июль).
3. Что написано в разделе «Дежурные» регламента выпуска релизов? исследование инструмент: `read` Таблица «Дежурные»: пятница — Кунгур, суббота — Воронцов. Документ: /srv/docs/regulations.docx, раздел «Дежурные».

## Что умеет

### Три инструмента, как у файлов проекта

\`glob\` ищет файлы по имени (\`\*.docx\`, \`\*\*/договор\*\`), \`grep\` — по содержимому регулярным выражением, \`read\` читает файл целиком пронумерованными строками или папку списком. Имена, параметры и формат ответа — те же, что у файлов проекта: модели не нужны новые привычки. Ничего не ограничивается: ни число найденных, ни число строк, ни их длина; страницами файл читается лишь по просьбе модели.

### Office и PDF — как текст

Документ Word приходит как markdown с заголовками, списками, таблицами и ссылками; таблица Excel — каждый лист таблицей, даты — датами; презентация — слайд за слайдом с заметками докладчика; PDF — постранично. Форматы 97–2003 (\`.doc\`, \`.xls\`, \`.ppt\`) читаются так же — интеграция разбирает их сама. Формат узнаётся по содержимому, а не по расширению; то, что прочитать нельзя, называется по виду и размеру.

### Сетевая папка без монтирования

Корень вида \`\\\\nas\\docs\\specs\` интеграция читает сама по SMB — с самого первого пакета по SMB2, без SMB1-приветствия, которое на современных серверах и NAS отключено; вход по NTLMv2, подпись сессии — если сервер требует. Нужна учётная запись только на чтение: коннектор передаёт её интеграции, и это единственный вид учётных данных, который интеграция видит, — каталог говорит об этом до установки.

### Область — корни и исключения

Бот работает в корнях и во всём, что вложено; корнем может быть и отдельный файл. Исключения — \`\*.bak\`, \`~$\*\`, \`.git\` — прячут файл и от поиска, и от списка папки. Путь вне корней не читается, даже если модель назовёт его точно. Пустой список корней — весь диск машины с коннектором; к сетевым папкам это не относится: они доступны только через корень, потому что к ним ходят с паролем.

## Как пользоваться

Всё происходит на машине, где стоит коннектор. Открывать доступ к вашей сети снаружи не нужно ни на одном шаге.

1. Шаг 1 ### Установка и права Установите интеграцию из каталога на локальной странице коннектора. Она работает под отдельным пользователем ОС, так что локальные файлы должны быть ему доступны на чтение (\`chmod -R a+rX\` или общая группа); коннектору в контейнере папку нужно пробросить (\`-v /srv/docs:/srv/docs:ro\`). **Коннектор** ← прокрутите кадр → Границы доступа написаны в карточке каталога.
2. Шаг 2 ### Настройка — корни, исключения, учётная запись Назовите корни через запятую — локальные пути и сетевые папки в любом написании (\`\\\\сервер\\папка\`, \`smb://сервер/папка\`), при желании исключения. Для сетевых корней — учётная запись (\`CORP\\svc-buff\`) и пароль; для локальных ничего больше не нужно. **Коннектор** ← прокрутите кадр → Поля формы — свои у каждой интеграции.
3. Шаг 3 ### То же самое из командной строки Установка без графики равноправна: \`connector install files\`, затем \`connector instance set --plugin files --version 1.0.0 --set roots=/srv/docs,\\\\nas\\docs --set excludes=\*.bak\`, пароль — \`connector instance secret … --secret share --account CORP\\svc-buff\` со стандартного ввода.

## Границы доступа

То же самое коннектор показывает на вашей машине до установки. Список берётся из подписанного каталога, а не написан здесь руками.

Ходит наружу

по HTTP — никуда; свои соединения открывает сама: `smb` к адресам из поля `roots`, порт 445

Учётные данные

share — share передаётся самой интеграции: её протокол коннектор за неё не говорит

Вебхуки

не принимает

| Инструмент | Что делает | Доступ |
| --- | --- | --- |
| glob | Найти файлы по имени — шаблон вида \*.docx или \*\*/договор\*, во всех указанных папках или в одной; новые сначала | только чтение |
| grep | Найти по содержимому — регулярное выражение по тексту документов, таблиц, презентаций, PDF и текстовых файлов; файл, номер строки, строка | только чтение |
| read | Прочитать файл текстом (документ — markdown, таблица — листами, презентация — слайдами, PDF — постранично) или папку списком; целиком, страницами — по offset/limit | только чтение |

Интеграция работает отдельным процессом под собственным пользователем операционной системы: она не видит ключа коннектора, не читает файлы других подключений и не может выйти в сеть мимо коннектора — кроме соединений, объявленных выше. Подробнее — в [разделе о безопасности](https://buff.systems/security).

## Требования

- Папка на машине с коннектором (или смонтированный ОС сетевой диск) — доступная на чтение пользователю подключения; в контейнере — проброшенная внутрь.
- Для сетевой папки без монтирования — сервер SMB 2.0.2 или 2.1 (Windows Server 2008 R2 и новее, Samba, NAS) и учётная запись только на чтение; сервер, требующий только SMB3 с шифрованием, подключается через монтирование ОС.
- Коннектор версии 0.11 или новее: учётные данные, которые передаются интеграции, и декларация её собственных соединений появились в нём; старый коннектор откажется ставить интеграцию и назовёт обе версии.
- Коннектор, запущенный с правом заводить отдельного пользователя ОС для интеграции (root или CAP\_SETUID).

## Вопросы

- **Бот сможет что-то изменить или удалить?**: Нет. У интеграции три инструмента, и все только читают; инструментов записи нет вовсе. Сетевую папку разумно открыть учётной записи только на чтение — тогда это гарантирует ещё и сервер.
- **Почему пароль от сетевой папки передаётся интеграции — у остальных ведь нет?**: SMB — не HTTP: подставить пароль в запрос за плагин коннектор не может, протокол говорит сам плагин. Поэтому этот вид учётных данных объявлен в манифесте отдельно, каталог показывает его до установки, а каждая выдача записывается в журнал. Пароль не нужен вовсе, если диск смонтирован средствами ОС и подключён как локальная папка.
- **Большая папка — это долго?**: Поиск по содержимому читает и разбирает файлы в момент запроса — ничего не индексируется, это осознанное решение: содержимое не копируется к нам. Сузьте область корнями и исключениями; модель, зная папку, укажет её или шаблон имён, и поиск пойдёт по меньшему.
- **Сканы читаются?**: Нет. PDF читается по текстовому слою; у скана его нет, и интеграция так и скажет — «нет текстового слоя, страниц: N». Распознавание текста в неё не входит.
- **Старые .doc, .xls, .ppt читаются или только новые?**: И те и другие. Форматы 97–2003 интеграция разбирает сама: текст, списки и ячейки таблиц из Word, листы с числами и датами из Excel, текст слайдов и заметки из PowerPoint. Диаграммы, картинки и внедрённые объекты в них не переводятся.

Коротко

- **Версия**: 1.0.3
- **Издатель**: buff
- **Обновлён**: 2026-10-05
- **Размер**: 610 КБ
- **Инструментов**: 3, только читают 3
- **Учётные данные**: share
- **Вебхуки**: не принимает
- **Платформы**: linux-x86\_64, linux-aarch64

[Документация коннектора](https://buff.systems/docs/connector) [Как это устроено с точки зрения ИБ](https://buff.systems/security) [Задать вопрос об интеграции](https://buff.systems/contact)

На этой странице

- [Обзор](https://buff.systems/#overview)
- [Сценарии](https://buff.systems/#use-cases)
- [Примеры](https://buff.systems/#examples)
- [Что умеет](https://buff.systems/#abilities)
- [Как пользоваться](https://buff.systems/#usage)
- [Границы доступа](https://buff.systems/#access)
- [Требования](https://buff.systems/#requirements)
- [Вопросы](https://buff.systems/#faq)

Дальше

## Подключить Файлы на диске

Поставьте коннектор в своей сети, откройте его локальную страницу и установите интеграцию из каталога. Пересобирать ничего не нужно.

[Скачать коннектор](https://buff.systems/app) [Написать нам](mailto:info@buff.systems)

Юрлицам и ИП — оплата переводом по реквизитам и закрывающие документы