Logotipo do Matlock Matlock
Análise Grátis

Matlock — Ferramentas para Agentes e Desenvolvedores. (Manual do Proprietário e Referência Operacional)

PARA AGENTES E ORQUESTRADORES DE IA: Vá diretamente para a Parte II: Especificação Operacional para Máquinas e Agentes Autônomos para consultar o catálogo MCP stdio de 27 ferramentas, o desbloqueio HTTP 402 em duas vias, as regras da sandbox de fronteira seq_matlock / cold_box e os contratos de encerramento.

Produto: Matlock — Ferramentas para Agentes e Desenvolvedores. (Eficiente. Exato. Rigoroso.)
Posicionamento: Verificação técnica local poliglota em < 50ms para AST, MITRE CWE, IEEE Std 1003.1 POSIX, CISA SSDF e AICPA SOC 2 Trust Services Criteria com selos de testes Salvaguarda à prova de violação, sandboxes Pre-CI de fronteira, automação CLI em 1 clique e MCP stdio local de 27 ferramentas (0 envios de código para a nuvem, 0 portas abertas, 0 bloqueio de git commit).
Editor: Matlock by Dutch P2P © 2026. Todos os direitos reservados.
Superfícies: Central de Comando Desktop (Windows, Linux e GoogleBook; macOS arm64 (matlock-mcp headless pronto) — pressione ? ou F1 a qualquer momento) · Central de Comando Web · Varredura Gratuita no Navegador · Documentação · Manual Online · URI MCP matlock://help/appliance-manual

Escopo e Aviso Legal: O Matlock avalia controles técnicos de base de código e de pipeline em relação a especificações e referências publicadas do setor (MITRE CWE, CISA SSDF, IEEE Std 1003.1 POSIX, portões automatizados de integridade Pre-CI e controles técnicos do AICPA SOC 2 Trust Services Criteria). O Matlock não garante software livre de defeitos, não emite relatórios formais de atestação de terceiros nem fornece certificações de uma firma independente de contadores públicos certificados habilitada (CPA).

Parte I: Guia do Operador Humano e Bancada

1. Glossário Rápido e Fluxo Principal

2. Layout da Tela, Temas e Navegação

3. Scripts Descobertos, Verificações Personalizadas, Ações e Favoritos

4. Rotinas Autônomas, Comandos do Computador e Alertas Locais

CartãoWindowsLinuxNotas
Shutdown in 30 minutesshutdown.exe /s /t 1800shutdown -h +30Atraso de 30 min, nunca /f; pareado com Cancel shutdown
Cancel shutdownshutdown.exe /ashutdown -cCancelamento imediato em 1 clique
Clean temporary filesApenas pasta temp do usuário, pula em usoArquivos > 1 dia em ~/.cache e /tmpNunca toca nos arquivos do projeto
Check disk spaceGet-PSDrive -PSProvider FileSystemdf -hSomente leitura
Optimize disk (defrag or trim)Optimize-Volume -DriveLetter C -Verbosefstrim -avExige admin/root; avisa de forma limpa sem pedir UAC/sudo
Backup copyrobocopy . "<backup-folder>" /MIRrsync -a --delete ./ "<backup-folder>/"Mantém .git, pula caches; robocopy 0–7 = Aprovado
Find a Word & Expose Itfindstr /s /i /m /c:"Aluminium" *.dartgrep -rnI "Aluminium" --include="*.dart" .Busca recursiva editável sem diferenciar maiúsculas
Lines Over 250 Catchfor /r %i in (*.dart) do ... find /c /v ""find . -name "*.dart" -exec awk '... c>250 ...' {} +Varredura somente leitura listando arquivos acima de 250 linhas

5. Cascata de Resultados, Reexecução Isolada, Ignorar e Copiar

6. Salvaguarda Fixa Antiviolação, Integridade dos Testes e Restauração

7. Barras Horizontais de Pontuação, Cobertura e Padrão de Modularidade

8. Configurações em Duas Colunas e Recuperação de Estado Selado

