cheesehaqi/dsh-qq-onebot-bridge

README 摘要

dsh-qq-onebot-bridge QQ ↔ DeepSeek Harness 双向桥插件（独立 bundle）。QQ 消息直接驱动 DSH agent 会话，agent 回复自动发回 QQ。 功能总览 - 双向消息桥 ：QQ（群聊/私聊）消息进入 DSH agent 会话；回复自动分段发回 QQ（OneBot v11 反向 WebSocket） - 会话分组 ：每个群一个独立会话（ sessionMode: chat ）或每群每人一个会话（ user ）；每个私聊用户一个独立会话，互不串上下文；agent 系统提示注入当前会话归属（chatScope） - 语音转文字（STT） ：群聊中 @机器人并引用（回复）一条语音 → 转写文字并回复；私聊语音直接转写。支持智谱 GLM-ASR-2512 或任意 OpenAI 兼容 /audio/transcriptions 端点（如 SiliconFlow） - 私聊识图 ：私聊中用户发送的图片/动画表情自动下载到 cwd/qq-images/ 并注入会话，agent 用 describe image 主动查看并回应（ privateImageView 开关） - 引用解析 ：@机器人并引用文本/图片/语音时自动展开（图片落盘到 cwd/qq-replies/ 供 describe image 查看，语音自动转写） - 表情系统 ：黄脸表情表 + 回复里 [face:名字] 标记替换 + 图片表情收藏（ autoCollectStickers ）+ 会话内 qq face list / qq face send 工具（ faceEnabled 总开关） - 会话命令 ： /new 重置当前会话、 /status 查看会话状态 - 安全控制 ： allowUsers / allowGroups 白名单、 accessToken 鉴权、 replyOnlyWhenMentioned 群聊仅@回复 - 人设解耦 ：插件 不包含任何人设/记忆内容 ——人设与群规则经 dsh-mnemon 的 USER.md / MEMORY.md 注入会话（见文末说明） 架构 安装 / 卸载 装/卸后重启 dsh web 生效。 配置 profile 的 cordis.patch.yml 覆盖 id: dsh-qq-onebot-bridge 的 config（完整示例见 examples/cordis.patch.example.yml ）： 键 默认 说明 host 127.0.0.1 反向 WS 监听地址 port 6700 反向 WS 监听端口 accessToken '' OneBot 端须携带的 Bearer token（空=不校验） allowUsers [] 用户白名单（空=所有人） allowGroups [] 群白…

分类