如何将C++编写的国际象棋GUI连接到Stockfish UCI引擎

问题根源 #

• system和单次_popen调用的本质是每次执行都会创建全新的独立Stockfish子进程，命令执行结束后进程立即销毁，无法保留上一次调用的上下文状态。你设置的position指令仅在第一个临时进程中生效，第二个执行go指令的进程完全无相关状态，自然输出结果不符合预期。
• 拼接多命令作为启动参数的方案不可行，因为Stockfish的命令行参数仅支持单次指令输入，它的标准交互逻辑是启动后从标准输入持续读取指令，而非启动时通过参数批量执行多命令。

核心实现思路 #

全程复用同一个Stockfish常驻进程，通过双向管道实现和进程的持续交互：

1. 操作系统API启动一次Stockfish进程，将进程的标准输入、标准输出分别绑定到两个独立管道
2. 所有UCI指令通过输入管道发送给Stockfish
3. 引擎的返回结果通过输出管道实时读取
4. 不需要使用时发送quit指令结束进程，释放资源

Windows平台参考实现代码 #

#include <windows.h>
#include <string>
#include <iostream>

HANDLE hChildStd_IN_Rd = NULL;
HANDLE hChildStd_IN_Wr = NULL;
HANDLE hChildStd_OUT_Rd = NULL;
HANDLE hChildStd_OUT_Wr = NULL;

// 初始化管道并启动Stockfish进程
bool initStockfish(const std::string& stockfishPath) {
    SECURITY_ATTRIBUTES saAttr;
    saAttr.nLength = sizeof(SECURITY_ATTRIBUTES);
    saAttr.bInheritHandle = TRUE;
    saAttr.lpSecurityDescriptor = NULL;

    // 创建标准输出管道
    if (!CreatePipe(&hChildStd_OUT_Rd, &hChildStd_OUT_Wr, &saAttr, 0)) return false;
    SetHandleInformation(hChildStd_OUT_Rd, HANDLE_FLAG_INHERIT, 0);

    // 创建标准输入管道
    if (!CreatePipe(&hChildStd_IN_Rd, &hChildStd_IN_Wr, &saAttr, 0)) return false;
    SetHandleInformation(hChildStd_IN_Wr, HANDLE_FLAG_INHERIT, 0);

    // 配置子进程启动参数
    PROCESS_INFORMATION piProcInfo;
    STARTUPINFO siStartInfo;
    ZeroMemory(&piProcInfo, sizeof(PROCESS_INFORMATION));
    ZeroMemory(&siStartInfo, sizeof(STARTUPINFO));
    siStartInfo.cb = sizeof(STARTUPINFO);
    siStartInfo.hStdError = hChildStd_OUT_Wr;
    siStartInfo.hStdOutput = hChildStd_OUT_Wr;
    siStartInfo.hStdInput = hChildStd_IN_Rd;
    siStartInfo.dwFlags |= STARTF_USESTDHANDLES;

    // 启动Stockfish子进程
    if (!CreateProcess(stockfishPath.c_str(), NULL, NULL, NULL, TRUE, 0, NULL, NULL, &siStartInfo, &piProcInfo)) {
        return false;
    }
    CloseHandle(piProcInfo.hThread);
    CloseHandle(piProcInfo.hProcess);
    return true;
}

// 向Stockfish发送UCI指令
void sendCommand(const std::string& cmd) {
    DWORD dwWritten;
    std::string cmdWithNewLine = cmd + "\n";
    WriteFile(hChildStd_IN_Wr, cmdWithNewLine.c_str(), cmdWithNewLine.size(), &dwWritten, NULL);
}

// 读取Stockfish输出直到命中指定结束标记
std::string readOutputUntil(const std::string& endMarker) {
    char buffer[1024];
    DWORD dwRead;
    std::string output;
    while (true) {
        ReadFile(hChildStd_OUT_Rd, buffer, sizeof(buffer)-1, &dwRead, NULL);
        if (dwRead == 0) break;
        buffer[dwRead] = '\0';
        output += buffer;
        if (output.find(endMarker) != std::string::npos) {
            break;
        }
    }
    return output;
}

int main() {
    // 替换为你的Stockfish可执行文件路径
    if (!initStockfish("C:/Users/kurtk/source/Chess/Project1/Project1/stock/stockfish.exe")) {
        std::cout << "启动Stockfish失败" << std::endl;
        return 1;
    }
    // UCI协议标准初始化流程
    sendCommand("uci");
    readOutputUntil("uciok");
    sendCommand("isready");
    readOutputUntil("readyok");

    // 执行业务指令
    sendCommand("position startpos moves e2e4");
    sendCommand("go depth 10");
    std::string goResult = readOutputUntil("bestmove");
    std::cout << goResult << std::endl;

    // 退出进程释放资源
    sendCommand("quit");
    CloseHandle(hChildStd_IN_Rd);
    CloseHandle(hChildStd_IN_Wr);
    CloseHandle(hChildStd_OUT_Rd);
    CloseHandle(hChildStd_OUT_Wr);
    return 0;
}

注意事项 #

• 发送给Stockfish的每条指令末尾必须加换行符\n，否则引擎会判定指令未输入完成，不会执行
• UCI协议要求启动后先发送uci指令等待引擎返回uciok，再发送isready等待readyok，再执行业务指令，否则可能出现引擎无响应的问题
• 示例代码简化了错误处理逻辑，生产环境使用时需要补充所有API调用的返回值判断和异常处理
• 若为Linux平台，可通过pipe + fork + dup2 + execvp实现相同逻辑，核心思路一致

内容的提问来源于stack exchange，提问作者blah blah