Download do feishu2md - download do código-fonte do feishu2md

feishu2md

Outro código-fonte

v2.4.0

Baixar

feishu2md

Esta é uma ferramenta para baixar documentos Feishu como arquivos Markdown, implementados na linguagem Go.

Por favor, veja aqui: Recrute desenvolvedores com necessidades e interesses para discutir desenvolvimento e manutenção juntos. Se você estiver interessado, entre em contato conosco.

motivação

"Uma habilidade por dia | Esta pequena ferramenta que desenvolvi pode ajudá-lo facilmente a converter documentos Feishu em Markdown"

Obtenha token de API

O arquivo de configuração precisa preencher as informações APP ID e APP SECRET. Consulte a documentação oficial do Feishu para obtê-lo. A configuração recomendada é

Entre no back-end do desenvolvedor Feishu
Crie um aplicativo autoconstruído (versão pessoal) e preencha as informações como desejar
(Importante) Abra o gerenciamento de permissões e habilite as seguintes permissões necessárias (você pode clicar no link abaixo para consultar o console de depuração da API -> campo de configuração de permissão)
- Obtenha informações básicas do documento, permissão "Visualizar nova versão do documento" docx:document:readonly
- Obtenha todos os blocos do documento, permissão "Visualizar nova versão do documento" docx:document:readonly
- Baixar materiais, permissão "Baixar imagens e anexos em documentos na nuvem" docs:document.media:download
- Obtenha a lista de arquivos na pasta "Visualizar, comentar, editar e gerenciar todos os arquivos no espaço da nuvem" permissão drive:file:readonly
- Obtenha informações do nó do espaço de conhecimento, permissão "Visualizar base de conhecimento" wiki:wiki:readonly
Abra as credenciais e informações básicas para obter o App ID e o App Secret

Como usar

Nota: Foi decidido que a ferramenta de download para versões antigas de documentos Feishu não será mais mantida, mas o branch v1_support ainda pode ser usado e o arquivo correspondente é v1.4.0.

Versão da linha de comando

Com o recurso de plataforma cruzada da linguagem Go, os arquivos executáveis das principais plataformas foram compilados e podem ser baixados no Release, e o arquivo executável feishu2md da plataforma correspondente pode ser colocado no caminho PATH.

Verifique a documentação de ajuda

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

Gerar arquivo de configuração

O arquivo de configuração da ferramenta pode ser gerado através do comando feishu2md config --appId --appSecret .

Você pode usar o comando feishu2md config para verificar o caminho do arquivo de configuração e se a configuração foi bem-sucedida.

Para obter mais opções de configuração, abra manualmente as alterações do arquivo de configuração.

Baixe um único documento como Markdown

Baixe diretamente através de feishu2md dl , o link do documento pode ser obtido compartilhando> ativar o compartilhamento de link> pessoas que obtiverem o link na Internet podem ler> copiar o link .

Exemplo:

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

Baixe em lote todos os documentos em uma pasta como Markdown

Este recurso atualmente não oferece suporte a versões do Docker

Baixe diretamente através de feishu2md dl --batch . O link da pasta pode ser obtido compartilhando > ativar o compartilhamento de link > pessoas que obtiverem o link na Internet podem ler > copiar o link .

Exemplo:

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

Baixe em lote todos os documentos de uma base de conhecimento como Markdown

Baixe diretamente através de feishu2md dl --wiki , o link de configurações do wiki pode ser obtido abrindo as configurações da base de conhecimento.

Exemplo:

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

Versão Docker

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

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

Composição do Docker:

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

Inicie o serviço docker compose up -d

Em seguida, visite https://127.0.0.1:8080 e cole o link do documento. O link do documento pode ser obtido compartilhando > Habilitar compartilhamento de link > Copiar link .

Versão on-line

Usei meu token de API de teste pessoal para implantar uma versão instável na plataforma Render. Esta versão não salvará nenhuma documentação e imagens no contêiner e retornará diretamente o arquivo do pacote compactado da memória através de HTTP, mas sim o Log da plataforma Render. pode registrar algumas informações HTTP.

A versão atual é apenas para uso temporário por usuários que não se preocupam com a privacidade ou têm preguiça de configurá-la. Também pode ser usada para testar e comparar se há algum problema com sua própria configuração de permissão de token. A plataforma Render usa cota gratuita e possui apenas 512M de memória. A alta disponibilidade não é garantida. A cadeia de confiança depende inteiramente de código-fonte aberto, portanto, use-o a seu critério.

Visite https://feishu2md.onrender.com/ e cole o link do documento. O link do documento pode ser obtido compartilhando > Habilitar compartilhamento de link > Copiar link .