前言¶

DSH 开发者有时需要把 Agent 放到 QQ 里使用：在私聊中追问，或在群聊中触发一次任务。若只希望接入消息，而不想引入个人 QQ 逆向协议、Hook、注入或模拟登录，下面介绍 dsh-qqbot-bridge。

这是什么¶

dsh-qqbot-bridge 是一个 DSH 插件，基于腾讯官方 QQ 机器人开放平台，将 QQ 私聊或群聊安全地接入 DeepSeek Harness（DSH）。

• 维护者：dsh-qqbot-bridge contributors
• 当前版本：0.1.0
• 许可证：MIT
• 仓库归属线索在资料中不一致，本文不据此断言最终归属

给机器人发送消息，等同于向一个独立的 DSH Agent 会话发送消息。

核心能力¶

• 只使用腾讯 QQ 机器人开放平台和腾讯官方 SDK，不使用个人 QQ 逆向协议、Hook、注入或模拟登录
• 首次启动支持腾讯官方扫码绑定，自动保存 AppID、Secret 和扫码用户 OpenID
• 私聊默认白名单，群聊默认关闭；空白名单不会退化成开放访问
• QQ 消息直接驱动 DSH Agent，支持流式回复、发送失败自动重试、会话持久化和模型切换
• 支持在 QQ 内处理 DSH 的一次性权限申请：/approve CODE 或 /deny CODE
• AppSecret、OpenID 和 API Key 仅保存在本机 $DSH_HOME/.env，不进入项目配置和日志
• 内置隐私扫描、单元测试、打包检查和 GitHub Actions CI

安装与启用¶

插件命令¶

下面是已核实的 npm 发布后安装命令。

dsh plugin --profile qqbot add dsh-qqbot-bridge
dsh --profile qqbot

从源码启动¶

以下启动命令来自已核实示例；仓库路径在资料中存在不一致，使用前请核对实际仓库。

Windows¶

git clone https://github.com/JHf0912/dsh-qqbot-bridge.git
cd dsh-qqbot-bridge
powershell -ExecutionPolicy Bypass -File .\scripts\dev-start.ps1

Linux/macOS¶

git clone https://github.com/JHf0912/dsh-qqbot-bridge.git
cd dsh-qqbot-bridge
chmod +x scripts/dev-start.sh
./scripts/dev-start.sh

启动脚本常用参数：

• --profile 名称
• --skip-install
• --build-only
• --setup-only

设置必填 API Key¶

必须设置 DEEPSEEK_API_KEY，否则机器人无法生成任何回复。

建议将密钥写入本机 DSH 环境文件：

# Windows 默认位置：C:\Users\<你>\.dsh\.env
# macOS/Linux 默认位置：~/.dsh/.env
DEEPSEEK_API_KEY="你的 API Key"

在 Windows 下，也可以追加到默认位置：

$key = Read-Host -Prompt "粘贴你的 DeepSeek API Key"
Add-Content "$env:USERPROFILE\.dsh\.env" "DEEPSEEK_API_KEY=`"$key`""

首次扫码与白名单¶

首次启动时，使用腾讯官方扫码绑定。绑定成功后，插件会保存 AppID、Secret 和扫码用户 OpenID。

注意：首次扫码写入的 QQBOT_C2C_ALLOW 白名单不会注入本次进程。首次扫码后，需要停掉并重跑一次，之后 QQ 消息才会按白名单策略被接受。

QQ 内审批¶

当 DSH 触发一次性权限申请时，可在 QQ 内使用验证码处理。示例如下：

/approve A1B2C3
/deny A1B2C3

审批边界如下：

• 仅任务发起者本人可以处理
• 验证码一次性使用
• 默认 120 秒超时自动拒绝

隐私与运行注意¶

• 插件以当前 dsh 进程权限运行；安装前应检查源码与许可证
• 需要 Node.js >= 22
• Windows 的 dev-start.ps1 不包含 node 存在性检查
• 当前版本为 0.1.0，项目仍处于早期阶段，建议先使用专用测试机器人、专用工作目录和私聊白名单
• 必须设置 DEEPSEEK_API_KEY
• 敏感配置应保存在 $DSH_HOME/.env，不要提交或粘贴到 Issue、PR、截图和日志中
• 使用前遵守腾讯 QQ 开放平台规则、机器人运营规范和所在地法律法规
• 项目无法承诺账号绝对不会受到限制，也不会提供绕过风控或协议限制的实现

结尾¶

dsh-qqbot-bridge 的价值在于：用腾讯官方机器人能力连接 QQ 与 DSH，并把访问控制、密钥存储和一次性审批放在插件侧处理。

社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系；已核实资料未提供目录页 URL。

GitHub 路径在资料中不一致，请人工核对后再使用：

• https://github.com/wang-22-code/dsh-qqbot-bridge
• https://github.com/JHf0912/dsh-qqbot-bridge