Eyeball

Analise documentos com prova visual. Quando ativado, o Eyeball produz um documento do Word na Área de Trabalho do usuário onde cada afirmação factual inclui uma captura de tela inline do material fonte com o texto citado destacado em amarelo.

Ativação

Quando o usuário invocar esta habilidade (por exemplo, "use eyeball", "execute eyeball nisso", "eyeball neste documento"), responda com:

Eyeball está ativo. Analisarei o documento e produzirei um documento do Word com capturas de tela inline da fonte para que você possa verificar cada afirmação com seus próprios olhos.

Em seguida, siga o fluxo de trabalho abaixo.

Fontes Suportadas

• Arquivos locais: Documentos do Word (.docx, .doc), PDFs (.pdf), arquivos RTF
• URLs da Web: Qualquer página da web publicamente acessível

Localização da Ferramenta

O utilitário Python Eyeball está localizado em:

<plugin_dir>/skills/eyeball/tools/eyeball.py

Para encontrar o caminho real, execute:

find ~/.copilot/installed-plugins -name "eyeball.py" -path "*/eyeball/*" 2>/dev/null

Se não for encontrado lá, verifique o diretório do projeto ou o diretório pessoal do usuário em busca do repositório eyeball.

Configuração da Primeira Execução

Antes do primeiro uso, verifique se as dependências estão instaladas:

python3 <path-to>/eyeball.py setup-check

Se algo estiver faltando, instale as dependências necessárias:

pip3 install pymupdf pillow python-docx playwright
python3 -m playwright install chromium

No Windows, instale também o pywin32 para automação do Word:

pip install pywin32

Fluxo de Trabalho

Siga estas etapas exatamente. A ordem é importante.

Etapa 1: Ler o texto fonte

Antes de escrever qualquer análise, extraia e leia o texto completo do documento fonte:

python3 <path-to>/eyeball.py extract-text --source "<path-or-url>"

Leia a saída cuidadosamente. Identifique os números de seção reais, títulos, números de página e linguagem chave.

CRÍTICO: Não pule esta etapa. Não escreva análises com base em suposições sobre como o documento está estruturado. Leia o texto real.

Etapa 2: Escrever análise com citações exatas

Para cada ponto em sua análise, você deve:

1. Referenciar o número da seção correto conforme aparece no documento (por exemplo, "Seção 9" em vez de "Seção 8" porque você assumiu a numeração).
2. Referenciar o número da página correto onde a seção aparece no texto extraído.
3. Selecionar âncoras que sejam frases literais da fonte que apoiem diretamente sua afirmação.

Etapa 3: Selecionar âncoras corretamente

Esta é a etapa mais importante. As âncoras determinam o que será destacado nas capturas de tela.

FAZER:

• Use frases literais do texto fonte que apoiem diretamente sua afirmação
• Use várias âncoras para abranger todo o intervalo de texto que o leitor deve ver
• Use frases específicas e incomuns que apareçam apenas onde você pretende

NÃO FAZER:

• Use rótulos de tópicos genéricos (por exemplo, "Confidencialidade") que aparecem em todo o documento
• Use apenas títulos de seção quando eles aparecerem como referências cruzadas em outros lugares
• Use palavras comuns únicas que correspondam em muitos lugares

Exemplos:

ERRADO -- usa um rótulo de tópico genérico que corresponde em todos os lugares:

{"anchors": ["User-Generated Content"], "target_page": 8}

CERTO -- usa a linguagem específica que apoia a afirmação:

{"anchors": ["retain ownership", "Ownership of Content, Right to Post"], "target_page": 8}

ERRADO -- o título da seção aparece como uma referência cruzada em páginas anteriores:

{"anchors": ["LIMITATION OF LIABILITY"]}

CERTO -- inclui o número da seção para precisão, visa a página correta:

{"anchors": ["12. LIMITATION OF LIABILITY", "INDIRECT", "CONSEQUENTIAL"], "target_page": 13}

Etapa 4: Construir o documento de análise

Construa um array JSON de seções e chame o comando de construção:

python3 <path-to>/eyeball.py build \
  --source "<path-or-url>" \
  --output ~/Desktop/<title>.docx \
  --title "Analysis Title" \
  --subtitle "Source description" \
  --sections '[
    {
      "heading": "1. Section Title",
      "analysis": "Your analysis text here. Reference Section X on page Y...",
      "anchors": ["verbatim phrase 1", "verbatim phrase 2"],
      "target_page": 5,
      "context_padding": 40
    },
    {
      "heading": "2. Another Section",
      "analysis": "More analysis...",
      "anchors": ["exact quote from source"],
      "target_pages": [10, 11],
      "context_padding": 50
    }
  ]'

Campos do objeto de seção:

• heading (obrigatório): Título da seção no documento de saída
• analysis (obrigatório): Seu texto de análise

…