dsh-qq-bridge · QQ Remote Control for DSH

     

更新 · 是什么 · 功能 · 快速开始 · 配置 · 安全 · 停止服务 · 常见问题 · 许可与致谢

<h2><span style="color:#16a34a;">想随时随地操控鲸鱼娘帮你干活？</span></h2> <h2><span style="color:#2563eb;">把任务丢给鲸鱼娘就转头刷手机忘记盯进度？</span></h2>

<strong>把 DSH 绑定到 QQ：出门在外也能发任务，Web 对话完成后立刻提醒刷手机的你。</strong> <strong>无需开放外部端口，无需配置公网地址~ 零安全风险~</strong>

<br>

_{QQ 远程控制 · Agent 回复提醒 · NapCat / 官方 QQ Bot 双路径}

更新

v1.0.0 更新：支持Web UI中配置，告别繁琐的CLI配置

直接在 QQ 里对 Agent 说“请在 2026 年 9 月 1 号中午 12 点提醒我提交报告”，插件会创建一次性定时任务，到点后在同一个 QQ 会话触发 Agent 并主动发回提醒。

v0.4.0 更新：支持定时提示功能!

直接在 QQ 里对 Agent 说“请在 2026 年 9 月 1 号中午 12 点提醒我提交报告”，插件会创建一次性定时任务，到点后在同一个 QQ 会话触发 Agent 并主动发回提醒。

是什么

• 控制鲸鱼娘：

• web 会话完成提醒：

dsh-qq-bridge 是一个 DeepSeek Harness（DSH）Web profile 插件，用来把 QQ 消息转成 DSH Agent 会话请求，再把 Agent 回复发回 QQ。最常用的链路是：

QQ 发送消息 -> NapCat / OneBot -> dsh-qq-bridge -> DSH Agent -> QQ 回复

默认推荐走 NapCat / OneBot：用一个 QQ 号登录 NapCat，然后从手机 QQ 给自己发消息，不需要额外准备机器人小号。也支持双号模式：一个 QQ 登录 NapCat，另一个 QQ 负责发指令。

如果不想使用 NapCat，也可以选择 腾讯官方 QQ 开放平台机器人。官方模式不需要扫码登录 NapCat，但需要在 QQ 开放平台创建机器人，并提供 AppID、AppSecret，再通过一次性 pair <code> 配对写入管理员 openid。

当前不支持通过 QQ 的“我的电脑”会话完整交互；这类消息可以被日志捕获，但回复会回到当前 QQ 自身，链路不完整。项目背景和架构说明见 docs/project-overview.md，使用导图见 docs/usage-guide.html。

功能

• QQ 遥控 Agent：白名单用户可直接在 QQ 里发任务，插件会转成 DSH live session，并把最终回复发回 QQ。
• 工作区、模型、权限和会话控制：支持 /dir、/new-session、/models、/model、/reasoningEff、/permission 等 bridge 侧指令，也支持用自然语言完成常用切换。
• 定时提醒和 memo：支持一次性定时任务和备忘记录，数据通过 DSH storageDomain 持久化。
• Web 会话完成提醒：非 QQ Web 会话结束后，可主动给管理员 QQ 发提醒；QQ 发起的会话只返回实际 Agent 回复。
• 双接入路径：默认推荐 NapCat / OneBot，本机个人使用更方便；也可切换腾讯官方 QQ Bot。

快速开始

当前自动安装向导只适配 Linux / WSL2 环境；原生 Windows 暂未适配。Windows 用户建议先在 WSL2 中使用。

系统要求

• 已安装 DSH / DeepSeek Harness，且 dsh web 可正常启动。
• Linux / WSL2 环境。Node.js 20+。
• 选择 NapCat 路径时，需要先安装 NapCat，并且需要一个可扫码登录的 QQ 号。
• 选择官方 QQ Bot 路径时，需要 QQ 开放平台机器人 AppID 和 AppSecret。

三步上手

1. 安装插件（推荐 npm 稳定版）：

   pnpm dsh plugin --profile web add @yachangchang/dsh-qq-bridge
   

   也可以直接从 GitHub 安装当前仓库：

   pnpm dsh plugin --profile web add github:TomoyoNatsume/dsh-qq-bridge
   

   插件会作为 DSH bundle 写入 dsh.profile.bundles。刚安装时默认 enabled: false，不会连接 QQ，也不会启动 bridge。

2. 启动 dsh web，进入 Web UI，打开左下角“设置”，进入 QQ bridge，填写 QQ 接入、管理员、Agent 模型等配置，点击“保存配置”。（NapCat 分支会检测本机是否安装并启动 NapCat，点击“保存配置”时会自动写入 OneBot 正向 WebSocket 配置和 token）

3. 保存成功后，在 QQ 里发送：

   ping
   

   如果发送 ping 后没反应，请运行 napcat log <你的QQ号>，或查看 ~/Napcat/log/napcat_<你的QQ号>.log 确认 NapCat 是否已经扫码登录。

NapCat 安装

选择 NapCat 路径前，本机需要有 napcat 命令。Linux / WSL2 推荐：

cd ~
curl -o napcat.sh https://raw.githubusercontent.com/NapNeko/NapCat-Installer/main/script/install.sh
bash napcat.sh --docker n --cli y

安装后确认命令可用：

napcat help

NapCat 扫码登录时请打开 setup 打印的日志。日志里可能有多个二维码，请拉到最后一个二维码扫码；如果二维码过期，在 setup 里选择“二维码过期”，它会重启 NapCat 生成新的登录请求。

设置 / setup

当前版本由设置页负责写入 bridge 配置并同步 QQ 专用 preset；也可以手动进入 ~/.dsh/profiles/web/ 执行 pnpm exec dsh-qq-bridge setup，通过 CLI 进行旧版 setup。

…