dsh-onebot — QQ 通道架构

dsh-onebot — QQ 通道架构 A architecture diagram generated by Archify. OneBot 11 受信连接（accessToken） dsh 宿主进程（@deepseek-ai/dsh） QQ 用户 · 私聊 / 群聊 · Architecture component QQ 用户 私聊 / 群聊 NapCat 网关 · OneBot 11 · OneBot 11 受信连接（accessToken） NapCat 网关 OneBot 11 OneBotConnection · WS 传输 / 心跳 / 重连 · dsh 宿主进程（@deepseek-ai/dsh） › OneBot 11 受信连接（accessToken） OneBotConnection WS 传输 / 心跳 / 重连 入站解析与鉴权 · cq.ts + chat.ts · dsh 宿主进程（@deepseek-ai/dsh） 入站解析与鉴权 cq.ts + chat.ts ChatBridge · 会话编排核心 · dsh 宿主进程（@deepseek-ai/dsh） ChatBridge 会话编排核心 dsh Agent 运行时 · 每会话一个持久 Agent · dsh 宿主进程（@deepseek-ai/dsh） dsh Agent 运行时 每会话一个持久 Agent LLM 模型后端 · dsh 模型层 · Architecture component LLM 模型后端 dsh 模型层 QQ 媒体 CDN · 图片 / 文件 · Architecture component QQ 媒体 CDN 图片 / 文件 MediaStore + STT · 下载 / TTL / 转写 · dsh 宿主进程（@deepseek-ai/dsh） MediaStore + STT 下载 / TTL / 转写 出站管道与文字图 · split.ts + t2i + qq_* · dsh 宿主进程（@deepseek-ai/dsh） 出站管道与文字图 split.ts + t2i + qq_* ffmpeg / whisper CLI · 本地进程 · Architecture component ffmpeg / whisper CLI 本地进程 QQ 会话（收发） WS 双向（事件 / 动作） 消息帧 解析 + 策略通过 会话消息（用户 / assistant） 推理 图片 / 语音 / 文件 CDN 下载 ffmpeg→WAV + whisper 出站文本 / 文字图分段 qq_* 工具调用 Legend Backend External

入站路径

  • • OneBot 11 消息 → CQ 段数组/CQ 字符串解析
  • • 私聊/群聊策略 + @提及 fail-closed gating
  • • 每 QQ 会话一个持久 Agent，重启自动 resume

出站路径

  • • 正文 >150 字渲染 t2i 文字图卡片，否则标点分段
  • • Markdown 剥离为 QQ 纯文本，[[qq_forward]] 合并转发
  • • 中间消息即时发送、单独撤回 + 回合末小结卡

媒体与语音

  • • 图片四路解析：url / base64:// / file:// / hash
  • • 大图长边 ≤imageMaxSize 等比压缩，GIF 不压
  • • 语音 ffmpeg→16kHz WAV + whisper，失败降级 [语音]

信任边界

  • • WS accessToken 鉴权，reverse 拒绝非法连接
  • • 管理员/白名单/群 @ gating，未知用户 fail-closed
  • • 出站敏感内容审计，无遥测、无第三方服务