前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在構建涉及體育數據分析的智能體時，接入穩定的數據源是核心需求。xby-nba-stats 是一個提供實時和歷史 NBA 數據的模型上下文協議服務器，涵蓋球員統計、比賽得分、球隊信息和高級分析。
功能概覽¶
該插件通過 MCP (Model Context Protocol) 協議向智能體提供數據接口，主要包括以下功能：
- 基礎數據查詢：
get_todays_scoreboard：獲取今日比賽比分板。get_scoreboard_by_date：獲取指定日期的比賽比分板。get_game_details：獲取特定比賽 ID 的詳細信息。get_box_score：獲取特定比賽 ID 的完整技術統計。get_schedule：獲取球隊賽程。
- 搜索與解析：
resolve_team_id：解析球隊名稱/城市/簡稱對應的 team_id。resolve_player_id：解析球員姓名對應的 player_id。find_game_id：根據日期和對陣情況查找 game_id，不填日期則查找最近一場。search_players：通過姓名子字符串搜索球員。
- 球員統計：
get_player_info：獲取球員基本信息。get_player_season_stats：獲取球員賽季數據。get_player_game_log：獲取球員賽季比賽日誌。get_player_career_stats：獲取球員職業生涯總數據。get_player_hustle_stats：獲取球員 hustle 數據。get_player_defense_stats：獲取球員防守數據。get_player_advanced_stats：獲取球員高級數據。get_player_awards：獲取球員獎項。
- 聯盟與球隊：
get_all_teams：獲取所有球隊信息。get_team_roster：獲取球隊陣容。get_standings：獲取聯盟排名。get_league_leaders：獲取聯盟得分/助攻等數據領跑者。get_all_time_leaders：獲取歷史數據領跑者。get_season_awards：獲取賽季獎項。
- 高級分析：
get_shot_chart：獲取投籃熱圖數據摘要。get_shooting_splits：獲取投籃分割數據摘要。get_play_by_play：獲取比賽逐回合數據。get_game_rotation：獲取比賽輪換數據。get_team_advanced_stats：獲取球隊高級數據。
- 工具類：
set_xby_apikey：設置 API 密鑰（自動持久化）。get_server_info：獲取服務器版本及運行時設置。
安裝與啓用¶
使用官方命令安裝該插件：
dsh plugin --profile web add github:xby_skill/xby-nba-stats
安裝後，插件將以當前 DSH 進程的權限運行，重啓進程後配置會自動生效。
配置與前置條件¶
使用該插件前，需要完成以下配置：
- 獲取 API 密鑰：前往 小笨羊官網 註冊並獲取 API 密鑰。
- 設置密鑰：在對話中使用
set_xby_apikey命令設置密鑰。
典型用法¶
以下是該插件在智能體開發中的典型使用場景：
- 查詢今日比分：
直接調用get_todays_scoreboard獲取當前 NBA 賽程的比分情況。 - 解析球員 ID：
使用resolve_player_id將用戶輸入的“勒布朗·詹姆斯”轉換爲 API 需要的 ID，進而查詢詳細數據。 - 獲取球隊陣容：
使用get_team_roster獲取特定球隊的當前大名單。 - 查詢賽季排名：
使用get_standings獲取東部或西部聯盟的實時排名。 - 高級數據分析：
調用get_player_advanced_stats或get_shot_chart獲取球員的 PER（效率值）或投籃分佈數據。
注意事項¶
- 該插件屬於聯網工具類別，依賴外部數據源。
- 許可證爲 MIT，開源協議允許自由使用和修改。
- 安裝前建議檢查 GitHub 源碼與許可證，確保符合項目規範。
