Kanban Pro

Синхронизация в облаке

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

Как работает облачная синхронизация

Kanban Pro — это приложение с локальным приоритетом. Каждый проект — это папка в вашей файловой системе, содержащая файлы билетов Markdown и каталог конфигурации .kanban/. Нет учетных записей, нет собственных облачных сервисов и нет регистраций.

Для сотрудничества с другими просто поместите папку проекта в синхронизируемый с облаком каталог — iCloud Drive, Dropbox, Google Drive, OneDrive или любой сетевой диск. Каждый участник открывает одну и ту же папку в Kanban Pro, и изменения автоматически распространяются через службу синхронизации файлов поставщика облака.

Подсказка

Учетная запись Kanban Pro не требуется. Синхронизация использует файловую систему напрямую — если ваш поставщик облака может синхронизировать папку, Kanban Pro будет работать с ней.

Настройка общего проекта

  1. Выберите папку облака. Откройте Finder и перейдите в каталог синхронизации вашего поставщика облака (например, ~/Library/Mobile Documents/com~apple~CloudDocs/ для iCloud Drive, ~/Dropbox/ для Dropbox или монтирование Google Drive / OneDrive в боковую панель Finder).
  2. Создайте папку проекта. Создайте новую папку для вашего проекта, например Доска команды.
  3. Откройте его в Kanban Pro. Запустите Kanban Pro, нажмите Открыть папку и выберите только что созданную папку. Kanban Pro инициализирует каталог .kanban/ и вы можете начать добавлять столбцы и билеты.
  4. Поделитесь папкой. Используйте функции общего доступа вашего поставщика облака для приглашения соавторов. В iCloud Drive щелкните правой кнопкой мыши на папке и выберите Поделиться. В Dropbox или Google Drive используйте диалог общего доступа. В OneDrive щелкните правой кнопкой мыши и выберите Поделиться → Поделиться через OneDrive. Каждый соавтор должен открыть одну и ту же синхронизируемую папку в собственной копии Kanban Pro.

Подсказка

При общем доступе установите разрешения на Может редактировать (не Может просматривать), чтобы соавторы могли создавать и обновлять билеты.

Рекомендуемая структура папок

Когда Kanban Pro инициализирует проект, он создает следующую структуру в выбранной папке:

Доска команды/
  .kanban/ — конфигурация проекта
    board.json — столбцы, настройки, пользовательские поля
    locks/ — активные блокировки редактирования (см. ниже)
    activity/ — записи журнала активности
  attachments/ — загруженные изображения и файлы
  KAN-1.md — билет (Markdown + YAML frontmatter)
  KAN-2.md
  KAN-3.md

Каждый билет — это простой файл Markdown с YAML frontmatter для метаданных (статус, приоритет, назначенное лицо, теги, пользовательские поля). Вы можете читать, редактировать или архивировать эти файлы любым инструментом — включая агентов кодирования ИИ, работающих непосредственно с файловой системой.

Синхронизация в реальном времени и редактирование без конфликтов

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

Как избежать конфликтов

  • Блокировка билета: Когда вы открываете билет для редактирования, Kanban Pro создает небольшой файл блокировки внутри .kanban/locks/. Другие пользователи видят билет как заблокированный и не могут перезаписать ваши изменения. Файлы блокировки синхронизируются через вашего поставщика облака, поэтому все соавторы видят одно и то же состояние блокировки.
  • Атомарные записи: Каждый билет — это один файл Markdown. Kanban Pro сначала записывает во временный файл, а затем переименовывает его на место — предотвращая частичные обновления, даже если поставщик облака синхронизирует во время записи.
  • Обнаружение завершения записи: Kanban Pro ждет стабилизации файлов (2 секунды для билетов, 1 секунда для конфигурации доски) перед их чтением. Это гарантирует, что облачная синхронизация завершила запись перед обработкой приложением изменения.
  • Последняя запись побеждает для конфигурации доски: Порядок столбцов, настройки и определения пользовательских полей хранятся в board.json. Если два пользователя одновременно меняют настройки доски, побеждает последняя запись — но в практике это редко, так как конфигурация доски меняется нечасто.

Понимание файлов блокировки

