feishu2md

feishu2md

Il s'agit d'un outil permettant de télécharger des documents Feishu sous forme de fichiers Markdown, implémenté en utilisant le langage Go.

Veuillez consulter ici : Recrutez des développeurs ayant des besoins et des intérêts pour discuter ensemble du développement et de la maintenance. Si vous êtes intéressé, veuillez nous contacter.

motivation

"Une compétence par jour | Ce petit outil que j'ai développé peut facilement vous aider à convertir des documents Feishu en Markdown"

Obtenir un jeton API

Le fichier de configuration doit remplir les informations APP ID et APP SECRET. Veuillez vous référer à la documentation officielle de Feishu pour l'obtenir. Le réglage recommandé est

• Entrez dans le backend du développeur Feishu
• Créez une application auto-construite (version personnelle) et remplissez les informations comme vous le souhaitez
• (Important) Ouvrez la gestion des autorisations et activez les autorisations nécessaires suivantes (vous pouvez cliquer sur le lien ci-dessous pour vous référer à la console de débogage de l'API -> champ de configuration des autorisations)
  • Obtenir les informations de base du document, autorisation "Afficher la nouvelle version du document" docx:document:readonly
  • Récupère tous les blocs du document, autorisation "Afficher la nouvelle version du document" docx:document:readonly
  • Télécharger des documents, autorisation « Télécharger des images et des pièces jointes dans des documents cloud » docs:document.media:download
  • Obtenez la liste des fichiers dans le dossier, autorisation "Afficher, commenter, modifier et gérer tous les fichiers dans l'espace cloud" drive:file:readonly
  • Obtenir des informations sur le nœud de l'espace de connaissances, autorisation « Afficher la base de connaissances » wiki:wiki:readonly
• Ouvrez les informations d'identification et les informations de base pour obtenir l'identifiant de l'application et le secret de l'application.

Comment utiliser

Remarque : Il a été décidé de ne plus maintenir l'outil de téléchargement des anciennes versions des documents Feishu, mais la branche v1_support peut toujours être utilisée et l'archive correspondante est la v1.4.0. Veuillez en être informé.

Version en ligne de commande

Avec la fonctionnalité multiplateforme du langage Go, les fichiers exécutables des principales plateformes ont été compilés et peuvent être téléchargés dans Release, et le fichier exécutable feishu2md de la plateforme correspondante peut être placé dans le chemin PATH.

Consultez la documentation d'aide

$ 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)

Générer le fichier de configuration

Le fichier de configuration de l'outil peut être généré via la commande feishu2md config --appId --appSecret .

Vous pouvez utiliser la commande feishu2md config pour vérifier le chemin du fichier de configuration et si la configuration a réussi.

Pour plus d'options de configuration, veuillez ouvrir manuellement les modifications du fichier de configuration.

Téléchargez un seul document au format Markdown

Téléchargez directement via feishu2md dl , le lien du document peut être obtenu en partageant > activez le partage de lien > les personnes qui obtiennent le lien sur Internet peuvent lire > copier le lien .

Exemple:

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

Téléchargez par lots tous les documents d'un dossier en tant que Markdown

Cette fonctionnalité ne prend actuellement pas en charge les versions Docker

Téléchargez directement via feishu2md dl --batch . Le lien du dossier peut être obtenu en partageant > activez le partage de lien > les personnes qui obtiennent le lien sur Internet peuvent lire > copier le lien .

Exemple:

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

Téléchargez par lots tous les documents d'une base de connaissances en Markdown

Téléchargez directement via feishu2md dl --wiki , le lien des paramètres wiki peut être obtenu en ouvrant les paramètres de la base de connaissances.

Exemple:

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

Version Docker

Image Docker : https://hub.docker.com/r/wwwsine/feishu2md

Commande Docker : docker run -it --rm -p 8080:8080 -e FEISHU_APP_ID= -e FEISHU_APP_SECRET= -e GIN_MODE=release wwwsine/feishu2md

Docker Composer :

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

Démarrez le service docker compose up -d

Visitez ensuite https://127.0.0.1:8080 et collez le lien du document. Le lien du document peut être obtenu en partageant > Activer le partage de lien > Copier le lien .

Version en ligne

J'ai utilisé mon jeton API de test personnel pour déployer une version instable sur la plateforme de rendu. Cette version n'enregistrera aucune documentation ni image dans le conteneur, et renvoie directement le fichier du package compressé depuis la mémoire via HTTP, mais le journal de la plateforme de rendu. peut enregistrer certaines informations HTTP.

La version actuelle est uniquement destinée à une utilisation temporaire par les utilisateurs qui ne se soucient pas de la confidentialité ou qui sont trop paresseux pour la configurer. Elle peut également être utilisée pour tester et comparer s'il y a un problème avec leur propre configuration d'autorisation de jeton. La plateforme Render utilise un quota gratuit et ne dispose que de 512 Mo de mémoire. La haute disponibilité n'est pas garantie. La chaîne de confiance repose entièrement sur du code open source, veuillez donc l'utiliser à votre propre discrétion.

Visitez https://feishu2md.onrender.com/ et collez le lien du document. Le lien du document peut être obtenu en partageant > Activer le partage de lien > Copier le lien .

reconnaissant

• chyroc/alouette
• chyroc/lark_docs_md