<<<<<<< HEAD # AstrBOT 守望先锋国际服查询插件 作者其实是个小白来的，部分由ai创建 # 注意,部分使用steam启动的玩家无法被查询 🎮 **守望先锋·归来国际服查询插件** [](https://github.com/TZYCeng/astrbot_plugin_owcx) [](https://www.python.org/) [](https://github.com/AstrBotDevs/AstrBot) [](https://opensource.org/licenses/MIT) ## 📦 安装方法 ### 方法一：通过AstrBot插件市场 1. 打开AstrBot WebUI 2. 进入插件管理 3. 搜索 "astrbot_plugin_owcx" 4. 点击安装 ### 方法二：手动安装 1. 下载插件文件到AstrBot的插件目录 ```bash cd AstrBot/data/plugins git clone https://github.com/TZYCeng/astrbot_plugin_owcx.git ``` 2. 安装依赖 ```bash pip install -r requirements.txt ``` 3. 重启AstrBot ## 使用方法 ### owsummary 查询玩家摘要信息（头像、竞技段位等）。 用法: /owsummary [玩家ID] 示例: /owsummary TeKrop#2217 或 /owsummary 同志有程#3156 说明: 玩家ID支持直接输入 #，插件会自动处理；省略 ID 则查询绑定的账号（使用绑定平台） ### owstats 查询玩家统计概览（胜率、KDA等）。 用法: /owstats [玩家ID] [游戏模式] 游戏模式: 快速、竞技（默认） 示例: /owstats TeKrop#2217 竞技 说明: 省略 ID 则查询绑定的账号 ### owcareer 查询玩家生涯统计（按英雄详细数据）。 用法: /owcareer [玩家ID] <游戏模式> [英雄名] 游戏模式: 快速、竞技 英雄名: 可选，支持中文（如 源氏、安娜）或英文（如 genji, ana） 示例: /owcareer TeKrop#2217 竞技 /owcareer TeKrop#2217 竞技 源氏 /owcareer 竞技 源氏 (已绑定ID后) ### owhero 查询英雄详细信息（含该英雄在当前配置地区/平台/模式下的全服胜率与选取率）。 用法: /owhero <英雄名> 英雄名支持中文（如 源氏、安娜）或英文（如 genji, ana） 示例: /owhero 源氏, /owhero ana ### owherostats 查询全服英雄胜率/选取率排行榜（按地区服务器统计，展示全部英雄）。 用法: /owherostats [角色] [地区] 角色: 坦克、输出、支援（可选） 地区: 亚服(asia)、美服(americas)、欧服(europe)，不填则使用配置中的默认地区 平台与游戏模式使用配置文件中的默认值 示例: /owherostats /owherostats 输出 /owherostats 支援 欧服 ### owbind 绑定 Overwatch ID 到当前 QQ 号，可选择平台（PC端/主机端），每个 QQ 号可绑定多个账号（数量上限见配置 max_binds_per_user，默认 3 个），新绑定的账号自动成为默认查询账号。 用法: /owbind <玩家ID> [平台] 平台: pc(电脑端)、console(主机端)，不填则使用配置中的默认平台 示例: /owbind TeKrop#2217 或 /owbind TeKrop#2217 主机 说明: 旧版本绑定数据自动迁移，无需手动处理 ### owunbind 解绑当前 QQ 号绑定的 Overwatch ID。 用法: /owunbind [玩家ID] 说明: 不填玩家ID时解绑当前默认查询账号；解绑默认账号后自动切换到剩余账号 ### owbinds 查看当前 QQ 号绑定的所有 Overwatch 账号（含平台与默认标记）。 用法: /owbinds ### owdefault 设置默认查询的 Overwatch 账号，快捷指令省略 ID 时将查询该账号。 用法: /owdefault <玩家ID> 示例: /owdefault TeKrop#2217 ### owme 快捷查询默认绑定账号的摘要信息。 用法: /owme 说明: 需要先使用 /owbind 绑定，多账号时查询 /owdefault 设置的账号 ## ⚙️ 配置说明 在 AstrBot WebUI 的插件配置中可设置以下选项： - **默认查询的游戏模式**: 竞技比赛 / 快速游戏 - **默认查询的平台**: pc / console（未绑定平台或绑定时未选择平台时使用） - **默认查询的地区服务器** (`default_region`): asia(亚服) / americas(美服) / europe(欧服)，用于 /owherostats 等按地区统计的查询 - **每QQ号绑定上限** (`max_binds_per_user`): 每个 QQ 号最多可绑定的 Overwatch 账号数量，默认 3 - **图片渲染开关** (`enable_image_render`): 开启后（默认开启），/owsummary、/owstats、/owcareer、/owme、/owherostats 的查询结果会渲染为卡片图片；渲染失败自动回退文字；临时图片每小时自动清理，Docker 内如无中文字体请关闭或挂载 `fonts/font.ttf` - **报错展示开关** (`show_api_error`): 开启后，查询出错时机器人会把 API 返回的具体报错（含建议重试等待时间）回复给查询者；无论开关与否，完整报错与堆栈都会记录在控制台 debug 日志中 - **API 服务地址** (`api_base_url`): OverFast API 地址，默认官方 `https://overfast-api.tekrop.fr`；自建服务（如 Docker 部署开源 OverFast）填入自建地址即可，非法值自动回退官方 - 图片渲染依赖 Pillow：`pip install Pillow>=9.0.0`（已在 requirements.txt 中） - 如系统缺少中文字体导致渲染文字异常，可在插件目录下新建 `fonts` 文件夹并放入任意中文字体文件（命名为 `font.ttf` 或 `font.ttc`） ## 📕 更新日志 版本更新记录已迁移至 [CHANGELOG.md](CHANGELOG.md)。 ======= # overwatch_bot an agent to fetch and analysis overwatch datastics >>>>>>> 558bcd8abb48f869ac425cbb85e248b450ddc36e