引擎运行与通信
界面负责棋盘、按钮和棋钟,引擎负责接收局面、计算并返回结果。两者用一行行文字命令交流。点击“分析”不只是调用一个算棋函数,还涉及设置局面、启动线程、持续输出和结束通知。
本文按 official Pikafish 的固定提交 1c66b9b 核对。这里解释各部分如何配合;参数怎么设置另见 UCI 选项,算棋方法见 搜索算法。
从启动到返回走法
main.cpp 先初始化攻击表和局面所需的数据,再创建 UCIEngine 并进入命令循环。uci.cpp 负责读写协议;Engine 统一管理局面、选项、线程、置换表和网络,实际搜索交给工作线程。
| 命令或输出 | 在这次思考中做什么 |
|---|---|
uci → uciok | 报告引擎名称和支持的选项,完成握手。 |
setoption | 修改选项;某些设置还会重新分配线程或内存。 |
position ... | 设置起始局面,并按 moves 后的着法逐步走到目标位置。 |
go ... | 读取时间、深度或节点限制,检查网络,准备根局面并启动搜索。 |
info ... | 搜索过程中持续报告深度、评分、节点数和主要变化。 |
stop | 请求结束本次搜索;工作线程收尾后返回结果。 |
bestmove ... | 本次搜索的最终走法通知;界面收到后再处理落子。 |
启动搜索后,命令循环还能继续接收 stop。stop 只是设置停止标记,不会强行杀掉线程;搜索主线程会等待其他工作线程结束,再通过回调输出 bestmove。quit 则请求停止并退出程序。
bestmove 后可能附带 ponder,表示预计的对手回应。真正后台思考由界面发送 go ponder 启动;对手确实走了预计着法,再用 ponderhit 转为正常思考。只看到一个预计回应,并不代表引擎已经自动开始后台搜索。
局面、历史与等待:不能只看棋盘
每次 position 都重新建立局面状态;附带的 moves 会逐步验证并落子,留下历史链。只发送最后一张 FEN,不能恢复此前怎么走过来,因此可能影响重复、长将和长捉判定。
ucinewgame 清理置换表和搜索历史,不负责把棋盘摆回开局。新局面仍需用 position 设置。当前代码遇到无法解析的局面或非法历史着法,会输出 CRITICAL ERROR 并退出;接入程序需要保留错误消息。
readyok 确认命令层能应答;bestmove 标志本次搜索收尾。 isready 在搜索继续时也会回复。结束搜索先发送 stop,再等待 bestmove;改选项也应在此后进行,因为 setoption 会等待搜索完成。选项代码校验类型和范围,再执行更新。
线程与内存:共享有用信息,各算各的分支
工作线程各自保存搜索局面和进度,启动前建立自己的根状态,更早历史只读共享。同一实例共用置换表;部分历史统计按 NUMA 节点组织,其他统计留在线程内部。各线程对完整局面进行搜索,从共享缓存中取得其他线程留下的信息。
NUMA 可以理解为多核机器中“访问附近内存与远处内存的代价不同”。相关代码负责安排线程和网络副本的位置;内存代码还提供对齐分配、大页尝试和相应回退。这些机制服务于数据访问效率,不改变象棋走法规则。
进程内存包括置换表、网络、历史表和线程栈等部分。 Hash 指定其中的置换表预算,线程数还影响其他分配。线程会有重复工作,扩大线程数的收益需要按具体硬件和局面测量。
时间管理根据剩余时间、加秒等给搜索预算,再随搜索表现调整,详见 多线程与时间分配。
cp、mate、wdl:三种不同含义
原始 UCI 搜索评分从根局面当前行棋方看,正数有利于这一方。界面可能另行换算成红方视角,读日志时要分清。
| 输出 | 应怎样理解 |
|---|---|
score cp 100 | 普通局面评分经过显示尺度换算后的数值;cp 的单位与比例见下文。 |
score mate 3 | 用 UCI 的步数计法报告决定性胜负距离;正数表示己方胜,负数表示己方败。 |
wdl 300 600 100 | 模型给出的胜/和/负估计,单位是千分比;这个示例对应 30%/60%/10%。 |
普通分数通过 round(100 × v / a) 换算,v 为内部分数,a 随盘上子力构成变化。理解 cp 要结合这一显示尺度。WDL 由另一个拟合模型产生,三项合计 1000,表示给定模型与测试条件下的胜、和、负估计。
内部决定性分数先转成剩余层数,再换成 mate 步数。例如正的三层距离会显示 mate 2。象棋的困毙和部分棋规判负也使用这套胜负分,所以看到 mate 不应自动认定为“只能靠将死结束”。若还带 lowerbound 或 upperbound,应按分数界限理解。
评估如何进入搜索,见 局面评估与 NNUE。源码:分数分类、cp/mate/WDL 换算、根搜索输出、棋规胜负分。
检查运行状态:各工具测什么
下列调试命令应在搜索停止后使用,部分界面可能不提供直接输入入口。
| 工具 | 用途与边界 |
|---|---|
d | 查看引擎实际持有的局面,排查界面与引擎是否一致。 |
eval | 查看当前局面的静态评估拆解。 |
compiler | 显示编译器、编译架构与启用的指令集等信息。 |
bench | 按指定局面和限制跑一组测试,统计节点与耗时;适合比较运行行为。 |
speedtest | 预热后运行测速序列,并报告线程、Hash、时间和节点速度等信息。 |
go perft 3 | 数到指定层数的合法着法路径,主要核验走法生成与落子撤销。 |
perft 的递归不调用局面评估,也不按完整长将/长捉规则截断;但当前 Engine::perft() 入口仍会检查网络。它数的是路径,不能把不同路径到达的同一盘面合并为一个,也不能代替棋规回归或棋力测试。
NPS 是每秒搜索节点数。比较编译版本时,应固定代码、网络、局面、线程和测试条件;不同搜索策略的节点工作量可能不同,单看 NPS 不能判断谁更强。
源码:诊断命令、bench 参数、speedtest 执行与报告、perft。
编译版本与压缩依赖各管什么
Makefile 决定目标架构、编译器和优化方式。普通版本在编译时选定指令集;x86-64 universal 把多个版本装进同一文件,启动时检查 CPU 特性再选择入口。当前分发代码还会避开部分旧 AMD 上较慢的 BMI2 路径,把指令支持情况和特定处理器的性能表现一起纳入选择。
输入 compiler,可在 Compilation architecture 和 Compilation settings 中查看本次运行的编译信息。universal 按 CPU 特性和分发条件进入所选实现,随后由该实现报告信息。
外部压缩网络的读取使用 Zstandard:misc.cpp 解压字节流,网络加载代码再解析并校验参数。压缩依赖负责文件读取,NNUE 负责评估,搜索代码负责选棋,不能因为仓库里有压缩库就把它看成另一套棋力算法。