Clique em Settings no canto superior direito para abrir o diálogo em 2 colunas (coluna esquerda com 6 categorias + controles diretos à direita; cada cabeçalho traz um botão ? que abre a seção correspondente do Manual):

  1. Appearance: Idioma (9 idiomas + idioma do texto copiado), Tema (System Default, Light, Dark Slate), atalho na área de trabalho e Minimize to System Tray when closed no Windows.
  2. Project & Runner: Seletor de Modularidade (Grade A..Minimum), Open folder do perfil local (pasta privada do perfil de usuário), Restaurar faixa de configuração inicial (Restore starter setup banner, reabre Set up for me), Keep Quick Run history e Reset Ignore Registry.
  3. Safeguard & Restore: Allow Matlock to restore tests, reversão automática de Salvaguarda exclusiva para pessoas e Sync across my computers (sincronização selada por pasta).
  4. Email Alerts (matlock://settings/alerts): Estação local de alertas email_smtp e custom_script + Test Email.
  5. AI Agent (MCP): Chave MCP Server (stdio) (desativada por padrão), ponte bidirecional "Sincronizar com Headless" ("Sync with Headless" em 1 clique para carregar cartões/sequências do agente e publicar instruções permanentes com 0 polling em segundo plano), Test MCP Connection, Copy MCP Config & Agent Instructions, Copy a question for my phone AI e Agent Email Bridge.
  6. License & Updates: Activate da chave de 24 caracteres / Move license to this device, Automatically check for updates (MATLOCK_OFFLINE=1 bloqueia toda rede de saída), Send anonymous crash diagnostics (desativado por padrão; MATLOCK_NO_TELEMETRY=1), Copy diagnostic info, Free up memory, Share Matlock, Contact us (dutch@dutchp2p.com) e Dutch P2P Tools.
  7. Recuperação de Estado Selado (Reset Ignore Registry): Se edições externas acionarem integrity_seal:MUTE_SEAL_TAMPERED ou storage_recovery:BAK_AUTO_RESTORE, abra Settings -> Project & Runner -> Storage & backup -> Reset Ignore Registry.

9. Conexão de Agentes de IA (MCP no Desktop e Guia para Celular/Chat)

{
  "mcpServers": {
    "matlock": {
      "command": "matlock.exe",
      "args": ["mcp", "--stdio"]
    }
  }
}

10. Referência de Padrões Integrados (10 Ecossistemas + Pre-CI)

Cada verificação integrada é compilada no Matlock e ancorada aos controles técnicos de MITRE CWE, CISA SSDF (NIST SP 800-218), IEEE Std 1003.1 POSIX, portões Pre-CI e AICPA SOC 2 Trust Services Criteria:

Ecossistema e DomínioO Que o Matlock Inspeciona e Falhas de Produção Evitadas
Núcleo Poliglota e Dart / FlutterBlocos catch silenciosos (CWE-391), riscos null/limites (CWE-476/CWE-125), corridas async sem await, vazamentos de streams/timers/controladores (CWE-401), loops infinitos (CWE-835), segredos fixos (CWE-798), segredos em logs (CWE-532), desativação da verificação de certificados TLS em HTTP/SMTP/CLI/CI (CWE-295 / [MITRE T1557]), SQLi (CWE-89), SSRF (CWE-918), XXE (CWE-611), JWT sem assinatura (CWE-347), redirecionamentos abertos (CWE-601), falta de timeouts, gravações não atômicas, travessia de caminho (CWE-22) e testes vazios (CWE-362).
Java (.java)Chaves embutidas (CWE-798), injeção de comandos/SQL (CWE-78/CWE-89), desserialização insegura (CWE-502), cifras fracas (CWE-327), exceções engolidas (CWE-391), vazamento de JDBC/streams (CWE-404), bugs == em strings, System.exit abrupto e sleeps em loop.
Python (.py)Segredos fixos (CWE-798), injeção shell/SQL (CWE-78/CWE-89), cargas inseguras pickle/yaml (CWE-502), hashes fracos (CWE-328), except vazio (CWE-391), argumentos padrão mutáveis, descritores abertos (CWE-775), chamadas síncronas em async def e testes vazios.
Rust (.rs)Segredos embutidos (CWE-798), strings shell/SQL formatadas (CWE-78/CWE-89), conversões unsafe sem guarda, TLS desativado (CWE-295), pânicos .unwrap()/todo!() em produção, sleeps bloqueantes em async, vazamentos intencionais (CWE-401), Result descartados e testes vazios.
Go (.go)Tokens fixos (CWE-798), exec/SQL concatenados (CWE-78/CWE-89), InsecureSkipVerify (CWE-295), RNG fraco (CWE-330), erros ignorados (CWE-252), vazamentos defer em loop e contextos não cancelados (CWE-404), clientes HTTP sem timeout, panic em produção e testes vazios.
TypeScript e JavaScript (.ts, .tsx, .js, .jsx)Segredos expostos (CWE-798), sumidouros DOM XSS / eval (CWE-79/CWE-95), interpolação shell (CWE-78), poluição de protótipo (CWE-1321), .catch() vazio (CWE-391), supressões de tipo, bugs NaN, bloqueios de E/S síncrona, sobras debugger e vazamento de listeners/timers (CWE-401).
C e C++ (.c, .cpp, .cc, .h, .hpp)Segredos fixos (CWE-798), cópias FFI/buffer sem limite (CWE-787/CWE-120), strings de formato (CWE-134), injeção system() (CWE-78), new[]/delete incompatíveis (CWE-762), use-after-free (CWE-416), destrutores que lançam exceção, memset em tipos não triviais e threads sem join.
Kotlin e Android (.kt, .kts)Segredos fixos (CWE-798), concatenação SQL (CWE-89), pontes WebView inseguras, TLS ignorado (CWE-295), preferências legíveis globalmente (CWE-276), corrotinas GlobalScope vazadas (CWE-401), travamentos na thread principal, falhas !!, CancellationException engolida e cabeçalhos ZIP/APK inválidos (CWE-190).
C# e .NET (.cs)Recursos IDisposable não liberados (CWE-404), falhas async void, strings SQL/comandos sem parâmetros (CWE-89/CWE-78), validação de certificado TLS desativada (CWE-295), exceções engolidas (CWE-391), deadlocks síncronos .Result/.Wait() e testes vazios.
SQL e Motores de Armazenamento (.sql)Permissões curinga (CWE-250), SQL dinâmico concatenado (CWE-89), senhas em texto puro em DDL (CWE-256), escape para comandos do SO (CWE-78), RLS desativado, DELETE/UPDATE sem cláusula WHERE, migrações não idempotentes, paginação OFFSET profunda e bloqueios de tabela sem guarda.
Pre-CI Multiplataforma, Bash/Shell (.sh), PowerShell (.ps1), Dockerfile e GitHub Actions YAMLColisões de maiúsculas/minúsculas (POSIX.1), shebangs CRLF, armadilhas de portabilidade Bash/POSIX e erros $ErrorActionPreference / LASTEXITCODE no PowerShell, tags Dockerfile não fixadas e contêineres como root, estouro de orçamento HTML/ativos, armadilhas .cmd/.bat no Windows, descritores vazados (CWE-775), separadores de caminho fixos, imports não rastreados, desvio de lockfiles, permissões abertas em GitHub Actions YAML, injeção em workflows e perda de bits +x.
Modularidade e Verificações PersonalizadasSeletor de Modularidade exclusivo para pessoas (Grade A <= 60 até Minimum <= 1000, padrão Grade C <= 250 arquivo / <= 80 fn; CWE-1080 / CWE-1120) mais verificações de padrão e script salvas no perfil do SO.

11. Licença Workstation Pro, Prévia Web e Varredura Gratuita

12. Linux, GoogleBook, Atualizações, Privacidade e Suporte

Parte II: Especificação Operacional para Máquinas e Agentes Autônomos

A. Pontos de Entrada e Transporte do Agente

{
  "mcpServers": {
    "matlock": {
      "command": "matlock-mcp",
      "args": ["--stdio", "--headless", "--no-coverage"]
    }
  }
}

B. Medição, Acesso M2M em Enxame e Desbloqueio Pro

C. Catálogo Completo de 27 Ferramentas MCP Locais

  1. matlock_run_scan(target_path?, changed_only?, dedup_by_rule?, if_none_match?, agent_id?, rule_id?, category?, pillar?, file_filter?, include_generated?, compact?, cursor?, rule_code?, transaction_signature?): Index 0 (readOnlyHint: true) varredura AST, CWE, POSIX e Pre-CI em < 50ms com file:line:col (col >= 1), cwe, mitre_attack e prescrições diff de 5 linhas (também suporta CLI matlock-mcp scan . --format=sarif em SARIF 2.1.0).
  2. matlock_describe_project(target_path?, mode?): Perfil opcional do projeto (0 créditos, readOnlyHint: true); passe mode: "tool_bag" (ou CLI matlock-mcp toolbag [--json]) para um inventário progressivo de ~350–550 tokens com cartões [LOCKED] (somente execução) vs. [MODIFIABLE] (refináveis), sequências, selos [NEW] / [UPDATED], marcas [UNAVAILABLE IN CONTAINER], instruções permanentes e prontidão de alertas.
  3. matlock_get_scan_results(target_path?, cursor?, pillar?, rule_code?): Achados paginados (25/página; Desktop oculta linhas Salvaguardadas até desbloquear; --headless com Tanque de Gás libera coordenadas).
  4. matlock_qualify_test(file | files, target_path?, dry_run?, baseline_only?, wait_if_busy?, max_wait_seconds?): Verifica 1–5 arquivos de teste (test_file / test_files) em 3 portões (execução aprovada com >= 1 asserção, 0 avisos do analisador + teto LOC, 0 achados Matlock) antes de selar na Salvaguarda, ou sela linha de base (baseline_only: true).
  5. matlock_get_test_integrity(target_path?, reverify?, include_archive?, id?, include_text?, note_for_id?, note?): Inspeciona registros de integridade de testes removidos e anexa notas explicativas do agente (0 permissão de dispensa).
  6. matlock_get_history(target_path?, limit?): Histórico somente leitura de notas e correções.
  7. matlock_read_appliance_manual(section_id?, standard_id?, query?, locale?): Manual offline (9 idiomas) e consulta CWE/POSIX/SSDF/SOC2/resultados (0 créditos, 0 rede).
  8. matlock_list_custom_tests: Lista verificações personalizadas definidas pelo usuário.
  9. matlock_register_custom_test: Salva uma verificação personalizada de padrão ou script.
  10. matlock_delete_custom_test: Exclui uma verificação personalizada desbloqueada (as integradas são imutáveis).
  11. matlock_list_actions: Lista cartões de ação (com favorite/bloqueio/aprovação) mais recommendedTemplates não configurados (unconfiguredTemplate: true).
  12. matlock_register_action(id, command, name?, favorite?): Programa ou atualiza qualquer Ação desbloqueada ou modelo inicial (tpl_github, tpl_save_drive, tpl_cloud_sync, tpl_save_backup, tpl_defrag_optimize, tpl_shut_down), limpa unconfiguredTemplate, fixa/remove Favoritos (favorite: true | false) e exige Require Approval no Desktop.
  13. matlock_register_sealed_script: Sela comandos de build/test (Locked by User) contra subagentes.
  14. matlock_run_action(id, working_dir?, async?, send_alert?, cold_box?): Executa um comando sob contenção de árvore de processos do SO (async: true não bloqueante, send_alert, cartões USB robocopy/rsync, nuvem R2/S3/GCS/Azure e git push personalizados; 0 git push embutido nos testes do Matlock).
  15. matlock_get_action_status(id?): Consulta status ao vivo, código de saída e cápsulas compactas de execuções async: true.
  16. matlock_stop_action(id?, stop_sequence?): Encerra imediatamente uma árvore de processos ativa (stop_sequence: true interrompe toda a sequência ativa).
  17. matlock_delete_action: Exclui um cartão de ação desbloqueado.
  18. matlock_list_sequences: Lista rotinas de várias etapas.
  19. matlock_register_sequence(id, name?, step_ids?, commands?, insert_step_id?, insert_command?, insert_step_name?, insert_at_index?, remove_step_index?, failure_policy?, always_run?, favorite?): Compõe ou edita em série uma Sequência desbloqueada, inserindo qualquer Ação ou alert::<id> no índice exato insert_at_index (base 0) com failure_policy ("stop" | "stop_and_alert" | "continue_and_alert"), always_run e favorite: true | false.
  20. matlock_run_sequence(id, file?, async?, send_alert?, cold_box?, deep?, include_coverage?): Executa seq_matlock ou seq_fast_verify (file para um único arquivo de teste, async: true para execução em segundo plano com despertar automático, send_alert para notificações; cold_box: false padrão para velocidade; cold_box: true antes de salvamento externo, nuvem, backup, push ou compilação, retornando em < 15ms quando já verificado; deep: true força limpeza completa e recalibração de cobertura).
  21. matlock_delete_sequence: Exclui uma rotina desbloqueada.
  22. matlock_list_alerts: Lista canais de alerta locais (segredos mascarados).
  23. matlock_set_alert: Configura alertas email_smtp somente de saída em Native Dart TLS 1.2/1.3 (predefinições globais, chaveiro do SO ou cofre local de contêiner selado por frase-senha) ou custom_script.
  24. matlock_trigger_alert(id, status, task_completed, uncovered_issues, next_move): Dispara notificação local com as 3 perguntas obrigatórias de encerramento.
  25. matlock_delete_alert: Exclui um cartão de alerta desbloqueado.
  26. matlock_purchase_license(transaction_signature?, license_key?, target_path?, network?, runs?, lid?): Liquida créditos medidos para enxames de agentes autônomos (ver /pt/agents) ou ativa uma license_key Pro de 24 caracteres de aprox. R$ 140* ($24.99 USD/ano).
  27. matlock_report_issue(category, subject, description, tool_context?, output_dump?): Relatório assíncrono higienizado de feedback/sugestão (0 créditos, CONTINUE_IMMEDIATELY).

D. Sandbox Cold Box de Fronteira, Governador de 3 Loops e Encerramento

E. Especificação Legível por Máquina para Agentes de IA (YAML)

product: "Matlock — Agent & Developer Tools. (Efficient. Exact. By the book.)"
pinned_version: "v1.0.0+1"
web_command_center: "https://matlock.dutchp2p.com/pt/app"
free_local_scan: "https://matlock.dutchp2p.com/pt/#wasm-instant-audit"
docs_hub: "https://matlock.dutchp2p.com/pt/docs"
online_manual: "https://matlock.dutchp2p.com/pt/manual"
public_repository: "https://github.com/Dutchp2p/matlock-public"
online_operational_map: "https://matlock.dutchp2p.com/llms.txt"
mcp_resource_uri: "matlock://help/appliance-manual"
mcp_stdio_command: "npx -y @dutchp2p/matlock-mcp | uvx matlock-mcp | matlock.exe mcp --stdio (Windows) | matlock mcp --stdio (.deb) or /path/to/matlock-linux-x64.AppImage mcp --stdio (Linux & GoogleBook) | matlock-mcp --stdio --headless --no-coverage (Linux x64, Windows x64 & macOS arm64)"
network_ports: 0
git_hooks_installed: 0
builtin_git_push_in_test_runs: false
custom_push_deploy_actions_allowed: true
mcp_tools_count: 27
primary_pipeline:
  card: "Matlock"
  sequence_id: "seq_matlock"
  entry_tool_index_0: "matlock_run_scan"
  badge_svg_url: "https://matlock.dutchp2p.com/badge/verified.svg"
  stages: "Clean -> Get -> Format -> Lint -> Analyze/Compile -> Test -> Coverage (depth 0..2)"
  cold_box_default: false
  cold_box_boundary_triggers: ["before external git push", "before cloud-drive save", "before removable backup", "before release compile"]
modularity_tuning_dial:
  person_only_sealed_os_settings: true
  default_tier: "Grade C (<= 250 / <= 80 fn)"
  tiers: ["Grade A (<= 60 / <= 25 fn)", "Grade B (<= 100 / <= 40 fn)", "Grade C (<= 250 / <= 80 fn)", "Grade D (<= 500 / <= 120 fn)", "Minimum (<= 1000 / <= 250 fn)"]
ignore_scopes_5: ["file:line:code", "file:code", "*:code", "file", "folder/"]
lock_governance:
  safeguarded: "Read & Run Only (auto-reverts unauthorized edits + Envelope tamper alert)"
  unlocked: "AI agent can modify (Read, Write, Modify & Run)"
os_storage:
  scope: "private_user_profile_outside_repo"
  env_override: "MATLOCK_STATE_DIR"

F. Princípios Operacionais do Agente e Limites de Execução

Voltar ao topo