Xây dựng không gian làm việc Codex CLI ưu tiên thực thi với Portable Setup Kit

Bộ công cụ Thiết lập Portable Codex CLI thực hiện được gì

Bộ công cụ Thiết lập Portable Codex CLI là một cấu hình và trình cài đặt do cộng đồng duy trì dành cho OpenAI Codex CLI. Đây không phải là Codex và cũng không phải sản phẩm chính thức của OpenAI.

Bộ công cụ thay đổi cách Codex tiếp cận công việc trên kho mã. Các hướng dẫn nhấn mạnh việc kiểm tra workspace, sử dụng các công cụ hiện có, thực hiện thay đổi được yêu cầu, chạy kiểm tra, chẩn đoán lỗi và báo cáo kết quả đã xác minh. Tính portable là phương thức phân phối; sản phẩm chính là phong cách vận hành ưu tiên thực thi này.

Quan trọng: Chế độ TURBO bật hành vi nâng cao, không tương tác, bao gồm approval_policy = "never". Chỉ sử dụng chế độ này trong workspace mà bạn tin cậy và sau khi đã xem xét gói. Cấu hình công khai tiêu chuẩn bắt đầu với việc phê duyệt an toàn hơn theo yêu cầu và sandbox workspace-write.

Tính năng chính

• Hướng dẫn ưu tiên thực thi: Codex được hướng dẫn thao tác trên mục tiêu thực tế thay vì dừng lại sau những lời khuyên chung chung hoặc một kế hoạch.
• Khởi chạy TURBO một lần nhấp: TURBO.cmd xác thực workspace, cấu hình các chính sách thực thi nâng cao, kế thừa cài đặt model gốc và khởi chạy Codex.
• Cài đặt theo giao dịch: Trình cài đặt xác minh các manifest SHA-256, tạo bản sao lưu có dấu thời gian, ghi nhật ký thao tác và tạo biên nhận khôi phục.
• Công cụ phân tích xác định: re-toolkit thuần Python xử lý việc kiểm tra PE32 và PE32+, dịch ngược x86 và x64, quét AOB, vi mô phỏng, phân tích Protobuf và TLV, tạo hook Frida và so sánh khác biệt nhị phân.
• Xử lý hai giai đoạn: Việc lập kế hoạch cấu trúc được tách khỏi kết xuất độ trung thực cao nhằm giảm các thành phần giữ chỗ và đầu ra dài bị suy giảm.
• Nhiều định dạng agent: Gói cung cấp hướng dẫn hoặc preset cho Codex CLI, OpenCode, Claude Code, Cursor, Windsurf và ChatGPT App.
• Hỗ trợ duy trì liên tục: Hook và các công cụ ngữ cảnh giúp bảo toàn trạng thái đã xác thực trong những tác vụ dài hơn.
• Tích hợp Git có thể hoàn tác: Trình cài đặt có thể liên kết core.hooksPath với pre-commit guard đi kèm gói và khôi phục giá trị trước đó khi hoàn tác.

Yêu cầu và chuẩn bị

Kho mã xác định Windows 10 và 11, PowerShell 5.1 hoặc 7 và Python 3.10 trở lên là các thành phần được hỗ trợ. Codex CLI là yêu cầu đối với quy trình chính, mặc dù trình cài đặt có thể thêm gói @openai/codex toàn cục được ghim phiên bản tương thích khi Codex chưa được cài đặt.

1. Tải ZIP bản phát hành hoặc clone kho mã.
2. Giải nén vào một thư mục cục bộ nếu bạn đã tải ZIP.
3. Chọn kho mã mà Codex sẽ quản lý.
4. Xem xét các script và cấu hình đi kèm trước khi bật chế độ thực thi nâng cao hoặc không hạn chế.
5. Sao lưu độc lập mọi dữ liệu workspace đặc biệt quan trọng, dù trình cài đặt có tạo bản sao lưu theo giao dịch.

Tùy chọn 1: Bắt đầu với chế độ TURBO

Để thiết lập nhanh nhất, hãy giải nén bản phát hành rồi nhấp đúp vào:

TURBO.cmd

Trình khởi chạy xác thực workspace, cấu hình hồ sơ thực thi nâng cao, sử dụng cài đặt model gốc của bạn và mở Codex ở trạng thái sẵn sàng hoạt động. Chế độ này cũng tự động phê duyệt trước các công cụ thời gian chạy, đánh dấu workspace là hoàn toàn đáng tin cậy và sử dụng hành vi phê duyệt không tương tác.

Vì các cài đặt này làm giảm các bước xác nhận, chỉ sử dụng chế độ TURBO cho mã đã được xem xét và workspace đáng tin cậy. Để cài đặt có kiểm soát hơn, hãy sử dụng quy trình thủ công bên dưới.

