nonebot-plugin-cs2radar 0.1.0__tar.gz

nonebot_plugin_cs2radar-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.venv/
+.env
+.env.*
+dist/
+build/

nonebot_plugin_cs2radar-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 luojisama
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nonebot_plugin_cs2radar-0.1.0/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: nonebot-plugin-cs2radar
+Version: 0.1.0
+Summary: NoneBot2 CS2 雷达插件，支持赛事/选手、5E、完美与官匹战绩查询及对局分析
+Project-URL: Homepage, https://github.com/luojisama/nonebot-plugin-cs2radar
+Project-URL: Repository, https://github.com/luojisama/nonebot-plugin-cs2radar
+Project-URL: Bug Tracker, https://github.com/luojisama/nonebot-plugin-cs2radar/issues
+Author-email: luojisama <2534316454@qq.com>
+License: MIT
+License-File: LICENSE
+Keywords: 5e,cs2,csgo,nonebot,nonebot2,onebot,perfectworld
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.23.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: nonebot-adapter-onebot>=2.2.0
+Requires-Dist: nonebot-plugin-htmlrender>=0.6.0
+Requires-Dist: nonebot-plugin-localstore>=0.6.0
+Requires-Dist: nonebot2>=2.2.0
+Requires-Dist: playwright>=1.30.0
+Requires-Dist: pydantic<3.0,>=1.10
+Description-Content-Type: text/markdown
+
+# nonebot-plugin-cs2radar
+
+NoneBot2 的 CS2 插件，提供职业选手查询、近期赛事/赛果、5E 战绩、完美平台战绩、官匹战绩、账号绑定与单局详细复盘。
+
+## 安装
+
+### 使用 nb-cli
+
+```bash
+nb plugin install nonebot-plugin-cs2radar
+```
+
+### 使用 pip
+
+```bash
+pip install nonebot-plugin-cs2radar
+```
+
+### 安装 Playwright 浏览器
+
+本插件依赖 `playwright` 渲染图片，请额外执行：
+
+```bash
+playwright install chromium
+```
+
+## 适配器
+
+- `OneBot V11`
+
+## 命令
+
+- `cs查询 <选手名>`: 查询职业选手资料卡
+- `cs赛事`: 查询近期赛事与比赛
+- `赛果`: 查询近几日赛果
+- `5e <ID/昵称>`: 查询 5E 战绩
+- `pwlogin <手机号> <验证码>`: 登录完美平台并保存本地会话
+- `pw <昵称/SteamID>`: 查询完美平台战绩
+- `bind <5e|pw> <玩家名>`: 绑定常用查询对象
+- `match [5e|pw|mm] [@群友] [局数]`: 查询最近第 N 把详细对局并生成复盘
+
+## 配置
+
+环境变量统一使用 `cs2radar_*` 前缀；旧的 `cs_pro_*` 前缀当前仍兼容一版，但会打印弃用警告。
+
+```env
+cs2radar_llm_enabled=true
+cs2radar_llm_api_type=openai
+cs2radar_llm_api_url=https://api.openai.com/v1
+cs2radar_llm_api_key=
+cs2radar_llm_model=gpt-4o-mini
+
+```
+
+说明：
+
+- LLM 配置为可选；未配置时仍可查询战绩，只是不生成 AI 复盘。
+- `pw` / `match pw` / `match mm` 依赖完美平台登录态，请先执行 `pwlogin`。
+
+## 数据存储与迁移
+
+插件默认把数据存储到 `nonebot-plugin-localstore` 的插件数据目录下，并会尝试自动迁移旧版本的以下文件：
+
+- `data/cs_pro/user_bindings.db`
+- `data/cs_pro/user_data.db`
+- `data/cs_pro/user_data.json`
+- `data/cs_pro/pw_session.json`
+
+## 常见问题
+
+### 1. 提示找不到浏览器或渲染失败
+
+请确认已经执行过：
+
+```bash
+playwright install chromium
+```
+
+### 2. `pw` 查询提示先登录
+
+这是正常行为。完美平台接口需要有效登录态，请先执行：
+
+```bash
+pwlogin <手机号> <验证码>
+```
+
+### 3. AI 复盘没有返回
+
+未配置 LLM Key、模型返回非 JSON、接口超时都会触发降级。此时插件仍会返回战绩图片，只是不附带 AI 结论。
+
+## License
+
+MIT
+
+## 发布
+
+推送语义化标签后会自动触发 GitHub Actions 发布到 PyPI，例如：
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+工作流优先使用仓库机密 `PYPI_API_TOKEN`；若未配置该机密，则回退为 PyPI Trusted Publishing。

