tencent-connect/dsh-qqbot

README 摘要

@tencent-connect/dsh-qqbot 基于 deepseek-harness (dsh) 的 QQ Bot IM 插件，将 QQ 消息平台作为 dsh agent 的前端协议驱动。 中文 English 架构 安装 方式一：手动执行 首次启动时，插件检测到凭据未配置会自动进入扫码引导：终端输出二维码 → 手机 QQ 扫码绑定 → 凭据自动保存到 profile，后续启动无需再次扫码。 方式二：本地路径安装 方式三：--patch 开发模式 配置项 配置 类型 默认值 说明 appId string 必填 QQ Bot AppID（或通过 QQBOT APPID 环境变量） appSecret string 必填 QQ Bot AppSecret（或通过 QQBOT SECRET 环境变量） provider string deepseek-official LLM 提供商名称 model string deepseek-chat 模型名称 preset string - Agent preset id cwd string process.cwd() Agent 工作目录 requireMention boolean true 群聊是否需要 @bot 才触发 groupPrompt string - 群聊额外 system prompt directPrompt string - 私聊额外 system prompt textChunkLimit number 4500 单条消息最大字符数 sessionIdleTimeout number 1800000 会话闲置超时(ms)，默认 30 分钟 debug boolean false 调试模式 内置命令 命令 说明 /bot-reset 重置当前会话（清除上下文） /bot-model 查看或切换模型 /bot-status 查看当前会话状态 /bot-help 查看所有指令 核心模块 会话路由 sessionKey: qqbot:${appId}:${scope}:${peerId} ，由 SHA-256 确定性派生 SessionId，重启后可恢复。 解析策略：进程内复用 → 持久化恢复 → 全新创建。 设计原则 - 纯 Cordis 插件 — 遵循 dsh "Plugins, not loop changes" 原则 - 声明式依赖 — inject = ['agents'] ，不直接耦合其他插件 - 会话隔离 — 每个 QQ 私聊用户/群聊各一个独立 Agent - Preset 支持 — 可通过 agent-presets 服务挂载预设（工具集、prompt 等） - 闲置回收 — 超时自动 dispose Agent，防止内存泄漏 - Markdown 输出 — 回复以 Mark…

分类