前言¶

给 DSH agent 接 QQ 机器人之后，群聊里最常见的问题是这类：「提莫怎么玩」「亚索带什么海克斯」「缩小引擎是什么」「提莫和亚索谁强」。这些问法要么没有固定意图，要么答案随版本变化，靠 agent 自己的知识既有时效性问题，也容易编出不存在的数据。

下面是介绍的插件 dsh-plugin-lol-mayhem（目录页 https://www.skillhub.cn/plugins/NormalAorii/dsh-plugin-lol-mayhem ，GitHub https://github.com/NormalAorii/dsh-plugin-lol-mayhem ，维护者 NormalAorii）解决这个问题的做法：把海克斯大乱斗的强度、强化、出装、组合数据做成 13 个原生工具，agent 在群里直接调用，不凭记忆作答。

这是什么¶

插件定位为 DeepSeek Harness 原生 Host 插件，面向「已接入 QQ 官方机器人」的 agent。装上后注册 13 个 lol_* 工具，并注入一段 system prompt：用户问海克斯大乱斗时必须调本插件的工具，要图时调 lol_card 再配合 qqbot_send_file 发送。

它属于联网工具分类，但数据并非每次请求都抓，而是内置离线快照加一个在线刷新入口，下面安装与用法会说明。

核心功能：13 个工具¶

按分工分成四组来看。

查询单个英雄的完整攻略：lol_champion 返回梯度与全服排名、胜率、选取率、海克斯强化 Top6（每条附机制说明与胜率选取率）、当前版本最强出装（最强/最热/备选三件套）、首件核心、技能加点、召唤师技能，以及这套出装对应的三强化组合。

强化维度：lol_augments 是强化排行榜，传英雄按该英雄适配排名，不传则给全服强化强度榜，可按白银/黄金/棱彩过滤；lol_augment 是单个强化档案，包含中文效果说明、梯度、全服胜率/选取率、适配英雄；lol_search 做模糊搜索，支持「瞎子/狐狸/电耗子/提百万」这类绰号。

出装与组合：lol_build 按流派拆开三件套，可传 tag 只看 AP、AD、Hybrid、On-Hit、坦克等某个流派；lol_trio 给出同一局能凑齐的三个海克斯套装，按组合胜率排序并标注样本局数。

对比与整活：lol_compare 对比两个英雄的梯度、排名、胜率、选取率、各自 Top3 强化与最强出装并给出结论；lol_tier 给 T1–T5 英雄梯度榜；lol_fun 找「胜率明显高于自身基线但没人拿」的强化或全服冷门高胜率英雄。

运维与展示：lol_meta 输出数据版本、来源、覆盖率、抓取时间与诊断；lol_update 在线刷新数据，写运行时缓存而不改动包内快照；lol_card 生成 1080 宽 PNG 图文卡，支持 champion、trio、augment、augments、tier、fun、meta 七种类型，由 agent 用 qqbot_send_file 发到群里；lol_help 提供菜单与示例问法。

数据来源与已知偏差¶

英雄级数据来自 aramgg 官方客户端的公开只读 JSON API：https://data.dtodo.cn/api/client/v1/，走 config → dataVersion → augments.json / champions.json / champions/<id>.json / items.json / summoner-spells.json。快照含 173 英雄、218 强化、306 物品，以及每个英雄的强化榜、出装流派和三强化组合。

有一处需要知道：op.gg 没有开放英雄级海克斯统计。op.gg 的海克斯数据只存在于模式主页的 RSC flight 里，由于没有「某英雄 × 某强化」的胜率，其内部接口也未公开，因此插件不伪造这部分数据。原始需求里的「接入 op.gg」无法按字面实现，这是已知偏差，lol_meta 会在来源说明里讲清楚。

数据是全服统计（腾讯服样本），不是实时对局推荐，每张卡片 footer 都会标注这一点。上游也有两个已知缺陷：三强化组合里有 2 个上游未定义的强化 id（2083/2104，显示为「未知强化 #id」）；约 7% 的单条强化因样本不足胜率为 null，卡片上显示「—」而不是 0%。

安装与启用¶

这个插件没有 dsh plugin add 形式的安装命令，README 给了三种方式。

0. 从 GitHub 下载：到 Releases 页面下载 dsh-plugin-lol-mayhem-1.0.0.tgz，然后走下面第 2 条；或者 git clone https://github.com/NormalAorii/dsh-plugin-lol-mayhem.git 后走第 1 条。
1. 本地目录安装（README 标注为本机已用的方式）：通过 plugin_manager 的 install_bundle，target 传本目录绝对路径，例如 C:\...\dsh-plugin-lol-mayhem。DSH 会把它装进 profile 并启用，重载后 13 个 lol_* 工具即可用。
2. 离线 tgz：把 tgz 拷到目标机器，plugin_manager install_bundle 传 tgz 绝对路径；或者在目标 profile 目录 npm install <tgz>，并把 dsh-plugin-lol-mayhem 加进 profile 的 package.json 的 dsh.profile.bundles。
3. 手工：把目录放进 profile 的 node_modules/，并在 profile 的 cordis.patch.yml 里添加：

- insert:
    - id: dsh-plugin-lol-mayhem
      name: dsh-plugin-lol-mayhem

前置条件有两个，建议装之前先确认。宿主需要有 tools 服务；lol_card 出图需要 Windows PowerShell 加 System.Drawing，缺这个环境时其余工具照常工作，卡片会返回文字兜底。

典型用法¶

数据维护有两条命令，都在插件目录下执行。

重新抓取全部数据（默认读 lol-probe/cache/api 缓存，通常几秒完成）：

npm run crawl

离线自检，不需要 DSH 宿主，会校验快照、13 个工具、模糊匹配，并真实生成 4 张 PNG：

npm run verify

对话里说「刷新数据」即可触发在线刷新：lol_update 写入 DSH_HOME/plugin-data/dsh-plugin-lol-mayhem/snapshot.json，这个运行时副本优先于包内快照。物料包内已含 data/snapshot.json 全量快照（约 1.2MB），离线也能跑。

出卡片的方式是：用户要攻略图时，agent 调 lol_card（传 champion、trio、augment、augments、tier、fun、meta 之一）拿到 PNG，再用 qqbot_send_file 发到 QQ。README 的 docs/teemo-card.png 就是 lol_card 针对提莫的真实输出，卡上依次是 Top6 强化（名字后直接跟机制说明）、当前版本出装、同局三强化组合、首件核心/技能加点/召唤师技能，底部标注数据来源与版本。

适用场景与注意¶

适合已经给 DSH agent 接了 QQ 官方机器人、想让它回答海克斯大乱斗构筑问题的开发者。插件按当前 DSH 进程权限运行，装之前建议先读一遍源码，确认 scripts/crawl.mjs 访问的接口和 cordis.patch.yml 的改动符合你的预期。许可证是 MIT，数据版权归 aramgg / Riot Games，插件本体不含游戏资源文件，只做个人查询用途。

小结¶

给它一个宿主加一个工具服务，就能把海克斯大乱斗的版本强度、强化机制、出装和三强化组合变成 agent 可调用的结构化答案，省掉自己抓数据和排版出图的工作。目录页：https://www.skillhub.cn/plugins/NormalAorii/dsh-plugin-lol-mayhem ；源码：https://github.com/NormalAorii/dsh-plugin-lol-mayhem 。