nonebot_plugin_cs2radar-0.1.0/README.md

@@ -0,0 +1,104 @@
+# nonebot-plugin-cs2radar
+
+NoneBot2 的 CS2 插件，提供职业选手查询、近期赛事/赛果、5E 战绩、完美平台战绩、官匹战绩、账号绑定与单局详细复盘。
+
+## 安装
+
+### 使用 nb-cli
+
+```bash
+nb plugin install nonebot-plugin-cs2radar
+```
+
+### 使用 pip
+
+```bash
+pip install nonebot-plugin-cs2radar
+```
+
+### 安装 Playwright 浏览器
+
+本插件依赖 `playwright` 渲染图片，请额外执行：
+
+```bash
+playwright install chromium
+```
+
+## 适配器
+
+- `OneBot V11`
+
+## 命令
+
+- `cs查询 <选手名>`: 查询职业选手资料卡
+- `cs赛事`: 查询近期赛事与比赛
+- `赛果`: 查询近几日赛果
+- `5e <ID/昵称>`: 查询 5E 战绩
+- `pwlogin <手机号> <验证码>`: 登录完美平台并保存本地会话
+- `pw <昵称/SteamID>`: 查询完美平台战绩
+- `bind <5e|pw> <玩家名>`: 绑定常用查询对象
+- `match [5e|pw|mm] [@群友] [局数]`: 查询最近第 N 把详细对局并生成复盘
+
+## 配置
+
+环境变量统一使用 `cs2radar_*` 前缀；旧的 `cs_pro_*` 前缀当前仍兼容一版，但会打印弃用警告。
+
+```env
+cs2radar_llm_enabled=true
+cs2radar_llm_api_type=openai
+cs2radar_llm_api_url=https://api.openai.com/v1
+cs2radar_llm_api_key=
+cs2radar_llm_model=gpt-4o-mini
+
+```
+
+说明：
+
+- LLM 配置为可选；未配置时仍可查询战绩，只是不生成 AI 复盘。
+- `pw` / `match pw` / `match mm` 依赖完美平台登录态，请先执行 `pwlogin`。
+
+## 数据存储与迁移
+
+插件默认把数据存储到 `nonebot-plugin-localstore` 的插件数据目录下，并会尝试自动迁移旧版本的以下文件：
+
+- `data/cs_pro/user_bindings.db`
+- `data/cs_pro/user_data.db`
+- `data/cs_pro/user_data.json`
+- `data/cs_pro/pw_session.json`
+
+## 常见问题
+
+### 1. 提示找不到浏览器或渲染失败
+
+请确认已经执行过：
+
+```bash
+playwright install chromium
+```
+
+### 2. `pw` 查询提示先登录
+
+这是正常行为。完美平台接口需要有效登录态，请先执行：
+
+```bash
+pwlogin <手机号> <验证码>
+```
+
+### 3. AI 复盘没有返回
+
+未配置 LLM Key、模型返回非 JSON、接口超时都会触发降级。此时插件仍会返回战绩图片，只是不附带 AI 结论。
+
+## License
+
+MIT
+
+## 发布
+
+推送语义化标签后会自动触发 GitHub Actions 发布到 PyPI，例如：
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+工作流优先使用仓库机密 `PYPI_API_TOKEN`；若未配置该机密，则回退为 PyPI Trusted Publishing。