# KataGo 教學級正式複盤報告（測試版）

> **正式設定：** `maxVisits=1000`。**實際分析來源：SGF 內嵌標註。**本次環境沒有獨立 KataGo binary／model，因此沒有重新計算；以下忠實整理原檔的 Lizzie／OpenCL Kata1-18B 結果。

## 1. 棋局概覽

| 欄位 | 內容 |
|---|---|
| 白方 | 祥禾2 |
| 黑方 | 085733 |
| 結果 | B+76.50 |
| 日期 | 2026-09-09 |
| 貼目 | 0.0 |
| 規則 | Japanese |
| 棋盤 | 19 |
| 黑方段位 | 1段 |
| 白方段位 | 4级 |
| 用時 | 1200 |

- 原檔 SHA-256：`3af7081682ef2cbfc8c3d4a5a43ca061548834701ea9d58d4168489b95f0ebe4`
- 主線：268 手；可讀到勝率標註：268 手
- 座標示例：SGF `pp` → GTP `Q4`（排除 GTP 的 I 欄）

## 2. 值得複盤的關鍵局面

以下依相鄰局面的白棋勝率變化排序；這是模型指標，不是正式棋力評等。

| 手數 | 實戰落子 | 白棋勝率前 → 後 | 變化 | 引擎首選 | 首選 PV（前 8 手） | 首選訪問數 |
|---:|---|---:|---:|---|---|---:|
| 64 | O14 | 48.6% → 14.0% | -34.6 個百分點 | P6 | P6 Q10 S11 Q2 N6 R2 | 30 |
| 51 | M18 | 10.7% → 41.4% | +30.7 個百分點 | E3 | E3 D6 R12 R11 Q11 Q12 | 40 |
| 66 | N14 | 34.2% → 4.6% | -29.6 個百分點 | P6 | P6 R10 S11 R12 R11 Q11 | 28 |
| 49 | N18 | 3.8% → 24.8% | +21.0 個百分點 | E3 | E3 D6 H4 P6 R10 S11 | 22 |
| 65 | O13 | 14.0% → 34.2% | +20.2 個百分點 | R12 | R12 P6 R10 S12 R7 Q8 R8 S11 | 49 |
| 50 | N17 | 24.8% → 10.7% | -14.1 個百分點 | P6 | P6 E4 J3 C3 N4 | 28 |
| 48 | O17 | 17.8% → 3.8% | -14.0 個百分點 | P6 | P6 E4 J3 C3 N4 | 19 |
| 47 | F17 | 5.4% → 17.8% | +12.4 個百分點 | E3 | E3 D6 H4 P6 R10 Q11 | 27 |

### 怎麼讀這張表

- **實戰落子與首選不同**不必然代表錯棋；低訪問數的早期／終局結果要保守解讀。
- 這份原檔在後段含有大量接近 0%／100% 的終局標註，示範程式已排除這些飽和區間，避免把終局連續手誤判為單一決定性失誤。
- 教學複盤優先看中盤、勝率差距穩定且 PV 有足夠訪問數的局面。

## 3. 可展示的三個 API／服務範例

### 範例 A：單局分析閉環
```text
POST /api/analyses  multipart: studentId + game.sgf
→ 202 { id, status: "queued" }
→ GET /api/analyses/:id
→ completed { summaryUrl, reportUrls, summary }
```
本檔已作為單檔上傳測試夾具；本次先以 SGF 內嵌分析離線產出正式格式報告。

### 範例 B：座標正規化
```text
SGF:  ;W[pp]
GTP:  Q4
KataGo query: "Q4"
```
這一步可避免 KataGo 報 `Could not parse board location: pp`。

### 範例 C：批次學員彙整
```json
{
  "studentId": "祥禾2",
  "games": 1,
  "responseCount": 268,
  "scoredCount": 8,
  "model": "OpenCLKata1-18B (embedded SGF annotations; target maxVisits=1000)",
  "note": "單局示範；正式批次需固定 model/rules/visits"
}
```
若再加入更多 SGF，可沿用同一長駐 engine，逐局串行並將壞檔放進 `failures`，不讓單檔錯誤中止整批。

## 4. 限制與下一步

1. 本次未重新跑 KataGo；正式重算需提供 pinned KataGo binary、model、analysis config，並將 maxVisits 固定為 1000。
2. 原檔內嵌分析的局部訪問數可能低於 1000；本報告是正式格式測試版，不宜把它當成已完成 maxVisits=1000 重算的棋力評估。
3. 互動 HTML 會保留完整主線、關鍵局面、PV、勝率與來源標籤，可離線開啟。
