Резюме
-
Поддерживает три типа документов: Docx, Wiki и Cloud Documents; обрабатывает встроенные таблицы, многомерные таблицы и интерактивные доски (whiteboards) путем извлечения токенов для последующей маршрутизации навыков
-
Основные операции включают fetch (с учетом области видимости и уровней детализации), создание (XML или Markdown), обновление (str_replace, операции с блоками, добавление, перезапись) и управление медиа (вставка, загрузка, предпросмотр)
-
Все команды
docs +create,docs +fetch, иdocs +updateтребуют флага--api-version v2; по умолчанию используется формат DocxXML, если Markdown явно не запрашивается -
Распознаёт Feishu URLs документов и токены как с доменов feishu.cn, так и doubao.com; маршрутизация основывается на паттернах пути URL и типе токена, а не на домене в одиночку
docs
身份:文档操作默认使用 --as user。首次使用前执行 lark-cli auth login。
# 常用示例
lark-cli docs +fetch --doc "文档URL或token;若 URL 存在 #share-... 锚点,优先使用锚点方式读取,不要全文拉取"
lark-cli docs +create --content '<title>标题</title>&<p>内容</p>'
lark-cli docs +update --doc "文档URL或token" --command append --content '<p>内容</p>'
前置条件 — 执行操作前必读
CRITICAL — Перед выполнением соответствующей операции ОБЯЗАТЕЛЬНО сначала используйте инструмент Read для чтения следующих файлов, чтение обязательно:
-
../lark-shared/SKILL.md— аутентификация, обработка прав доступа, глобальные параметры (общие для всех операций) -
Чтение документа (
docs +fetch) — обязательное к ознакомлениюlark-doc-fetch.md(--scope/--detailвыбор、локальная стратегия чтения、<fragment>/<excerpt>вывод结构) -
Создание или редактирование содержимого документа — обязательное к ознакомлению
lark-doc-xml.md(XML синтаксические правила,只有 если 用户明确要求 Markdown 时改读lark-doc-md.md)и обязательное к ознакомлениюlark-doc-style.md(写作原则:默认段落、按体裁、组件克制);从零创建时加读lark-doc-create-workflow.md;编辑已有文档时加读lark-doc-update.mdиlark-doc-update-workflow.md
未读完以上文件就执行相应操作会导致参数选择错误或格式错误。