前言¶
DeepSeek Harness（DSH）采用插件化架构，意在将智能体控制能力模块化。在本地电脑上运行 Agent 后，如何通过移动端进行远程操控是常见需求。传统方案往往需要配置反向代理或暴露公网 IP，增加了部署复杂度。dsh-qq-plugin 通过对接腾讯官方 QQ 机器人平台，提供了一个无需额外网络配置、通过 QQ 消息直接操控本地 DSH Agent 的方案。
插件介绍¶
这是一个名为 dsh-qq-plugin 的 DSH 插件。它允许用户在手机 QQ 上通过扫描二维码绑定腾讯的官方机器人平台，从而与运行在桌面上的 DSH Agent 进行双向交互。该插件由用户 xcisxc29 维护，许可证为 MIT。
核心功能¶
插件提供了以下核心能力：
- 双向文本与多媒体：QQ 消息直接作为 DSH 的 Prompt，Agent 的回复返回至 QQ；支持图片、视频、语音及文件的双向传输。
- 长回复处理：过长的回复会自动转换为
.md文件发送，避免消息被截断。 - 多会话管理：支持通过
/new、/list、/switch等命令管理多个 DSH 会话。 - 模型与推理级别切换：通过
/model命令切换模型及推理级别。 - 权限与问题交互：Agent 的权限询问和选择题可通过 QQ 数字选项进行回应。
- 主动推送：Agent 可主动向 QQ 发送通知。
- 定时任务：支持通过 QQ 设置定时任务（如“23:12 唤醒我”）。
安装与启用¶
安装前需确保 DSH 桌面版版本为 0.2.0-rc.2 或更新。插件运行需要 DSH 的 workspace、tool 和 UI 服务。
- 在 DSH 侧边栏进入插件入口，选择「添加插件」。
- 输入包名
dsh-qq-plugin（注意不要少写-plugin后缀）。 - 或在终端执行命令：
dsh plugin --profile desktop add dsh-qq-plugin
- 安装完成后点击「立即启用」并重启 DSH。
典型用法¶
启用后，打开 Settings -> QQ，点击「开始扫码」，使用手机 QQ 扫描二维码确认绑定。绑定即完成注册，无需额外申请 AppID。
- 文件传输：在 QQ 说「把我电脑上桌面那张 DSH 自画像发过来」，文件会直接送达。
- 会话切换：在 QQ 说「切换到另一个」或使用
/switch。 - 模型切换：在 QQ 发送
/model 2。 - 定时任务：在 QQ 说「23:12 唤醒我」。
适用场景与注意¶
该插件适合需要通过手机临时操控电脑上运行的 DSH Agent 的场景。需注意：未认证机器人仅限管理员使用；主动推送功能基于假设无配额的规则，若消息被拦截会排队重试。
结尾¶
该插件为 DSH 用户在移动端控制桌面 Agent 提供了基于 QQ 的轻量级通道。更多细节可参考 GitHub。
