如何在Python程序中调整Stockfish引擎的搜索深度参数？

• 前置准备工作
  • 通过pip安装官方维护的Python封装库，执行命令：pip install stockfish
  • 提前获取适配当前操作系统的Stockfish可执行文件，记录文件在本地的完整存储路径
• 深度参数的对应逻辑
  Stockfish执行minimax搜索的最大层数，完全对应接口中的depth配置项，无需依赖已失效的旧版支持页面指引，通过Python封装的原生接口即可完成参数调整，无隐藏配置项。
• 两种常用调整方式
  1. 全局设定固定搜索深度
     初始化实例后直接调用内置的set_depth()方法，传入目标深度的整数值即可，后续所有搜索任务都会严格按照该深度执行minimax计算，示例代码：

  from stockfish import Stockfish
  
  # 初始化实例，替换为本地Stockfish可执行文件的真实路径
  engine = Stockfish(path="/your/local/path/to/stockfish")
  
  # 设定minimax搜索最大深度为16
  engine.set_depth(16)
  
  # 传入棋局走法序列
  engine.set_position(["e2e4", "e7e5", "g1f3"])
  
  # 按设定深度执行搜索，返回最优走法
  best_move = engine.get_best_move()
  

  2. 单次搜索临时指定深度
     不需要修改全局配置时，可以在调用搜索方法时直接传入深度参数，该参数优先级高于全局设定，仅对当前单次搜索生效，示例代码：

  # 全局设定深度为16，本次临时按深度10执行搜索
  best_move = engine.get_best_move(depth=10)
  

• 注意事项
  • 不要将深度参数和固定思考时长参数movetime混淆：深度参数会严格限制minimax的搜索层数，达到深度上限后立刻停止计算；movetime参数是固定计算时长，实际达到的搜索深度会随硬件性能动态变化
  • 旧版stockfish库如果不支持set_depth方法，可以通过原生命令通道直接下发配置，兼容写法为：

    engine.send_usi_command(["setoption name Depth value 16"])
    

  • 可设置的最大深度上限由Stockfish程序本身的编译版本决定，常规桌面端编译版本最高支持到22层左右的无剪枝完整搜索，更高深度会触发引擎的自动优化截断

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