引擎算力与借用说明

一、三种算力通道

二、WASM 与 exe：到底差在哪

1. 它们其实是同一个引擎

WASM（WebAssembly）是把 C++ 编译成浏览器能执行的字节码； exe 是编译成 Windows 原生程序。棋力算法完全一样，差别只在「能用到多少机器资源」。

2. 界面软件（鲨鱼、兵河五四等）为什么也用 exe

那类软件是桌面程序，本身自带棋盘界面，通过 UCI 协议调用本地引擎 exe—— 和弈桥的思路相同，只是它们把界面和引擎都放在本机，不涉及浏览器。 弈桥要解决的是另一个问题：让网页也能用上本机那一份算力。

• 如果你只用界面软件打谱，装个引擎 exe 就够了，不需要弈桥；
• 如果你想在网页研究室里用本机算力（页面上的实时主变、逐着评分），那才需要弈桥；
• 两者可以共存：同一个 `pikafish.exe` 文件，界面软件和弈桥都能调用（各自起各自进程）。

三、安装弈桥（不含引擎，需自备）

第 1 步：安装弈桥

1. 从站方提供的下载地址取得安装包，解压到任意目录；
2. 右键 install.ps1 → 「使用 PowerShell 运行」，或在解压目录执行：
   powershell -ExecutionPolicy Bypass -File install.ps1
3. 安装过程不需要管理员权限，程序装到当前用户目录：
   %LOCALAPPDATA%\Programs\gdchess-yiqiao
4. 装完会自动：加入开机自启（当前用户启动文件夹）、注册「应用和功能」卸载项、启动并自检、右下角出现托盘图标。

第 2 步：下载引擎与权重

1. 打开皮卡鱼官方下载页：www.pikafish.com；
2. 下载与你 CPU 匹配的引擎程序（`pikafish.exe`，或 `pikafish-bmi2.exe` / `pikafish-avx2.exe` 变体）； 拿不准就选普通版，弈桥会自动挑它能用的最强变体；
3. 下载对应的权重文件 pikafish.nnue（必须与引擎同版本，新旧权重混用会报错或棋力异常）。

第 3 步：放到弈桥能找到的位置

1. 右键托盘图标 → 「打开引擎目录」（会打开上面那个安装目录）；
2. 把 pikafish.exe 与 pikafish.nnue 一起放进去（两个文件必须同目录）；
3. 回到托盘看第一条只读项，应显示 引擎：pikafish.exe（默认目录）；
4. 如果引擎放在别处（比如 D 盘统一目录），用托盘 「选择引擎文件…」 直接选中那个 exe 即可， 选择会记在配置文件里、升级不丢；要回去就点「恢复默认引擎」。

第 4 步：允许浏览器访问「本地网络」（Chrome / Edge 必做一次）

弈桥只监听本机 127.0.0.1:19870。从 Chrome / Edge 138 版起，公网页面 （www.gdchess.com）要访问「本机地址」必须由你授权一次——这是浏览器的安全策略， 与弈桥、证书都无关。允许后浏览器会按站点记住，以后不再询问。

1. 打开我的研究室，选「本机弈桥」后点「分析」启动引擎 （探测在引擎启动时才发生，只打开设置抽屉不会发请求）； 首次探测时浏览器会弹出类似「允许 www.gdchess.com 访问此设备上的本地网络？」的提示， 点 「允许」 即可（页面每 30 秒自动重连，允许后最多半分钟自动切到「本机弈桥」，也可以直接刷新）；
2. 没看到弹窗、或以前误点过「拒绝」，按下面手动改回来，都是同一个开关：

第 5 步：确认接通

1. 浏览器打开本机自检页：https://127.0.0.1:19870/ping， 应看到 "ok":true、"engineHere":true；
2. 回到我的研究室 → 点右上「算力」→ 应显示「本机弈桥」可用；
3. 随便摆个局面点「分析」，托盘版本条目出现引擎名、页面上开始出主变，就算通了。

