18 KiB
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Türkçe · Русский · Tiếng Việt · ไทย · Deutsch · Español · Français · Українська · Polski · Português (Brasil) · العربية · فارسی · Bahasa Indonesia · Italiano · Ελληνικά · മലയാളം · Roman Urdu · Română · Български
REA: Kỹ thuật dịch ngược cho mọi thứ
Một MCP để dịch ngược tệp nhị phân, ứng dụng và hành vi khi chạy.
Thấy một tính năng bạn thích? Hiểu cách nó hoạt động, đến tận mức mã nhị phân.
Trang web · Hướng dẫn · Các nghiên cứu điển hình
Bắt đầu nhanh · Các nghiên cứu điển hình · Cách REA hoạt động · Những gì bạn có thể phân tích · Xây dựng môi trường RL · Câu hỏi thường gặp · Tài liệu
npx rea-agents setup
Important
Các nguồn chính thức của REA: morluto/rea, rea.tools, rea-agents (npm). Hãy dùng các liên kết cài đặt và bản phát hành từ những nguồn chính thức này. Tên kho mã tương tự hoặc README được sao chép không chứng minh rằng tệp tải xuống là bản chính thức.
Bạn thấy một tính năng trong ứng dụng và muốn đưa nó vào sản phẩm của mình? Hãy nhờ tác nhân của bạn điều tra bằng REA. Tác nhân có thể kiểm tra ứng dụng mà không cần mã nguồn, giải thích cách tính năng hoạt động, đưa ra bằng chứng và xây dựng một phiên bản cho dự án của bạn.
REA kết nối tác nhân của bạn với các công cụ kiểm tra tệp nhị phân mã máy, ứng dụng JavaScript và Electron, assembly .NET và trang web. Bạn cũng có thể dùng các công cụ đó từ terminal. Việc phân tích chạy cục bộ; kết quả bao gồm bằng chứng và giới hạn làm cơ sở cho từng kết luận.
Thiết lập đăng ký REA với tác nhân và cài hướng dẫn công việc tương ứng. Phân tích native dùng Hopper, Ghidra, IDA hoặc Kuna có sẵn; có thể cài Hopper sau khi bạn chấp thuận. Phân tích tĩnh JavaScript không cần công cụ phân tích native.
Bắt đầu nhanh
Thiết lập tác nhân (MCP)
Sau khi cài Node.js và npm, chạy lệnh sau từ một thư mục đáng tin cậy bên ngoài dự án cần phân tích.
npx rea-agents setup
Chọn các tác nhân, xem lại những thay đổi được đề xuất và chấp thuận. Quá trình thiết lập thêm máy chủ MCP của REA cùng hướng dẫn quy trình tương ứng, đồng thời sao lưu cấu hình hiện có. Sau đó khởi động lại tác nhân.
Hỏi tác nhân:
Tìm hiểu cách tính năng tìm kiếm trong ứng dụng Notes hoạt động, cho tôi xem bằng chứng và xây dựng tính năng tương tự cho dự án của tôi.
Thay Notes bằng ứng dụng mục tiêu và chỉ rõ tính năng bạn muốn hiểu.
Sử dụng terminal (CLI)
Kiểm tra thư mục ứng dụng JavaScript/Electron đã giải nén hoặc tệp ASAR:
npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json
Kết quả bao gồm mô-đun, các khai báo import, ranh giới Electron và bằng chứng tương ứng. Thay đường dẫn bằng mục tiêu của bạn, chẳng hạn "D:/apps/example" trên Windows.
Để cài lệnh rea cho việc sử dụng thường xuyên:
npm install --global rea-agents
rea --help
Để phân tích mã máy, trước tiên hãy cấu hình trình phân tích. Xem hướng dẫn CLI và Evidence về các lệnh phân tích mã máy, lựa chọn trình phân tích, ảnh chụp trạng thái và sử dụng trong script.
Cập nhật REA
Với CLI được cài bằng npm install --global / bun add --global:
rea update
Nếu dùng npx, cập nhật thiết lập tác nhân bằng:
npx rea-agents@latest setup
Các nghiên cứu điển hình
DX-Ball: tái tạo phép tính phân bố âm thanh trái phảiLần theo lời gọi âm thanh đến hàm hỗ trợ chuyển vị trí thành giá trị phân bố âm thanh, kiểm tra các lệnh và chuyển mã giả chưa đầy đủ sang C. Bản tái tạo vượt qua 3.205 trường hợp kiểm thử với x86 gốc và tái tạo đủ 63 byte của hàm đã biên dịch. |
Notion: lần theo cầu nối clipboard của ElectronTìm API clipboard trong tiến trình kết xuất, lần theo qua preload và IPC đến tiến trình chính, rồi kiểm tra định dạng clipboard có dữ liệu định dạng phong phú. |
TH04: khôi phục phép tính vòng đạn trong DOSKiểm tra các lệnh 16 bit của trò chơi PC-98 gốc, khôi phục phép tính góc cố định và góc nhắm mục tiêu, rồi so sánh C++ được tái tạo với đầu ra của trình biên dịch thời đó. |
Nếu bạn dùng REA cho một mục tiêu thú vị, chúng tôi muốn biết. Chia sẻ trường hợp của bạn qua issue hoặc pull request, nêu mục tiêu, câu hỏi, cách REA giúp bạn và những gì tìm được.
Cách REA hoạt động
Tác nhân gọi REA qua MCP để kiểm tra mục tiêu và lần theo mã liên quan. REA trả về các phát hiện kèm bằng chứng. Tác nhân dùng chúng để đặt câu hỏi tiếp theo, giải thích hành vi hoặc viết và kiểm thử một cách triển khai. Các lệnh CLI sử dụng cùng quy trình.
Những gì bạn có thể phân tích
Tệp nhị phân mã máy · JavaScript / Electron · Trang web · Assembly .NET · APK Android · Phần sụn · Hành vi tiến trình
Định dạng được hỗ trợ và yêu cầu
Xây dựng môi trường RL
Tạo môi trường cục bộ từ phiên web đã ghi hoặc ứng dụng máy tính Linux để tác tử thực hành một nhiệm vụ và kiểm tra kết quả.
Câu hỏi thường gặp
Tác nhân nào có thể dùng REA?
Bất kỳ tác nhân nào hỗ trợ máy chủ MCP cục bộ. Quá trình thiết lập cấu hình các tác nhân được hỗ trợ; ứng dụng khách khác có thể dùng đăng ký MCP thủ công.
Tôi có cần Hopper, Ghidra, IDA hoặc Kuna không?
Phân tích mã máy chuyên sâu sử dụng một trong những công cụ đó. Kiểm tra tĩnh JavaScript và .NET hoạt động mà không cần bộ máy phân tích mã máy. Quá trình thiết lập có thể cài Hopper sau khi được chấp thuận; Ghidra, IDA và Kuna dùng bản cài đặt sẵn có. Xem thiết lập trình phân tích.
Tôi có cần khởi chạy Hopper trước không?
REA khởi chạy Hopper khi một thao tác cần đến nó. Trên macOS, hộp thoại lần chạy đầu có thể yêu cầu chọn chế độ dùng thử hoặc kích hoạt giấy phép. Xem khởi động Hopper và khắc phục sự cố.
Cài skill từ skills.sh có tác dụng gì?
Skill cung cấp hướng dẫn điều tra cho tác nhân. Dùng npx rea-agents setup để đăng ký máy chủ MCP của REA và cài hướng dẫn tương ứng, sau đó khởi động lại tác nhân. Xem chỉ cài skill.
REA trả về mã gì?
Phân tích mã máy trả về mã giả và hợp ngữ. Phân tích JavaScript/Electron khôi phục mô-đun cùng quan hệ giữa chúng. Tác nhân dùng các phát hiện này để viết và kiểm thử cách triển khai; các nghiên cứu điển hình cung cấp ví dụ thực hành.
REA có tải ứng dụng của tôi lên không?
REA phân tích mục tiêu cục bộ. Tác nhân nhận kết quả công cụ, và nhà cung cấp mô hình của tác nhân có chính sách dữ liệu riêng.
Tôi nên làm gì khi gặp lỗi?
Hãy cập nhật trước; một bản phát hành gần đây có thể đã sửa lỗi.
Với CLI được cài bằng npm:
rea update
Với thiết lập tác nhân qua npx:
npx rea-agents@latest setup
Nếu dùng tác nhân, hãy hoàn tất làm mới thiết lập và khởi động lại nó. Thử lại cùng tác vụ. Nếu vấn đề vẫn còn, mở issue với phiên bản REA, loại mục tiêu, các bước tái hiện và đầu ra lỗi.
Tài liệu
Bắt đầu với hướng dẫn thực hành trên trang web. Để biết tùy chọn cụ thể, điều kiện tiên quyết và hợp đồng kết quả:
- Cài đặt và thiết lập: đăng ký tác nhân, cấu hình trình phân tích, cập nhật và gỡ cài đặt.
- Kiểm tra mức sẵn sàng và khắc phục sự cố: chẩn đoán một tác nhân hoặc bộ máy phân tích cụ thể.
- CLI và Evidence: lệnh, lựa chọn trình phân tích, ảnh chụp trạng thái, nhập/xuất và trạng thái thoát.
- Hợp đồng MCP và prompt cho tác nhân: kết quả công cụ, phiên làm việc và điều tra có hướng dẫn.
- Danh mục công cụ: danh sách công cụ, trình phân tích và lệnh CLI được tạo khi dựng dự án.
Báo cáo lỗ hổng theo SECURITY.md.
Cộng đồng và hỗ trợ
- Discord — Hãy đặt câu hỏi và chia sẻ những gì bạn đang tìm hiểu với cộng đồng hơn 50.000 người đam mê kỹ thuật đảo ngược và xây dựng các dự án mới!
- Twitter / X — Theo dõi @reatools để nhận tin mới.
- Góp ý và ý tưởng — Bạn muốn thêm tính năng hoặc hỗ trợ một định dạng tệp? Hãy cho chúng tôi biết qua GitHub hoặc Discord.
Lịch sử sao
🎉 400.000 sao trên GitHub — xin cảm ơn!
Cảm ơn mọi người đã sử dụng REA, báo lỗi, đề xuất tính năng, kiểm thử bản dựng và đóng góp bản sửa lỗi.
Đóng góp
Chúng tôi hoan nghênh bạn giúp phát triển REA! Mở issue để báo lỗi hoặc đề xuất tính năng, hoặc gửi pull request để cải thiện mã hay tài liệu.
Xem CONTRIBUTING.md về thiết lập môi trường phát triển và các bước kiểm tra, hướng dẫn kiểm thử về các luồng xác minh.
Miễn trừ trách nhiệm
Xem DISCLAIMER.md để biết hướng dẫn sử dụng có trách nhiệm.
REA dành cho nghiên cứu, giáo dục, khả năng tương tác, bảo tồn phần mềm và phân tích phần mềm bạn sở hữu hoặc được phép kiểm tra, trong khuôn khổ pháp luật.
The project's position on illegal or unauthorized use covers all REA versions, distribution channels, and platforms; each copy retains its applicable licenses.
Giấy phép
REA-authored code is licensed under MIT. Third-party material retains its own licenses and copyright notices; see Third-party notices for the dependency inventory, preserved license texts, and external-tool terms.
You must legally obtain and be authorized to use commercial tools, including IDA Pro / Hex-Rays decompilers, Hopper, and JEB, under their applicable licenses. REA grants no tool license, key, or activation entitlement. Trials and demos remain subject to vendor terms, including user, feature, automation, and output sharing restrictions. Cracked copies, stolen keys, unauthorized key sharing, and bypassing license restrictions are not authorized. This guidance does not amend MIT or third-party licenses.
