前言¶
DSH 在电脑上运行任务,用户往往不在电脑前。当任务完成、需要决策或执行出错时,需要一个低延迟的渠道接收通知,并能够无缝地继续对话。dsh-remote-qqbot 插件将 DSH 的任务状态推送到 QQ,并支持通过引用回复继续会话。
是什么¶
dsh-remote-qqbot 是 DeepSeek Harness 的 QQ 远程机器人插件,由 cyanovo 维护,采用 MIT 许可证。它将电脑上的任务状态推送到手机上的 QQ,并允许通过引用回复的方式继续会话。
安装¶
执行以下命令安装插件:
dsh plugin --profile desktop add github:cyanovo/dsh-remote-qqbot
安装完成后必须重启 DSH 进程才能生效。如果使用的是 dsh web,请将命令中的 --profile desktop 替换为 --profile web。
配置¶
- 打开 DSH 的设置。
- 进入 QQ 远程提醒与跨会话记忆。
- 在 QQ 远程提醒 选项中填入 QQ 机器人的 AppID 与 ClientSecret。
- 保存并重启 DSH。
使用方法¶
- 查看状态:在 QQ 中给机器人发送
/status,查看连接状态和当前会话情况。 - 强制新任务:发送
/task <内容>,将内容强制作为新任务放入专属会话。 - 会话管理:发送
/sessions列出最近会话,回复数字即可切换会话。 - 发送截图:发送
/screen抓取电脑屏幕并发给自己。 - 继续对话:引用机器人发送的消息进行回复,回复内容将注入到该消息所属的会话中。
核心功能¶
- 任务通知:任务完成、需要回答问题、执行出错时推送到 QQ。
- 会话记忆:支持跨会话持久化记忆、agentmd 操作日志自动追加、会话上下文注入。
- 交互方式:支持 QQ 主动私聊通知、引用回复回到对应会话。
- 协作模式:同工作区多会话自动协作,输入框下方有独立开关。
- 回答模式:提供三档回答模式(默认不落服务器、仅存服务器、存服务器+短链接)。
- 闲聊模式:闲聊会话默认为“只看不动”,回答直接回聊天框。
- 远程操作:QQ 菜单支持“屏幕”发送截图和“会话”挑选会话说话。
- 自动更新:支持远程更新,可通过
/update命令一键安装。
技术与注意事项¶
- 零依赖:不需要注册账号、不需要登录、不需要服务器、不需要公网 IP、不需要 frp。插件直接连接腾讯官方机器人接口。
- 入站限制:入站注入(引用回复等)需要本机
127.0.0.1:19387/api接口支持。 - 权限安全:闲聊会话是“只读”的,默认不占用服务器存储。
- 隐私保护:云上传总闸
cloudEnabled默认关闭,默认回答模式不落服务器,正文只存在于本地和 QQ 聊天记录中。
相关链接¶
- GitHub: https://github.com/cyanovo/dsh-remote-qqbot
- 目录页: https://www.skillhub.cn/plugins/cyanovo/dsh-remote-qqbot