CommunityPesquisa e Análise de Dadosgithub.com

steipete/hopper-debugger

Depuração com Hopper: binários macOS/iOS, símbolos ObjC/Swift, dyld, LLDB.

O que é hopper-debugger?

Esta skill integra o Hopper Disassembler ao ambiente de desenvolvimento através do `mcporter`, permitindo consultas de desmontagem como parte do fluxo de depuração. Ela é especialmente útil para engenheiros que trabalham com binários de sistemas Apple (macOS/iOS), frameworks como AppKit e SwiftUI, e precisam analisar chamadas de métodos, símbolos e cadeias de caracteres. A skill suporta a abertura de binários extraídos do cache dyld, busca por procedimentos, strings e referências cruzadas, além de exibir pseudo-código e assembly de funções específicas. O fluxo de trabalho recomendado combina a análise estática no Hopper com validação dinâmica via LLDB, logs e reprodução focada de bugs, garantindo que hipóteses sejam verificadas antes de modificar o código-fonte. A skill também fornece orientações para lidar com falhas comuns, como timeouts, documentos fechados e travamentos do Hopper, preferindo reiniciar o daemon do mcporter em vez de matar processos indiscriminadamente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/hopper-debugger

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Hopper Debugger

Objetivo: usar o Hopper através do mcporter como um desmontador consultável, combinando o resultado com código-fonte local, LLDB, logs e reproduções focadas.

Início Rápido

Validar o servidor MCP:

MCPORTER_LIST_TIMEOUT=15000 timeout 20 mcporter list hopper --brief

Listar documentos abertos no Hopper:

MCPORTER_CALL_TIMEOUT=20000 timeout 30 mcporter call hopper.list_documents --output json

Se nenhum documento estiver aberto, abra o binário/framework no Hopper primeiro:

open -a "Hopper Disassembler" /caminho/para/Binário

O Hopper pode exibir um diálogo de primeira abertura/importação. Deixe o usuário clicar no botão de confirmação e repita a chamada MCP. Evite chamadas MCP paralelas ao Hopper; o servidor pode fechar o transporte ou travar o Hopper enquanto a importação ainda está sendo finalizada.

Frameworks Apple

Prefira binários de framework já extraídos do cache dyld quando presentes:

/tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
/tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI

Abra um de cada vez ao depurar problemas de limite SwiftUI/AppKit:

open -a "Hopper Disassembler" /tmp/dsc-appkit/System/Library/Frameworks/AppKit.framework/Versions/C/AppKit
mcporter call hopper.list_documents --output json

open -a "Hopper Disassembler" /tmp/dsc-appkit/System/Library/Frameworks/SwiftUI.framework/Versions/A/SwiftUI
mcporter call hopper.list_documents --output json

Verificar acesso:

mcporter call hopper.list_documents --output json
mcporter call hopper.current_document --output json
mcporter call hopper.search_strings pattern=SwiftUI --output json
mcporter call hopper.search_strings pattern=NSStatusItem --output json

Nomes de documentos podem começar como Untitled; repita após o Hopper terminar a importação. Use current_document, buscas por símbolos/strings e alterações no título da janela para identificar AppKit vs SwiftUI.

Fluxo de Consulta

  1. Comece pelo caminho do código-fonte local ou símbolo em tempo de execução que você está tentando explicar.
  2. Busque nomes/procedimentos/strings:
mcporter call hopper.search_procedures pattern='NSStatusBar' --output json
mcporter call hopper.search_name pattern='NSStatusBarButtonCell' --output json
mcporter call hopper.search_strings pattern='NSStatusItem' --output json
  1. Inspecione um alvo pequeno por vez:
mcporter call hopper.procedure_info procedure='<símbolo>' --output json
mcporter call hopper.procedure_assembly procedure='<símbolo>' --output json
mcporter call hopper.procedure_pseudo_code procedure='<símbolo>' --output json
mcporter call hopper.procedure_callers procedure='<símbolo>' --output json
mcporter call hopper.procedure_callees procedure='<símbolo>' --output json
mcporter call hopper.xrefs address=0x12345678 --output json
  1. Resuma o fluxo de controle relevante; não cole grandes descompilações.
  2. Valide a hipótese com LLDB/logging/reprodução antes de modificar o código do aplicativo.

Bugs de Item de Status / Clique em Menu

Buscas úteis em AppKit/SwiftUI:

mcporter call hopper.search_strings pattern='NSStatusItem_Private_ForSwiftUI' --output json
mcporter call hopper.search_procedures pattern='popUpStatusBarMenu' --output json
mcporter call hopper.search_procedures pattern='trackMouse' --output json
mcporter call hopper.search_name pattern='NSStatusBarButtonCell' --output json
mcporter call hopper.search_name pattern='NSStatusItem' --output json

Símbolos que valem a pena inspecionar quando cliques na barra de menu não fazem nada:

  • -[NSStatusBarButtonCell trackMouse:inRect:ofView:untilMouseUp:]
  • -[NSStatusBarButtonCell _sendActionFrom:]
  • -[NSStatusItem popUpStatusBarMenu:]
  • -[NSApplication sendAction:to:from:]
  • Símbolos de status/menu do SwiftUI que referenciam NSStatusItem_Private_ForSwiftUI

Compare a desmontagem com o estado em tempo de execução:

pgrep -af "App.app/Contents/MacOS/App"
lldb /caminho/para/debug/Binário

Para aplicativos assinados com proteção, a anexação pode falhar sem get-task-allow; inicie o binário de depuração bruto sob LLDB quando necessário.

Tratamento de Falhas

  • Envolva chamadas Hopper com timeout; uma janela modal/importação ou documento fechado pode deixar o transporte travado.
  • Não envie requisições MCP Hopper concorrentes durante a importação. Se uma consulta for cara, aguarde sua conclusão antes de iniciar outra.
  • Se as chamadas reportarem Connection closed, verifique se há um modal do Hopper, depois repita após a confirmação.
  • Se o Hopper travar, reabra um único documento, aguarde a importação/análise e execute list_documents novamente antes de buscas mais profundas.
  • Se o mcporter estiver travado, inspecione os processos antes de matar qualquer coisa:
pgrep -af 'mcporter|HopperMCPServer|Hopper Disassembler'
  • Prefira reiniciar o daemon do mcporter em vez de matar processos indiscriminadamente:
mcporter daemon stop
mcporter daemon start

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Habilidades Relacionadas