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

У команды есть папка — на сервере, на общем диске отдела, на 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 года.

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, раздел «Дежурные».

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` со стандартного ввода.

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

• Папка на машине с коннектором (или смонтированный ОС сетевой диск) — доступная на чтение пользователю подключения; в контейнере — проброшенная внутрь.
• Для сетевой папки без монтирования — сервер 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. Диаграммы, картинки и внедрённые объекты в них не переводятся.