Files
reverse-engineering-anything/docs/readme/README_vi.md
T
Matt Van HornandMatt Van Horn 645735fc0f feat(windows): inspect Shell Link (.lnk) shortcut files (#7859)
* feat(windows): inspect Shell Link (.lnk) shortcut files

Add inspect_windows_shortcut / inspect-windows-shortcut to read one
local Shell Link without resolving or executing the target. The report
keeps header flags and FILETIMEs, IDList items, LinkInfo volume and
network names, StringData, ExtraData including Tracker droid facts
labelled derived, and derived observations such as argument length
and a minimized ShowCommand.

* fix(windows): tighten Shell Link string reads and coverage

- Decode counted StringData over its full CountCharacters payload.
- Locate LinkInfo string terminators before charging max_string_bytes
  and before decoding; an unterminated string is a coverage issue.
- Mark an IDList without a TerminalID and an out-of-range
  LinkInfoHeaderSize as partial coverage.
- Report arguments_present and argument_length as null when
  HasArguments is set but the field could not be read.
- Derive target_extension from the joined base path and suffix.
- Keep ISO dates for FILETIME and UUIDv1 timestamps before 1970.
- Retain the completed file snapshot on parse failures.
- Reject an empty CLI path before normalization.
- Select the shortcut contract from its family in focused tests.
- Fixture StringData no longer writes a NUL into the counted payload.

* style: format docs index and Shell Link boundary type

Apply oxfmt to the two files format:check reports so Static checks passes.

* fix(windows): reject network share paths for Shell Link reads

inspect_windows_shortcut is advertised as offline, but the Windows path
schema admits UNC paths, and lstat on one can contact an SMB server and
offer the caller's credentials.

Reject UNC, extended UNC, and other host-prefixed device paths in the
provider before any filesystem call. Extended drive paths such as
\\?\C:\x stay allowed. A mapped network drive cannot be told from a
local drive by its path, and the docs say so.

* fix(windows): decode Unicode Shell Link file-entry names

File-entry items with bit 0x04 of the type byte, such as 0x36, store a
UTF-16LE name, but the parser always read it as Latin-1. The read stopped
at the first zero byte, so report.exe became r and an IDList-only
shortcut reported the wrong target_extension. Read those names as
UTF-16LE.

* fix(windows): read volume labels by exact Shell Link discriminator

VolumeLabelOffset 0x14 selects VolumeLabelOffsetUnicode and is not itself a
label offset, and that Unicode field exists for no other value. The parser
treated any offset of 0x14 or more as having both, so a Unicode-only label such
as "OS" also produced a false ANSI label "O", and an ANSI label stored past 0x14
had its own bytes read as a Unicode offset.

Branch on the exact value in parseVolume, the one place that interprets it, and
report a VolumeID too short to hold the selected field. The fixture wrote both
encodings for a Unicode volume, which hid the false label, so it now writes one.

* fix(windows): limit network share rejection to Windows hosts

POSIX hosts read repeated leading slashes as one local root, so an
accepted selection such as ///tmp/shortcut.lnk is a local file there.
Apply the host-prefixed path check only on Windows, and take the
platform through the provider constructor so the Windows path forms
stay covered on every test host.

* fix(windows): compare shortcut icons only against full paths

A stored IDList filename or relative path cannot show that an icon at a
full path is elsewhere, so the comparison reported a false difference.
Report null unless the icon and a recorded target are both full paths,
and assert the missing TerminalID issue by code and offset instead of
its message.

* fix(windows): keep unread ExtraData blocks unknown

A walk that stopped before or inside ExtraData still reported the blocks
that HasExpString and HasExpIcon expect as absent, though they were never
checked for. Report a block as absent only after the TerminalBlock shows the
section was read in full. Without one the block stays unknown and coverage
stays partial.

* fix(native): ignore LNK network provider type unless ValidNetType is set

CommonNetworkRelativeLink NetworkProviderType is only meaningful when the
ValidNetType flag (0x2) is set. Return null otherwise.

* fix(native): accept any ExtraData TerminalSize below 4 as the terminal

MS-SHLLINK requires TerminalSize to be less than 4, not exactly 0. Treat
1, 2 and 3 as the terminal block instead of a malformed block.

* fix(native): derive shortcut target facts from the stored environment target

Include the EnvironmentVariableDataBlock literal target among the target
candidates for target_extension and the icon comparison. Variables are not
expanded and the target is not opened.

* fix(windows-shortcut): keep unexpanded variable paths unresolved in icon comparison

A stored environment target such as C:\Users\%USERNAME%\app.exe could be
compared as different from C:\Users\Alice\app.exe. Variable-bearing paths
are never expanded, so the icon comparison now returns null unless a fixed
target matches the icon exactly.

* test: drop redundant ok assertion before typed error guard

The testing guide asks for the typed error to be thrown before asserting a
successful Result value, and says a preceding .ok assertion adds no coverage.

* fix(windows): point out-of-range LinkInfo offsets at their field

A LinkInfo, VolumeID or CommonNetworkRelativeLink offset that points
past its structure was reported at base + offset. With an offset such
as 0xffffffff that position exceeds uint32, so the report failed its
schema and the service discarded the whole partial result.

Report such issues at the offending offset field instead, which keeps
every issue offset and coverage.failing_offset inside the file. Cover
each LinkInfo offset field in the parser tests and the
LocalBasePathOffset case through the stable filesystem service.

* fix(windows): require RFC 4122 variant before deriving Tracker UUID facts

A version nibble of 1 alone does not identify a version-1 UUID. Also require the clock_seq_hi_and_reserved top bits to be 10, so other GUID layouts keep their raw value and derive no MAC or timestamp.

* fix(windows): ignore DeviceNameOffset fields unless ValidDevice is set

MS-SHLLINK 2.3.2 says DeviceNameOffset and DeviceNameOffsetUnicode are
ignored when the ValidDevice flag is clear. parseNetwork read both
regardless, so garbage in those fields became device-name facts or
malformed_structure issues. Read the flags once and only read the device
name fields when ValidDevice is set.

* fix(windows): keep unsupported Tracker headers as raw data

Check TrackerDataBlock Length (0x58) and Version (0) before decoding.
A block with any other header is retained as raw bytes with a
malformed_structure issue, so it no longer yields MAC and timestamp
facts under complete coverage.

* fix(windows): compare shortcut icon paths by normalized location

Collapse "." and ".." segments and repeated separators in the icon
comparison as text only, never opening a path. ".." stops at the drive
or UNC share root, and \\?\ and \\.\ paths stay verbatim.

Join LocalBasePath with CommonPathSuffix as the target and use the bare
base only when the suffix is empty, as the network share branch does.

Read the selected shortcut with lstat and open only, so a rejected
symlink's destination is never resolved.

* fix(windows): keep the UNC share in the root after repeated separators

normalizePath took the host and the next split part as the UNC root, so
\\server\\share\..\app.exe kept an empty share and let .. remove the
real share. Drop empty parts before picking the root so paths on
different shares stay different.

* fix(cli): parse windows shortcut limits as decimals

The four inspect-windows-shortcut limit options now go through
cliDecimalField like the other inspection commands, so values such as
0x10 are rejected and cliDecimalArguments.test.ts passes.

* fix(native): reject linked parents of windows shortcuts

A parent directory symlink or junction pointing at a UNC share was
followed by the first lstat, since the network check reads only the
path text and the symlink rejection covers only the final component.
On Windows, lstat each ancestor from the drive root down and reject
the path at the first link, before anything follows it.

* docs(native): move Windows shortcut guide and add its feature spec

Move the Shell Link guide to docs/guides/native/windows-shortcut.md and
list it under Native binaries in the site navigation, keeping the
/windows-shortcut public route. Update README, translated README, CLI
page and authored skill links to the new physical path.

Add docs/specs/native/windows-shortcut/ with spec.md, plan.md and
tasks.md, as required by docs/development/documentation.md.

* fix(native): admit the windows shortcut parent walk

On Windows the ancestor link walk ran before the provider's resource
admission, so close() could finish while the walk kept calling lstat.
Run the walk inside the same admission as the read, and check the
caller's signal before each ancestor lstat.

* fix(native): walk the effective parents of windows shortcuts

The ancestor link walk checked every prefix of the path as written, so
C:\alias\..\real\a.lnk was refused when C:\alias is a directory link,
although Windows removes alias\.. before opening the file. Walk the
ancestors left after removing . and .. components, keeping the
caller's spelling, never climbing above an absolute root, and leaving
\\?\ paths as written since Windows does not normalize them.

* test(native): assert the linked parent as a structured fact

The parent link regression matched the phrase "junction, which" in the
refusal message, so a wording edit would fail it. Report the linked
ancestor as observed.linked_ancestor on the input issue and assert that
fact instead of the explanatory text.

* test(native): bound the shortcut close gate and release it in finally

Race the parent walk lstat acknowledgement against inspection settling
with awaitAcknowledgement, then release the gate and join the inspect
and close work in finally so a failure reports its cause instead of
waiting for the Vitest timeout.

* fix(native): walk Windows shortcut parents lazily

windowsAncestors built and kept every parent prefix before the first
lstat, so a path with thousands of components allocated memory
quadratic in its length. It now keeps only the normalized components
and yields each parent from a running prefix as the walk reaches it.

---------

Co-authored-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com>
2026-11-09 20:19:44 +08:00

36 KiB
Raw Blame History

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.

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

morluto%2Frea | Trendshift

Trang web · Hướng dẫn · Các nghiên cứu điển hình

Tham gia cộng đồng REA trên Discord

Bắt đầu nhanh · Cách REA hoạt động · Những gì bạn có thể phân tích · Các nghiên cứu điển hình · 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.


REA khởi chạy cầu nối phân tích bên trong Hopper khi kiểm tra tệp nhị phân mã máy



Discord
Tham gia cộng đồng kỹ thuật dịch ngược

Discord · Hỏi đáp · Chia sẻ kết quả


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.

Truy cập trang web REA để xem cách thiết lập, hướng dẫn có hình minh họa và các nghiên cứu điển hình thực tế.

Bắt đầu nhanh

Trên Linux, khởi chạy Ghidra, JADX và công cụ firmware cùng phân tích tĩnh JavaScript/Electron cần ps tương thích procps trong PATH của REA để kiểm tra quyền sở hữu tiến trình. Xem điều kiện Linux.

Thiết lập tác nhân

Sau khi cài Node.js và npm, chạy:

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.

Quá trình thiết lập hỗ trợ Claude Code, Codex, Cursor, Gemini CLI, Grok Build và các tác nhân khác. Xem cài đặt và thiết lập để cấu hình trình phân tích và đăng ký MCP thủ công.

MCP mặc định dùng schema đầu vào gọn. Để có hướng dẫn đầy đủ về trường và xác thực lồng nhau, đặt REA_MCP_INPUT_SCHEMA_PROFILE=full trong đăng ký MCP. Cả hai cấu hình giữ toàn bộ công cụ và cùng xác thực chuẩn ở máy chủ; xem hướng dẫn hợp đồng MCP.

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

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

REA thay đổi nhanh và các bản phát hành mới thường xuyên có bản sửa lỗi. Hãy giữ bản cài đặt của bạn được cập nhật.

Với CLI được cài bằng npm install --global / bun add --global:

rea update

rea --update là bí danh của rea update, nhận cùng tùy chọn đầu ra toàn cục. Lệnh cập nhật giữ tối đa tổng cộng 4 MiB stdout/stderr. Siêu dữ liệu quá lớn bị từ chối sau khi lệnh kết thúc; cài đặt chi tiết giữ chẩn đoán có giới hạn. Tiến độ tuân theo backpressure của terminal và chờ các lần ghi đã gửi hoàn tất.

Cập nhật Bun toàn cục cần Bun 1.2.17 trở lên. Nâng cấp Bun cũ theo cách thủ công trước khi chạy rea update.

Để cập nhật đăng ký tác nhân và skill, chạy lệnh thiết lập được in ra sau khi cập nhật.

Nếu dùng npx, cập nhật thiết lập tác nhân bằng:

npx rea-agents@latest setup

Xem lại thay đổi cấu hình và khởi động lại tác nhân. Với lệnh CLI dùng một lần, dùng npx rea-agents@latest rồi thêm lệnh cần chạy.

Với Bun, dùng bunx rea-agents@latest thay cho npx rea-agents@latest.

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.

Quy trình điều tra của REA: tác nhân hỏi về mục tiêu cục bộ, REA kiểm tra và lần theo mục tiêu bằng công cụ phân tích, rồi tác nhân dùng mã, tham chiếu và những điểm chưa biết được trả về để giải thích, triển khai và kiểm thử.

Mở hình ở kích thước đầy đủ.

Những gì bạn có thể phân tích

REA yêu cầu Node.js 22.x (>=22.23.4), 24.x (>=24.22.1) hoặc 26+ (>=26.12.1), cùng với npm. Công cụ bổ sung và nền tảng chạy REA được hỗ trợ tùy thuộc vào mục tiêu:

Mục tiêu REA trả về gì Yêu cầu và hướng dẫn
Tệp nhị phân mã máy Mã giả, hợp ngữ, chuỗi, ký hiệu, lời gọi và tham chiếu Hopper, Ghidra, IDA hoặc Kuna; phân tích mã máy
Bố cục ELF ngoại tuyến Các section, segment, ký hiệu/thông tin tái định vị gốc và các biện pháp giảm thiểu có thể có từ phân tích tĩnh pwntools do bên gọi cung cấp trên Linux x64; chẩn đoán tệp nhị phân
Bytecode EVM Bộ chọn điều phối, độ lệch byte, tham số suy luận và khả năng thay đổi trạng thái Đầu vào cục bộ chứa byte thô hoặc dạng thập lục phân trên Linux x64; hướng dẫn EVM ngoại tuyến
Rust binaries Embedded cargo-auditable dependency list Rust binaries
PE certificates Authenticode WIN_CERTIFICATE entries and PKCS#7 signer/X.509 identity fields Built-in static PE inspection; PE certificates
PE imports Import and delay-load DLL names, ordinals, IAT RVAs and pefile import hash Built-in static PE inspection; PE imports
Windows shortcuts Shell Link target, arguments, working dir, ExtraData and Tracker droid facts Built-in static LNK inspection; Windows shortcuts
ELF notes PT_NOTE/SHT_NOTE owners, types, GNU build-id and ABI-tag fields Built-in static ELF inspection; ELF notes
Binary hardening PIE, NX, RELRO, CFG and related header flags for ELF, PE and Mach-O Built-in static header inspection; binary hardening
Linux kernel modules .modinfo keys, __versions CRCs, this_module presence, and signature trailer Built-in static ELF inspection; kernel modules
Erlang BEAM IFF chunks, atoms, exports, and tables Built-in static BEAM inspection; Erlang BEAM
Apple IPS crashes .ips metadata, threads, images, registers and crash classes Built-in static JSON inspection; Apple IPS
Sự cố Linux đã ghi lại Bản ghi note thô, thanh ghi/tín hiệu của mọi luồng được ghi lại và các ứng viên ánh xạ tùy chọn pwntools do bên gọi cung cấp trên Linux x64; GDB/pwndbg tùy chọn; sự cố đã ghi lại
Thư mục cài đặt ứng dụng máy tính Các runtime có khả năng được dùng, tệp bằng chứng, dấu hiệu thành phần và bước tiếp theo Kiểm tra thư mục và phần đầu tệp có giới hạn;Ứng dụng máy tính
JavaScript / Electron Mô-đun, các khai báo import, source map, tuyến, IPC và quan hệ với tiện ích mở rộng mã máy Node.js và npm; phân tích ứng dụng; Linux: procps ps
Trang web Cấu trúc trang, script, quan sát mạng và ảnh chụp màn hình được yêu cầu Trình duyệt thuộc họ Chrome; phân tích trình duyệt
Bản ghi lưu lượng mạng đã lưu Yêu cầu, phản hồi, payload có thể truy cập và vị trí nguồn HAR / Fiddler Everywhere SAZ; mitmdump trên Linux cho bản ghi định dạng gốc của mitmproxy; hướng dẫn bản ghi mạng
Bắt gói tin Điểm cuối, DNS, TLS SNI, phân bố giao thức và yêu cầu HTTP tshark và capinfos do nơi gọi cung cấp; hướng dẫn pcap
Assembly .NET Siêu dữ liệu, lệnh CIL, các phụ thuộc mã máy được khai báo và so sánh bản dựng Kiểm tra tĩnh; hướng dẫn mã được quản lý
APK Android Khai báo manifest, lớp, phương thức được dịch ngược và tham chiếu JADX không giao diện đồ họa và JDK đầy đủ trên Linux/macOS/Windows x64; hướng dẫn Android
Thiết bị Android Thiết bị, gói, tiến trình, nhật ký, dump, ảnh chụp màn hình và truyền APK/tệp adb do nơi gọi cung cấp (trình giả lập hoặc thiết bị); hướng dẫn ADB
Dự án JEB Đơn vị dự án từ engine, hash của artifact và mã giả của kiểu/phương thức Một ứng dụng JEB do nơi gọi khởi động, phục vụ MCP, chọn bằng REA_JEB_MCP_URL; hướng dẫn JEB
Tài nguyên Android Manifest đã giải mã, bảng chuỗi, ngôn ngữ và thông tin phiên bản Trình khởi chạy Apktool do nơi gọi cung cấp; hướng dẫn tài nguyên
Ứng dụng Flutter Băm snapshot Dart, hash thư viện theo ABI và nguồn gốc build engine Không cần (phân tích APK tĩnh); hướng dẫn Flutter
Phần sụn Các vùng, kết quả trích xuất và dữ liệu chuyển sang phân tích mã máy Binwalk / Unblob trên Linux; hướng dẫn phần sụn
Gói tin đã ghi Trường được chọn, giá trị lặp, bộ lọc và quy tắc giải mã Linux: TShark 4.x + prlimit; hướng dẫn bản ghi gói tin
Tín hiệu logic đã ghi Chú thích bộ giải mã, phạm vi mẫu và chẩn đoán Linux: sigrok-cli 0.7.2 + prlimit; hướng dẫn tín hiệu
Gói và tài nguyên Danh sách tệp, giá trị băm, plist, cấu trúc bundle Apple và tài nguyên được trích xuất Hướng dẫn hiện vật phần mềm và JavaScript, ứng dụng Apple
Hành vi tiến trình Đầu ra terminal, tương tác, quan sát khi thoát và hệ thống tệp, cùng so sánh các lần chạy Linux/macOS có PTY gốc; ghi lại tiến trình
PyInstaller CArchive, PYZ, Python bytecode Static inspection; Python packaged applications
Tệp nhị phân Go Phiên bản trình biên dịch nhúng, mô-đun, thay thế và thiết lập build Kiểm tra tĩnh tích hợp ELF/PE/thin Mach-O; Không cần cài Go
Cơ sở dữ liệu SQLite Bảng, cột, chỉ mục, view, trigger và hàng được chọn từ bảng thông thường Ảnh chụp cơ sở dữ liệu/WAL cục bộ; Node.js 24.x >=24.15 hoặc 26+ có giới hạn SQLite native
Đối tượng mã GPU Đích CUDA/HIP, tham số và tài nguyên kernel được chọn, văn bản PTX được giữ lại Kiểm tra tĩnh tích hợp ELF/PE/fatbin/CUBIN/PTX; GPU
Tệp mô hình Siêu dữ liệu GGUF / safetensors, khai báo tensor và tổng suy ra Kiểm tra header; tùy chọn băm toàn bộ tệp; GGUF / safetensors
Siêu dữ liệu IL2CPP Ảnh assembly Unity global-metadata.dat, tên kiểu/phương thức và phạm vi chỉ mục Giải mã tĩnh phiên bản 24, 27, 29, 31, 39; không cần Unity
Godot PCK Danh mục và trích xuất, header/thư mục gốc và định danh nội dung được chọn Định dạng tĩnh 2, 3, 4; không cần Godot
Hiện vật WASM Xác thực, section, dạng WAT import/export chính xác và WAT đã giải mã Do người gọi cung cấp WABT 1.0.42; inspect_wasm_artifact
Chữ ký APK Bên ký v1/v2/v3/v3.1, dấu vân tay chứng chỉ, xoay vòng khóa và tính nhất quán nội bộ của digest Kiểm tra tĩnh tích hợp; inspect_apk_signature

Kiểm tra tĩnh JavaScript và .NET đọc các tệp được cung cấp mà không chạy ứng dụng. Ghi lại khi chạy sẽ khởi chạy hoặc tương tác với mục tiêu đã chọn bằng quyền người dùng của bạn; từng hướng dẫn mô tả tác động của nó.

Để kiểm tra tệp nhị phân native ngoại tuyến, REA cũng hỗ trợ GNU objdump và Rizin do bạn tự cung cấp. Hướng dẫn công cụ dịch ngược trình bày cách thiết lập nhà cung cấp, các lệnh CLI và giới hạn của Evidence. REA không cài đặt hoặc cập nhật hai nhà cung cấp này.

Với tệp nhị phân lớn, tăng hạn khởi động bằng REA_GHIDRA_STARTUP_TIMEOUT_MS hoặc REA_HOPPER_STARTUP_TIMEOUT_MS.

Định dạng mã máy và nền tảng chạy REA được hỗ trợ khác nhau tùy trình phân tích. Xem thiết lập Hopper và Ghidra, hướng dẫn IDA, Kuna và hỗ trợ Ghidra thử nghiệm trên Windows. Ghidra cũng hỗ trợ phân tích DOS 16 bit. Để chọn trình phân tích, xem hướng dẫn CLI. Kiểm tra khả năng sử dụng theo bản phát hành đối với tính năng được bổ sung sau phiên bản npm mới nhất.

Các nghiên cứu điển hình

Minh họa các ví dụ về cân bằng âm thanh DX-Ball, cầu nối bảng nhớ tạm Notion và vòng đạn TH04

DX-Ball: tái tạo phép tính phân bố âm thanh trái phải

Lầ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.

Đọc nghiên cứu điển hình · Kho mã tái tạo

Notion: lần theo cầu nối clipboard của Electron

Tì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ú.

Đọc nghiên cứu điển hình

TH04: khôi phục phép tính vòng đạn trong DOS

Kiể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 đó.

Đọc nghiên cứu điển hình · Kho mã tái tạo

Xây dựng môi trường RL bằng REA

Ghi phiên ứng dụng web, chuyển API thành công cụ và xuất môi trường mà tác tử AI có thể dùng. Chạy bằng AgentEnv, rồi thêm tác vụ và kiểm tra phần thưởng để huấn luyện RL hoặc đánh giá.

Hướng dẫn xây dựng môi trường · Xem bản demo trên X

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.

Xây dựng môi trường RL

Tạo môi trường cục bộ để tác tử AI luyện các tác vụ như tìm issue hoặc tạo thư mục mà không cần chạy ứng dụng gốc. Dùng môi trường này cho học tăng cường (RL) hoặc để kiểm tra khả năng hoàn thành tác vụ của tác tử.

REA biến các yêu cầu và phản hồi API đã ghi thành công cụ mà tác tử có thể gọi. Môi trường dùng dữ liệu đã ghi và chỉ hỗ trợ thay đổi khi bản ghi xác nhận tác động của thay đổi đó.

Sau khi thiết lập REA trong tác tử, thay URL và các tác vụ thư mục bên dưới bằng thông tin của bạn:

Dùng REA xây dựng môi trường RL từ ứng dụng web thử nghiệm của tôi tại
http://127.0.0.1:3000.
Bao gồm liệt kê, tạo, đổi tên và xóa thư mục. Có thể tạo và xóa
thư mục thử nghiệm nhưng không thay đổi dữ liệu có sẵn.
Lưu vào thư mục my-env, kiểm tra thao tác nào hoạt động và cho tôi biết cách chạy.
Dùng dòng lệnh

Dùng các lệnh này nếu đã có tệp ghi lại yêu cầu và phản hồi của ứng dụng trong trình duyệt. Để chạy môi trường tạo ra, bạn cũng cần AgentEnv và Docker.

rea environment-build ./session.har ./my-env --name my-env --json
agent-env run ./my-env

REA xuất môi trường chạy được cùng bài kiểm tra cơ bản để xác nhận môi trường khởi động và phản hồi. Kết nối với framework RL để đặt mục tiêu tác vụ, thêm kiểm tra phần thưởng và chạy huấn luyện.

Hướng dẫn xây dựng môi trường · Tài liệu tham chiếu môi trường · Xem bản demo trên X

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ả:

Báo cáo lỗ hổng theo SECURITY.md.

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.

Lịch sử sao GitHub của REA

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.

Đó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 và sơ đồ kiến trúc về cấu trúc dự án.

Giấy phép

MIT

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.