Skip to content

v0.1.26 · 出了 macOS 版（可自己打包）+ Win 包改名 RapaceGo-win.zip

Choose a tag to compare

View all tags
@Rapace7 Rapace7 released this 09 Oct 16:24
· 36 commits to main since this release
v0.1.26
682ee48

出了 macOS 版（要自己打包）；同步脚本不再误删引擎；产物名区分 win / mac

下载（页面最下面的 Assets，按平台挑一个；三个都不含引擎）：

平台 文件
Windows RapaceGo-win.zip
macOS（M 系列） RapaceGo-mac-arm64.zip
macOS（Intel） RapaceGo-mac-x64.zip

引擎要自己配（见 README「显卡品牌」那一节）；想省事就用懒人包（网盘那个完整包，自带引擎）。

展开看这一版改了什么 v0.1.26：出了 macOS 版（要自己打包）；同步脚本不再误删引擎；产物名区分 win / mac

📌 2026-10-09 深夜补充（只改说明，程序文件没有任何变化）

macOS 版发布后，用户实测反馈了说明里漏掉的一步，已修正：

从浏览器下载的引擎文件（llama-server、KataGo、LoGos 的 .gguf）也要过一遍
xattr -cr —— 只对 RapaceGo.app 做是不够的。

原因：macOS 会给浏览器下载的每个文件打上隔离标记（com.apple.quarantine），
带标记的二进制不能执行。表现是「软件能识别到这个程序，但就是跑不起来」——
不容易往隔离属性上想。

# 下官方 llama.cpp 包的人：对解压出来那一整个文件夹做（它要靠同目录的 .dylib）
xattr -cr ~/Downloads/llama-bXXXXX-bin-macos-arm64/

更省事的办法：两个引擎都用 Homebrew 装，压根不用碰这一步 ——

brew install katago
brew install llama.cpp      # → /opt/homebrew/bin/llama-server

然后在「设置」里直接指 Homebrew 的路径。README 已按这个思路重写。

🔧 本次只改文档，不涉及程序代码 —— RapaceGo-win.zip / -mac-arm64.zip /
-mac-x64.zip 三个包与之前完全相同，不必重新下载。

感谢 @zhenli789 的实测反馈 —— 这条只在真实 Mac 上才暴露得出来。

先说下载：这一版有三个包，别拿错

你要的平台 下哪个
Windows RapaceGo-win.zip
macOS（M 系列 / Apple Silicon） RapaceGo-mac-arm64.zip
macOS（Intel） RapaceGo-mac-x64.zip

三个包都不含引擎（历来如此）—— 引擎要自己配，见 README 的「显卡品牌」那一节。
想省事就用懒人包（网盘那个完整包），它自带引擎、解压即用。

macOS 版：能用，但你要自己打包

代码层面已经支持 macOS 了。但我们不提供预编译的 Mac 包 —— 原因很实在：
开发者没有 Mac 机器，打出来的包没人能实测，不敢发没验过的东西；
而且 Apple 的签名公证要开发者年费（$99/年），暂时没投。

不过 "自己打包"只需要四条命令，而且 Mac 上装引擎比 Windows 还简单：

brew install katago                    # Metal 后端，Apple Silicon 原生
git clone https://github.com/Rapace7/RapaceGo.git && cd RapaceGo
npm install && npm run dist:mac        # 产出 dist/RapaceGo-mac-arm64.zip
xattr -cr /Applications/RapaceGo.app   # 未签名包第一次打开要过 Gatekeeper

那 Releases 里的 RapaceGo-mac-*.zip 是什么？ 是我在 GitHub 的 macOS 机器上
打出来的参考产物 —— 给不想自己装 Node 环境的人直接用。同样是未签名的，
第一次打开照样要 xattr -cr 或右键→打开。

已知限制（诚实说明）：

  • 只承诺 Apple Silicon（M 系列） —— Homebrew 有 arm64 预编译瓶；
    Intel Mac 没有瓶，brew install katago 会从源码编译，很久。
  • 整条 Mac 路径没有实机验证过（没有 Mac 机器）。代码改动是完整的
    （引擎名不再写死 .exe、加了 Mac 应用菜单、⌘ 快捷键），
    在 Windows 上跑全套测试确认没改坏，但真机效果要靠反馈。

