Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# 更新日志

## 0.1.5 · 2026-11-18

- 玩家概览与近期战绩图片加宽,排版更紧凑,表格数字不再拆行。
- 玩家概览新增综合评分、称号和五维雷达图,分别展示胜负预期与实际胜率。
- 近期风格改用中文兵种标签,精简指标说明。

## 0.1.4 · 2026-11-18

- 图片页脚改用 GitHub Logo。
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

AstrBot 原生《断箭》(Broken Arrow)战绩查询插件。以简洁排版展示玩家概览、近期战绩与单局核心数据,支持图片战报和默认账号绑定,不依赖大模型。

近期战绩提供彩色评分;单局战报包含赛前预测、双方对比、兵种构成和玩家数据。
用 `ba me` 查看综合评分、称号和五维雷达图。图中的「胜负预期」衡量近期战果相对赛前预期的表现;「实际胜率」是近期已知胜负对局中获胜的比例。`ba recent` 查看逐局评分,`ba last` 查看最近一局的赛前预测、双方对比和玩家数据。

> 数据来源 [BATrace](https://dash.batrace.top/),如有帮助请支持该平台。更新内容见 [更新日志](CHANGELOG.md)。

Expand Down Expand Up @@ -89,7 +89,7 @@ ba stats @群友

- 运行要求:AstrBot **4.29.4 及以上**,QQ(OneBot v11);详细测试与验证记录见 [验证记录](docs/VALIDATION.md)。
- 开源协议:项目采用 **Apache-2.0**;`scoring.py` 的 ba-dragon 移植部分及 `assets/scoring-model.json` 保留上游 **MIT** 许可,完整文本见 [ba-dragon 许可](docs/BA_DRAGON_LICENSE.txt)。
- 致谢与参考:[BATrace](https://dash.batrace.top/)(战绩数据源)、[AlexanderHYu/ba-dragon](https://github.com/AlexanderHYu/ba-dragon)(逐局评分模型及接口参考)、[benx1n/wows-stats-bot](https://github.com/benx1n/wows-stats-bot)、[timeance/astrbot_plugin_openai_native](https://github.com/timeance/astrbot_plugin_openai_native)、AstrBot(详见 [第三方说明](docs/THIRD_PARTY.md))。
- 致谢与参考:[BATrace](https://dash.batrace.top/)(战绩数据源)、[AlexanderHYu/ba-dragon](https://github.com/AlexanderHYu/ba-dragon)(评分模型及接口参考)、[benx1n/wows-stats-bot](https://github.com/benx1n/wows-stats-bot)、[timeance/astrbot_plugin_openai_native](https://github.com/timeance/astrbot_plugin_openai_native)、AstrBot(详见 [第三方说明](docs/THIRD_PARTY.md))。

```sh
python -m pip install -r requirements-dev.txt
Expand Down
2 changes: 1 addition & 1 deletion assets/scoring-model.json

Large diffs are not rendered by default.

8 changes: 6 additions & 2 deletions docs/API_NOTES.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,11 @@ SteamID64 与 STB ID 均保持字符串;**未找到可靠的 Steam→STB 映

## 评分、预测与战报展示

`scoring.py` 使用 `assets/scoring-model.json`,移植 ba-dragon 固定提交的逐局评分逻辑与参数。近期战绩首列统一命名「评分」,按分数段着色,不显示称号。缺少必要数据时返回 `None` 并显示「暂无」,不补零。它与来源 ELO 分别展示,不是完整生涯评价,也不引入时间线或 Kalman 聚合算法。
`scoring.py` 使用 `assets/scoring-model.json`,移植 ba-dragon 固定提交的 `computeDragonScore`。近期战绩使用逐局分,不显示称号;玩家概览接收按时间从新到旧排列的对局,先跳过无效局,再取最多 20 场,将逐局标准分从旧到新输入 Kalman 滤波器,短局权重较低。再查 `playerPct` 得到 1–10 综合分,按显示分数及 `tiers` 给出称号;它不是单局显示分的平均值。1 场有效对局也可评分,`sample_size` 保留实际场数;0 场时综合分、称号和前四维均为 `None`。

五个雷达值均为 0–100。分值 K/D、摧毁贡献、占点贡献分别表示相对同条件玩家的表现百分位;占点不计入综合分。「胜负预期」是逐局 `phi((S-E)/outSd)` 的平均表现:`S` 采用上游模型内部的排位 ELO 涨跌,`E` 由双方赛前 ELO 和其他挂机者修正得出。前四项均按可用分项取平均后四舍五入为百分制整数。与上游缺失值回退不同,插件在缺少本人或在线队友占点时跳过该局的占点轴,缺少任何参战者所需的 ELO 或摧毁/损失价值时跳过整局。已归一化的真实零仍参与计算。

第五维 `win_rate` 由服务层传入,仅统计近期样本中目标玩家有明确布尔 `won` 的对局。没有已知赛果时为 `None`,已知赛果全部为负时为 `0`;即使没有有效评分局,也可独立提供该轴。两种胜负指标不互相填补,评分本身不触发网络请求。

`ba last` 的单局图片顶部展示基于双方赛前 ELO 的赛前预测及双队摘要;中部左侧兵种构成、右侧双方对比;底部展示队伍玩家数据。摘要区分赛前平均 ELO(`OldRating`)与赛后平均 ELO(`NewRating`)。预测是模型估算,不表示实际赛果。兵种构成按模型的单位角色与基础价格估算出动花费,缺少单位价格或记录时保留不完整说明,不冒充实际结算。

Expand Down Expand Up @@ -194,4 +198,4 @@ AstrBot 适配器从事件的 `get_platform_id()/get_sender_id()/get_group_id()`

该提交的 ba-dragon 主源码为 MIT,LICENSE 载明 AlexanderHYu 与沿用部分的 Zola 版权;其 README 另外说明可选录像使用 GPL FFmpeg。
Python 请求调度、数据模型和业务适配由本插件实现;`scoring.py` 的移植部分与 `assets/scoring-model.json` 使用 ba-dragon 的 MIT 评分逻辑和模型参数,并保留其来源与版权。未引入录像工具或 FFmpeg。
完整上游许可原样保留于 [BA_DRAGON_LICENSE.txt](BA_DRAGON_LICENSE.txt),安装、源码与 Gemini 包均随附。本仓库根 `LICENSE` 继续为 Apache-2.0;具体第三方来源与移植范围见 [THIRD_PARTY.md](THIRD_PARTY.md)。
完整上游许可原样保留于 [BA_DRAGON_LICENSE.txt](BA_DRAGON_LICENSE.txt) 和模型的 `source.licenseText`。本仓库根 `LICENSE` 继续为 Apache-2.0;分发时的许可保留要求、具体来源与移植范围见 [THIRD_PARTY.md](THIRD_PARTY.md)。
8 changes: 4 additions & 4 deletions docs/THIRD_PARTY.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
| --- | --- | --- |
| [AstrBot](https://github.com/astrbotdevs/astrbot) | 原生插件 API、ZIP 格式与配置 Schema 核对 | v4.29.4,`61335414433db721b3f7ecc93f90deafe0a59d78` |
| [AstrBot T2I](https://github.com/AstrBotDevs/astrbot-t2i-service) | 核对 `viewport_width`、像素比及 JPEG 质量参数 | `bcc08e47274c69e5ace19bbf738b95260ce17ca7` |
| [ba-dragon](https://github.com/AlexanderHYu/ba-dragon) | BATrace 接口参考;逐局评分、赛前 ELO 预测及兵种构成估算的 MIT 移植 | `072dc9bc2d73ffc87000c1d3db4c0f9b4dcab549`,详见下文及 API_NOTES.md |
| [ba-dragon](https://github.com/AlexanderHYu/ba-dragon) | BATrace 接口参考;逐局评分、玩家综合评分、赛前 ELO 预测及兵种构成估算的 MIT 移植 | `072dc9bc2d73ffc87000c1d3db4c0f9b4dcab549`,详见下文及 API_NOTES.md |
| [wows-stats-bot](https://github.com/benx1n/wows-stats-bot) | README 中绑定与 @ 查询的交互研究,未移植 HoshinoBot 实现 | master,`80c86970685887578054e61e1a76d1589ea1dc31` |
| [BATrace](https://dash.batrace.top/) | 预期战绩数据来源 | 自身接入许可、配额及真实字段待确认 |
| [astrbot_plugin_openai_native](https://github.com/timeance/astrbot_plugin_openai_native) | 参考用户跨群累计、群共享额度、配置提示与额度查询;按本任务要求统一私聊用户计数和北京时间日界 | main,`98bd76784bb2a35df0aea968138f87fd4d9ee207`;核对 README、配置 Schema、事件身份提取 |
Expand All @@ -15,11 +15,11 @@

## ba-dragon 评分与模型

`scoring.py` 将固定提交中的 `src/shared/dragon/score.ts`、`roles.ts`、`model.ts` 相关逻辑移植为 Python;`assets/scoring-model.json` 使用同一提交的 `src/shared/dragon/model.json` 参数,以及评分和兵种构成所需的单位角色与基础价格信息。模型内的 `source` 记录仓库、提交、来源文件和 MIT 文本。
`scoring.py` 将固定提交中的 `src/shared/dragon/score.ts`、`roles.ts`、`model.ts` 相关逻辑移植为 Python;`assets/scoring-model.json` 从同一提交的 `src/shared/dragon/model.json` 提取评分参数,单位表仅保留角色和基础价格。模型内的 `source` 记录仓库、提交、来源文件和完整 MIT 文本。

移植范围是逐局评分、基于赛前 ELO 的预测及按基础花费估算的兵种构成。展示统一称「评分」,按分数着色;不包含称号、时间线或 Kalman 生涯聚合。模型结果是估算,不代表官方评价。
玩家概览使用 `computeDragonScore` 的 Kalman 聚合、玩家分位表、分档和四个表现分项;分档称号取自 `src/renderer/src/features/players/PlayerDetail.tsx`。第五项「实际胜率」由插件服务根据明确的 `won` 计算并传入评分模块。近期战绩保持逐局评分。未移植单局奖项、时间线或实力 ELO;这些模型分数不代表官方评价。

完整上游版权与 MIT 许可原样保留于 [BA_DRAGON_LICENSE.txt](BA_DRAGON_LICENSE.txt),包括 `Copyright (c) 2026 AlexanderHYu` 及 `Copyright (c) 2025-2026 Zola (Zawinzala)` 与原文件的沿用部分说明。安装包、源码包及 Gemini 文案包均保留该文本;文案润色不修改许可证。
[BA_DRAGON_LICENSE.txt](BA_DRAGON_LICENSE.txt) 和模型的 `source.licenseText` 均原样保留固定提交的 `LICENSE`,包括 `Copyright (c) 2026 AlexanderHYu` 及 `Copyright (c) 2025-2026 Zola (Zawinzala)` 与原文件的沿用部分说明。分发这些移植代码或模型时,安装包、源码和 Gemini 文案包均应保留完整上游版权及 MIT 许可;文案润色不修改该文本。

未移植参考项目的录像工具或 FFmpeg。其 README 提到的可选 GPL FFmpeg 不随本插件分发。

Expand Down
30 changes: 20 additions & 10 deletions docs/VALIDATION.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
# 验证记录

验证日期:2026-11-18(Asia/Hong_Kong)。版本:v0.1.4。
验证日期:2026-11-18(Asia/Hong_Kong)。版本:v0.1.5。

## 本次结果

| 项目 | 结果 |
| --- | --- |
| 完整离线测试 | **723 passed,31.67 秒** |
| 评分与固定上游 TypeScript 对照 | **320 个合成样本一致**;中间值误差小于 1e-12 |
| 三类战报本地渲染 | 18 组 HTML/文字、36 张 PNG;无布局越界或外部请求 |
| 设置中心本地交互 | 深色 390px、浅色 1100px 两组通过;4 张预览;验证浅色默认值及已保存深色配置 |
| 完整离线测试 | **740 项通过** |
| 综合评分与固定上游 TypeScript 对照 | **483 组合成输入通过**,涵盖单局、多局、时间缺失、零场与真实零值 |
| 三类战报本地渲染 | 深浅色、长名称和缺失样本共 36 张截图通过布局检查,另生成 12 张按 390px 聊天气泡等比缩放的概览与近期战绩预览 |
| 设置中心本地交互 | 设置页面未变;沿用 v0.1.4 的两组浏览器验证,覆盖浅色默认值及已保存深色配置 |
| 依赖兼容性 | 依赖未变;沿用 v0.1.3 的 `uv pip check` 结果:30 个已安装包兼容 |
| 完整 AstrBot 服务、真实渲染服务 | 未启动;按 v4.29.4 固定源码核对 API,使用事件与桥接桩验证 |
| BATrace / QQ 实际联调 | 开发环境未调用;用户已提供候选结果和图片超时日志 |
Expand All @@ -21,11 +21,12 @@
- 分值 K/D 使用摧毁分与损失分;击杀/阵亡是单位数量,伤害/承伤是另一组数据。出兵花费、补给消耗保留有效小数,不被整数格式误判为缺失。
- 分析接口只以明确布尔 `won` 及相同对局 ID 提供目标玩家胜负;不将 ELO 涨跌当成展示的权威胜负。单局页保留已知目标胜负。
- 分析样本与近期样本分别标明;重复和相互矛盾的分析结果不重复计入分母。地图、单位按来源 ID 关联。
- 「评分」移植固定 ba-dragon 模型的逐局 career 计算,按分数着色,不展示称号。保留 MIT 来源与完整许可。
- Oracle 包含原始 160 个样本,以及逐个删除 `StartTime` 的 160 个边界样本。开始/结束时间分别保留;不以结束时间减时长反推开始时间。近期列表按真实结束时间、缺少时按真实开始时间排序,两者都缺少才放最后。
- 近期「评分」移植固定 ba-dragon 模型的逐局 career 计算,按分数着色,不展示称号;玩家概览展示综合评分和称号。保留 MIT 来源与完整许可。
- 端到端样例对照:同一场的逐局分为 9.3,玩家综合分为 7.9(有龙样)。雷达的分值 K/D、摧毁贡献、占点贡献、胜负预期分别为 91、53、53、92;该玩家实际一战一胜,所以第五轴是 100%。无胜负记录时,第五轴留空。
- 上游对照包含 160 组单局、160 组缺少开始时间、160 组多局和 3 组边界输入。近期列表按真实结束时间、缺少时按真实开始时间排序,不反推开始时间。
- 赛前预测使用 A/B 队全部必要赛前 ELO;兵种构成按已收录单位基础价格估算。缺少成员单位数据或存在未知价格时,不把已识别部分重新归一化为完整构成。
- 队伍摘要的赛前平均 ELO 使用传递到展示层的赛前值;本局 `NewRating` 标明为赛后平均 ELO,不将历史对局的赛后值称为当前值。
- 单局图片按 900 CSS 像素渲染:顶部预测及 A/B 队伍摘要,中部左侧兵种构成、右侧双方对比,底部玩家。其他卡片为 390 CSS 像素;运行仍使用 JPEG 85、ultra 像素比。
- 玩家概览、近期战绩、单局战报分别使用 640、800、900 CSS 像素。单局保持顶部预测及 A/B 队伍摘要、中部左侧兵种构成与右侧双方对比、底部玩家的布局;运行仍使用 JPEG 85、ultra 像素比。
- 双方对比与逐兵种构成都共用左 A、右 B 的横条;兵种使用对应类别的同色系深浅色(A 深、B 浅)。构成数值保持双方各自占比,横条按这两个占比划分;缺失值与 0/0 不生成虚假的比例。
- 所有图片页脚为本地内嵌 GitHub Logo、`timeance/astrbot_plugin_BA_stats` 和「数据来源 BATracer」。深浅主题分别使用官方白色与黑色 Logo,不在运行时请求素材。
- 图片默认浅色;原生配置、独立设置中心和渲染器默认值一致,已保存的深色选择保持有效。图片缓存摘要包含完整 HTML,样式、主题和 Logo 变更会生成新缓存。
Expand Down Expand Up @@ -55,7 +56,16 @@ v0.1.3 共用图片下载与验证流程:检查 HTTP 状态,限制下载大

这些结果证明离线流程与坏缓存处理通过测试,**不代表已完成真实 QQ 收发验收**。仍需在用户实例安装后验证;不能将旧日志中的所有 QQ 超时都归因为相同原因。

## 执行与证据
## v0.1.5 验证方式

```powershell
& ../.venv/Scripts/python.exe -X utf8 -m pytest -q
& ../.venv/Scripts/python.exe -X utf8 -B tools/render_previews.py --screenshots --output ../tmp/overview-v015/previews
```

另用 20 场合成对局走通解析、服务和两种宽度的玩家概览渲染:胜负预期 83、实际胜率 65%。已查看 640px 和 390px 截图;伤害值 `11,682.87` 均在同一行,长单位名能换行。

## 历史验证:v0.1.4

```powershell
& ../.venv/Scripts/python.exe -X utf8 -m pytest -q --basetemp=../tmp/pytest-v014-reviewed --junitxml=../validation/pytest-v0.1.4.xml
Expand All @@ -72,7 +82,7 @@ v0.1.3 共用图片下载与验证流程:检查 HTTP 状态,限制下载大

主代理目视检查了单局深浅两色宽图、单局缺失数据手机卡、近期浅色手机卡、玩家概览深色手机卡和常用设置浅色桌面页。卡片矩阵含正常、长昵称、缺失数据三组,深浅两色,900/390px;预览均标明合成样本。浏览器拦截外部请求,只使用本地生成内容,没有使用外部账号或登录态。

本轮战报预览保存在会话目录的 `tmp/report-visual-v014/previews/`;设置中心预览位于 `previews/settings-*.png`。本地预览不随插件发布。
v0.1.4 战报预览保存在会话目录的 `tmp/report-visual-v014/previews/`;设置中心预览位于 `previews/settings-*.png`。本地预览不随插件发布。

会话目录:`H:/Codex/01a1e923-f766-7562-b804-35854a994fc4`。Python 3.11.4;Playwright 1.65.2,本地 Chromium 159.0.8154.6。主测试使用 httpx.MockTransport、临时 SQLite 和 AstrBot 桩;没有访问真实战绩、QQ 账号、数据库或运行配置。

Expand Down
13 changes: 9 additions & 4 deletions main.py
Original file line number Diff line number Diff line change
Expand Up @@ -155,7 +155,7 @@ async def initialize(self):
await self.storage.open()
self._images.mkdir(parents=True, exist_ok=True)
self._prune_images()
self.diagnostics.record("plugin_start", status="0.1.4")
self.diagnostics.record("plugin_start", status="0.1.5")

async def _run(self, awaitable, *, timed=True):
if self._closed:
Expand Down Expand Up @@ -227,8 +227,13 @@ async def _prepare_image(self, view, umo, mode, progress):
progress["stage"] = "generate"
source = await self.html_render(
"{{ body | safe }}", {"body": html}, return_url=True,
options={"type": "jpeg", "quality": 85, "full_page": True,
"viewport_width": 900 if view.get("kind") == "match" else 390, "device_scale_factor_level": "ultra"}, umo=umo)
options={
"type": "jpeg", "quality": 85, "full_page": True,
"viewport_width": Renderer.WIDTHS[view.get("kind", "overview")],
"device_scale_factor_level": "ultra",
},
umo=umo,
)
url = source if is_image_url(source) else None
content_type = ""
if url:
Expand Down Expand Up @@ -304,7 +309,7 @@ async def _status(self):
"schema": "响应结构变化", "identity_mismatch": "身份校验失败",
"no_data": "暂无收录", "upstream": "上游暂不可用", "queue_full": "队列已满",
"not_configured": "接入未配置", "closed": "客户端已关闭", "daily_quota": "每日额度已用完"}
return (f"断箭战报 v0.1.4\n在线查询:{'已启用' if status['configured'] else '未启用或 API 地址无效'}\n"
return (f"断箭战报 v0.1.5\n在线查询:{'已启用' if status['configured'] else '未启用或 API 地址无效'}\n"
f"今日总请求:{usage['global']}/{GLOBAL_DAILY_LIMIT}(固定上限);北京时间 0 点重置\n"
f"本次运行请求:{status['requests']};进行中:{status['inflight']}\n"
f"API 缓存:{await self.storage.cache_count()} 条;命中:{status['cache_hits']};旧缓存:{status['stale_hits']}\n"
Expand Down
6 changes: 3 additions & 3 deletions metadata.yaml
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
name: astrbot_plugin_ba_stats
display_name: 断箭战报
short_desc: "《断箭》战绩查询,支持逐局评分、赛前预测与图片战报。"
desc: "查询《断箭》(Broken Arrow)玩家概览、近期战绩和单局战报,展示逐局评分、赛前预测、双方对比与兵种构成,支持账号绑定、群友查询及图片或文字展示。在设置中心或原生插件配置中开启在线查询后使用。"
version: "0.1.4"
short_desc: "《断箭》战绩查询,支持玩家评分、五维雷达图与图片战报。"
desc: "查询《断箭》(Broken Arrow)玩家概览、近期战绩和单局战报,展示玩家评分、五维雷达图、逐局评分、赛前预测与双方对比,支持账号绑定、群友查询及图片或文字展示。在设置中心或原生插件配置中开启在线查询后使用。"
version: "0.1.5"
author: timeance
repo: https://github.com/timeance/astrbot_plugin_BA_stats
astrbot_version: ">=4.29.4"
Expand Down
Loading
Loading