dsh-qq-tools

给大肥鱼会话用的 QQ 群/私聊工具：列群、看群记录、发群消息、发表情、收藏表情（SnowLuma 收藏夹）、好友/私聊记录、发私聊消息、私聊唤醒、群成员、戳一戳感知/戳回去、挂载会话选择。8 个工具加 1 个设置组件，可在插件页逐个开关。适合需要将DSH会话与QQ群或私聊进行对接和互通的用户。

Package

dsh-qq-tools

Compatibility

Unverified

Version

0.8.2

License

MIT

Last updated

Oct 24, 2026

配置

首次启动会自动创建 ~/.dsh/qq-tools-config.json：

{
  "napCat": "http://127.0.0.1:3000",
  "accessToken": "",
  "targetSession": "",
  "groups": [],
  "historyCount": 30,
  "maxHistoryCount": 50,
  "pollMs": 5000,
  "mentionEnabled": true,
  "wsUrl": "ws://127.0.0.1:3001",
  "pokeEnabled": true,
  "privateEnabled": true,
  "privateUsers": [],
  "observationMs": 60000,
  "timeoutMs": 6000
}

napCat 是 OneBot 11 HTTP 地址（SnowLuma 默认 http://127.0.0.1:3000，NapCat 也一样）；wsUrl 是 WebSocket 事件地址（默认 ws://127.0.0.1:3001）。
targetSession 是目标会话 ID；可以在插件页「挂载会话 → 配置」里下拉选择，也可以直接改这个文件；留空时工具不会挂到任何会话。
groups 是允许看/发的群；空数组表示不限制。
mentionEnabled / pokeEnabled / privateEnabled 分别是 @ 轮询、戳一戳事件、私聊唤醒的总闸，对应组件关掉时它们也不会运行。
privateUsers 是允许唤醒和私聊工具的 QQ 白名单；空数组表示不限制。非空时，不在列表里的私聊消息不会唤醒，qq_list_friends 也不会列出他们。

dsh-qq-tools

Install

README

配置