Windows 用户：这一版修了一个会"删掉几 GB 引擎"的隐患

_sync_deploy.ps1（我自己同步用的脚本，不影响用户）的保留清单原来是
settings.json + records\，把 KataGo\、LoGos\ 当"旧内容"清掉。

这在"免解压版不自带引擎、靠配置里的绝对路径找引擎"的年代是对的 ——
但这次我们把引擎搬进免解压版内部（做成自包含、搬到哪都能跑）之后，
再清就等于把引擎删了。实测踩到：同步完引擎全没、软件起不来。

已修：保留清单加上这两个引擎目录。

对普通用户的影响：没有。 这是我自己工作流的脚本。
写出来是因为"前提变了、旧代码还在按旧前提干活"这类问题最容易复发。

其他

  • 产物名改了：Windows 那个从 RapaceGo.zip 改成 RapaceGo-win.zip
    —— 因为现在有 mac 包了，不区分容易拿错。
  • Win 版还修了 3 处文档错话（设置面板里能改 / 别解压成嵌套 / 不附带引擎），
    这些在 v0.1.25 的补丁里已经改过，这一版把打包产物也带上了。

验证（真机实测）

① Windows v0.1.26 免解压版启动正常
   下棋/分析：CUDA（v1.18.2） · 显卡：RTX 4070（NVIDIA）
             · AI 讲解：CUDA0（可用 8187 MB） —— ✓ 都能配上
② 同步两次，第二次确认引擎目录没被清掉（8.06 GB 完好）
③ mac 包在 GitHub 的 macOS runner 上打包成功（arm64 + x64）
④ Windows 全套测试：单测 12/1/7/1 全过，3 个 lint 全 0

关于「三大目录」的分工（维护者备查，也免得自己混）

位置 是什么 里面该有什么
RapaceGo\（开发目录） 改代码、跑测试的地方 源码 + node_modules + 一堆 _ 开头的开发脚本
dist\ 只放要传 GitHub 的东西 只有 RapaceGo.zip（win-unpacked 是中间产物，同步完自动删）
玄清围弈\ 本地自用的免解压版（唯一一个） 可直接双击运行的完整程序
桌面 RapaceGo懒人包\ 给别人下载用的整包（传网盘，不传 GitHub） 程序 + KataGo + LoGos，解压即用、零配置

为什么懒人包不上 GitHub：它 8.2 GB，而 GitHub Release 单个附件上限 2 GB，
且大头（4.4GB 的 .gguf 模型、296MB 的 .bin.gz 权重）本身就是压缩格式，
再打 zip 也压不动。GitHub 那份走轻量路线（146MB + 首次运行自动下模型）。

★ 懒人包的目录约定（做包时最容易搞错的一条）

main.js 里打包态的「引擎位置」是和 RapaceGo.exe 平级，不是上一级：

BASE_DIR = IS_PACKAGED ? path.dirname(process.execPath) : __dirname;  // 打包后 = exe 目录
const up = IS_PACKAGED ? BASE_DIR : path.join(__dirname, '..');        // 打包后 up 就是 exe 目录本身
katago: path.join(up, 'KataGo', 'engine', 'katago.exe')

所以懒人包的布局必须是：

RapaceGo懒人包\
├─ RapaceGo.exe      ← 和下面两个目录平级
├─ KataGo\engine\katago.exe + weights\
└─ LoGos\llama-server.exe + *.gguf

别把程序本体再套一层 RapaceGo\ —— 那样软件会去找 懒人包\RapaceGo\KataGo\...，
而文件在 懒人包\KataGo\...，结果引擎永远起不来（实测 settings.check 五项全 false）。

重建懒人包：powershell -File _build_lazy.ps1（已含"删掉 settings.json / records"等铁律）。

下载

只有一个文件：

文件 大小 说明
RapaceGo.zip 约 146 MB 解压一次，之后从文件夹里双击启动 —— 启动最快，也最便携

包名固定不带版本号（这样每次下载地址都一样）。要知道自己装的是哪一版：
打开软件 → 左上角「帮助」，标题右边写着版本号。

