Скачать feishu2md - feishu2md Скачать исходный код

фейшу2мд

Другой исходный код

v2.4.0

Скачать

фейшу2мд

Это инструмент для загрузки документов Feishu в виде файлов Markdown, реализованный с использованием языка Go.

Пожалуйста, смотрите здесь: Нанимайте разработчиков с потребностями и интересами для совместного обсуждения разработки и обслуживания. Если вы заинтересованы, свяжитесь с нами.

мотивация

«Один навык в день | Этот небольшой инструмент, который я разработал, может легко помочь вам конвертировать документы Feishu в Markdown»

Получить API-токен

В файле конфигурации необходимо указать идентификатор приложения и секретную информацию приложения. Чтобы получить его, обратитесь к официальной документации Feishu. Рекомендуемая настройка:

Войдите в серверную часть разработчика Feishu
Создайте самостоятельное приложение (персональную версию) и заполните информацию по своему усмотрению.
(Важно) Откройте управление разрешениями и включите следующие необходимые разрешения (вы можете щелкнуть ссылку ниже, чтобы перейти к консоли отладки API -> поле конфигурации разрешений)
- Получите основную информацию о документе, разрешение «Просмотр новой версии документа» docx:document:readonly
- Получить все блоки документа, разрешение «Просмотр новой версии документа» docx:document:readonly
- Скачать материалы, разрешение «Загрузка изображений и вложений в облачные документы» docs:document.media:download
- Получите список файлов в папке «Просмотр, комментирование, редактирование и управление всеми файлами в облачном пространстве» с разрешениями drive:file:readonly
- Получить информацию об узле пространства знаний, разрешение «Просмотр базы знаний» wiki:wiki:readonly
Откройте учетные данные и основную информацию, чтобы получить идентификатор приложения и секрет приложения.

Как использовать

Примечание. Инструмент загрузки старых версий документов Feishu было решено больше не поддерживать, но ветку v1_support по-прежнему можно использовать, а соответствующий архив — v1.4.0. Обратите внимание.

Версия командной строки

Благодаря кроссплатформенной функции языка Go исполняемые файлы основных платформ скомпилированы и могут быть загружены в выпуске, а исполняемый файл feishu2md соответствующей платформы можно поместить в путь PATH.

Проверьте справочную документацию

$ feishu2md -h
NAME:
  feishu2md - Download feishu/larksuite document to markdown file

USAGE:
  feishu2md [global options] command [command options] [arguments...]

VERSION:
  v2-0e25fa5

COMMANDS:
  config        Read config file or set field(s) if provided
  download, dl  Download feishu/larksuite document to markdown file
  help, h       Shows a list of commands or help for one command

GLOBAL OPTIONS:
  --help, -h     show help (default: false)
  --version, -v  print the version (default: false)

$ feishu2md config -h
NAME:
   feishu2md config - Read config file or set field(s) if provided

USAGE:
   feishu2md config [command options] [arguments...]

OPTIONS:
   --appId value      Set app id for the OPEN API
   --appSecret value  Set app secret for the OPEN API
   --help, -h         show help (default: false)

$ feishu2md dl -h
NAME:
  feishu2md download - Download feishu/larksuite document to markdown file

USAGE:
  feishu2md download [command options] < url >

OPTIONS:
  --output value, -o value  Specify the output directory for the markdown files (default: " ./ " )
  --dump                    Dump json response of the OPEN API (default: false)
  --batch                   Download all documents under a folder (default: false)
  --wiki                    Download all documents within the wiki. (default: false)
  --help, -h                show help (default: false)

Создать файл конфигурации

Файл конфигурации инструмента можно создать с помощью команды feishu2md config --appId --appSecret .

Вы можете использовать команду feishu2md config чтобы проверить путь к файлу конфигурации и успешность настройки.

Для получения дополнительных параметров конфигурации вручную откройте изменения файла конфигурации.

Загрузите один документ в формате Markdown

Загрузите напрямую через feishu2md dl , ссылку на документ можно получить , поделившись > включите обмен ссылками > люди, получившие ссылку в Интернете, смогут прочитать > скопировать ссылку .

Пример:

$ feishu2md dl " https://domain.feishu.cn/docx/docxtoken "

Пакетная загрузка всех документов в папке в формате Markdown

Эта функция в настоящее время не поддерживает версии Docker.

Загрузите напрямую через feishu2md dl --batch . Ссылку на папку можно получить , поделившись > включите совместное использование ссылок > люди, получившие ссылку в Интернете, смогут прочитать > скопировать ссылку .

Пример:

$ feishu2md dl --batch -o output_directory " https://domain.feishu.cn/drive/folder/foldertoken "

Пакетная загрузка всех документов базы знаний в формате Markdown.

Загрузите напрямую через feishu2md dl --wiki . Ссылку на настройки вики можно получить, открыв настройки базы знаний.

Пример:

$ feishu2md dl --wiki -o output_directory " https://domain.feishu.cn/wiki/settings/123456789101112 "

Докер-версия

Образ докера: https://hub.docker.com/r/wwwsine/feishu2md

Команда Docker: docker run -it --rm -p 8080:8080 -e FEISHU_APP_ID= -e FEISHU_APP_SECRET= -e GIN_MODE=release wwwsine/feishu2md

Докер

 # docker-compose.yml
version : ' 3 '
services :
  feishu2md :
    image : wwwsine/feishu2md
    environment :
      FEISHU_APP_ID : 
      FEISHU_APP_SECRET : 
      GIN_MODE : release
    ports :
      - " 8080:8080 "

Запустите сервисный docker compose up -d

Затем посетите https://127.0.0.1:8080 и вставьте ссылку на документ. Ссылку на документ можно получить, выбрав «Поделиться» > «Включить общий доступ к ссылке» > «Скопировать ссылку» .

Онлайн-версия

Я использовал свой личный тестовый API-токен для развертывания нестабильной версии на платформе Render. Эта версия не сохраняет никакой документации и изображений в контейнере и напрямую возвращает сжатый файл пакета из памяти через HTTP, а журнал платформы Render. может зарегистрировать некоторую информацию HTTP.

Текущая версия предназначена только для временного использования пользователями, которые не заботятся о конфиденциальности или слишком ленивы для ее настройки. Ее также можно использовать для проверки и сравнения проблем с их собственной конфигурацией разрешений токена. Платформа Render использует бесплатную квоту и имеет только 512 МБ памяти. Высокая доступность не гарантируется. Цепочка доверия полностью опирается на открытый исходный код, поэтому используйте ее по своему усмотрению.

Посетите https://feishu2md.onrender.com/ и вставьте ссылку на документ. Ссылку на документ можно получить, выбрав «Поделиться» > «Включить общий доступ к ссылке» > «Скопировать ссылку» .