Chạy một lần và đầu ra --json

Khi chạy rexapf kèm nội dung tác vụ, CLI làm đúng một tác vụ, in câu trả lời cuối ra stdout rồi thoát. Chế độ này hợp với script, cron hay bước CI: không mở cổng mạng và không để lại tiến trình chạy nền.

#Chạy một tác vụ

1. Đứng trong thư mục dự án

   Thư mục hiện tại là thư mục làm việc của phiên.

   bashSao chép

   $ cd ~/du-an

2. Giao tác vụ

   Nội dung tác vụ là các đối số còn lại, được nối bằng dấu cách. Nên đặt trong ngoặc kép.

   bashSao chép

   $ rexapf "chạy test và sửa lỗi"

3. Đọc kết quả

   Trong lúc chạy, phần suy nghĩ của mô hình (nếu có) được ghi ra stderr. Khi xong, câu trả lời cuối được in ra stdout.

4. Kiểm tra mã thoát

   Mã 0 nghĩa là lượt kết thúc bình thường. Mã 1 nghĩa là tác vụ bị huỷ, lỗi, hoặc chưa đăng nhập.

$ rexapf "tóm tắt README trong ba gạch đầu dòng"
- Dự án là ...
- Cài đặt bằng ...
- Chạy test bằng ...

$ echo $?
0

#Đọc tác vụ từ stdin

Dùng - làm đối số duy nhất, hoặc chỉ cần nối ống vào rexapf:

$ echo "tóm tắt README" | rexapf -
$ git diff | rexapf -
$ cat yeu-cau.md | rexapf

Lưu ý:

• - phải là đối số tác vụ duy nhất. Viết rexapf - thêm chữ sẽ báo lỗi.
• Một đối số chỉ toàn khoảng trắng bị từ chối với error: cần nội dung tác vụ.
• Nếu không có tác vụ và stdin là terminal, CLI in trợ giúp thay vì chờ nhập.

#Đầu ra JSON từng dòng

Thêm --json để stdout nhận luồng sự kiện, mỗi dòng một đối tượng JSON, thay cho câu trả lời thuần:

$ rexapf --json "liệt kê các file lớn"

{"type":"session","sessionId":"session-…","cwd":"/home/ban/du-an"}
{"type":"status","phase":"turn_start","turn":1}
{"type":"tool_call","callId":"…","tool":"bash","input":{"command":"du -sh *"}}
{"type":"tool_result","callId":"…","status":"completed","result":"…"}
{"type":"text","text":"Các file lớn nhất là …"}
{"type":"status","phase":"turn_end","turn":1,"reason":"completed"}
{"type":"final","text":"Các file lớn nhất là …"}

Ví dụ lấy câu trả lời cuối bằng jq:

$ rexapf --json "đếm số dòng code" | jq -r 'select(.type=="final") | .text'

#Tiếp tục một phiên

Mỗi lần chạy mặc định tạo phiên mới session-<uuid>. Lấy id từ sự kiện session (hoặc từ TUI), rồi giao tiếp việc:

$ rexapf --session-id session-1234abcd "làm tiếp phần còn lại"

Phiên phải tồn tại và có cùng thư mục làm việc với lần chạy hiện tại; nếu không, CLI từ chối trước khi chạy. Không thể dùng một id đang được tiến trình khác điều khiển. Muốn mở phiên đó trong giao diện tương tác, chỉ chạy rexapf --session-id <id>; xem Giao diện tương tác.

#Dùng trong CI

• Đăng nhập trên máy chạy CI một lần bằng rexapf login; thông tin được lưu trong ~/.dsh/.credentials.yaml (xem Tệp cấu hình).
• Kiểm tra mã thoát của rexapf để quyết định bước CI đạt hay không.
• Công cụ web_search không có trong CLI; web_fetch vẫn dùng được.

Danh sách đầy đủ cờ và lệnh ở Tham chiếu lệnh.