Files
rea/README_tr.md
Kaoru0822andClaude Opus 5.5 b6d8bb65d3 docs(readme): add responsible-use guidance and reframe the introduction
Reframe the tagline and opening paragraph around security research,
interoperability and authorized analysis. Add a "Responsible use"
section before Quick start that lists unsupported uses and the user's
legal responsibilities, replace the Notes example prompt with a
release-versus-debug crash investigation, and point the Disclaimer at
the new section while keeping the cryptocurrency statement.

Apply the same changes to all 18 translated READMEs, with anchors
matching each translated heading.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 06:03:22 +00:00

21 KiB
Raw Permalink Blame History

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Türkçe · Русский · Tiếng Việt · ไทย · Deutsch · Español · Français · Українська · Polski · Português (Brasil) · العربية · فارسی · Bahasa Indonesia · Italiano

REA: Her şeyi tersine mühendislikle inceleyin

İkili dosyaların, uygulamaların ve çalışma zamanı davranışının tersine mühendisliği için tek bir MCP.

Yazılımın nasıl çalıştığını ikili kod düzeyine kadar anlayın — güvenlik araştırmaları, birlikte çalışabilirlik ve analiz etme yetkiniz olan yazılımlar için.

npm version MCP tool catalog Node.js requirements skills.sh MIT license Discord

morluto%2Frea | Trendshift

Web sitesi · Rehberler · Örnek çalışmalar

Hızlı başlangıç · REA nasıl çalışır · Neleri analiz edebilirsiniz · Örnek çalışmalar · Sık sorulan sorular · Belgeler

npx rea-agents setup


REA, yerel bir ikili dosyayı incelerken Hopper içinde analiz köprüsünü başlatıyor



Discord
Tersine mühendislik topluluğuna katılın

Discord · Soru-cevap · Sonuç paylaşımı


REA; güvenlik araştırmacılarının, kötü amaçlı yazılım analistlerinin, CTF oyuncularının ve geliştiricilerin derlenmiş yazılımları ajanları aracılığıyla anlamasına yardımcı olur. Ajanınızı analiz etme yetkiniz olan bir ikili dosyaya, uygulamaya veya yakalamaya yönlendirin; REA onu kaynak kodu olmadan inceler, davranışını açıklar ve her sonucun dayandığı kanıtları gösterir.

REA, ajanınızı yerel makine kodu içeren ikili dosyaları, JavaScript ve Electron uygulamalarını, .NET derlemelerini ve web sitelerini inceleyen araçlara bağlar. Aynı araçları terminalden de kullanabilirsiniz. Analiz yerel olarak çalışır; sonuçlar her çıkarımın dayandığı kanıtları ve sınırlamaları içerir.

Kurulum, REA'yı ajanınıza kaydeder ve uyumlu iş akışı talimatlarını yükler. Yerel makine kodu analizi mevcut bir Hopper veya Ghidra kurulumunu kullanabilir; kurulum işlemi, onayınızla isteğe bağlı olarak Hopper da yükleyebilir. Statik JavaScript analizi bu iki motora da ihtiyaç duymaz.

Kurulum talimatları, görselli rehberler ve gerçek örnek çalışmalar için REA web sitesini ziyaret edin.

Sorumlu kullanım

REA yasal analiz için tasarlanmıştır: güvenlik araştırmaları, kötü amaçlı yazılım ve olay analizi, güvenlik açığı araştırması ve koordineli açıklama, CTF'ler ve eğitim, birlikte çalışabilirlik, yazılımların korunması ve sahibi olduğunuz ya da inceleme yetkiniz olan yazılımlarda hata ayıklama veya denetim.

REA projesi aşağıdakileri desteklemez ve bunlara yardım etmez:

  • DRM'yi, lisans denetimlerini, hile önleme sistemlerini veya diğer teknik koruma önlemlerini atlatmak;
  • oyun hileleri geliştirmek veya çevrim içi hizmetlere müdahale etmek;
  • test etme yetkiniz olmayan sistemlerde kimlik doğrulamayı, bot korumasını veya erişim denetimlerini aşmak;
  • tescilli yazılımları kopyalamak veya korunan kodlarını ve varlıklarını yeniden üretmek;
  • yapay zekâ modeli sağlayıcılarının kullanım politikalarından veya güvenlik önlemlerinden kaçmak;
  • yapay zekâ hesaplarını veya API erişimini yeniden satmak ya da paylaşmak.

