File Converter

Converta vários formatos de arquivo para documentos e imagens, como DOCX, PDF, CSV e outros.

Documentação

Operações de Arquivo

简体中文 | Português

Uma habilidade local de operações de arquivos para agentes de IA. Converta, inspecione, arquive e extraia texto de arquivos na máquina local usando um script Python integrado com saída JSON estruturada.

O Que Ele Faz

Converter

  • Formatos de imagem: png, jpg, webp, gif, bmp, tiff
  • pdf -> docx
  • xlsx -> csv
  • xls -> csv (requer xlrd, não instalado por padrão)
  • docx -> pdf (requer LibreOffice)
  • html/md/markdown -> pdf (requer wkhtmltopdf)

Inspecionar

  • Metadados básicos: tamanho, tipo MIME, permissões, última modificação
  • Imagem: dimensões, modo de cor, formato
  • PDF: número de páginas
  • Excel: nomes das planilhas, contagens de linhas

Arquivar

  • Criar zip a partir de arquivos e diretórios
  • Extrair zip para diretório (com proteção ZipSlip)

Extrair Texto

  • PDF, DOCX, XLSX, HTML, Markdown, metadados EXIF de imagens

Configuração Rápida

bash skills/file-ops/scripts/setup.sh

Uso

Verificação de saúde:

skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py health

Converter:

skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py convert --input /path/input.pdf --to docx

Inspecionar:

skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py inspect --input /path/file.pdf

Arquivar:

skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py archive --input /path/dir --output /path/out.zip
skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py archive --input /path/archive.zip --output /path/dest --extract

Extrair texto:

skills/file-ops/.venv/bin/python skills/file-ops/scripts/file_ops.py extract-text --input /path/document.pdf

Use --output /path/output.ext com convert se você não quiser que a saída seja gravada ao lado do arquivo de entrada.