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.4 · 2026-11-18

- 图片页脚改用 GitHub Logo。
- 单局战报顶部补充双方队伍摘要,对比和兵种构成改用比例横条展示。
- 图片默认使用浅色,可在设置中切换深色;保留已保存的主题选择。

## 0.1.3 · 2026-11-17

- 图片发送方式新增 Base64(默认)、本地文件(NapCat 直读)和图片链接(NapCat 下载);发送失败时记录 ERROR 并回复原文字战报,不自动切换方式。
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ ba stats @群友
- **数据源接入**:在线查询开关、API 地址,无需填写客户端标识或令牌。
- **查询与命令**:默认/最大近期场数(5 / 20)、用户冷却(3 秒)、中文子命令别名开关。
- **每日请求额度**:每用户默认 20 次、每群默认 100 次(可在 `0–100` 间调整,`0` 表示不单独限制);**全插件每日总上限固定为 100 次不可调整**。所有额度于北京时间每天 0 点重置,按上游 HTTP 请求计数,失败与重试也计入;命中缓存及本地命令不扣额。
- **战报显示**:图片战报开关(渲染或发送未成功时回复同内容文字)、深浅主题(默认深色)、显示时区(默认 `Asia/Shanghai`)。
- **战报显示**:图片默认浅色,可在「图片主题」中切换深色;支持图片战报开关(渲染或发送未成功时回复同内容文字)和显示时区(默认 `Asia/Shanghai`)。
- **维护与缓存**:请求间隔、并发、超时、重试及缓存容量/旧缓存回退时间,设置中心中默认折叠。
- **诊断日志**:诊断开关、日志状态和 ZIP 下载集中显示,内容默认折叠;总容量上限 30 MB,旧日志自动轮换。

