# 中華職棒進階數據

> 中華職棒（CPBL）進階數據網站，提供中華職棒賽程與比分、球員資料、投手與打者進階數據、排行榜，以及投球、擊球與守備相關數據視覺化。

正式網站：https://stats.cpbl.com.tw
主要語言：繁體中文（zh-TW）
時區：Asia/Taipei（UTC+8）

本網站資料可能隨賽事進行及官方資料更新而變動。查詢目前球季、近期比賽、球員表現或排行榜時，應以相關頁面最新顯示內容為準。

## 資料使用與引用原則

* 引用統計數據時，應保留球季、賽事類別、球員或球隊、篩選條件，以及資料查詢時間。
* 不同球季、賽事類別、球員類型或篩選條件產生的統計結果，不應直接視為相同資料集比較。
* 賽事類別包含一軍例行賽、一軍季後挑戰賽、一軍總冠軍賽、二軍例行賽、二軍總冠軍賽等；實際可用類別以各頁面提供的選項為準。
* 賽程與比分可能隨比賽進行更新。未開始、進行中、已結束、延賽或其他狀態應依賽事頁面的即時狀態判斷。
* 查詢「今天」、「目前」、「最新」、「本季」等時間敏感資訊時，應重新讀取相關頁面，不應依賴先前取得的快取資料。
* 部分進階數據與視覺化依賴 Trackman 或其他追蹤資料。缺少資料或顯示「-」代表該項資料不存在、不可用或樣本不足，不代表數值為 0。
* 不同指標可能有不同有效樣本數。位置、球種、進壘區域、擊球或投球相關分區的樣本數可能少於球員整體投球數、打席數或擊球事件數。
* PR 表示百分位排名（Percentile Rank），不是原始統計數值。實際定義、方向及有效樣本應以頁面標示為準。
* 球速、轉速、擊球初速、擊球仰角、擊球距離及其他指標的單位與定義，以網站頁面顯示內容為準。
* 網站包含互動式篩選器與視覺化，部分內容可能需要 JavaScript 才能完整呈現。
* 引用球員或單場比賽資料時，應優先使用網站實際提供的詳細頁網址，不要自行推測或建立球員 ID、賽事 ID。
* 球員詳細頁網址格式為 `/players/{id}`。
* 賽事詳細頁網址格式為 `/schedule/{id}`。
* `{id}` 僅表示網址結構，不是實際可查詢的識別碼。實際網址請由球員列表、賽程列表或 sitemap.xml 取得。

## 主要頁面

* [首頁](https://stats.cpbl.com.tw/): 網站總覽、近期賽事、近期球員表現及最新進階數據內容入口。
* [賽程](https://stats.cpbl.com.tw/schedule): 查詢比賽日期、賽事類別、球場、對戰球隊、比分與比賽狀態，並可進入單場賽事詳細頁查看相關資料。
* [所有球員](https://stats.cpbl.com.tw/players): 搜尋中華職棒球員並進入球員詳細頁，可依網站提供內容查看球員基本資料、進階指標、百分位排名及相關投打視覺化。
* [排行榜](https://stats.cpbl.com.tw/rankings): 比較中華職棒球員與球隊的進階數據，可依年度、賽事類型、球員類型、球隊、守備位置、球種、球場、月份及其他條件篩選。

## 進階數據

排行榜及球員頁可能包含以下類型的資料：

* 擊球彈道（Batted Ball Profile）
* 擊球初速（Exit Velocity）
* 擊球仰角（Launch Angle）
* 擊球事件數量（BBE）
* 投球球速（Pitch Velocity）
* 投球轉速（Pitch Spin）
* 揮空率（Whiff%）
* 追打率（Chase%）
* 三振率（K%）
* 保送率（BB%）
* 強擊球率（Hard-Hit%）
* 加權上壘率（wOBA）
* 百分位排名（PR / Percentile Rank）
* 擊球落點與方向
* 本壘板紀律與進壘區域
* 其他網站頁面提供的進階投打與守備資料

指標的實際名稱、定義、計算方式與可用範圍，以網站當前頁面內容為準。

## 指標說明與教學

* [進階數據新手入門](https://stats.cpbl.com.tw/news/1FICwK5WNh6BjTn5asaXeveYcblJ9NXJkhcZjE8CMf-w): 說明如何閱讀與使用中華職棒進階數據。
* [進階數據介紹](https://stats.cpbl.com.tw/news/1vrRUWdz8zWv6bWMz0xiazeJUJl8q1c2lxg_uAg122hc): 提供轉速、擊球初速、擊球仰角、擊球事件及其他進階棒球數據的名詞與定義。

## 網址索引

* [網站地圖](https://stats.cpbl.com.tw/sitemap.xml): XML 格式的公開網址索引，包含球員、賽程、文章及其他可公開存取頁面。尋找特定球員或賽事網址時，應優先使用此索引或網站內部連結。

## Optional

* [聯絡我們](https://stats.cpbl.com.tw/contact-us): 網站聯絡資訊。
* [隱私政策](https://stats.cpbl.com.tw/legal/privacy): 網站隱私政策。
* [robots.txt](https://stats.cpbl.com.tw/robots.txt): 自動化存取與搜尋引擎爬取規則。