API ВЕГА

Работает с обычными Markdown-файлами в Drive: загружает их, создаёт, читает, обновляет и сравнивает версии. Подходит, когда нужно изменить файл в облаке или сверить его с локальным черновиком; для обычных локальных файлов и импорта в онлайн-документ нужен другой инструмент.

Возможности

  • Создаёт Markdown-файлы в Drive через lark-cli markdown +create.
  • Читает содержимое файла через +fetch, перезаписывает его через +overwrite.
  • Сравнивает удалённые версии или удалённый файл с локальным через +diff.
  • Выполняет локальную замену текста или регулярного выражения через +patch: скачивает файл, заменяет текст и загружает файл целиком.
  • Принимает содержимое через строку, @file или stdin. Для --file и --name требуется расширение .md.
  • Не предназначен для поиска файлов, управления доступом, комментариев, перемещения, удаления и импорта Markdown в онлайн-документ.

Когда использовать

  • Нужно создать или загрузить обычный .md-файл в Drive.
  • Нужно прочитать или обновить Markdown-файл в Drive.
  • Нужно сравнить версии файла или удалённый файл с локальным черновиком.
  • Нужно заменить фрагмент в облачном Markdown-файле.

Примеры

Для замены с регулярным выражением экранируйте специальные символы:

lark-cli markdown +patch --file-token boxcnxxxx --regex --pattern "version \\(1\\.0\\)" --content "version (2.0)"

Установка

npx skills add https://github.com/larksuite/cli --skill lark-markdown