feishu2md
v2.4.0
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.
"Uma habilidade por dia | Esta pequena ferramenta que desenvolvi pode ajudá-lo facilmente a converter documentos Feishu em Markdown"
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 empresarial 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
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.
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 NOME: feishu2md - Baixe o documento feishu/larksuite para o arquivo markdown USO: feishu2md [opções globais] comando [opções de comando] [argumentos...] VERSÃO: v2-0e25fa5 COMANDOS: config Leia o arquivo de configuração ou defina os campos, se fornecidos download, dl Baixe o documento feishu/larksuite para o arquivo markdown help, h Mostra uma lista de comandos ou ajuda para um comandoOPÇÕES GLOBAIS: --help, -h mostra ajuda (padrão: falso) --version, -v imprime a versão (padrão: false) $ feishu2md configuração -h NOME: feishu2md config - Leia o arquivo de configuração ou defina os campos, se fornecidos USO: feishu2md config [opções de comando] [argumentos...] OPÇÕES: --appId value Define o ID do aplicativo para a API OPEN --appSecret value Define o segredo do aplicativo para a API OPEN --help, -h mostra ajuda (padrão: falso) $ feishu2md dl -h NOME: feishu2md download - Baixe o documento feishu/larksuite para o arquivo markdown USO: feishu2md download [opções de comando] <url>OPÇÕES: --output value, -o value Especifique o diretório de saída para os arquivos markdown (padrão: "./") --dump Dump resposta json da API OPEN (padrão: false) --batch Baixe todos os documentos em uma pasta (padrão: false) --wiki Baixe todos os documentos do wiki (padrão: false) --help, -h mostra ajuda (padrão: falso)
Gerar arquivo de configuração
O arquivo de configuração da ferramenta pode ser gerado através do comando feishu2md config --appId <your_id> --appSecret <your_secret> .
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 <your feishu docx url> , 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 <your feishu folder url> . O link da pasta pode ser obtido compartilhando > ativando o compartilhamento de link > pessoas que obtêm o link na Internet podem ler > copiar o link .
Exemplo:
$ feishu2md dl --batch -o diretório_de_saída "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 <your feishu wiki setting url> , o link de configurações do wiki pode ser obtido abrindo as configurações da base de conhecimento.
Exemplo:
$ feishu2md dl --wiki -o diretório_de_saída "https://domain.feishu.cn/wiki/settings/123456789101112"
Imagem Docker: https://hub.docker.com/r/wwwsine/feishu2md
Comando Docker: docker run -it --rm -p 8080:8080 -e FEISHU_APP_ID=<your id> -e FEISHU_APP_SECRET=<your secret> -e GIN_MODE=release wwwsine/feishu2md
Composição do Docker:
# docker-compose.ymlversion: '3'services: feishu2md:image: wwwsine/feishu2mdenvironment: FEISHU_APP_ID: <seu id> FEISHU_APP_SECRET: <seu segredo> GIN_MODE: releaseports: - "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 .
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 > ativar compartilhamento de link > copiar link .
chyroc/cotovia
chyroc/lark_docs_md
