gcry13067381632-jpg/dsh-qqbot0

@zaofan/dsh-qqbot

提供QQ机器人通道及Web可视化设置面板

AI 分析

适合需要将DSH接入QQ群聊或私聊,并进行可视化配置的用户。

包名
@zaofan/dsh-qqbot
版本
1.4.0
许可证
MIT
最近更新
2026年9月12日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:gcry13067381632-jpg/dsh-qqbot

配置项

配置类型默认值说明
appIdstring必填QQ Bot AppID(或通过 QQBOT_APPID 环境变量)
appSecretstring必填QQ Bot AppSecret(或通过 QQBOT_SECRET 环境变量)
providerstringdeepseek-officialLLM 提供商名称
modelstringdeepseek-chat模型名称
presetstring-Agent preset id
cwdstringprocess.cwd()Agent 工作目录(不是数据目录)
dataRootstring{cwd}/dshqqbot插件数据根(表情包 / .qqbot / .qqbot-extensions)。默认就在 {cwd}/dshqqbot —— 工作目录保持干净; 想放别处显式配置; 老数据首次启动自动迁入
requireMentionbooleantrue群聊是否需要 @bot 才触发
groupPromptstring-群聊额外 system prompt
directPromptstring-私聊额外 system prompt
textChunkLimitnumber4500单条消息最大字符数
sessionIdleTimeoutnumber1800000会话闲置超时(ms),默认 30 分钟
debugbooleanfalse调试模式
groupAdmin.enabledbooleanfalse群管理总开关(需机器人为群管理员)
groupAdmin.ownersstring[][]可操作群管理的主人 openid 白名单(空=不校验)
groupAdmin.manageGroupstring''对话内默认管理群 openid(web/非群会话时用)
groupAdmin.watchJoinRequestsbooleanfalse订阅入群申请事件(改后需重启)
groupAdmin.notifyInGroupbooleantrue收到申请时在群内发提醒

🔧 新版 Web 面板把群管理单开成「⑥ QQ 群管理」卡片(入群审批/禁言/成员信息/黑名单), 与上方 groupAdmin.* 配置同一份数据。