守望先锋数据查询插件。你可以通过此插件查询：
玩家资料、最近战绩、单场对局详情、同玩查询、段位历史、快速强度/竞技强度、今日/昨日/本周总结、英雄热度榜单/单英雄历史曲线、英雄威能、英雄维基、商店、补丁说明
此插件由 https://github.com/AddOneSecondL/Overstats 移植而来（感谢原作者开源），已能正常使用，但由于工程量大，目前可能仍存在一些 bug。欢迎专业人士在使用中提交代码 PR 进行改进，精准重现原项目的数据返回体验。此插件现阶段着力于对原项目的功能进行完整移植，在插件 bug 完全修复、移植圆满完成之前，暂时谢绝超出原项目的个性化定制。
在 AstrBot WebUI 中安装并启用插件。
这个插件必须先配置网易大神凭据，否则大部分玩家查询命令无法使用。
你至少需要准备：
- 一个已绑定守望先锋战网账号的网易大神账号
- 该账号对应的
role_id - 该账号对应的
token
role_id 和 token 的获取步骤如下。
- 登录网易大神官网：
https://ds.163.com - 打开守望先锋相关页面或 充值中心 ，确认已经绑定好战网账号
- 按
F12打开浏览器开发者工具 - 切到
Network标签页 - 按
Ctrl+F5强制刷新页面 - 搜索
role_id - 复制属于你账号的数字值
在网易大神官网按 F12 打开浏览器控制台，然后粘贴运行下面这段脚本。
把代码里的 YOUR_ROLE_ID 替换成你上一步拿到的 role_id。
(async () => {
const url = "https://inf.ds.163.com/v1/web/game/report/getReportToken";
const payload = {
appKey: "bn",
roleId: "YOUR_ROLE_ID",
server: "1",
source: 1,
type: "yearly",
};
function getCookie(name) {
return (
document.cookie
.split("; ")
.find((row) => row.startsWith(name + "="))
?.split("=")
.slice(1)
.join("=") || ""
);
}
const body = JSON.stringify(payload);
const sigMod = await window.sig.default();
const signRaw = sigMod.gen_sign(body);
const signObj = JSON.parse(signRaw);
const xsrf = getCookie("GL-XSRF-TOKEN");
const uid = getCookie("GOD_UUID");
const deviceId =
localStorage.getItem("ns-client-id") ||
localStorage.getItem("ds-website-uuid") ||
"";
console.log("body =", body);
console.log("GL-CheckSum =", signObj.sign);
console.log("GL-Nonce =", signObj.timestamp);
console.log("GL-X-XSRF-TOKEN =", xsrf);
console.log("GL-Uid =", uid);
console.log("GL-DeviceId =", deviceId);
const resp = await fetch(url, {
method: "POST",
credentials: "include",
headers: {
"Content-Type": "application/json;charset=UTF-8",
"GL-ClientType": "61",
"GL-DeviceId": deviceId,
"GL-Uid": uid,
"GL-X-XSRF-TOKEN": xsrf,
"GL-CheckSum": signObj.sign,
"GL-Nonce": String(signObj.timestamp),
},
body,
});
const text = await resp.text();
console.log("status =", resp.status);
console.log("raw =", text);
try {
const json = JSON.parse(text);
console.log("json =", json);
console.log("role_id =", json?.result?.roleId || payload.roleId);
console.log("token =", json?.result?.token || "");
} catch (e) {
console.log("not json");
}
})();如果请求成功，通常会得到类似这样的结果：
{
"result": {
"appKey": "bn",
"roleId": "123456789",
"server": "1",
"day": "2026",
"token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"code": 200,
"errmsg": "OK"
}其中：
result.roleId就是要填入插件配置的role_idresult.token就是要填入插件配置的token
在 AstrBot WebUI 的插件配置页里，至少填好一组大神账号：
账号名称role_idtoken启用此账号
建议第一次先只配 1 个账号，确认能用后再加备用号。
插件通过技术手段复用 Astrbot 使用的大模型，完美打通了 AI 趣味战绩锐评、补丁查询翻译等功能。 无需额外自备大模型 API Key 或填写 Base URL，只需在 AstrBot 插件配置面板的 AI 分析设置 中：
- 在“AI 大模型提供商”下拉框中选择你在 AstrBot 中已启用的模型。
- 在“AI 人格模式”中自由选择模式：
custom：自定义提示词（自定义留空时，将自动退回到经典的数据分析师 Prompt）。插件已默认填入极具趣味的热血毒舌“科比·黑曼巴”人设。session：跟随 Astrbot 当前聊天会话（群聊/私聊）的人设。persona：在 Astrbot 人格列表中选择。
下面用相对路径说明插件在不同目录下各文件的职责。
插件代码目录（data/plugins/astrbot_plugin_ow_dashen/）
├─ main.py # AstrBot 插件入口，命令注册、适配层、图片发送、缓存清理
├─ metadata.yaml # 插件元数据
├─ _conf_schema.json # WebUI 配置项定义
├─ README.md # 使用说明
├─ LICENSE # 开源协议
├─ logo.png # 插件图标
├─ data/
│ ├─ cmd_config.json # 文转图模板相关配置
│ └─ t2i_templates/ # AstrBot 文转图 HTML 模板
└─ overstats/ # 从 Overstats 移植来的核心逻辑
├─ paths.py # 统一管理插件独立数据目录路径
├─ config/ # Overstats 配置注入与加载
├─ src/ # 核心业务代码
└─ res/ # 随插件分发的静态资源（字体、底图、图标等，只读资源）
AstrBot 插件配置目录（data/config/）
└─ astrbot_plugin_ow_dashen_config.json # WebUI 保存的插件配置，如 role_id、token、输出偏好、功能开关
AstrBot 插件独立数据目录（data/plugin_data/astrbot_plugin_ow_dashen/）
├─ bindings.json # 用户绑定的 BattleTag 映射
├─ temp/ # 发送图片前写入的临时图片目录
└─ overstats/
├─ db/
│ ├─ match_stats.sqlite3 # 本地比赛统计 / 总结相关数据库
│ ├─ ow_hero_leaderboard.sqlite3 # 英雄热度 / 英雄曲线数据库
│ └─ request_metrics.sqlite3 # 请求成功率统计数据库
├─ cache_img/ # 下载到本地的头像 / 远程资源图缓存
├─ query_tool.json # 从网易大神同步并本地缓存的 query tool 配置
├─ query_tool_assets/ # query tool 相关静态资源缓存
│ └─ extra/ # 总结模块额外下载资源缓存
├─ ow_hero_wiki/ # 英雄维基页面、结构化数据和渲染缓存
└─ dashen_summary_runtime_cache/
└─ rank_distribution_daily/ # 总结模块运行时缓存（如段位分布日缓存）
说明：
data/plugins/astrbot_plugin_ow_dashen/是插件代码与只读静态资源目录。data/config/astrbot_plugin_ow_dashen_config.json是插件配置目录，只保存用户显式配置。data/plugin_data/astrbot_plugin_ow_dashen/是插件运行时数据目录，所有数据库、缓存、绑定文件、临时图片都应保存在这里，方便跨平台部署与卸载时统一清理。
推荐按这个顺序测试：
/owhelp
/ow 绑定 <BattleTag>
/ow 我的绑定
/ow 资料
/ow 战绩
/ow 对局详情 1
/ow 锐评 2
/ow 同玩 <另一个BattleTag> 5
/ow 威能 安娜
/ow 英雄维基 猎空
/ow 段位
/ow 竞技强度 3
/ow 今日总结
/ow 商店
/ow 补丁
如果你已经绑定过 BattleTag，后续大部分命令都可以不再手动输入 BattleTag。
/owhelp
/ow 绑定 <BattleTag>
/ow 解绑
/ow 我的绑定
/ow 资料 [BattleTag]
/ow 战绩 [BattleTag] [场数]
/ow 对局详情 [BattleTag] <序号>
/ow 锐评 [BattleTag] <序号>
/ow 段位 [BattleTag]
/ow 快速强度 [BattleTag] [场数]
/ow 竞技强度 [BattleTag] [场数]
/ow 今日总结 [BattleTag]
/ow 昨日总结 [BattleTag]
/ow 本周总结 [BattleTag]
/ow 同玩 <玩家2> [场数]
/ow 同玩 <玩家1> <玩家2> [场数]
/ow 同玩详情 <玩家2> <序号>
/ow 同玩详情 <玩家1> <玩家2> <序号>
/ow 同玩锐评 <玩家2> <序号>
/ow 同玩锐评 <玩家1> <玩家2> <序号>
已绑定账号时，玩家1 可以省略。同玩锐评 会在插件已配置 AstrBot 大模型提供商时追加 AI 锐评图。
/ow 英雄热度 [模式] [段位]
/ow 英雄曲线 <英雄名> [模式] [段位]
/ow 威能 <英雄名>
/ow 英雄维基 <英雄名> [问题]
/ow 商店
/ow 补丁 [类型]
/ow 搜索玩家 <关键词>
/ow 自检
/ow 清理缓存
格式：
名字#数字，例如 BattleTag#123456
战绩：建议1-20同玩：建议1-40快速强度 / 竞技强度：建议3-12
快速、竞技
全部、青铜、白银、黄金、铂金、钻石、大师、宗师、冠军
最新、小更新、大更新
这是正常现象，因为要从网易大神接口下载很多素材图片。可以使用清理缓存命令清理。
先检查这几项：
role_id/token是否有效- BattleTag 是否正确
- 插件配置中的大神账号是否启用
- 先试
/ow 自检
正常现象，尤其是：本周总结、强度分析、英雄曲线、同玩、英雄维基首次查询
这些命令请求更多上游数据，耗时会更长。
不要把 token 等涉及个人隐私的敏感信息发到公开仓库、公开群聊或 issue。
不要在与网易大神官方相关的平台上宣传此插件。