前言¶

跑 QQ 桥接做主动消息时，「投骰」模式往往要隔一段时间才命中一次。进度散落在桥接控制台和日志里，想一眼看清每个会话投了多少次、平均几投一中，还要改保底、间隔、静音时段，得来回敲接口或改配置。DSH NEXT 宿主自带设置面板，但默认不会单独汇总这类投骰统计。

下面介绍独立插件 dsh-qq-dice（维护者 aooom4）：挂在 DSH 设置左侧「投骰进度」栏目，轮询桥接状态、自行累计命中间隔，并在界面里保存参数且立即生效。1.3.0 起还支持不装 qq-bridge 时用内置演示引擎把整块面板跑起来。

这是什么¶

dsh-qq-dice 是面向 DSH NEXT 桌面宿主 的设置槽位插件，当前包版本 1.3.0，许可证 MIT。它不依赖其它第三方 DSH 插件，只用宿主内置的 slots、webServer、React 等能力。

定位可以概括为三件事：查看 QQ 桥接机器人主动消息投骰进度；统计「平均投多少次才命中一次」；在设置界面改桥接侧参数并即时生效。主动消息仍由桥接（或你接入的自定义服务）发出，本插件负责展示、统计与写回配置。

社区目录分类为「趣味换装」；仓库在 GitHub 公开，aooom4/dsh-qq-dice。

核心功能¶

进度与「几投一中」¶

面板顶部展示每轮命中平均用了几投（均值不超过保底次数），并给出最快、最慢与「最近每次命中用了几投」明细（时间带日期）。每个会话在统计表里也有同一口径的「投几次中一次」列。

桥接端只保存本轮已投次数，命中后归零，不保留总投骰与历史命中。插件默认约每 5 秒请求 /api/socialV2/proactive-status（投骰间隔调到 10 秒以下时会自动加密轮询），自行累计：计数增长记入历史总投骰；计数回退（命中归零）时记一次命中，本轮投数 = 命中前最后一次观测到的 rollCount + 1。主指标平均即 intervals 的均值，与明细表、统计表同源。1.2.4 起与桥接 roll 口径对齐，面板数字不会超过保底次数（默认 90）。

会话表格与忽略/恢复¶

每个会话一行，展示状态、本轮已投、安静/保底提示、下次命中率、下一投、待补发、累计命中、投几次中一次、被重置等。点「移除」会把会话写入桥接 socialV2.proactive.ignoredKeys，立刻停止定时投骰、从表格消失，并清除本插件内该会话的历史命中统计（不可恢复，前有确认）。表格下方列出已忽略会话，可点「恢复」重新投骰。不动 QQ 收发与 DSH 会话映射，也无需重启。

参数页¶

可在界面修改模式、启用开关、保底次数、投骰间隔、安静阈值、静音时段、基础命中率、加码起点、每次加码、random 概率、新消息重置计时等。静音时段示例 23-8（本地时间、左闭右开、可跨零点，多段逗号分隔，留空表示不静音）。保存前校验格式与关系（如加码起点须小于保底次数），点保存写回桥接端，无需重启机器人。

三档数据源（1.3.0）¶

没有桥接时 auto 会给出可读提示；切到 demo 即可看到完整面板。配置保存在插件 state/datasource.json，令牌只存宿主机，前端不回显。

其它行为说明¶

• 开启 resetOnIncoming 时，对方消息导致的计数清零不会误记为命中（1.1.1 起用 lastIncomingAt 与安静阈值区分）。
• 统计落盘 state/hits.json，DSH 重启后继续累计；桥接侧另有 state/dice-hits.log，与本插件累计统计相互独立。
• demo 统计在 state/demo-hits.json，与真实 hits.json 隔离，切回 auto 不会被演示数据污染。

安装与启用¶

命令行（推荐）¶

先把 desktop 换成你自己的 profile 名：

dsh plugin --profile desktop add github:aooom4/dsh-qq-dice

同一包也发布在 npm，可用包名 dsh-qq-dice 安装。装完后从系统托盘完全退出 DSH 再重新打开（仅关窗口会缩到托盘，不会重载插件）。设置左侧出现「投骰进度」即表示加载成功。

手动放置（开发或无 CLI）¶

1. 将仓库放到 DSH 插件目录，例如 ~/.dsh/plugins/dsh-qq-dice（Windows 多为 C:\Users\<用户名>\.dsh\plugins\dsh-qq-dice）。
2. 在 ~/.dsh/profiles/desktop/package.json 中合并 dependencies 与 dsh.profile.bundles，增加对 dsh-qq-dice 的 link: 依赖（路径须为本机绝对路径）。
3. 必要时在 node_modules 下建立指向插件目录的链接，或用 pnpm install 处理 link:。
4. 同样需托盘完全退出后重启 DSH。

未找到本机桥接时，可在「数据源」切 demo 试面板，或 custom 填写其它桥接地址。

典型用法¶

本机已有 qq-bridge¶

保持数据源默认 auto，打开设置 → 投骰进度，即可看到各会话进度与平均值。需要调参时在参数区修改后点保存。

自定义 HTTP 桥接¶

数据源选 custom，填写 baseUrl（仅 http/https）及可选 token（默认 header x-console-token）。对方需实现 GET/POST {base}/config 与 GET {base}/status，返回 README 约定的 JSON 字段；ignoredKeys 经 config 读写，移除/恢复会话无需额外接口。

无桥接先体验¶

数据源选 demo。插件用内置引擎模拟两个演示会话，默认 5 秒间隔；改参数后下一轮生效，状态在 state/demo-state.json。演示不实现静音时段、新消息重置等全部桥接侧逻辑，也不发 QQ 消息。

适用场景与注意¶

适合：已在用（或计划用）QQ 桥接投骰模式做主动消息，希望在 DSH 里集中看进度、算平均几投一中、改 proactive 参数的人。只是想了解面板长什么样、没有桥接环境时，可用 demo。

安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证。插件以当前 DSH 进程权限运行，会读写本机 state/（含会话标识、可选自定义数据源令牌等，仓库 .gitignore 已排除，勿提交版本库）。custom 模式下你对接的服务质量决定数据是否真实；demo 下改参数不会影响真实 QQ 发送。

DSH 社区插件目录由独立站点维护，与 DeepSeek / 幻方无官方从属关系；安装第三方插件属于个人环境扩展，按需评估信任边界。

结尾¶

dsh-qq-dice 把 QQ 桥接投骰进度、命中间隔统计和参数编辑收进 DSH NEXT 设置页，并可用 auto / custom / demo 三档数据源适配不同环境。需要固定版本时，可从 Releases 下载版本包。

• 目录页：https://www.skillhub.cn/plugins/aooom4/dsh-qq-dice
• 仓库：https://github.com/aooom4/dsh-qq-dice