Каталог .kanban/locks/ содержит временные файлы блокировки, указывающие, какие билеты в настоящее время редактируются и кем. Каждый файл блокировки — это небольшой документ JSON:

{
  "ticket": "KAN-42",
  "user": "Alice",
  "device": "Alice-MacBook",
  "timestamp": "2026-03-09T10:30:00Z"
}

Файлы блокировки создаются при открытии билета для редактирования и удаляются при закрытии редактора. Они позволяют Kanban Pro отображать визуальный индикатор на заблокированных билетах, чтобы соавторы знали, что кто-то работает над ними.

Разрешение старых блокировок

Если Kanban Pro упадет или устройство отключится, файл блокировки может остаться неочищенным. Это называется старой блокировкой.

Старая блокировка?

Если билет выглядит заблокированным, но никто его не редактирует, вы можете безопасно удалить соответствующий файл в .kanban/locks/ с помощью Finder или терминала. Kanban Pro обнаружит удаление и разблокирует билет.

Kanban Pro также обнаруживает блокировки старше 24 часов и помечает их как потенциально старые в интерфейсе, давая вам возможность принудительно разблокировать прямо из приложения.

Примечания поставщика облака

iCloud Drive

iCloud Drive работает без проблем с Kanban Pro. macOS держит недавно отвлекаемые файлы загруженными локально, поэтому ваша доска загружается мгновенно. Если файл билета был вытеснен из локального хранилища (отображается как небольшой файл-заполнитель .icloud в Finder), macOS загружает его по требованию — вы можете заметить небольшую задержку при открытии очень больших проектов в первый раз.

Общий доступ к папке iCloud Drive

  1. Откройте Finder и перейдите в папку iCloud Drive в боковой панели.
  2. Щелкните правой кнопкой мыши на папке проекта и выберите Поделиться → Сотрудничество.
  3. Установите разрешения на «Только приглашенные люди» и «Может делать изменения».
  4. Введите адреса электронной почты ваших соавторов и нажмите Поделиться.

Подсказка

Чтобы файлы проекта всегда были доступны на вашем Mac, щелкните правой кнопкой мыши на папке проекта в Finder и выберите Сохранить загруженным. Это предотвращает удаление файлов macOS для экономии места.

Dropbox

Dropbox хорошо работает с Kanban Pro, но функция Smart Sync может удалить файлы билетов для экономии места на диске. Для лучшей производительности отметьте папку проекта как Доступно в режиме без сети, чтобы все файлы оставались на вашем Mac.

Настройка доступа в автономном режиме

  1. Откройте Finder и перейдите в папку Dropbox.
  2. Щелкните правой кнопкой мыши на папке проекта.
  3. Выберите Доступно в режиме без сети.
  4. Зеленая галочка подтверждает, что папка теперь хранится локально.

Общий доступ к папке Dropbox

  1. Щелкните правой кнопкой мыши на папке проекта в Finder.
  2. Нажмите на Поделиться… (рядом со значком Dropbox).
  3. Нажмите Добавить людей, введите адреса электронной почты и установите разрешения на Может редактировать.
  4. Нажмите Поделиться, чтобы отправить приглашение.

Google Drive

Google Drive for Desktop предлагает два режима синхронизации. Для Kanban Pro настоятельно рекомендуется режим Mirror файлов, поскольку он сохраняет полную локальную копию вашего проекта — обеспечивая мгновенный доступ без задержек загрузки.

Переключение в режим Mirror

  1. Нажмите на значок Google Drive на панели меню.
  2. Откройте Параметры.
  3. В разделе «Параметры синхронизации My Drive» выберите Mirror файлов.
  4. Google Drive загрузит все файлы на ваш Mac. Это может занять много времени для больших библиотек.

Предупреждение

Режим по умолчанию «Потоковая передача файлов» загружает файлы по требованию, что может вызвать заметную задержку, когда Kanban Pro читает файлы билетов. Переключитесь в режим Mirror для лучшего опыта.

Общий доступ к папке Google Drive

  1. Щелкните правой кнопкой мыши на папке проекта в Finder (внутри монтирования Google Drive).
  2. Нажмите на Поделиться.
  3. Введите адреса электронной почты соавторов и установите доступ на Редактор.
  4. Нажмите Поделиться, чтобы отправить приглашение.

