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 для тестирования.