Expand Down
10 changes: 5 additions & 5 deletions _conf_schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -97,14 +97,14 @@
"theme": {
"description": "图片主题",
"type": "string",
"default": "dark",
"default": "light",
"options": [
"dark",
"light"
"light",
"dark"
],
"labels": [
"深色",
"浅色"
"浅色",
"深色"
]
},
"timezone": {
Expand Down
10 changes: 10 additions & 0 deletions assets/github-mark-black.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 10 additions & 0 deletions assets/github-mark-white.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions docs/API_NOTES.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,9 +85,9 @@ SteamID64 与 STB ID 均保持字符串;**未找到可靠的 Steam→STB 映

`scoring.py` 使用 `assets/scoring-model.json`,移植 ba-dragon 固定提交的逐局评分逻辑与参数。近期战绩首列统一命名「评分」,按分数段着色,不显示称号。缺少必要数据时返回 `None` 并显示「暂无」,不补零。它与来源 ELO 分别展示,不是完整生涯评价,也不引入时间线或 Kalman 聚合算法。

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

所有战报图片页脚包含 `assets/github-avatar.png`、`timeance/astrbot_plugin_BA_stats` 与固定文字「数据来源 BATracer」。设置提示仍原样保留「数据来源 BATrace ,如有帮助请支持该平台」。
所有战报图片页脚内嵌 `assets/github-mark-black.svg` 或 `assets/github-mark-white.svg`,并包含 `timeance/astrbot_plugin_BA_stats` 与固定文字「数据来源 BATracer」。设置提示仍原样保留「数据来源 BATrace ,如有帮助请支持该平台」。

## 设置中心与诊断日志

Expand Down
2 changes: 1 addition & 1 deletion docs/THIRD_PARTY.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,6 @@

依赖由宿主环境安装,安装 ZIP 不附带第三方库;各依赖许可证以其发布包为准。预览工具使用本地 Playwright/Chromium,仅用于开发验收,运行插件不需要安装它们。

`assets/github-avatar.png` 用于图片页脚的 GitHub 作者标识,与 `timeance/astrbot_plugin_BA_stats` 及「数据来源 BATracer」一同显示;不属于 ba-dragon 评分模型素材。
`assets/github-mark-black.svg` 与 `assets/github-mark-white.svg` 来自 GitHub 官方 [Logo 素材包](https://brand.github.com/GitHub_Logos.zip),用于图片页脚的项目链接。按主题内嵌对应黑白版本,与 `timeance/astrbot_plugin_BA_stats` 及「数据来源 BATracer」一同显示。

`logo.png` 与 `assets/readme-logo.png` 原样来自用户交接包,交付时核对 SHA-256 一致。它们的授权与来源由交接提供方负责说明,本项目没有代替权利人作版权声明。
35 changes: 19 additions & 16 deletions docs/VALIDATION.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
# 验证记录

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

## 本次结果

| 项目 | 结果 |
| --- | --- |
| 完整离线测试 | **695 passed,33.35 秒** |
| 完整离线测试 | **723 passed,31.67 秒** |
| 评分与固定上游 TypeScript 对照 | **320 个合成样本一致**;中间值误差小于 1e-12 |
| 三类战报本地渲染 | 沿用 v0.1.2 的 18 组 HTML/文字、36 张 PNG;本轮未修改战报版式 |
| 设置中心本地交互 | 深色 390px、浅色 1100px 两组通过;4 张预览;新增发送方式保存检查 |
| 依赖兼容性 | `uv pip check`:30 个已安装包兼容 |
| 三类战报本地渲染 | 18 组 HTML/文字、36 张 PNG;无布局越界或外部请求 |
| 设置中心本地交互 | 深色 390px、浅色 1100px 两组通过;4 张预览;验证浅色默认值及已保存深色配置 |
| 依赖兼容性 | 依赖未变;沿用 v0.1.3 的 `uv pip check` 结果:30 个已安装包兼容 |
| 完整 AstrBot 服务、真实渲染服务 | 未启动;按 v4.29.4 固定源码核对 API,使用事件与桥接桩验证 |
| BATrace / QQ 实际联调 | 开发环境未调用;用户已提供候选结果和图片超时日志 |
| 远端 PR / CI | 以对应 PR 的实时结果为准;本记录不表示已合并或部署 |
Expand All @@ -24,8 +24,11 @@
- 「评分」移植固定 ba-dragon 模型的逐局 career 计算,按分数着色,不展示称号。保留 MIT 来源与完整许可。
- Oracle 包含原始 160 个样本,以及逐个删除 `StartTime` 的 160 个边界样本。开始/结束时间分别保留;不以结束时间减时长反推开始时间。近期列表按真实结束时间、缺少时按真实开始时间排序,两者都缺少才放最后。
- 赛前预测使用 A/B 队全部必要赛前 ELO;兵种构成按已收录单位基础价格估算。缺少成员单位数据或存在未知价格时,不把已识别部分重新归一化为完整构成。
- 单局图片按 900 CSS 像素渲染:顶部预测,中部左右对比/构成,底部玩家。其他卡片为 390 CSS 像素;运行仍使用 JPEG 85、ultra 像素比。
- 所有图片页脚为本地内嵌 GitHub 头像、`timeance/astrbot_plugin_BA_stats` 和「数据来源 BATracer」。不在运行时请求头像。
- 队伍摘要的赛前平均 ELO 使用传递到展示层的赛前值;本局 `NewRating` 标明为赛后平均 ELO,不将历史对局的赛后值称为当前值。
- 单局图片按 900 CSS 像素渲染:顶部预测及 A/B 队伍摘要,中部左侧兵种构成、右侧双方对比,底部玩家。其他卡片为 390 CSS 像素;运行仍使用 JPEG 85、ultra 像素比。
- 双方对比与逐兵种构成都共用左 A、右 B 的横条;兵种使用对应类别的同色系深浅色(A 深、B 浅)。构成数值保持双方各自占比,横条按这两个占比划分;缺失值与 0/0 不生成虚假的比例。
- 所有图片页脚为本地内嵌 GitHub Logo、`timeance/astrbot_plugin_BA_stats` 和「数据来源 BATracer」。深浅主题分别使用官方白色与黑色 Logo,不在运行时请求素材。
- 图片默认浅色;原生配置、独立设置中心和渲染器默认值一致,已保存的深色选择保持有效。图片缓存摘要包含完整 HTML,样式、主题和 Logo 变更会生成新缓存。

## 设置中心与诊断

Expand All @@ -35,7 +38,7 @@
- API 使用 AstrBot 登录鉴权,插件额外检查用户名。未登录、已关闭、无效 JSON、非法类型/范围、保存失败及旧实例卸载有回归测试。下载不通过公开静态目录。
- 诊断仅记录允许的事件与字段:请求耗时/状态、渲染及图片发送阶段、文件类型/大小、受控错误分类等。日志上限为 `30 * 1024 * 1024` 字节,旧段自动淘汰;关闭后可下载既有日志。
- 记录器覆盖轮换、并发导出、关闭、磁盘失败及脱敏;不记录令牌、请求头、完整响应、聊天正文或图片内容。导出为 ZIP,不清空原日志。
- 本地浏览器验证保存开关、下载路由、409 草稿保留、重新读取后保留草稿、待重载提示及固定总额度;新增验证 Base64 默认值,以及 file/url 保存后等待重载。合成桥接不替代真实宿主收发;常用设置全页预览将悬浮保存栏放到文档末尾,交互测试使用原样 CSS。
- 本地浏览器验证保存开关、下载路由、409 草稿保留、重新读取后保留草稿、待重载提示及固定总额度;验证 Base64 默认值,以及 file/url 保存后等待重载。本轮增加图片浅色默认值、切换主题和保留已保存深色的检查。合成桥接不替代真实宿主收发;常用设置全页预览将悬浮保存栏放到文档末尾,交互测试使用原样 CSS。

## 图片发送与损坏缓存

Expand All @@ -55,21 +58,21 @@ v0.1.3 共用图片下载与验证流程:检查 HTTP 状态,限制下载大
## 执行与证据

```powershell
& ../.venv/Scripts/python.exe -X utf8 -m pytest -q --basetemp=../tmp/pytest-v013-portable --junitxml=../validation/pytest-v0.1.3.xml
# 695 passed in 33.35s
& ../.venv/Scripts/python.exe -X utf8 -m pytest -q --basetemp=../tmp/pytest-v014-reviewed --junitxml=../validation/pytest-v0.1.4.xml
# 723 passed in 31.67s

& ../.venv/Scripts/python.exe -X utf8 -B tools/render_previews.py --screenshots
# v0.1.2 记录:18 HTML/text pairs; 36 screenshots; 0 layout/network failures
# 本轮未修改战报版式,沿用对应预览,未重复运行此命令。
& ../.venv/Scripts/python.exe -X utf8 -B tools/render_previews.py --screenshots --output ../tmp/report-visual-v014/previews
# 18 HTML/text pairs; 36 screenshots; 0 layout/network failures

& ../.venv/Scripts/python.exe -X utf8 -B tools/check_settings_view.py
# 2 local browser scenarios passed; 4 screenshots; no external requests

uv --cache-dir ../tmp/uv-cache pip check --python ../.venv/Scripts/python.exe
# All installed packages are compatible
# 依赖未变,沿用 v0.1.3:uv pip check,30 个已安装包兼容。
```

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

本轮战报预览保存在会话目录的 `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
4 changes: 2 additions & 2 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.3")
self.diagnostics.record("plugin_start", status="0.1.4")

async def _run(self, awaitable, *, timed=True):
if self._closed:
Expand Down Expand Up @@ -304,7 +304,7 @@ async def _status(self):
"schema": "响应结构变化", "identity_mismatch": "身份校验失败",
"no_data": "暂无收录", "upstream": "上游暂不可用", "queue_full": "队列已满",
"not_configured": "接入未配置", "closed": "客户端已关闭", "daily_quota": "每日额度已用完"}
return (f"断箭战报 v0.1.3\n在线查询:{'已启用' if status['configured'] else '未启用或 API 地址无效'}\n"
return (f"断箭战报 v0.1.4\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
2 changes: 1 addition & 1 deletion metadata.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ name: astrbot_plugin_ba_stats
display_name: 断箭战报
short_desc: "《断箭》战绩查询,支持逐局评分、赛前预测与图片战报。"
desc: "查询《断箭》(Broken Arrow)玩家概览、近期战绩和单局战报,展示逐局评分、赛前预测、双方对比与兵种构成,支持账号绑定、群友查询及图片或文字展示。在设置中心或原生插件配置中开启在线查询后使用。"
version: "0.1.3"
version: "0.1.4"
author: timeance
repo: https://github.com/timeance/astrbot_plugin_BA_stats
astrbot_version: ">=4.29.4"
Expand Down
Loading
Loading