Gerekli izinleri almak ve geçerli yasalara, lisans sözleşmelerine ve hizmet şartlarına uymak sizin sorumluluğunuzdadır. Tersine mühendislik, bulunduğunuz yargı bölgesinde veya analiz ettiğiniz yazılımın lisansı tarafından kısıtlanmış olabilir.

Yukarıdaki kullanımlar için yardım talepleri, issue'larda ve tartışmalarda yanıt verilmeden kapatılır ve REA topluluğundan çıkarılmaya yol açabilir.

Hızlı başlangıç

Ajanınızı yapılandırın

Node.js ve npm yüklüyken şu komutu çalıştırın:

npx rea-agents setup

Ajanlarınızı seçin, önerilen değişiklikleri inceleyin ve onaylayın. Kurulum, mevcut yapılandırmaları yedekleyerek REA'nın MCP sunucusunu ve uyumlu iş akışı talimatlarını ekler. Ardından ajanınızı yeniden başlatın.

Kurulum Claude Code, Codex, Cursor, Gemini CLI, Grok Build ve diğer ajanları destekler. Sağlayıcı yapılandırması ve elle MCP kaydı için yükleme ve kurulum belgesine bakın.

Ajanınıza sorun

Uygulamamın release derlemesi açılışta çöküyor ama debug derlemesi çökmüyor.
./build/MyApp dosyasını incele, iki derlemenin nerede ayrıştığını bul ve kanıtları göster.

Ajanınızı analiz etme yetkiniz olan bir hedefe yönlendirin ve neyi anlamak istediğinizi açıklayın.

Terminali kullanın

Çıkarılmış bir JavaScript/Electron uygulama dizinini veya ASAR dosyasını inceleyin:

npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json

Sonuç; modülleri, içe aktarmaları, Electron sınırlarını ve bunlara ilişkin kanıtları içerir. Yolu hedefinizle değiştirin; Windows'ta örneğin "D:/apps/example" kullanabilirsiniz.

Düzenli kullanım için rea komutunu yüklemek üzere:

npm install --global rea-agents
rea --help

Yerel makine kodu analizi için önce bir sağlayıcı yapılandırın. Yerel analiz komutları, sağlayıcı seçimi, anlık görüntüler ve betik kullanımı için CLI ve Evidence rehberine bakın.

REA'yı güncelleyin

REA hızla değişir ve yeni sürümler sık sık hata düzeltmeleri içerir. Kurulumunuzu güncel tutun.

npm ile yüklenen CLI için:

rea update

Ajan kayıtlarını ve skill'i güncellemek için güncellemenin çıktısında gösterilen kurulum komutunu çalıştırın.

npx kullanıyorsanız ajan kurulumunu şu komutla güncelleyin:

npx rea-agents@latest setup

Kurulum değişikliklerini inceleyin ve ajanınızı yeniden başlatın. Tek seferlik CLI işlemleri için npx rea-agents@latest komutunun ardından istediğiniz komutu yazın.

REA nasıl çalışır

Ajanınız, hedefi incelemek ve ilgili kodu izlemek için MCP üzerinden REA'yı çağırır. REA bulguları kanıtlarıyla birlikte döndürür. Ajan bunları takip soruları sormak, davranışı açıklamak veya bir uygulama yazıp test etmek için kullanır. CLI komutları aynı iş akışlarını kullanır.

REA araştırma akışı: ajanınız yerel bir hedef hakkında soru sorar, REA analiz araçlarıyla hedefi inceler ve izler; ajan döndürülen kodu, referansları ve bilinmeyenleri açıklama, geliştirme ve test için kullanır.

Şekli tam boyutuyla açın.

Neleri analiz edebilirsiniz

REA; Node.js 22.x (>=22.19), 24.x (>=24.11) veya 26+ ve npm gerektirir. Ek araçlar ve desteklenen ana bilgisayar sistemleri hedefe bağlıdır:

