feishu2md

feishu2md

Dies ist ein Tool zum Herunterladen von Feishu-Dokumenten als Markdown-Dateien, implementiert mit der Go-Sprache.

Bitte schauen Sie hier: Rekrutieren Sie Entwickler mit Bedarf und Interessen, um gemeinsam über Entwicklung und Wartung zu sprechen. Bei Interesse kontaktieren Sie uns bitte.

Motivation

„Eine Fähigkeit pro Tag | Dieses kleine Tool, das ich entwickelt habe, kann Ihnen leicht dabei helfen, Feishu-Dokumente in Markdown zu konvertieren.“

Holen Sie sich API-Token

Die Konfigurationsdatei muss die APP-ID- und APP-GEHEIMNIS-Informationen enthalten. Weitere Informationen finden Sie in der offiziellen Feishu-Dokumentation. Die empfohlene Einstellung ist

• Geben Sie das Feishu-Entwickler-Backend ein
• Erstellen Sie eine selbst erstellte Anwendung (persönliche Version) und geben Sie die Informationen nach Ihren Wünschen ein
• (Wichtig) Öffnen Sie die Berechtigungsverwaltung und aktivieren Sie die folgenden erforderlichen Berechtigungen (Sie können auf den Link unten klicken, um zur API-Debugging-Konsole zu gelangen -> Berechtigungskonfigurationsfeld)
  • Erhalten Sie grundlegende Informationen zum Dokument, die Berechtigung „Neue Version des Dokuments anzeigen“ docx:document:readonly
  • Alle Blöcke des Dokuments abrufen, Berechtigung „Neue Version des Dokuments anzeigen“ docx:document:readonly
  • Materialien herunterladen, Berechtigung „Bilder und Anhänge in Cloud-Dokumenten herunterladen“ docs:document.media:download
  • Rufen Sie die Dateiliste im Ordner mit der Berechtigung „Alle Dateien im Cloud-Bereich anzeigen, kommentieren, bearbeiten und verwalten“ drive:file:readonly
  • Informationen zum Wissensraumknoten abrufen, Berechtigung „Wissensdatenbank anzeigen“ wiki:wiki:readonly
• Öffnen Sie die Anmeldeinformationen und grundlegenden Informationen, um die App-ID und das App-Geheimnis zu erhalten

Wie zu verwenden

Hinweis: Es wurde beschlossen, dass das Download-Tool für alte Versionen von Feishu-Dokumenten nicht mehr gepflegt wird, der Zweig v1_support kann jedoch weiterhin verwendet werden und das entsprechende Archiv ist v1.4.0. Bitte beachten Sie.

Befehlszeilenversion

Mit der plattformübergreifenden Funktion der Go-Sprache wurden die ausführbaren Dateien der Hauptplattformen kompiliert und können in Release heruntergeladen werden. Die ausführbare feishu2md-Datei der entsprechenden Plattform kann im PATH-Pfad abgelegt werden.

Sehen Sie sich die Hilfedokumentation an

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

Konfigurationsdatei generieren

Die Konfigurationsdatei des Tools kann über den Befehl feishu2md config --appId --appSecret generiert werden.

Mit dem Befehl feishu2md config können Sie den Pfad der Konfigurationsdatei überprüfen und prüfen, ob die Konfiguration erfolgreich ist.

Für weitere Konfigurationsoptionen öffnen Sie bitte manuell die Änderungen in der Konfigurationsdatei.

Laden Sie ein einzelnes Dokument als Markdown herunter

Laden Sie es direkt über feishu2md dl herunter. Der Dokumentlink kann durch Teilen erhalten werden. Aktivieren Sie die Linkfreigabe. Personen, die den Link im Internet erhalten, können den Link lesen und kopieren .

Beispiel:

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

Laden Sie alle Dokumente in einem Ordner stapelweise als Markdown herunter

Diese Funktion unterstützt derzeit keine Docker-Versionen

Laden Sie es direkt über feishu2md dl --batch herunter. Sie können den Ordner-Link erhalten, indem Sie ihn teilen > Link-Freigabe aktivieren > Personen, die den Link im Internet erhalten, können ihn lesen > Link kopieren .

Beispiel:

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

Laden Sie alle Dokumente einer Wissensdatenbank stapelweise als Markdown herunter

Laden Sie es direkt über feishu2md dl --wiki herunter. Der Link zu den Wiki-Einstellungen kann durch Öffnen der Wissensdatenbank-Einstellungen abgerufen werden.

Beispiel:

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

Docker-Version

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

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

Docker Compose:

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

Starten Sie den Dienst docker compose up -d

Besuchen Sie dann https://127.0.0.1:8080 und fügen Sie den Dokumentlink ein, indem Sie „Teilen“ > „Linkfreigabe aktivieren“ > „Link kopieren“ aufrufen.

Online-Version

Ich habe mein persönliches Test-API-Token verwendet, um eine instabile Version auf der Render-Plattform bereitzustellen. Diese Version speichert keine Dokumentation und Bilder im Container und gibt die komprimierte Paketdatei direkt aus dem Speicher über HTTP zurück, sondern das Protokoll der Render-Plattform Möglicherweise werden einige HTTP-Informationen protokolliert.

Die aktuelle Version ist nur für die vorübergehende Verwendung durch Benutzer gedacht, denen der Datenschutz egal ist oder die zu faul sind, ihn zu konfigurieren. Sie kann auch verwendet werden, um zu testen und zu vergleichen, ob ein Problem mit der eigenen Token-Berechtigungskonfiguration vorliegt. Die Render-Plattform nutzt ein kostenloses Kontingent und verfügt nur über 512 MB Speicher. Eine hohe Verfügbarkeit ist nicht garantiert. Die Vertrauenskette basiert vollständig auf Open-Source-Code. Bitte nutzen Sie diesen nach eigenem Ermessen.

Besuchen Sie https://feishu2md.onrender.com/ und fügen Sie den Dokumentlink ein, indem Sie „Teilen“ > „Linkfreigabe aktivieren“ > „Link kopieren“ aufrufen.

dankbar

• Chyroc/Lerche
• chyroc/lark_docs_md