前言¶
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