Hedef REA'nın döndürdükleri Gereksinimler ve rehber
Yerel makine kodu içeren ikili dosyalar Sözde kod, assembly kodu, dizeler, semboller, çağrılar ve referanslar Hopper, Ghidra veya IDA; yerel kod analizi
Çevrimdışı ELF yapısı Bölümler, segmentler, özgün semboller/yeniden konumlandırmalar ve statik analizden olası güvenlik önlemleri Linux x64 üzerinde çağıranın sağladığı pwntools; ikili dosya tanılama
EVM bayt kodu Yönlendirme seçicileri, bayt ofsetleri, çıkarımla belirlenen argümanlar ve durum değiştirilebilirliği Linux x64 üzerinde yerel ham bayt/onaltılık girdi; çevrimdışı EVM rehberi
Kaydedilmiş Linux çökmeleri Ham note kayıtları, kaydedilen her iş parçacığının yazmaçları/sinyalleri ve isteğe bağlı eşleme adayları Linux x64 üzerinde çağıranın sağladığı pwntools; isteğe bağlı GDB/pwndbg; kaydedilmiş çökmeler
JavaScript / Electron Modüller, içe aktarmalar, kaynak haritaları, rotalar, IPC ve yerel eklenti ilişkileri Node.js ve npm; uygulama analizi
Web siteleri Sayfa yapısı, betikler, ağ gözlemleri ve istenen ekran görüntüleri Chrome ailesinden bir tarayıcı; tarayıcı analizi
Kaydedilmiş ağ yakalamaları İstekler, yanıtlar, erişilebilir yük içerikleri ve kaynak konumları HAR; mitmproxy'nin kendi biçimindeki yakalamalar için Linux üzerinde mitmdump; ağ yakalama rehberi
.NET derlemeleri Meta veriler, CIL talimatları, bildirilmiş yerel bağımlılıklar ve derleme karşılaştırmaları Statik inceleme; yönetilen kod rehberi
Android APK'leri Manifest bildirimleri, sınıflar, tersine derlenmiş metotlar ve referanslar Linux/macOS/Windows x64 üzerinde arayüzsüz JADX ve tam bir JDK; Android rehberi
Android cihazları Cihazlar, paketler, süreçler, günlükler, dökümler, ekran görüntüleri ve APK/dosya aktarımları Çağıranın sağladığı adb (emülatör veya cihaz); ADB rehberi
JEB projeleri Motor destekli proje birimleri, artefakt özetleri ve tür/metot sözdekodu Çağıranın başlattığı, MCP sunan bir JEB istemcisi, REA_JEB_MCP_URL ile seçilir; JEB rehberi
Android kaynakları Çözülmüş manifest, dize tabloları, diller ve sürüm bilgileri Çağıranın sağladığı Apktool başlatıcısı; kaynak rehberi
Donanım yazılımı Bölgeler, çıkarma sonuçları ve yerel kod analizine devirler Linux üzerinde Binwalk / Unblob; donanım yazılımı rehberi
Paketler ve kaynaklar Dosya envanterleri, özet değerleri, plist'ler, Apple paket yapısı ve çıkarılmış kaynaklar Artefakt ve JavaScript rehberi, Apple uygulamaları
Süreç davranışı Terminal çıktısı, etkileşimler, sonlanma ve dosya sistemi gözlemleri, çalıştırma karşılaştırmaları Yerel PTY ile Linux/macOS; süreç yakalama

Statik JavaScript ve .NET incelemesi, uygulamayı çalıştırmadan sağlanan dosyaları okur. Çalışma zamanı yakalaması, seçilen hedefi kullanıcı izinlerinizle çalıştırır veya onunla etkileşime girer; her çalışma zamanı rehberi etkilerini açıklar.

Yerel makine kodu içeren ikili dosya biçimleri ve ana bilgisayar desteği sağlayıcıya göre değişir. Hopper ve Ghidra kurulumu, IDA rehberi ve Windows için deneysel Ghidra desteği belgelerine bakın. Ghidra ayrıca 16 bit DOS analizini destekler. Sağlayıcı seçimi için CLI rehberine bakın. En son npm sürümünden sonra eklenen özellikler için sürümlerde kullanılabilirliği kontrol edin.

Örnek çalışmalar

DX-Ball ses kaydırma, Notion pano köprüsü ve TH04 mermi halkası örneklerinin çizimleri

DX-Ball: Sesin stereo konumlandırma hesabını yeniden oluşturma

Bir ses çağrısından konumu stereo konumlandırmaya dönüştüren yardımcı fonksiyona ilerleyin, talimatları inceleyin ve eksik sözde kodu C'ye dönüştürün. Yeniden oluşturulan kod, özgün x86 üzerinde 3.205 test durumunu geçer ve derlenmiş fonksiyonun 63 baytının tamamını yeniden üretir.

