Skip to content

Commit de022ae

Browse files
haochaoc
haoc
authored and
haoc
committed
fix: prevent full-game KataGo analysis timeouts
1 parent 2610e06 commit de022ae

6 files changed

Lines changed: 301 additions & 80 deletions

File tree

‎docs/RELEASE_NOTES_v0.3.14-dev.3.md‎

Lines changed: 138 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,138 @@
1+
# GoMentor v0.3.14-dev.3
2+
3+
GoMentor v0.3.14-dev.3 is a development hotfix for full-game KataGo analysis reliability. It changes the teacher's full-game review path to use a faster whole-game sweep, refine only the strongest suspected mistake points, pause competing quick graph analysis, and return usable partial KataGo batches instead of waiting until timeout when a few positions are slow. This release keeps the v0.3.14-dev.2 development baseline: real local KataGo + LLM teaching evaluation, opt-in persistent KataGo analysis engine, spawn fallback, grounded shape recognition engine, local pattern matcher, knowledge source-policy gates, optimized move-range review, quality checks and eval gates, Real Eval / engine silver fixture gate, KataGo engine pool telemetry, Release artifact smoke, student level, student age, teacher persona style settings with evidence boundary, teacher sessions, and selective PR #6 integration. Windows packages continue to include the Windows OpenCL runtime bundle and KataGo OpenCL adjacent runtime files; GPU vendor OpenCL drivers still come from the user's GPU driver. Thanks to layiku and wimi321.
4+
5+
QQ群：1030632742，欢迎一起交流、提建议、完善 GoMentor。
6+
7+
## 中文
8+
9+
### 下载前先选版本
10+
11+
| 平台 / 场景 | 推荐下载 |
12+
| --- | --- |
13+
| macOS Apple Silicon | `GoMentor-0.3.14-dev.3-mac-arm64.dmg` |
14+
| macOS Intel | `GoMentor-0.3.14-dev.3-mac-x64.dmg` |
15+
| Windows 普通版，OpenCL 推荐包 | `GoMentor-0.3.14-dev.3-win-x64.exe` 或 `GoMentor-0.3.14-dev.3-win-x64-portable.zip` |
16+
| Windows NVIDIA 专版，适合 NVIDIA 显卡和 CUDA 环境 | `GoMentor-0.3.14-dev.3-win-x64-nvidia.exe` 或 `GoMentor-0.3.14-dev.3-win-x64-nvidia-portable.zip` |
17+
| 校验文件 | `SHA256SUMS.txt` |
18+
19+
### 本版重点
20+
21+
- 修复老师侧 `KataGo 整盘分析` 容易超时的问题。
22+
- 整盘复盘改为轻量快扫全盘，再精读少数关键问题手，避免每手都走高成本 forced 查询。
23+
- 老师整盘任务会暂停后台快速胜率图，减少 KataGo 任务互相抢算力。
24+
- 批量分析遇到少数慢响应时会返回已完成结果，避免一直等到失败。
25+
26+
## 繁體中文
27+
28+
### 下載前先選版本
29+
30+
| 平台 / 使用情境 | 建議下載 |
31+
| --- | --- |
32+
| macOS Apple Silicon | `GoMentor-0.3.14-dev.3-mac-arm64.dmg` |
33+
| macOS Intel | `GoMentor-0.3.14-dev.3-mac-x64.dmg` |
34+
| Windows 一般版，OpenCL 推薦包 | `GoMentor-0.3.14-dev.3-win-x64.exe` 或 `GoMentor-0.3.14-dev.3-win-x64-portable.zip` |
35+
| Windows NVIDIA 專版 | `GoMentor-0.3.14-dev.3-win-x64-nvidia.exe` 或 `GoMentor-0.3.14-dev.3-win-x64-nvidia-portable.zip` |
36+
| 校驗檔 | `SHA256SUMS.txt` |
37+
38+
### 本版重點
39+
40+
- 修正老師側 `KataGo 整盤分析` 容易逾時的問題。
41+
- 整盤復盤改為先快速掃全局，再精讀少數關鍵問題手。
42+
- 老師整盤任務會暫停背景快速勝率圖，避免 KataGo 任務互相搶資源。
43+
- 批次分析遇到少數慢回應時會返回已完成結果，不再等到整體失敗。
44+
45+
## English
46+
47+
### Pick the right package before downloading
48+
49+
| Platform / use case | Recommended download |
50+
| --- | --- |
51+
| macOS Apple Silicon | `GoMentor-0.3.14-dev.3-mac-arm64.dmg` |
52+
| macOS Intel | `GoMentor-0.3.14-dev.3-mac-x64.dmg` |
53+
| Standard Windows x64, OpenCL recommended | `GoMentor-0.3.14-dev.3-win-x64.exe` or `GoMentor-0.3.14-dev.3-win-x64-portable.zip` |
54+
| Windows NVIDIA edition for NVIDIA GPUs and CUDA runtimes | `GoMentor-0.3.14-dev.3-win-x64-nvidia.exe` or `GoMentor-0.3.14-dev.3-win-x64-nvidia-portable.zip` |
55+
| Checksums | `SHA256SUMS.txt` |
56+
57+
### Why update
58+
59+
- Fixes full-game `KataGo analysis` timeouts in the AI teacher tool path.
60+
- Full-game review now does a light whole-game sweep first, then refines only the strongest suspected mistakes.
61+
- Teacher full-game tasks pause the background quick winrate graph so KataGo capacity goes to the review.
62+
- Batch analysis can return usable completed positions when a few KataGo responses are slow, instead of failing the whole tool call.
63+
64+
## 日本語
65+
66+
### ダウンロード前に選ぶもの
67+
68+
| 環境 | 推奨ファイル |
69+
| --- | --- |
70+
| macOS Apple Silicon | `GoMentor-0.3.14-dev.3-mac-arm64.dmg` |
71+
| macOS Intel | `GoMentor-0.3.14-dev.3-mac-x64.dmg` |
72+
| Windows 標準版、OpenCL 推奨 | `GoMentor-0.3.14-dev.3-win-x64.exe` または `GoMentor-0.3.14-dev.3-win-x64-portable.zip` |
73+
| NVIDIA GPU / CUDA 向け Windows NVIDIA 版 | `GoMentor-0.3.14-dev.3-win-x64-nvidia.exe` または `GoMentor-0.3.14-dev.3-win-x64-nvidia-portable.zip` |
74+
| チェックサム | `SHA256SUMS.txt` |
75+
76+
### 主な変更
77+
78+
- AI 教師の全局 `KataGo analysis` がタイムアウトしやすい問題を修正しました。
79+
- 全局レビューは軽量な全局スイープを先に行い、重要な疑問手だけを精読します。
80+
- 全局レビュー中は背景の高速勝率グラフ解析を止め、KataGo の計算資源をレビューに回します。
81+
- 一部の応答が遅い場合も、取得済みの解析結果を使って処理を継続します。
82+
83+
## 한국어
84+
85+
### 다운로드 전 선택
86+
87+
| 환경 | 권장 다운로드 |
88+
| --- | --- |
89+
| macOS Apple Silicon | `GoMentor-0.3.14-dev.3-mac-arm64.dmg` |
90+
| macOS Intel | `GoMentor-0.3.14-dev.3-mac-x64.dmg` |
91+
| Windows 표준 x64, OpenCL 권장 | `GoMentor-0.3.14-dev.3-win-x64.exe` 또는 `GoMentor-0.3.14-dev.3-win-x64-portable.zip` |
92+
| NVIDIA GPU / CUDA용 Windows NVIDIA 에디션 | `GoMentor-0.3.14-dev.3-win-x64-nvidia.exe` 또는 `GoMentor-0.3.14-dev.3-win-x64-nvidia-portable.zip` |
93+
| 체크섬 | `SHA256SUMS.txt` |
94+
95+
### 이번 버전
96+
97+
- AI 교사의 전체 대국 `KataGo analysis`가 시간 초과되기 쉬운 문제를 수정했습니다.
98+
- 전체 복기는 먼저 가벼운 전역 스윕을 실행하고, 중요한 문제 수만 정밀 분석합니다.
99+
- 전체 복기 중에는 배경 빠른 승률 그래프 분석을 멈춰 KataGo 자원을 복기에 집중합니다.
100+
- 일부 응답이 느려도 이미 완료된 분석 결과를 사용해 전체 도구 호출 실패를 줄입니다.
101+
102+
## ภาษาไทย
103+
104+
### เลือกไฟล์ก่อนดาวน์โหลด
105+
106+
| แพลตฟอร์ม | ไฟล์ที่แนะนำ |
107+
| --- | --- |
108+
| macOS Apple Silicon | `GoMentor-0.3.14-dev.3-mac-arm64.dmg` |
109+
| macOS Intel | `GoMentor-0.3.14-dev.3-mac-x64.dmg` |
110+
| Windows x64 มาตรฐาน แนะนำ OpenCL | `GoMentor-0.3.14-dev.3-win-x64.exe` หรือ `GoMentor-0.3.14-dev.3-win-x64-portable.zip` |
111+
| Windows NVIDIA edition สำหรับ NVIDIA GPU และ CUDA | `GoMentor-0.3.14-dev.3-win-x64-nvidia.exe` หรือ `GoMentor-0.3.14-dev.3-win-x64-nvidia-portable.zip` |
112+
| Checksums | `SHA256SUMS.txt` |
113+
114+
### จุดสำคัญของรุ่นนี้
115+
116+
- แก้ปัญหาเครื่องมือครู AI `KataGo analysis` แบบทั้งเกมที่หมดเวลาได้ง่าย
117+
- รีวิวทั้งเกมจะสแกนทั้งกระดานแบบเบาก่อน แล้วจึงวิเคราะห์ลึกเฉพาะจุดที่น่าสงสัยที่สุด
118+
- ขณะรีวิวทั้งเกม ระบบจะพักกราฟ winrate แบบเร็วด้านหลัง เพื่อลดการแย่งทรัพยากร KataGo
119+
- หากบางตำแหน่งตอบช้า ระบบจะใช้ผลที่เสร็จแล้วต่อ แทนที่จะรอจนล้มเหลวทั้งหมด
120+
121+
## Tiếng Việt
122+
123+
### Chọn gói tải xuống
124+
125+
| Nền tảng | Gói khuyến nghị |
126+
| --- | --- |
127+
| macOS Apple Silicon | `GoMentor-0.3.14-dev.3-mac-arm64.dmg` |
128+
| macOS Intel | `GoMentor-0.3.14-dev.3-mac-x64.dmg` |
129+
| Windows x64 tiêu chuẩn, khuyến nghị OpenCL | `GoMentor-0.3.14-dev.3-win-x64.exe` hoặc `GoMentor-0.3.14-dev.3-win-x64-portable.zip` |
130+
| Windows NVIDIA edition cho GPU NVIDIA và CUDA | `GoMentor-0.3.14-dev.3-win-x64-nvidia.exe` hoặc `GoMentor-0.3.14-dev.3-win-x64-nvidia-portable.zip` |
131+
| Checksums | `SHA256SUMS.txt` |
132+
133+
### Điểm mới
134+
135+
- Sửa lỗi công cụ giáo viên AI `KataGo analysis` khi phân tích toàn ván dễ bị timeout.
136+
- Review toàn ván giờ quét nhanh toàn bộ trước, sau đó chỉ phân tích sâu vài nước nghi vấn quan trọng nhất.
137+
- Khi chạy review toàn ván, GoMentor tạm dừng quick winrate graph nền để tránh tranh tài nguyên KataGo.
138+
- Nếu một vài vị trí phản hồi chậm, hệ thống dùng các kết quả đã hoàn tất thay vì chờ đến khi toàn bộ tool call thất bại.

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "gomentor",
3-
"version": "0.3.14-dev.2",
3+
"version": "0.3.14-dev.3",
44
"description": "KataGo + multimodal LLM desktop workbench for Go students and teachers.",
55
"main": "out/main/index.js",
66
"type": "module",

0 commit comments

Comments
 (0)