Tùy chọn 2: Thực hiện cài đặt thủ công theo giao dịch

Mở PowerShell trong thư mục bộ công cụ đã giải nén. Tạm thời cho phép script cài đặt trong tiến trình PowerShell hiện tại, sau đó cung cấp đường dẫn tuyệt đối đến workspace mục tiêu:

Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1 -ProjectRoot 'C:\path\to\your-workspace' -KeysmithPreset unrestricted -SkipPlugins

Ví dụ này chọn preset Keysmith unrestricted và bỏ qua các plugin tùy chọn. Hãy xem xét các lựa chọn này trước khi sử dụng trong môi trường của bạn.

Trong quá trình cài đặt, bộ công cụ thực hiện theo trình tự giao dịch:

1. Xác thực thư mục gốc của dự án.
2. Đối chiếu gói nguồn với manifest SHA-256.
3. Tạo bản sao lưu có dấu thời gian và nhật ký thao tác.
4. Cài đặt các tệp người dùng, skill, tệp dự án, công cụ ngữ cảnh và re-toolkit.
5. Thay thế các đường dẫn cần thiết cho môi trường đích.
6. Cấu hình độ tin cậy của dự án và đường dẫn hook Git của kho mã.
7. Thử thiết lập plugin tùy chọn khi được yêu cầu mà không xem lỗi plugin là lỗi nghiêm trọng.
8. Ghi receipt.json và last-receipt.txt.

Mỗi lần thay thế đều được ghi lại trước khi thực hiện. Nếu một bước cài đặt sau đó thất bại, trình cài đặt sẽ phát lại danh sách thao tác theo thứ tự ngược và khôi phục liên kết hook Git trước đó.

Trình cài đặt thêm gì

• Cấu hình người dùng Codex: Các tệp trong %CODEX_HOME% hoặc ~/.codex, bao gồm config.toml, AGENTS.md, hướng dẫn, quy tắc khởi đầu và các kỹ năng.
• Kỹ năng tác nhân cấp người dùng: Các kỹ năng có thể tái sử dụng trong ~/.agents.
• Cấu hình dự án: AGENTS.md, CLAUDE.md, .codex, .agents, .gitignore, quy trình ngữ cảnh, hook và bộ công cụ dịch ngược.
• Cấu hình Git cục bộ: core.hooksPath=.agents/git-hooks cho kho lưu trữ đã chọn.
• Codex CLI: Bản cài đặt npm toàn cục được ghim phiên bản tương thích khi Codex chưa có sẵn.
• Plugin tùy chọn: Hỗ trợ Browser, Visualize và Sites khi có sẵn.

Bản phát hành này cố ý loại trừ thông tin xác thực và trạng thái gắn với máy. Bản phát hành không di chuyển dữ liệu xác thực, dữ liệu OAuth, phiên làm việc, lịch sử, nhật ký, bộ nhớ đệm, cơ sở dữ liệu SQLite, cookie, khóa API, khóa riêng tư, dữ liệu thời gian chạy trình duyệt, đường dẫn tệp nhị phân trên máy tính để bàn hoặc trạng thái thời gian chạy ngữ cảnh từ máy tính khác.

Xác minh Gói và Cài đặt

Chạy tập lệnh xác minh gói trước khi sử dụng thiết lập:

.\verify.ps1

Để xác minh các tệp được cài đặt vào một không gian làm việc cụ thể, thêm -Installed và đường dẫn dự án:

.\verify.ps1 -Installed -ProjectRoot 'C:\path\to\your-workspace'

Xác minh là một phần quan trọng trong thiết kế. Trình cài đặt kiểm tra tệp kê khai trước khi ghi và chặn việc duyệt đường dẫn trong tệp kê khai. Kho lưu trữ cũng mô tả bộ kiểm thử chín bước Test-All.ps1 được sử dụng để kiểm thử bản phát hành.

Sử dụng Cơ bản với Codex

Sau khi cài đặt, khởi động Codex trong kho lưu trữ đã cấu hình thông qua TURBO.cmd hoặc quy trình Codex CLI thông thường của bạn. Hãy giao cho nó một tác vụ cụ thể trong kho lưu trữ thay vì yêu cầu tư vấn chung.

Ví dụ, yêu cầu Codex kiểm tra một bài kiểm thử bị lỗi, triển khai bản sửa lỗi, chạy lại các bước kiểm tra liên quan và tóm tắt các tệp đã thay đổi. Các hướng dẫn được cài đặt nhằm giúp tác nhân tiếp tục từ kiểm tra sang triển khai và xác minh bất cứ khi nào có hành động tiếp theo.

Một tác vụ phù hợp có thể được diễn đạt như sau:

