cyhddyx/dsh-qq-tools ↗★ 0

dsh-qq-tools

提供QQ群和私聊交互工具,支持收发消息与表情。 适合需要将DSH会话与QQ群或私聊进行对接和互通的用户。

包名
dsh-qq-tools
兼容性
待验证
版本
0.8.2
许可证
MIT
最近更新
2026年10月24日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:cyhddyx/dsh-qq-tools

配置

首次启动会自动创建 ~/.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 也不会列出他们。