dsh-qq-relay
将应用连接至QQ，支持多媒体传输与理解。 适合需要通过QQ机器人与DSH进行交互和多媒体处理的用户。
同名包的其他仓库
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:HDHKVT/dsh-qq-relay说明文档
阅读完整 README ↗安装与首次配置
git clone https://github.com/HDHKVT/dsh-qq-relay.git D:\dsh-plugins\dsh-qq-relay
- 在 DSH profile 里挂载（
link:），重启dsh web； - 设置页 → 「QQ 中继」→ 填 appId / appSecret / 主人 openid → 保存；
- 在 QQ 里私聊机器人一句，数据目录出现
relay.json与日志即为连通。
数据目录默认 D:\dsh-plugins\_media\dsh-qq-relay（可用 DSH_QQ_RELAY_BASE 改）。
配置（relay.json 关键项）
| 键 | 默认 | 说明 |
|---|---|---|
transport | direct | 直连；mailbox 是旧的引擎信箱腿（保留不删） |
sessionId | — | 锁定哪条会话 |
direct.appId / .appSecret / .ownerId | — | QQ 机器人凭据（接口对外只回 hasSecret） |
reply.maxChars | 900 | 单条回复上限 |
image.maxMb / retentionDays | 12 / 7 | 收图上限 / 保留天数（0 = 不落盘） |
file.maxMb | 20 | 收文件上限 |
send.fileMaxMb | 30 | 发文件上限 |
ack.enabled / .mode / .text | 开 / media | 回执开关、范围、文案 |
sticker.trigger | 存表情包 | 收录暗号 |
video.mode / .model / .modelDir / .maxGrid | accurate / auto / 空 / 8 | 视频功能 |
video.biliCookie | 空 | 可选 SESSDATA（不下发浏览器、不写日志） |
video.biliDir / retentionDays | 空 / 7 | B 站下载目录（空= /bili）/ 保留天数（0=不清理） |
ui.showCard | true | 会话右上角那张 QQ 中继卡片是否显示 |
完整默认值与校验见 lib/config.js。