IMAP/SMTP email tools (list/read/search/send/folders/attachment/health/watch/mark/reply) with since/until date-range filters, email_mark for read/unread/star/move, email_reply for reply/reply-all/forward with threading headers, QQ/163/126/Sina/Aliyun/Gmail/Outlook/iCloud presets, multi-account support, a send-approval gate, a web settings page and a whale-girl new-mail popup driven by the incremental email_watch checker. Outlook OAuth2 device-code login works out of the box through a built-in community client, and an account can still supply its own clientId instead. A step-by-step first-run guide (4 steps) now opens inside its settings panel.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-email
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:STARDUSTLC666/dsh-email
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
简体中文 · English
Handle mail in DSH and review replies before sending.
Install · Workflow · Full guide
Features
Version 0.23 adds safe HTML send/reply/draft previews, reviewed scheduled sends, explicit Google OAuth, Tencent enterprise mail presets, localized reply quotations and optional mail-triggered DSH tasks. See the workflow and operating boundaries. Existing Gmail app-password accounts continue to work. Scheduling requires a running DSH; task execution and automatic result replies are opt-in.
- Use IMAP/POP3/SMTP, Outlook OAuth or AgentMail accounts.
- Read messages, search and download attachments in the workbench.
- Review the sender, To/Cc, content and attachments before confirming.
- Run in Chinese, English, Spanish, French, German, Japanese, Brazilian Portuguese or Russian, using the DSH locale runtime.
- Subscribe in-process to mailbox arrivals through
emailTasks, without reading bodies or starting sessions.
Actual interface with controlled validation data; the PPTX image is a rendered sample when shown.
Formatted reading, longer quoted replies, and IMAP single/bulk Trash with Undo: see the mailbox workflow. You choose whether to load external images and confirm moves before they run.
Install
Open Plugins in the DSH desktop app and install dsh-email. If the CLI is available:
dsh plugin --profile desktop add dsh-email
For the web profile, replace desktop with web. Restart that DSH profile after installation. The package’s DSH requirement is >=0.2.1-rc.3.
Start using it
- Open Email account settings and configure your own IMAP/SMTP, OAuth or AgentMail account.
- Test the connection, select an account and browse Inbox and Sent in the mail workbench.
- Search and open a message, inspect its body and attachments, then ask for a reply draft without sending.
- Edit, save and preview the draft; verify To/Cc, attachments and sending account before confirming.
- Verify the result in Sent or the original thread. Recipient deny rules continue to take precedence.
Example request：
Read this message and prepare a reply draft. Do not send it yet.
Before you start
Bring your mailbox authorization or AgentMail API key. POP3 has protocol-specific state and search limits. When the network only reaches a mail server through a proxy, add proxy to the account (or set HTTPS_PROXY); see the usage guide.
Configuration, detailed tools and troubleshooting: full reference.
Plugin updates
Check updates at the bottom of the workbench or native plugin details. Automatic checks are on by default; automatic installation is off. You choose whether to install and when to restart. Suite-managed components update with their bundle. Update behavior.
Documentation
Feedback and contributions
If the plugin helps, a Star makes it easier for others to discover. Report problems or suggest improvements in Issues; code and documentation PRs are welcome. Include versions and reproduction steps, and remove credentials from reports.
License
Links
More in this category
xmanrui/dsh-im★ 3543
Connect IM bots to DeepSeek Harness via QR codes or bot credentials (9 channels: Feishu, WeChat, DingTalk, WeCom, QQ, Slack, Telegram, Discord, and WhatsApp).
shaobeichen/dsh-pocket★ 2941
Remote phone access to the DSH Web UI: scan a QR code for LAN or public (cloudflared tunnel) access with real-time sync, a mobile-adaptive layout, and a settings tab.
OpenPetsHQ/openpets#dsh★ 1397
Bridges DeepSeek Harness lifecycle status, errors, and approval requests to a locally running OpenPets desktop companion.
c1overzz/dsh-bili-scroll★ 1381
Let your DSH agent browse Bilibili on its own, read subtitles, write a daily digest, and @ you when it finds something worth your attention.
inclusionAI/Avernet#deepseek-harness-channel-bcn★ 602
Connects DeepSeek Harness to Avernet's Bot Collaboration Network over WebSocket V2, with automatic onboarding, isolated agent sessions, tool-call events, and multi-bot routing tools.
zaofan-make/dsh-qqbot★ 249
QQ official bot channel (enhanced fork of tencent-connect/dsh-qqbot): full agent chat in groups and DMs, rich media, an auto-tagged sticker library with AI image replies, join approval, mute and broadcast, scheduled wakeups, remote approvals over QQ, interactive cards, multi-account instances, extensions, member profiles, and token-saving value-scored wakeups.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.