Kiểm tra các bài kiểm thử bị lỗi trong không gian làm việc này, xác định nguyên nhân gốc, triển khai bản sửa lỗi đúng và nhỏ nhất, chạy lại các bài kiểm thử bị ảnh hưởng và báo cáo kết quả đã xác minh.

Hồ sơ này nhằm khuyến khích Codex trước tiên kiểm tra các tệp và kết quả kiểm thử, chỉnh sửa dự án thực tế, thử lại các bước kiểm tra thất bại, sau đó cung cấp kết quả ngắn gọn thay vì trả về một hướng dẫn để bạn tự thực hiện.

Sử dụng Bộ công cụ Dịch ngược Tích hợp

Bộ công cụ được cài đặt tại .agents/tools/re-toolkit/ bên trong dự án. Điểm vào hợp nhất của nó là cli.py. Các lệnh hỗ trợ --json đặc biệt hữu ích khi một tập lệnh hoặc tác nhân khác cần đầu ra có cấu trúc.

Tự động Phân loại Tệp nhị phân

python .agents/tools/re-toolkit/cli.py auto target.dll --json

Lệnh này tự động phát hiện định dạng và phân loại mục tiêu.

Kiểm tra Tệp PE

python .agents/tools/re-toolkit/cli.py parse-pe sample.exe --json

Bộ phân tích PE có thể kiểm tra tiêu đề, bảng section, DLL đã nhập, symbol đã xuất và thông tin dịch RVA cho các tệp PE32 và PE32+.

Quét Mẫu AOB

python .agents/tools/re-toolkit/cli.py pattern-scan target.bin --pattern "48 89 ?? 24 ?? 55" --json

Sử dụng ?? làm ký tự đại diện khi các byte có thể thay đổi giữa các tệp nhị phân hoặc phiên bản.

Trích xuất Chuỗi

python .agents/tools/re-toolkit/cli.py strings sample.exe --min-len 5 --json

Lệnh này trích xuất các chuỗi ASCII và UTF-16LE cùng với vị trí offset, đồng thời lọc các chuỗi ngắn hơn độ dài tối thiểu đã chọn.

Giải mã Opcode

python .agents/tools/re-toolkit/cli.py disasm 90505831C0C3 --arch x86_64

Bộ dịch mã hỗ trợ phân tích x86 và x64 đối với opcode thô hoặc các section nhị phân.

Giải mã Payload Protobuf Không được Tài liệu hóa

python .agents/tools/re-toolkit/cli.py decode-protobuf 089601120474657374

Lệnh này kiểm tra dữ liệu theo định dạng wire của Protobuf mà không cần schema. Hệ thống con cũng bao gồm phân tích khung TLV.

Mô phỏng Chuỗi Lệnh Nhỏ

python .agents/tools/re-toolkit/cli.py emulate --code B82A000000505BC3

Bộ vi mô phỏng cung cấp sandbox tách biệt cho thanh ghi, ngăn xếp và bộ nhớ để phân tích ở cấp CPU được hỗ trợ.

Tạo Hook Frida

python .agents/tools/re-toolkit/cli.py gen-hook --symbol CryptHashData --module advapi32.dll --output hook.js

Lệnh này tạo tập lệnh interceptor Frida cho module và symbol đã chọn. Bộ công cụ cũng hỗ trợ tạo tập lệnh chống gỡ lỗi.

Tính Bản vá Khác biệt Nhị phân

python .agents/tools/re-toolkit/cli.py diff-patch --orig orig.bin --patched mod.bin --json

Lệnh này so sánh một tệp nhị phân gốc với bản sao đã sửa đổi và xuất thông tin bản vá.

Kiểm tra Vùng dưới dạng Hex Dump

python .agents/tools/re-toolkit/cli.py hexdump target.bin --offset 0x100 --length 128

Lệnh này định dạng 128 byte bắt đầu tại offset 0x100 thành bản kết xuất thập lục phân được căn chỉnh.

Chạy Quy trình Hai Giai đoạn

Dự án bao gồm một quy trình hai giai đoạn, tách việc lập kế hoạch cấu trúc khỏi kết xuất cuối cùng. Giai đoạn đầu tiên tạo cấu trúc và các nhịp chính, trong khi giai đoạn thứ hai tạo ra toàn bộ đầu ra. Việc tách biệt này nhằm giảm tình trạng mất tập trung, cắt ngắn và các thành phần giữ chỗ nguyên văn như ROLE_A và ROLE_B.

python .agents/tools/re-toolkit/cli.py pipeline "Your complex scenario or system architecture prompt"

Quy trình này phù hợp nhất với các prompt phức tạp cần chuẩn bị cấu trúc rõ ràng trước khi tạo nội dung chi tiết.

