AI и агенты
feishu-docx
leemysw/feishu-docxИнструмент для экспорта и записи документов Feishu/Lark (Docs, Sheet, Bitable) в Markdown. Поддерживает OAuth 2.0, CLI, TUI, Claude Skills и пакетный экспорт Wiki. Идеален для AI-агентов, работающих с корпоративной базой знаний.
Установка
terminal
bash
pip install playwrightREADME
feishu-docx
🆕 Последние обновления (v0.2.3)
- Добавлена команда
export-browserдля публичных документов и документов, доступных в текущей сессии браузера - Браузерный экспорт теперь скачивает изображения, вложения, доски и диаграммы как локальные ресурсы
- Стандартная команда
exportулучшает резервную загрузку ресурсов публичных документов за счёт предварительного прогрева сессии страницы
🎯 Зачем feishu-docx?
Позвольте AI-агентам читать, писать и управлять вашей базой знаний Feishu/Lark.
- 🤖 Создан для AI — бесшовная интеграция с Claude/GPT Skills для получения документов
- 📄 Полное покрытие — документы, таблицы, Bitable, узлы Wiki и статьи WeChat
- ✍️ Поддержка записи — создание документов, добавление контента и обновление отдельных блоков
- ☁️ Управление облачным пространством — список файлов, удаление, управление правами, безопасная очистка
- 🔐 Аутентификация — однократная авторизация с автоматическим обновлением токена
- 🎨 Двойной интерфейс — CLI + красивый TUI на базе Textual
- 📦 Без настройки —
pip installи сразу начинайте экспорт
⚡ Быстрый старт (30 секунд)
bash
# Установка
pip install feishu-docx
# Настройка учётных данных (однократно)
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET
# Экспорт! (автоматически получает tenant_access_token, OAuth не нужен)
feishu-docx export "https://my.feishu.cn/wiki/KUIJwaBuGiwaSIkkKJ6cfVY8nSg"
# Создать документ Feishu напрямую из статьи WeChat
feishu-docx create --url "https://mp.weixin.qq.com/s/xxxxx"
# Управление документами в облачном пространстве приложения
feishu-docx drive ls --type docx
# Опционально: режим OAuth для прав на уровне пользователя
# feishu-docx config set --auth-mode oauth && feishu-docx auth🤖 Поддержка Skills
Дайте агенту прямой доступ к вашей базе знаний Feishu!
Проект включает Claude Skill по пути .skills/feishu-docx/SKILL.md.
Поддерживает OpenCode, Claude Code, Codex, Cursor и другие инструменты.
Скопируйте этот Skill в свой проект агента, и Claude сможет:
- 📖 Читать базу знаний Feishu как контекст
- 🔍 Искать и ссылаться на внутренние документы
- 📝 Создавать документы, добавлять контент и обновлять отдельные блоки
✨ Возможности
| Функция | Описание |
|---|---|
| 📄 Экспорт документов | Docx → Markdown с форматированием, изображениями, таблицами |
| 📊 Экспорт таблиц | Sheet → таблицы Markdown |
| 📋 Экспорт Bitable | Многомерные таблицы → Markdown |
| 📚 Экспорт Wiki | Автоматическое разрешение узлов Wiki |
| 🗂️ Пакетный экспорт Wiki | Рекурсивный экспорт всего пространства Wiki с иерархией |
| ✍️ Запись документов | Создание документов, добавление Markdown, обновление отдельных блоков |
| 📰 Импорт/экспорт WeChat | Экспорт статей WeChat или создание документов Feishu из них |
| 🌐 Браузерный экспорт | Экспорт публичных документов или документов из текущей сессии браузера с локальными ресурсами |
| ☁️ Управление Drive | Список файлов, удаление, управление правами, очистка |
| 🗄️ Схема базы данных | Экспорт структуры базы данных APaaS в Markdown |
| 🧷 Загрузка локальных ресурсов | Изображения и вложения сохраняются локально с относительными путями |
| 🔐 Аутентификация | Автоматический tenant_access_token (рекомендуется) или OAuth 2.0 |
| 🎨 Красивый TUI | Терминальный интерфейс на базе Textual |
✅ Поддерживаемые блоки
Инструмент поддерживает экспорт следующих компонентов документов Feishu/Lark:
| Категория | Возможности | Статус | Примечания |
|---|---|---|---|
| Базовый текст | Заголовки, абзацы, списки, задачи (Todo), блоки кода, цитаты | ✅ | Полная поддержка |
| Форматирование | Жирный, курсив, зачёркнутый, подчёркнутый, ссылки, @упоминания | ✅ | Полная поддержка |
| Макет | Колонки, выноски, разделители | ✅ | Полная поддержка |
| Таблицы | Нативные таблицы | ✅ | Экспорт в Markdown/HTML |
| Медиа | Изображения, доски | ✅ | Доски экспортируются как изображения |
| Встроенные | Таблицы (Sheets), Bitable | ✅ | Только текстовое содержимое |
| Специальные | Синхронизированные блоки | ⚠️ | Только оригинальные блоки в том же документе |
| Файлы | Вложения | ✅ | Локальная загрузка при возможности, иначе временная ссылка |
📖 Использование
Сценарии использования
- Экспорт документов Feishu, Sheets, Bitable и узлов Wiki в Markdown
- Экспорт статьи WeChat в Markdown
- Создание документа Feishu напрямую из URL статьи WeChat
- Создание, добавление или обновление содержимого документов Feishu
- Управление файлами и правами в облачном пространстве приложения или личном облачном пространстве
CLI
Для export-browser требуется Playwright:
bash
pip install playwright
playwright install chromiumfeishu-docx --help
Команды:
auth Запустить OAuth 2.0 авторизацию
config Управление конфигурацией
create Создать документ Feishu из WeChat или Markdown
drive Управление файлами в облачном пространстве
export Экспортировать документ Feishu в Markdown
export-browser Экспортировать документ через браузер (для публичных или сессионных документов)
schema Экспортировать схему базы данных APaaS
tui Запустить терминальный интерфейс
wiki Управление и экспорт Wiki
TUI
feishu-docx tui
🔧 Настройка
Шаг 1: Создание приложения Feishu
- Перейдите на Feishu Open Platform
- Создайте новое приложение
- Получите
App IDиApp Secret - Настройте необходимые разрешения (права на чтение документов)
Шаг 2: Настройка учётных данных
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET
Шаг 3 (опционально): OAuth для прав на уровне пользователя
bash
feishu-docx config set --auth-mode oauth
feishu-docx auth🤝 Вклад в проект
Вклад приветствуется! Не стесняйтесь открывать issues и pull requests.
📄 Лицензия
MIT License — подробности в файле LICENSE.