Örnek çalışmayı okuyun · Yeniden oluşturma deposu

Notion: Electron pano köprüsünü izleme

İşleyici sürecin pano API'sini bulun, preload ve IPC üzerinden ana sürece kadar izleyin ve zengin pano biçimini inceleyin.

Örnek çalışmayı okuyun

TH04: DOS mermi halkası hesabını geri çıkarma

Özgün PC-98 oyununun 16 bit talimatlarını inceleyin, sabit ve hedefe yönelik açı hesaplarını geri çıkarın ve yeniden oluşturulan C++ kodunu dönemin derleyici çıktısıyla karşılaştırın.

Örnek çalışmayı okuyun · Yeniden oluşturma deposu

REA'yı ilginç bir konuda kullandıysanız görmek isteriz. Hedefi, sorunuzu, REA'nın nasıl yardımcı olduğunu ve bulgularınızı bir issue veya pull request ile paylaşın.

Sık sorulan sorular

Hangi ajanlar REA'yı kullanabilir?

Yerel MCP sunucularını destekleyen her ajan REA'yı kullanabilir. Kurulum, desteklenen ajanları yapılandırır; diğer istemciler elle MCP kaydını kullanabilir.

Hopper, Ghidra veya IDA gerekiyor mu?

Derin yerel kod analizi bunlardan birini kullanır. Statik JavaScript ve .NET incelemesi yerel analiz motoru olmadan çalışır. Kurulum onaydan sonra Hopper yükleyebilir; Ghidra ve IDA mevcut kurulumlarınızı kullanır. Sağlayıcı kurulumuna bakın.

Önce Hopper'ı başlatmam gerekiyor mu?

REA, bir işlem gerektirdiğinde Hopper'ı başlatır. macOS'ta ilk çalıştırmada demo modunu seçmenizi veya lisansınızı etkinleştirmenizi isteyen bir iletişim kutusu açılabilir. Hopper başlatma ve sorun giderme belgesine bakın.

skills.sh üzerinden skill yüklemek ne yapar?

Skill, ajanınıza araştırma talimatları sağlar. REA'nın MCP sunucusunu kaydetmek ve uyumlu talimatları yüklemek için npx rea-agents setup kullanın, ardından ajanınızı yeniden başlatın. Yalnızca skill yükleme belgesine bakın.

REA hangi kodu döndürür?

Yerel kod analizi sözde kod ve assembly kodu döndürür. JavaScript/Electron analizi modülleri ve aralarındaki ilişkileri geri çıkarır. Ajanınız bu bulgularla bir uygulama yazar ve test eder; örnek çalışmalar uygulamalı örnekler sunar.

REA uygulamamı yükler mi?

REA hedefleri yerel olarak analiz eder. Ajanınız araç sonuçlarını alır ve model sağlayıcısının kendi veri politikası vardır.

Bir hatayla karşılaşırsam ne yapmalıyım?

Önce güncelleyin; yakın tarihli bir sürüm hatayı düzeltmiş olabilir.

npm ile yüklenen CLI için:

rea update

npx üzerinden ajan kurulumu için:

npx rea-agents@latest setup

Ajan kullanıyorsanız kurulum yenilemesini tamamlayın ve ajanı yeniden başlatın. Aynı görevi tekrar deneyin. Sorun sürerse REA sürümünüzü, hedef türünü, yeniden üretme adımlarını ve hata çıktısını içeren bir issue açın.

Belgeler

Web sitesindeki uygulamalı rehberlerden başlayın. Kesin seçenekler, ön koşullar ve sonuç sözleşmeleri için:

Güvenlik açıklarını SECURITY.md üzerinden bildirin.

Yıldız geçmişi

🎉 GitHub'da 110.000 yıldız — teşekkürler!

REA'yı kullanan, hata bildiren, özellik talep eden, derlemeleri test eden ve düzeltmelere katkıda bulunan herkese teşekkürler.

REA GitHub yıldız geçmişi

Sorumluluk reddi

Bkz. Sorumlu kullanım.

Katkıda bulunma

REA'ya katkınızı bekliyoruz! Hata bildirmek veya özellik önermek için bir issue açın; kodu veya belgeleri geliştirmek için bir pull request gönderin.

Geliştirme ortamı ve kontroller için CONTRIBUTING.md, doğrulama süreçleri için test rehberi ve proje yapısı için mimari harita belgelerine bakın.

Lisans

MIT