Доступ и роли

Выделите пробную общую папку. Проверьте чтение и запись с выбранной ролью. Участник с правом только чтения не должен получать запись. После удаления участника проверьте новые обращения, уже открытое соединение, отдельные ключи и публикации. Локальные ранее скачанные копии сохраняются.

Подключение агента

Для агента используйте отдельный ключ на выбранную общую папку. Ключ не ограничивает доступ отдельным файлом или подпапкой внутри неё. Явно выбирайте минимальные разрешения: только read для чтения, read и write для чтения и изменения. По умолчанию при создании ключа API выбирает оба разрешения.

Секрет ключа не включайте в заметки, скриншоты и обращения в поддержку. Перед рабочим подключением проверьте чтение, запрет записи для ключа только с read и отказ после отзыва на пробной папке. Отзыв ключа - отдельное действие; изменение разрешений не заменяет отзыв.

Условная запись через REST

Условная запись предусмотрена для PUT /v1/shares/{share_uuid}/sync-write с путём файла в параметре path. При изменении прочитанного файла передавайте в If-Match его сохранённый SHA256: ETag из ответа download или sha256 из files-index. При создании нового файла передавайте If-None-Match: *.

Ответ 412 Precondition Failed означает, что условие записи не выполнено: перечитайте актуальный файл, проверьте изменения и только затем повторяйте операцию. Без условия записи сервер возвращает 428 Precondition Required.

Проверка сравнивает версию сохранённого файлового артефакта. Она не является гарантией сохранности результата и не подтверждает учёт ещё не сохранённых изменений живой совместной сессии.

Подключение через MCP

В проверенной версии подключения через MCP операция upsert_file не передаёт условие версии. Описанная выше защита REST не применяется к этой операции автоматически. Для работы, требующей условной записи, используйте соответствующий REST endpoint.

Клиент, способ авторизации и доступные операции сверяйте с инструкцией к используемой версии. Не выдавайте ключ с записью, если агенту нужно только чтение.

При ошибке укажите версию клиента, время, операцию и код ответа; ключ и содержимое личных файлов не отправляйте.

Перед публикацией

Проверьте выбранную заметку и её вложения. Определите, кому должна открываться ссылка. Для публичного материала используйте отдельную сессию читателя и убедитесь, что результат соответствует намерению автора. После прекращения публикации проверьте старую ссылку повторно. Уже скачанные копии могут сохраниться у читателя.

Если нужный режим или результат проверки неясны, уточните возможность до отправки ссылки.

Собственное развёртывание

Начните с инструкции выбранной версии. Сверьте компоненты, авторизацию, адреса и внешние зависимости. До рабочих данных проверьте подключение клиента и восстановление копии.

Проверки и ошибки

Не находится плагин.

Проверьте имя Team Relay Sync и идентификатор team-relay-sync. Не устанавливайте одноимённые дополнения другого проекта. Проверка установки.

Не открывается общая папка.

Проверьте выбранный сервис, аккаунт и приглашение. RU и Entire - разные подключения. Попросите владельца сверить членство и роль.

Не видны изменения.

Сохраните копию важного материала. Проверьте подключение и пробный обмен в обе стороны. Не продолжайте массовые изменения до выяснения причины.

Ошибка агента.

Запишите версию клиента, операцию, время и код ответа. При 412 перечитайте актуальную версию и проверьте изменения; не повторяйте запись вслепую.

В обращении укажите устройство, версии Obsidian и Team Relay Sync, сервис и шаг ошибки. Пароли, ключи и личные заметки отправлять не нужно.

Team Relay

Обращение в поддержку

Не отправляйте пароли, ключи и содержимое рабочих заметок.