四、托盘界面操作说明

弈桥是托盘程序（在右下角时钟区），没有主窗口，所有操作都在托盘菜单里：

五、云端算力（pikaapi）的两种模式

pikaapi 是部署在站方算力服务器上的常驻引擎池服务（HTTP 接口，与站点解耦）。 目前有两种接入方式，本节只做简介，等通道升级完成后会另文详述参数与典型应用：

六、手机与小程序上的算力表现

手机是「算力弱势设备」：CPU 核心少、散热差，浏览器还会在切后台时暂停页面。 跑 WASM 分析时手机发烫、掉电快，分析一久还会被降频拖慢。 云端算力正是为这类设备准备的——把计算全部放到站方服务器上，手机只负责摆棋和收结果：

• 不烧手机资源：CPU 几乎无负载，不发烫、不掉电快，后台也不怕被浏览器暂停；
• 所有设备同速：千元机与旗舰机拿到一样的结果，老手机也有「顶配体验」；
• 不受浏览器沙箱限制：没有 WASM 的线程与内存上限，算得更深更稳；
• 小程序友好：小程序原生页面不支持 WASM（即使通过 web-view 打开网页，引擎能力也受限）， 而云端算力对小程序就是一次普通的网络请求，web-view 内嵌页可直接使用。

各通道在移动端的表现对比：

七、常见问题

装了弈桥，但研究室还是显示 WASM？

按顺序查四件事：① 托盘图标在不在（不在 → 菜单里重新运行一次 YiQiao.exe）； ② 先用浏览器打开 https://127.0.0.1:19870/ping 看是否 "ok":true；③ 若报证书错误，按第三节末尾的 certutil 命令补装证书； ④ 若上面两步都正常、研究室仍回退 WASM，几乎一定是「本地网络访问」权限没放行， 按第三节第 4 步在 Chrome / Edge 里允许一次即可。 另外，未登录时不会发本机通道令牌，也会回退 WASM。

浏览器问「是否允许访问本地网络」，我不小心点了拒绝？

不影响安全，只是研究室连不上本机弈桥、会回退 WASM。改回来： Chrome 打开 chrome://settings/content/siteDetails?site=https%3A%2F%2Fwww.gdchess.com， Edge 打开 edge://settings/content/siteDetails?site=https%3A%2F%2Fwww.gdchess.com， 把「本地网络访问」改成「允许」，刷新研究室即可，无需重装弈桥。详见第三节第 4 步。

提示「弈桥运行中，但引擎缺失」？

程序在跑但没找到引擎文件。托盘「打开引擎目录」确认 pikafish.exe 与 pikafish.nnue 都在（同目录）；若放在别处，用「选择引擎文件…」指过去。

分析时电脑很烫、风扇很响？

引擎是纯计算程序，吃满 CPU 属正常。可减少同时分析的面板数，或关掉不用的标签页 （每个页面各自占一个引擎进程，托盘「活跃会话 N」可以看到当前数量）。

手机上分析发烫、掉电快？

这是手机跑 WASM 的正常代价（计算发生在手机里）。建议：日常用浅层快速分析； 需要深度分析时换电脑（装弈桥）；等云端算力开放后，手机端会明显轻松，见第六节。

Mac / 手机能用本机算力吗？

暂不支持，只能用页内 WASM；各端差异详见第六节的对比表。

公司电脑装不了软件 / 装完被安全软件拦了？

弈桥不写系统目录、不改系统设置，但会在「当前用户信任库」装一张证书、在启动文件夹放一个快捷方式， 部分安全软件会提示。若公司策略禁止，直接用 WASM 即可，功能不受影响，只是慢一些。

同一个引擎文件，界面软件和弈桥能一起用吗？

能。各自启动独立进程，互不干扰。但别让两个程序同时把 CPU 占满。