OneDrive

OneDrive for Mac хорошо работает с Kanban Pro. Как и другие облачные сервисы, OneDrive предлагает функцию «Файлы по требованию», которая может удалить файлы из локального хранилища. Для лучших результатов установите папку проекта на Всегда сохранять на этом устройстве.

Локальное сохранение файлов

  1. Откройте Finder и перейдите в папку OneDrive.
  2. Щелкните правой кнопкой мыши на папке проекта.
  3. Выберите Всегда сохранять на этом устройстве.
  4. Зеленая галочка подтверждает, что папка останется загруженной.

Общий доступ к папке OneDrive

  1. Щелкните правой кнопкой мыши на папке проекта в Finder.
  2. Выберите Поделиться → Поделиться через OneDrive.
  3. Введите адреса электронной почты соавторов и установите разрешения на Может редактировать.
  4. Нажмите Отправить.

Подсказка

Избегайте специальных символов в имеках папок или файлов (:, *, ?, |) — OneDrive их не поддерживает, и они могут вызвать ошибки синхронизации.

Сетевые диски и NAS

Kanban Pro работает с любым подмонтированным сетевым томом (SMB, AFP, NFS). Убедитесь, что диск остается подмонтированным при работе. Если сетевое соединение прерывается, Kanban Pro приостановит наблюдение за файлами и возобновит работу, когда том станет доступным снова.

Лучшие практики

  • Сохраняйте папки проекта доступными в режиме без сети. Отметьте папку проекта как «Доступно в режиме без сети», «Mirror файлов», «Всегда сохранять на этом устройстве» или «Сохранить загруженным» в зависимости от вашего поставщика облака. Это предотвращает задержки, вызванные загрузкой файлов по требованию.
  • Сохраняйте структуру папок плоской. Избегайте глубоко вложенных каталогов — плоская структура улучшает надежность синхронизации у всех поставщиков.
  • Проверьте статус синхронизации перед закрытием Mac. Ищите значки синхронизации в процессе в Finder или на панели меню. Выключение во время синхронизации может оставить частичные файлы, которые запутают соавторов.
  • Поддерживайте свободное место для хранения. Оставляйте не менее 10-15% свободного места на диске Mac и не менее 20% свободного облачного хранилища. Низкое хранилище может остановить синхронизацию или вызвать удаление файлов.
  • Используйте одного поставщика облака в команде. Смешивание поставщиков (например, один человек на iCloud, другой на Dropbox) требует, чтобы каждый человек имел свою копию — они не будут синхронизироваться друг с другом.

Устранение неполадок

  • Изменения не отображаются: Проверьте, что ваш поставщик облака активно синхронизируется. Ищите значки состояния синхронизации в Finder или на значке меню поставщика облака. Kanban Pro обновляется в течение секунд от обнаружения изменения файла — если файл еще не синхронизирован, приложение не может его видеть.
  • Билет застрял в заблокированном состоянии: См. раздел о старых блокировках выше. Вы можете принудительно разблокировать из приложения (для блокировок старше 24 часов) или вручную удалить файл блокировки в .kanban/locks/.
  • Отсутствующие билеты после синхронизации: Некоторые поставщики облака замедляют синхронизацию новых файлов. Подождите и проверьте статус синхронизации вашего поставщика. Если проблема сохраняется, убедитесь, что папка установлена для синхронизации в режиме без сети. В iCloud Drive проверьте, что файлы не были заменены файлами-заполнителями .icloud.
  • Медленная начальная загрузка: Если ваш поставщик облака потоком файлы по требованию, первая загрузка может занять больше времени при загрузке файлов. Переключитесь на режим без сети или зеркала для лучшей производительности.
  • Синхронизация неожиданно приостановлена: Некоторые поставщики облака приостанавливают синхронизацию, когда ваш Mac работает от батареи или имеет мало места на диске. Проверьте значок меню вашего поставщика на предмет индикаторов паузы и возобновите синхронизацию при необходимости.
  • Отображаются файлы конфликтных копий: Если вы видите файлы с названием «Конфликтная копия» в Finder, два человека, вероятно, редактировали один и тот же файл в режиме без сети. Откройте оба файла для сравнения, сохраните правильную версию и удалите конфликтную копию.