xcisxc29 / dsh-qq-plugin

# dsh-qq-plugin
Drive the DeepSeek Harness agent on this computer from your phone, in QQ.
It goes through **Tencent's official QQ bot platform** (`api.bot.qq.com`, bound by scanning a QR
code), so there is **no public IP to expose, no reverse proxy, and no third-party protocol client**
in the middle. Bind once, and it keeps working.
**Runs on the current DSH desktop app** — developed and tested against DSH `0.2.0-rc.2`.
This is the QQ counterpart of dsh-wechat-plugin. It is
feature-aligned with it, with a few deliberate departures where the QQ protocol makes the WeChat
machinery unnecessary — see Differences from the WeChat version.
中文说明
> **Ask for a file in one sentence and it lands on your phone.** Say *"send me that DSH self-portrait
> from my desktop"* in QQ and the agent finds the file on the computer, sends it back, and confirms
> with *"sent — DSH 自画像.png on the desktop (29 KB, PNG)"*. The **＋** at the right of the composer
> is the attachment entry: images, videos, voice and files all go in that way
> (see Media in both directions).
## Features
- **Text both ways.** A QQ message becomes a DSH prompt, and the reply comes back to QQ.
- **Images, files and voice in; images, videos and files out.** Attachments are saved into the
 session workspace and handed to the agent; the agent sends files back with `send_to_qq`.
 **A reply that runs long is turned into a `.md` file** and sent to your phone instead of being cut.
- **One QQ chat, many DSH conversations.** `/new`, `/list`, `/switch`, `/current`, `/cancel` — or
 just say "switch to the other one". The list has **session folders** and **sessions** as two levels.
- **Pick the model and the reasoning level from your phone too.** `/model` lists the models with
 each one's reasoning levels; `/model 2` and `/model 等级 high` switch them, effective from the
 **next** step.
- **Answer permission prompts and questions from your phone.** Approvals are answered with
 「允许」/「拒绝」 (allow/deny) or a numbered option; the agent's multiple-choice questions arrive in
 QQ with numbered options and a digit answers them — being away from the desk does not stall the task.
- **Proactive push.** `notify_qq` lets any session on this machine message you — that is what makes
 "tell me when it is done" work. It works in practice: a ten-message burst was delivered in full,
 and the last six of those went out as proactive pushes. (Tencent's rules for unsolicited sends can
 change and **the plugin assumes no quota**; anything undelivered is queued and flushed the next
 time you speak.)
- **Scheduled tasks.** Run through the DSH host's own `schedule_create` / `schedule_list` /
 `schedule_delete` / `schedule_update` — just say "wake me at 23:12". The plugin does not
 reimplement what DSH already has; it is only the channel.
- **Settings page** under **Settings → QQ** — nine settings, a native folder picker, and diagnostics.
## Install
**For the DSH desktop app** on a machine that stays on. It needs DSH's workspace, tool and UI