完全不会用 GitHub 也能装（四步）

① 打开下载页：https://github.com/Rapace7/RapaceGo/releases

② 往下滑，找到最上面那条发布（标题写着版本号和日期，GitHub 的下载文件都放在「发布」里）

③ 那个区块下面有一栏 Assets

⚠️ Assets 不是一个文件夹，是这次发布附带的下载文件清单。
小白最容易在这儿绕晕 —— 你要找的就是这份清单里的文件。

④ 点清单里的 RapaceGo.zip 下载

  • ⚠️ 别下页面最下面的 Source code (zip) —— 那是 GitHub 自动生成的源码压缩包，
    解压出来不能双击运行

⑤ 下载完右键「全部解压缩」，打开文件夹，双击 RapaceGo.exe —— 软件就起来了。

认准三样东西就行：① 最上面那条发布 → ② 它下面的 Assets 清单 → ③ 蓝色的 RapaceGo.zip

更新到新版本

把新包解压到原来那个文件夹、覆盖同名文件就行 —— 棋谱和设置不会丢。

  1. 打开软件 → 左上角「帮助」，记下当前版本号
  2. 到这个页面看最上面那条是不是更新了
  3. 关掉软件（重要：程序开着文件被占用，覆盖会失败或只覆盖一半）
  4. 下载新的 RapaceGo.zip → 解压到你现在用的那个文件夹 → 问是否覆盖时选「替换」
  5. 重新双击 RapaceGo.exe

为什么不会丢东西：包里只有程序本体，records/（你的棋谱和讲解）、settings.json
（引擎路径）、KataGo/、LoGos/（引擎与模型）都不在包里，所以原样保留。

保险做法：更新前把 records 文件夹复制一份到别处 —— 那是唯一丢了找不回来的东西。

⚠️ 引擎要自己准备一次（包里不含）

下载包里只有软件本体（约 570KB 的代码 + Electron 运行时），两个引擎是别人的项目：

① KataGo（必需，不装就没有 AI 下棋和数据分析）

② 讲解模型（可选，4.4GB）

解压后的文件夹里有一个 下载讲解模型.bat —— 双击它就行。
它会自动下载、合并模型、装好推理运行时，全程中文提示；
中途断了重新双击会接着下（按精确字节数判断，没下全的续传）。

👉 已经自己下载了那三个 .part 分卷（part01/02/03）？
那就不用管 bat 了 —— 往下翻到 ▶ 点这里展开 那段，一行命令就能合并。

▶ 点这里展开：已经自己下好那三个 .part 分卷了？手动合并也行（不用 bat）

下载 LoGos-7B-Q4_K_M.gguf.part01 / .part02 / .part03 之后，任选一种方式合并成
LoGos-7B-Q4_K_M.gguf（三个文件放在同一个文件夹里）：

① 命令提示符一行

copy /b LoGos-7B-Q4_K_M.gguf.part01+LoGos-7B-Q4_K_M.gguf.part02+LoGos-7B-Q4_K_M.gguf.part03 LoGos-7B-Q4_K_M.gguf

② PowerShell（流式拷贝，内存占用低）

$out = [System.IO.File]::Create("LoGos-7B-Q4_K_M.gguf")
foreach ($p in "part01","part02","part03") {
  $i = [System.IO.File]::OpenRead("LoGos-7B-Q4_K_M.gguf.$p")
  $i.CopyTo($out); $i.Close()
}
$out.Close()

③ 7-Zip / WinRAR 不行 —— 压缩工具没有「合并分卷」功能。

⚠️ 合并后务必核对：应该是 4,683,071,328 字节（约 4.36 GB）。
不对就是没下全，删掉重下。核对完可以把三个 .part 删掉（省 4.4GB）。
然后回软件「设置」→ LoGos 组分别选 llama-server.exe 和合并出来的 .gguf。

为什么要分卷：GitHub 单个文件硬上限 2GB，而这模型 4.4GB —— 平台限制，
不是故意折腾你。三个分卷就是纯二进制切片，合并结果和原文件逐字节一致
（开发时用 sha256 验过）。

合并完还需要推理运行时（llama-server.exe）—— 上面那个 bat 会帮你装。

