Giao thức UCI
Các cách dùng dưới đây đã được đối chiếu với commit 1c66b9b của official Pikafish. Để biết engine (động cơ cờ) bắt đầu và kết thúc một lượt tìm kiếm theo các lệnh này ra sao, xem Vận hành và giao tiếp của engine.
Một lượt phân tích đầy đủ
Giao diện gửi lần lượt các lệnh dưới, chờ uciok trước khi đặt tùy chọn và chờ readyok trước khi đặt thế cờ, bắt đầu phân tích:
uci
setoption name Threads value 2
isready
position startpos moves b0c2 b9c7
go movetime 1000b0c2, b9c7 lần lượt đưa Mã Đỏ và Mã Đen ra từ vị trí khai cuộc. Engine ghi lịch sử hai nước, tìm với giới hạn một giây, xuất info rồi kết thúc bằng bestmove. Giao diện đi nước đó và gửi position đã cập nhật trước lượt phân tích tiếp.
Với go infinite, gửi stop, chờ bestmove và tiếp tục đọc đầu ra chuẩn trong lúc bàn giao. Đổi thế hoặc tùy chọn sau khi lượt tìm này kết thúc.
quit
Yêu cầu dừng tìm kiếm và thoát engine. Nếu đang tìm kiếm, engine sẽ chờ các luồng làm việc hoàn tất; trong lúc đó vẫn có thể xuất kết quả tìm kiếm hoặc bestmove.
ucinewgame
Khi bắt đầu một ván mới, giao diện nên gửi lệnh ucinewgame cho engine để xóa bảng chuyển vị, lịch sử tìm kiếm và các dữ liệu liên quan. Lệnh này không thiết lập thế cờ ban đầu; vẫn cần gửi position. Việc xử lý có thể mất một khoảng thời gian, nên giao diện có thể gửi isready sau đó để xác nhận các bước trước đã hoàn tất. Nếu lần tìm kiếm trước chưa kết thúc, cần gửi stop và chờ bestmove trước.
setoption
Thiết lập tùy chọn cho engine, cách dùng:
setoption name <id> [value <x>]Trong đó, <id> là tên tùy chọn UCI, <x> là giá trị bạn muốn đặt.
Ví dụ giao diện muốn đặt số luồng của engine là 16, có thể gửi:
setoption name Threads value 16Một số tùy chọn, như Clear Hash (xóa bảng chuyển vị), có thể bỏ value và dùng trực tiếp, ví dụ:
setoption name Clear HashVề các tùy chọn UCI, xem chi tiết tại trang "Tùy chọn UCI", ở đây không nhắc lại.
Cần kết thúc tìm kiếm trước khi thay đổi tùy chọn. Một số thiết lập sẽ xuất thông tin trạng thái như info string; tùy chọn không được nhận diện hoặc thiết lập không hợp lệ cũng có thể tạo thông báo. Vì vậy, không nên giả định rằng lệnh này hoàn toàn không có đầu ra.
isready
Dùng để xác nhận engine có thể phản hồi; engine xuất readyok khi nhận lệnh. Engine cũng có thể trả lời trong lúc đang tìm kiếm, nên readyok không có nghĩa tìm kiếm đã kết thúc. Để kết thúc tìm kiếm, hãy dùng stop và chờ bestmove.
uci
Dùng để lấy thông tin liên quan của engine (như tên, tác giả, tùy chọn UCI...). Dưới đây là ví dụ đầu ra của một phiên bản cũ; các tùy chọn, giá trị mặc định và phạm vi cụ thể phải được xác định từ đầu ra của phiên bản engine đang dùng:
id name Pikafish 2024-02-18
id author the Pikafish developers (see AUTHORS file)
option name Debug Log File type string default
option name Threads type spin default 1 min 1 max 1024
option name Hash type spin default 16 min 1 max 33554432
option name Clear Hash type button
option name Ponder type check default false
option name MultiPV type spin default 1 min 1 max 128
...
uciokTrong đó, uciok là bắt buộc. Nếu sau khi giao diện nhập uci mà không nhận được uciok từ engine, giao diện sẽ coi chương trình đó không phải engine UCI.
position fen
Nhập thế cờ FEN cho engine.
Ví dụ:
position fen 3k1a3/4a4/5n3/9/9/9/9/9/9/4KR3 wHoặc thêm movelist (các nước đi trước đó) vào:
position fen 5a3/3ka4/5n3/9/9/9/9/9/9/4K1R2 w - - 0 1 moves g0f0 d8d9Lưu ý
Phiên bản Pikafish được kiểm tra trong bài này yêu cầu tiền tố position, không nhận chuỗi FEN đứng riêng. Nước đi theo tọa độ dùng cột từ a đến i và hàng từ 0 đến 9. Lịch sử nước đi kèm theo giúp engine xử lý lặp lại thế cờ, chiếu liên tục và đuổi bắt liên tục; chỉ FEN của thế cờ cuối cùng không đủ để khôi phục toàn bộ lịch sử.
Khi thiết lập thành công, thường không có phản hồi trực tiếp. Nếu thế cờ hoặc lịch sử nước đi có lỗi, cách triển khai hiện tại sẽ xuất CRITICAL ERROR rồi thoát.
position startpos
Đặt thế cờ hiện tại là thế cờ ban đầu (rnbakabnr/9/1c5c1/p1p1p1p1p/9/9/P1P1P1P1P/1C5C1/9/RNBAKABNR w). Có thể thêm moves cùng lịch sử nước đi phía sau; phải giữ tiền tố position.
Khi thiết lập thành công, thường không có phản hồi trực tiếp. Nước đi không hợp lệ trong lịch sử sẽ khiến engine xuất lỗi rồi thoát.
go
Để engine phân tích thế cờ hiện tại (thế cờ hiện tại có thể đặt bằng lệnh position).
Có thể thêm các tham số sau:
searchmoves <move1> <move2> ... <movei>: chỉ định các nước đi cần tìm kiếm (chức năng "đổi nước" của giao diện cần dùng tham số này); với bộ phân tích lệnh hiện tại, tham số này phải nằm sau các tham số khác trên cùng dòng. Giao thức UCI không có lệnhbanmoves(lệnh này thuộc giao thức UCCI).infinite: phân tích không giới hạn (cho đến khi gửistop).ponder: suy nghĩ nền.wtime,btime: thời gian còn lại của Đỏ và Đen (ms).winc,binc: thời gian cộng thêm của Đỏ và Đen (ms).movestogo: dùng cho thể thức thời gian "trong bao nhiêu thời gian phải đi bao nhiêu nước", cho engine biết còn bao nhiêu nước nữa thì được cộng thời gian mới, trong cờ tướng thường không dùng đến.depth: chỉ định độ sâu.nodes: chỉ định số nút tìm kiếm.mate: dừng tìm kiếm khi tìm thấy khoảng cách tới kết quả thắng thua quyết định nằm trong số nước được chỉ định; không chỉ áp dụng khi bên mình thắng.movetime: chỉ định thời gian mỗi nước (ms).perft: đếm số chuỗi nước đi hợp lệ tới độ sâu được chỉ định; mỗi mức là một bên đi một nước, không thực hiện tìm kiếm chấm điểm thông thường.
Sau khi nhập go, engine sẽ tìm kiếm thế cờ hiện tại và xuất kết quả tìm kiếm. Khi đạt giới hạn tương ứng hoặc người dùng gửi lệnh stop, engine sẽ dừng tìm kiếm.
go infinite cần được kết thúc bằng stop. Khi đối thủ đi đúng nước dự đoán, dùng ponderhit để chuyển suy nghĩ nền sang tìm kiếm thông thường. Sau khi tìm kiếm thông thường hoàn tất, engine xuất bestmove; còn go perft xuất số liệu về các chuỗi nước đi. Xem thêm Vòng đời tìm kiếm.
d
Xuất thế cờ hiện tại, FEN của thế cờ, thông tin key và thông tin chiếu tướng. Lệnh này dành cho việc phát triển và gỡ lỗi engine.
eval
Xuất thông tin đánh giá của thế cờ hiện tại. Lệnh này dành cho việc phát triển và gỡ lỗi engine.
export_net
Xuất trọng số, có thể chỉ định tên file.
flip
Lật bàn cờ theo chiều trên dưới, đồng thời đổi màu quân Đỏ và Đen cùng bên đến lượt đi; chủ yếu dùng để kiểm tra tính đối xứng của đánh giá.
compiler
Xuất thông tin trình biên dịch và tập lệnh của engine.
bench
Xem chi tiết tại bench là gì? Kết quả bench cho biết điều gì?.
Phiên bản hiện tại còn có lệnh đo tốc độ speedtest. Về công dụng và sự khác nhau giữa các công cụ, xem Chẩn đoán khi vận hành.
Đối chiếu cách triển khai: phân phối lệnh và phân tích tham số, thiết lập thế cờ và xử lý lỗi, lật thế cờ.
