Skip to main content
F

dsh-plugins

feng5124/dsh-plugins

Smart mail for DSH: multi-account IMAP/SMTP send & read tools (with attachments), whitelist-only wake with a configurable wake Workspace (default / named / ungrouped / directory), and same-thread reply continuation that resumes (and interrupts) the origin

Install

dsh plugin --profile web add github:feng5124/dsh-plugins

README

dsh-plugins

Community plugins for DeepSeek Harness (DSH).

dsh-smart-mail: use 0.4.0 or newer. The 0.2.0 tree had two defects that made it nearly unusable — the background poller never fired (only manual polling worked), and multipart mail (QQ and most clients) arrived with an empty body. Both are fixed in 0.3.0, which also adds per-thread model selection and config persistence. 0.2.0 was never published to npm.

0.4.0 adds a wake-placement choice: a mail-triggered session can start in the Host's default Workspace, in a Workspace you pick by name, in no group at all (未分组), or in a plain directory. Workspaces are referenced by the id the Host assigns, never by a hardcoded path, so the same package works on any machine and the panel lists whatever Workspaces that installation actually has.

PackageWhat it does
packages/dsh-smart-mailMulti-account IMAP/SMTP send & read tools, whitelist-only headless wake on new mail, and same-thread reply continuation: a reply resumes the original DSH session, interrupting its running turn first, and restores the session when it was archived. Thread resolution follows References/In-Reply-To → X-DSH-Session → subject tag. Also ships a real MIME body reader, per-thread model selection, configurable wake placement (Workspace / ungrouped / directory), quiet rotated logging, and panel config that survives a restart. Zero runtime dependencies.
packages/dsh-plugin-headless-sessions-panelSidebar panel that lists running/recent headless DSH sessions and exports each as readable Markdown, with open-into-workspace actions. The session scanner ships inside the package.

Mail as a conversation entry point

dsh-smart-mail treats a mailbox as a session entry point rather than a notification feed:

  • every outgoing message carries a [dsh-xxxx] subject tag, an X-DSH-Session header, and a recorded Message-ID;
  • an inbound reply resolves back to its thread (exact References/In-Reply-To first, then the header, then the subject tag — a client that drops one still works);
  • a reply into a running session replaces that turn (prompt with mode: 'steer', falling back to queue + cancel when steering is refused);
  • a reply into an archived session restores it through the Workspace registry (unarchiveSession, or the equivalent enqueueOperation/requireState/setState write) instead of starting a new session;
  • everything else — new senders, non-whitelisted mail, duplicates — never wakes anything, and says so in one aggregate log line per poll round.

Install

Inside DSH, either install from the package name (after publishing to npm):

plugin_manager install_bundle target=dsh-smart-mail
plugin_manager install_bundle target=dsh-plugin-headless-sessions-panel

or install a local checkout by directory, or add this repository's market index to the Plugins → Discover tab (experimental "Custom plugin markets").

Releasing

See the release runbook in the publishing workspace (dsh-market-publish/RUNBOOK.md): staged packages → npm publish or git tag → generator.mjs builds the format-1 market index → validated by the official validator → committed to the gh-pages branch, served at https://feng5124.github.io/dsh-plugins/index.json.

License

MIT — see LICENSE.

Related plugins