前言¶
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 源码与许可证，确保符合项目规范。