▶ 点这里展开：完全手动装（不用 bat、不用管分卷）

模型：YichuanMa/LoGos-7B 转的 GGUF Q4_K_M；
运行时：llama.cpp 的 Windows CUDA 版。
⚠️ 官方主包不含 CUDA 运行时，要另下同版本的 cudart-*.zip 放同目录。

装完之后文件夹长什么样

解压出来不止 RapaceGo.exe 一个文件，还有一堆 .dll、.pak、locales\ 之类 ——
那些都是软件自带的运行库（Electron 框架），不用管、也不要删（一共约 368 MB）。

下面把「你加进去的」和「软件自带的」分开写：

RapaceGo/                          ← 解压出来的文件夹（名字随便，拷到哪都能用）
│
├─ ★ 你自己准备的 ──────────────────────────
│  ├─ KataGo/                      ① 下 KataGo 的 Windows 版解压进来，改名成 KataGo
│  │  ├─ katago.exe
│  │  ├─ …（同目录还有一堆 .dll，一起放着别删）
│  │  └─ weights/                  ② 新建这个文件夹，放两个权重
│  │     ├─ b11c768nbt.bin.gz              算胜率 / 推荐点 / 形势
│  │     └─ b18c384nbt-humanv0.bin.gz      当 AI 对手（带 human 的那个）
│  └─ LoGos/                       ③ 双击「下载讲解模型.bat」之后自动出现（可选）
│     ├─ llama-server.exe
│     └─ LoGos-7B-Q4_K_M.gguf
│
├─ ★ 软件自带的（别删）─────────────────────
│  ├─ RapaceGo.exe                 ← 双击这个启动（245 MB，程序+框架都在里面）
│  ├─ 下载讲解模型.bat              ← 要讲解功能就双击它（会自动建上面的 LoGos/）
│  ├─ start.bat                    ← 双击没反应时的备用启动方式
│  ├─ resources/  locales/         ← 程序代码、界面、语言包
│  ├─ *.dll（7 个）                 ← 图形 / 视频 / 编译器等运行库
│  ├─ *.pak / *.bin / *.dat        ← 界面资源
│  └─ LICENSE.electron.txt · LICENSES.chromium.html  ← 开源许可声明
│
└─ ★ 自动生成的（随时可删）─────────────────
   ├─ settings.json                ← 你在「设置」里填的引擎路径（**删了要重填**）
   ├─ records/                     ← 你的棋谱 + 复盘报告 + 逐手讲解（**别删**）
   └─ userdata/                    ← 页面缓存（删了自动重建，不心疼）

一句话：只有 RapaceGo.exe 和那一堆自带的 dll/pak 是"程序本体"，其余要么是你放进去的引擎、
要么是它自己生成的数据。看不懂的文件不要删 —— 真正该动的只有 KataGo/、LoGos/ 和「设置」。
想彻底卸载：把整个文件夹删掉就行（棋谱想留就先复制 records/ 出来）。

装好后在软件左上角「设置」里指一下路径（选 katago.exe 时它会自动帮你填权重），
再点左上角（顶栏左侧）的引擎灯 →「加载」。

硬件：显存是主要门槛

实测（RTX 4070 Laptop / 8GB，nvidia-smi）：

组件 显存
KataGo 分析引擎 ≈ 350 MB
KataGo 对弈引擎 ≈ 170 MB
LoGos 讲解模型（Q4_K_M） ≈ 4.9 GB
三个全开 ≈ 5.5 GB

6GB 显存的卡能用但别全开；4GB 或核显只能用 KataGo 部分功能。
软件默认一个引擎都不加载，用不到就不占显存。

说明

  • 本项目代码 MIT；KataGo MIT；LoGos 授权为「仅研究、非商业」
  • 讲解由本地小模型 LoGos 生成，只输出中文（训练数据是中文标注）。
    看不懂中文的话：把讲解文字选起来丢进翻译工具就行（软件里允许选中复制）。
  • 代码几乎全部由 AI Agent 编写（对话由 DeepSeek V4.1 Flash 驱动），
    完整的决策过程见仓库里的 开发记录.md

Contributors

zhenli789
Assets 5
Loading