dsh-qqbot

项目详情摘要

基于 deepseek-harness (dsh) 的 QQ Bot 插件，将 DeepSeek AI 助手接入 QQ 私聊与群聊。** English | 简体中文** 扫码加入 QQ 群 / 频道 QQ 开发者交流群 群号: 1032635674 QQ 开发者社区频道 频道号: 20dnumts4z 架构 安装 方式一：手动执行 首次启动时，插件检测到凭据未配置会自动进入扫码引导：终端输出二维码 → 手机 QQ 扫码绑定 → 凭据自动保存到 profile，后续启动无需再次扫码。 **提示**：建议升级至 `0.4.0` 以上版本扫码，支持点击链接在浏览器打开，避免部分终端二维码渲染错位的问题。 方式二：本地路径安装 方式三：--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` | 单条消息最大字符数 | `streaming` | boolean | `true` | 是否启用流式输出（群聊始终不启用） | `sessionIdleTimeout` | number | `1800000` | 会话闲置超时(ms)，默认 30 分钟 | `processingTimeoutMs` | number | `1800000` | 处理超时(ms)，超时中断当前 LLM 调用 | `maxQueue` | number | `20` | 并发队列最大长度 | `historyLimit` | number | `10` | 群历史缓冲条数 | `askTimeoutMs` | number | `300000` | 待答问题超时(ms)，默认 5 分钟（ask_user_question） | `showToolResults` | boolean | `false` | 是否展示工具调用成功结果（错误始终展示） | `debug` | boolean | `false` | 调试模式 | 访问控制（access） 配置 | 类型 | 默认值 | 说明 | `access.c2cMode` | `open`/`allowlist`/`disabled` | `open` | 私聊访问模式 | `access.c2cAllow` | string[] | `[]` | 私聊白名单（user openid） | `access.groupMode` | `open`/`allowlist`/`disabled` | `open` | 群聊访问模式 | `access.groupAllow` | string[] | `[]` | 群聊白名单（group openid） | 富媒体理解（media） 配置 | 类型 | 默认值 | 说明 | `media.enabled` | boolean | `true` | 是否启用富媒体理解（图片/视频下载 + 工具分析） | `media.maxMB` | number | `200` | 富媒体下载大小上限(MB) | `media.ttlHo