mirai 0.1.0 for Windows — experimental preview 1

Experimental. The first Windows build of mirai, published as a pre-release so it can be tried and its problems reported. Linux remains the primary platform. 中文说明在下方。

Download

File	What it is
mirai-0.1.0-windows-preview.1-x86_64-setup.exe	Per-user installer into %LOCALAPPDATA%\Programs\mirai, no administrator rights needed. Adds a Start menu entry and offers mirai for .sgf files without taking the association from another program. Uninstall from Settings → Apps.
mirai-0.1.0-windows-preview.1-x86_64.zip	Portable: unpack anywhere and run bin\mirai.exe in the unpacked folder.
SHA256SUMS	Checksums of both.

64-bit x86 Windows only. Neither file is code-signed, so SmartScreen warns on first run: choose More info → Run anyway.

What to expect

• Stutter is expected. GTK's Windows backend is much less mature than its Linux ones. On Windows its GPU renderers draw a black band around every window (GTK #7567), so GTK 4.24 draws with Cairo on the CPU instead, and scrolling, resizing and animation can hitch. This is not a mirai bug. GDK_DEBUG=dcomp brings the GPU renderers back, black band included.
• KataGo is not included. Use a Windows KataGo release (katago.exe with its DLLs; any backend). For automatic setup on first run, put KataGo's folder on PATH and your network (*.bin.gz) in %USERPROFILE%\.katago\models; otherwise choose both in Preferences → Engines. See the guide.
• Checked so far: live analysis with a local KataGo, Fox Go search and download, English and Simplified Chinese (following the Windows display language), a second .sgf opening in the running instance, the installer, the uninstaller and the zip.
• Untested on Windows: mirai-server.exe (included) and connecting to a remote engine.
• Settings are in %APPDATA%\zhaob1n\mirai\config\; autosaves, the Fox cache and KataGo logs in %LOCALAPPDATA%\zhaob1n\mirai\data\. Uninstalling leaves both; delete them by hand for a clean slate.

This exact build was checked under Wine 11; an earlier build of the same work ran on real Windows hardware. Reports from real machines are what this pre-release is for: open an issue with your Windows version, what you did and what happened. For an engine problem, attach the newest file in %LOCALAPPDATA%\zhaob1n\mirai\data\katago-logs\.

How it is built

Cross-compiled on Linux from commit b82fe6e, with Rust's x86_64-pc-windows-gnu target in a Fedora rawhide container: GTK 4.24.0, libadwaita 1.9.4, GLib 2.90.0, GStreamer 1.28.6. tools/packaging/windows-cross.sh reproduces it; PACKAGING.md explains the choices.

---

简体中文

实验性版本。 这是 mirai 的第一个 Windows 版本，以预发布版（pre-release）形式提供，方便试用和反馈问题。Linux 仍是主要平台。

下载

文件	说明
mirai-0.1.0-windows-preview.1-x86_64-setup.exe	按用户安装的安装程序，装到 %LOCALAPPDATA%\Programs\mirai，不需要管理员权限。会添加开始菜单项，并让 mirai 可以打开 .sgf 文件，但不会抢走其他程序已有的关联。卸载请在“设置 → 应用”中进行。
mirai-0.1.0-windows-preview.1-x86_64.zip	便携版：解压到任意位置，运行解压目录里的 bin\mirai.exe。
SHA256SUMS	以上两个文件的校验和。

仅支持 64 位 x86 Windows。两个文件都没有代码签名，第一次运行时 SmartScreen 会警告：选择“更多信息 → 仍要运行”。

需要知道的情况

• 卡顿是预期现象。 GTK 的 Windows 后端远不如它的 Linux 后端成熟。在 Windows 上，它的 GPU 渲染器会在每个窗口周围画出一圈黑框（GTK #7567），所以 GTK 4.24 改用 CPU 上的 Cairo 绘制，滚动、调整窗口大小和动画都可能卡顿。这不是 mirai 的缺陷。设置 GDK_DEBUG=dcomp 可以换回 GPU 渲染器，黑框也会一起回来。
• 不包含 KataGo。 请使用 Windows 版 KataGo（katago.exe 及其 DLL，任何后端均可）。要让首次运行自动完成设置，把 KataGo 所在文件夹加入 PATH，把权重（*.bin.gz）放进 %USERPROFILE%\.katago\models；否则在“首选项 → 引擎”里选择二者。详见指南。
• 目前已验证： 本地 KataGo 的实时分析、野狐棋谱搜索和下载、英文和简体中文界面（跟随 Windows 显示语言）、再打开一个 .sgf 时交给已运行的实例、安装程序、卸载程序和便携版。
• Windows 上尚未测试： mirai-server.exe（已包含）以及连接远程引擎。
• 设置在 %APPDATA%\zhaob1n\mirai\config\；自动保存、野狐缓存和 KataGo 日志在 %LOCALAPPDATA%\zhaob1n\mirai\data\。卸载不会删除它们；想彻底清除请手动删除。

这个构建本身在 Wine 11 下验证过；同一批改动的早期构建在真实 Windows 机器上运行过。发布这个预发布版，正是为了收集真机上的反馈：请开一个 issue，写明 Windows 版本、你做了什么、发生了什么。引擎相关的问题，请附上 %LOCALAPPDATA%\zhaob1n\mirai\data\katago-logs\ 里最新的文件。

构建方式

在 Linux 上从提交 b82fe6e 交叉编译，使用 Rust 的 x86_64-pc-windows-gnu 目标和 Fedora rawhide 容器：GTK 4.24.0、libadwaita 1.9.4、GLib 2.90.0、GStreamer 1.28.6。用 tools/packaging/windows-cross.sh 可以复现；各项选择的原因见 PACKAGING.md。

README assets

Images referenced by README.md. Not a software release; assets are replaced in place with tools/docs/upload-readme-assets.sh.