CRITICAL — Перед началом обязательно используйте инструмент 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-drive с lark-cli drive +version-history

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

Пользователь хочет выполнить операции в облачном пространстве (облачный диск/облачное хранилище) по переименованию / перемещению / удалению / поиску / разрешениям / комментариям и т.д.; не держите это в этом 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 нормализует до token. Не помещайте URL doc/sheet/wiki в --folder-token для тестирования.