dsh-klbq

dsh-klbq

卡拉彼丘（Strinova）战绩查询的 DSH 插件：按游戏昵称从 [dakanu.com](https://dakanu.com) 取数，

渲染成一张长图（排位段位 / 总览 / 模式 / 角色 / 最近对局），并把工具 klbq_query 暴露给 agent。

提供的工具

klbq_query

| 参数 | 类型 | 说明 |

|---|---|---|

| nickname | string（必填） | 游戏昵称或 UID |

| maxMatches | number | 最近对局条数 0~20，默认 10 |

返回：

{
  "ok": true,
  "nickname": "ahiahdiawh",
  "level": 62,
  "currentRank": "束缚电子 II",      // 排位当前段位
  "topRank": "禁闭夸克 III",         // 排位历史最高
  "summary": { "rounds": 30, "winRate": 0.5, "kda": 2.86, "avgDamage": 3220, ... },
  "recent": [ { "result": "win", "mode": "排位爆破", "kda": "8/6/15", "score": "9:4" } ],
  "imagePath": "C:\\Users\\...\\Temp\\dsh-klbq-cards\\ahiahdiawh-1794051495410.png",
  "imageBytes": 413696
}

图片写到系统临时目录的 dsh-klbq-cards/ 下。工具不返回 base64——

一张 500KB 的 PNG 进上下文会非常浪费，所以「模型看摘要、人看图片」。

安装

本插件有两条发行通道，按你用的 QQ 接法选一条：

| 通道 | 安装 | 版本线 | 行为 |

|---|---|---|---|

| QQ 官方机器人（@tencent-connect/dsh-qqbot） | npm i dsh-klbq | 0.2.x | 工具 + 往 system prompt 注入 /klbq 用法，QQ 里发指令可直接出图 |

| 自建 OneBot 桥接（SnowLuma / OneBot v11） | npm i dsh-klbq@sl | 0.1.x | 纯工具，不碰 system prompt，零额外 token |

npm i dsh-klbq@latest   # 官方机器人
npm i dsh-klbq@sl       # 自建桥接 / SnowLuma

两条线只差一处：0.2.x 多了 QQ 官方机器人适配层（lib/qqbot.js）。

自建桥接自己就实现了 /klbq 指令和发图（见 qq-bridge 的 src/klbq.js），

插件在那边只需要提供工具，不需要注入任何提示词——所以 sl 通道停在 0.1.x。

也可以本地 link 安装（开发用）：

// ~/.dsh/profiles//package.json
"dependencies": { "dsh-klbq": "link:C:/Users//.dsh/plugins/dsh-klbq" },
"dsh": { "profile": { "bundles": [ ..., "dsh-klbq" ] } }

并把插件目录软链到 profile 的 node_modules/dsh-klbq。DSH 重启后生效。

两个实现要点（改代码前务必先读）

1. SNI 阻断：本机直连 https://dakanu.com 会在 TLS 握手阶段被 RST

（ClientHello 带这个域名就被重置；不带 SNI 直连 IP 能拿到 301/200）。

因此请求统一「连 IP + servername: '' + Host 头」，并 rejectUnauthorized: false。

servername 必须是空字符串，写成 undefined 时 Node 会补成域名 → 必被重置。

这条通道只取公开战绩、不传凭据；不要用它传输密钥或隐私数据。

2. 两套段位体系：排位是「至纯物质 / 升格分子 / 虚空原子 / 聚变质子 / 自由中子 /

束缚电子 / 禁闭夸克 / 无限超弦 / 奇点」（按 rank.segment 号段）；

挑战赛是「青铜…传奇」（按 gradeScore 算）。卡片右上角用排位，别混用。

渲染

用系统自带的 Edge / Chrome 无头截图（两趟：先 --dump-dom 量内容高度，再按高度截图），

不引入 canvas / puppeteer 之类的重依赖。找不到浏览器时可用环境变量 KLBQ_BROWSER 指定路径。

与 QQ 官方机器人（@tencent-connect/dsh-qqbot）配合使用

装了这个通道之后，在 QQ 私聊或群里直接发：