Lark Markdown (v1)

Просмотр, создание, загрузка, редактирование и сравнение Markdown-файлов в Lark / Feishu через CLI lark-cli.

ВАЖНО — перед началом обязательно прочитайте ../lark-shared/SKILL.md с помощью инструмента Read. Там содержится информация об аутентификации и обработке прав доступа.

Быстрое принятие решений

• Идентификация: Markdown-файлы обычно принадлежат облачному хранилищу пользователя — приоритетно используйте --as user. Для автоматизированных сценариев или когда приложение само создало и владеет целевым файлом используйте --as bot. Перед первым доступом от имени user выполните lark-cli auth login.
• При сбое markdown +create / +overwrite сначала определите, связано ли это с идентификацией и правами: для bot чаще всего это scope приложения или ACL целевой директории; для user — авторизация или ACL пользователя. Не меняйте идентификацию без разбора.

Когда использовать какую команду

• Загрузить / создать нативный .md-файл: lark-cli markdown +create
• Сравнить исторические версии .md-файла или удалённый Markdown с локальным черновиком: lark-cli markdown +diff
• Прочитать содержимое .md-файла из Drive: lark-cli markdown +fetch
• Частичная замена / замена по регулярному выражению: lark-cli markdown +patch
• Перезаписать .md-файл в Drive: lark-cli markdown +overwrite
• Получить номер исторической версии перед сравнением/скачиванием/откатом: используйте lark-cli drive +version-history из lark-drive
• Импортировать Markdown как онлайн-документ (docx): не используйте этот скилл — используйте lark-cli drive +import --type docx из lark-drive
• Переименование / перемещение / удаление / поиск / права / комментарии: переключитесь на lark-drive

Ключевые границы

• Этот скилл работает с Markdown-файлами как обычными файлами в Drive, а не с docx-документами.
• --name и локальные имена файлов --file должны явно иметь расширение .md.
• --content поддерживает: прямую строку, @file для чтения из локального файла, - для stdin.
• markdown +patch семантически означает: скачать весь Markdown, заменить локально, загрузить целый файл обратно.
• markdown +patch — не атомарный серверный patch; это организованное на стороне CLI частичное обновление.
• Итоговое содержимое после замены не может быть пустым.

Экранирование при регулярных выражениях

# ПЛОХО: специальные символы regexp не экранированы
lark-cli markdown +patch --file-token boxcnxxxx --regex --pattern "version (1.0)" --content "version (2.0)"

# ХОРОШО: явное экранирование скобок и точки
lark-cli markdown +patch --file-token boxcnxxxx --regex --pattern "version \\(1\\.0\\)" --content "version (2.0)"

Команды (shortcuts)

Связанные скиллы

• lark-shared — аутентификация и глобальные параметры
• lark-drive — управление файлами Drive: импорт в docx, перемещение/удаление/поиск и т.д.