Сводка

Операции с Markdown-файлами Feishu Drive: создание, чтение, редактирование, патчинг и сравнение нативных файлов .md.

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

• Операция патча скачивает полный файл, применяет замены локально, затем повторно загружает; поддерживает пары образец-содержимое и не допускает пустых результатов

• Имена файлов должны явно иметь суффикс .md; входные данные содержимого принимают строки, локальные файлы через @file, или stdin через -

• Требуется бинарник lark-cli и аутентификация через общие учетные данные Feishu; задачи по управлению файлами, такие как переименование, перемещение, удаление и разрешения, относятся к lark-drive skill

markdown (v1)

КРИТИЧЕСКОЕ — Перед началом ОБЯЗАТЕЛЬНО используйте инструмент Read для чтения ../lark-shared/SKILL.md，который содержит обработку аутентификации и разрешений

Быстрые решения

Идентификация: Markdown файлы обычно относятся к ресурсам облачного пространства пользователя, предпочтительно использовать --as user. Если это автоматизированный сценарий, или приложение уже создано и имеет права на целевой файл, можно использовать --as bot в зависимости от сценария. Перед первым обращением как user выполнить lark-cli auth login

markdown +create / +overwrite завершаются неудачей, сначала проверьте, не связано ли это с идентификацией и правами доступа: у bot чаще всего встречаются ограничения типа app scope или ACL целевой директории, у user — авторизация пользователя или ACL пользователя; не переключайте идентификацию и повторные попытки без необходимости.

Пользователь должен загрузить/создать нативный .md файл, используя lark-cli markdown +create

Пользователь должен сравнить историю версий нативного .md файла или сравнить удалённую версию Markdown с локальным черновиком, используя lark-cli markdown +diff

Пользователь должен прочитать содержание файла .md в Drive, используя lark-cli markdown +fetch

Пользователь должен выполнить частичные текстовые замены/замены с помощью регулярных выражений в Markdown-файле, предпочтительно используя lark-cli markdown +patch

Пользователь должен выполнить полное обновление содержания файла .md в Drive, используя lark-cli markdown +overwrite

Пользователь должен сначала получить номер версии Markdown-файла, затем выполнить сравнение/скачивание/откат, сначала используйте lark-cli drive +version-history из lark-drive

Пользователь должен импортировать локальный Markdown в онлайн-версию документа (docx); не используйте этот skill, используйте lark-drive с lark-cli drive +import --type docx

Пользователь должен выполнять операции на облачном пространстве с Markdown-файлами: переименование / перемещение / удаление / поиск / управление доступом / комментарии и т. п.; не оставляйте это в этом skill, переключитесь на lark-drive

Если markdown +create / +overwrite попадают в missing scope, permission denied, not found, quota_exceeded, version limit, по умолчанию остановить повторные попытки и обработать согласно подсказке об ошибке; только rate_limit, server_error или временные сетевые ошибки выполняют ограниченную обратно-откатную попытку.

Целевые параметры markdown +create не следует угадывать: для папки Drive используйте --folder-token, для узла Wiki — --wiki-token. Если пользователь передал URL, можно передать полный URL; CLI приведёт его к токену. Не помещайте URL doc/sheet/wiki в --folder-token для тестирования.