Cấu hình Các Công cụ Agent Được Hỗ trợ Khác

Gói này bao gồm các tệp cấu hình gốc cho nhiều môi trường agent, gồm AGENTS.md cho Codex CLI, OPENCODE.md và opencode.json cho OpenCode, CLAUDE.md cho Claude Code, .cursorrules cho Cursor và .windsurfrules cho Windsurf.

Để cấu hình và đồng bộ các framework agent dựa trên GPT cùng các tích hợp IDE được hỗ trợ trong workspace, hãy chạy adaptor phổ quát:

ADAPT_ALL.cmd

Bạn cũng có thể xuất các preset thông qua re-toolkit:

python .agents/tools/re-toolkit/cli.py export-preset --target all

Kho lưu trữ bao gồm một preset ChatGPT App riêng tại docs/CHATGPT_APP_PRESET.md.

Mẹo Nâng cao

Ưu tiên Đầu ra Có Cấu trúc cho Tự động hóa

Sử dụng --json khi lệnh hỗ trợ tùy chọn này. Kết quả có cấu trúc từ việc phân tích PE, quét mẫu, phân loại tự động hoặc so sánh tệp nhị phân sẽ dễ lưu, đối chiếu và chuyển cho công cụ khác hơn.

Kết hợp các Lệnh Phân tích

Bắt đầu với auto để phát hiện định dạng, tiếp tục bằng parse-pe để lấy siêu dữ liệu tệp thực thi, dùng strings để tìm các chỉ dấu có thể đọc được và áp dụng pattern-scan khi bạn đã có chữ ký byte tiềm năng. Dùng disasm, emulate hoặc gen-hook để kiểm tra sâu hơn từng bước.

Sử dụng Thăm dò Giả định một cách Thận trọng

Bộ công cụ cung cấp một thăm dò bóng hai mô hình mang tính giả định, với cơ chế hủy khi bị từ chối và chuyển đổi dự phòng:

python .agents/tools/re-toolkit/cli.py spec-probe "Reverse engineer target module and extract memory offsets" --target game.dll --json

Chỉ sử dụng các khả năng phân tích tệp nhị phân trên phần mềm và dữ liệu mà bạn được phép kiểm tra.

Lưu Giữ Biên lai

Đừng xóa biên lai đã tạo nếu bạn có thể cần hoàn tác quá trình cài đặt. Biên lai lưu chuỗi thao tác cần thiết để xóa các tệp mới được cài đặt, khôi phục các tệp bị thay thế và phục hồi cấu hình hook Git trước đó.

Hiểu các Mặc định Bảo mật Tiêu chuẩn

Ngoài hành vi TURBO được chọn rõ ràng, bản phát hành công khai bắt đầu với các cài đặt có thể xem xét sau:

approval_policy = "on-request"
sandbox_mode = "workspace-write"

Các quy tắc khởi đầu không bao gồm tiền tố lệnh được phê duyệt trước, trừ khi chế độ TURBO được chọn. Hãy sử dụng các mặc định tiêu chuẩn khi bạn muốn có ranh giới xác nhận và các thao tác ghi trong phạm vi workspace.

Hoàn tác Cài đặt

Để khôi phục lần cài đặt được ghi nhận gần nhất, hãy chạy:

.\rollback.ps1

Để khôi phục một giao dịch cụ thể, hãy cung cấp rõ biên lai của giao dịch đó:

.\rollback.ps1 -Receipt 'C:\path\to\receipt.json'

Người dùng Git Bash có thể gọi wrapper:

./ROLLBACK.sh

Việc hoàn tác sẽ xóa các tệp do trình cài đặt thêm vào, khôi phục các tệp đã tồn tại trước khi cài đặt và khôi phục hoặc hủy thiết lập giá trị core.hooksPath trước đó của kho lưu trữ.

Tài liệu Bổ sung

Để tìm hiểu các khái niệm Codex nền tảng, hãy tham khảo tài liệu chính thức về Codex CLI, kiến thức cơ bản về cấu hình, AGENTS.md, rules, hooks, skills và plugins.

Kết luận

Codex CLI Portable Setup Kit đóng gói một hồ sơ Codex tập trung vào thực thi, hướng dẫn dự án, tích hợp agent, các tiện ích phân tích xác định, tính năng xác minh, sao lưu và hoàn tác trong một quy trình thiết lập có thể tái lập. Hãy bắt đầu bằng quy trình cài đặt giao dịch tiêu chuẩn khi bạn muốn các quyền kiểm soát có thể xem xét, xác minh kết quả và chỉ bật chế độ TURBO khi hành vi nâng cao, không tương tác của chế độ này phù hợp với một workspace đáng tin cậy.