DSH Plugins Marketplace

DSH Plugins

Plugins

/

Notifications & Integrations

/

dsh-event-relay

d

dsh-event-relay

Manifest valid
UI (client)hasBundlePatch

dsh-event-relay

A DeepSeek Harness (DSH) plugin: install it into a profile alongside your own plugins.

Push from host to browser. The host can start a conversation; every other channel (fetch, RPC) requires the browser to ask first. If your plugin's UI should react the moment something happens host-side (a setting changed, a build finished, a notification arrived), this is that channel.

One shared SSE route (/relay/events) holds every subscriber's response open and streams JSON messages {"topic","payload"} as things happen. One connection per browser tab, no matter how many plugins subscribe.

Architecture

flowchart LR
    subgraph HOST["🖥️ Host, dsh-event-relay (host half)"]
        P["publish(topic, payload)"]
        N["notifyClients<br/>filter per client"]
        W[("/relay/events<br/>held-open responses")]
    end
    subgraph WIRE["⇄ SSE"]
        direction LR
        M["data: {topic, payload}<br/>...one message per event..."]
    end
    subgraph BROWSER["🌐 Browser tab, dsh-event-relay (client half)"]
        C["eventRelay service<br/>subscribe(topic, listener)"]
        S["notifyListeners<br/>fan-out per topic"]
        L1["plugin A listener"]
        L2["plugin B listener"]
        L3["plugin C listener"]
    end
    P --> N --> W
    W --> M
    M --> C
    C --> S
    S --> L1
    S --> L2
    S --> L3

Plugin value proposition

alternativefalls short
pollinglatency + waste (N fetches to learn "nothing changed")
refetch on focus/navigationfree and correct, but updates only when the user acts
your own EventSource/WebSocket per pluginthe browser caps ~6 connections/domain (HTTP/1.1); a few plugins permanently occupy them and every other request queues. This shared stream is one connection for the whole tab
host RPC (/api)request→response: the frontend can ask, but the host cannot interrupt

One direction, on purpose. Browser→host is transaction-shaped (command → reply): use plain HTTP (a route your host half registers) with status codes, validation, and error handling the stream doesn't have. Host→browser is notification-shaped: unpredictable moments, all tabs at once. Different jobs, different roads.

How to install

Requires a DeepSeek Harness checkout and a profile (here web):

# from the harness checkout
pnpm dsh plugin --profile web add /path/to/dsh-event-relay

# verify the profile still composes
pnpm dsh --profile web --dump-config

Then (re)start the harness; the host half loads at boot. Browser plugins consume the client service with ctx.get('eventRelay'), nothing to wire up beyond installing this package.

Producers (host plugins)

const relay = ctx.get('eventRelay')            // optional, degrade if absent
relay.publish('my-topic', payload)             // direct
ctx.on('my/event', (data) => relay.publish('my/event', data))   // mirror a Cordis event (do this in your plugin)

Consumers (browser bundles)

const relay = ctx.get('eventRelay')            // provided by this package's client half
const unsubscribe = relay.subscribe('kanban', (topic, payload) => { ... })
// or raw: new EventSource('/relay/events?topics=kanban,notifications')

payload in the callback is whatever the publisher passed. Apply it directly or ignore it and refetch your own truth, both are first-class styles.

Topic filtering: a subscription matches its exact topic and any child topic ('kanban' matches 'kanban/change'). The browser's connection URL carries the union of the tab's topics, so the server only sends what this tab listens for. When the last listener of the tab unsubscribes, the connection closes.

On every (re)open of the stream, subscribers of the synthetic topic __relay receive '__relay/open'. Consumers that apply state from messages use it to resynchronize: anything missed while the stream was down is recovered by one refetch.

Design

Transport, not a bus: Cordis events remain the host-side event system; this only carries messages across the plane boundary.

Payload is optional, not doorbell-only. Some plugins use the relay purely as a change signal, a topic-only message that tells them to refetch their own truth. Others consume the payload directly: the notifications demo pushes the notification itself, a kanban board pushes change messages. publish(topic, payload): send whatever is useful. Doorbells are one usage style, not the contract.

Liveness, not correctness: the relay may be absent, and a consumer should fall back to pull-on-focus (or pull on __relay/open) rather than depend on the stream for state. Route roots are composition-level contracts (/api, /plugins, /workspace-history, /notifications, /granular-settings are taken).

Debugging

The wire can be listened to from a terminal. Very useful to verify publishes end-to-end without a browser:

curl -N 'http://127.0.0.1:3080/relay/events'

Add ?topics=<prefixes> to mirror a client's filter; -N makes curl stream instead of buffering.

Dependencies

None

Plugins dependent on this

Comments

Loading…

From the same category

dsh-im

by xmanrui

通过扫码或机器人凭据把IM机器人接入DeepSeek Harness(支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord和WhatsApp)。 Connect IM bots to DeepSeek Harness via QR code or credentials (9 channels).

Notifications & IntegrationsManifest valid

★ 3.7k

↓ 25.8k/wk

MIT

JavaScript

Nov 7, 2026

dsh plugin --profile web add @xmanrui/dsh-im

by c1overzz

DSH 插件:每天替你刷一轮 B站,读字幕挑出值得的、写一份日报,值得的 @ 你

Tools & CapabilitiesNotifications & IntegrationsTerminal & ClientsManifest valid

★ 1.4k

↓ 10.5k/wk

MIT

JavaScript

Nov 12, 2026

dsh plugin --profile web add dsh-bili-scroll

by zaofan-make

AI 统管 QQ 群组:审核放行、群发文件、沟通其他 web 会话的 AI! ;气氛组担当:表情包自动入库、AI 自己决定开口、多预设多人格轮班陪聊!; 远程办公:权限审批、提问卡片转发到 QQ。; 自定义互动按钮:AI 帮你轻松搭文字游戏 —— 卡片逻辑由 AI 帮你写 ;省 token 设计:群聊价值评分后才唤醒 AI,上下文自动压缩。

Notifications & IntegrationsTerminal & ClientsManifest valid

★ 261

↓ 17k/wk

MIT

TypeScript

Nov 17, 2026

dsh plugin --profile web add @zaofan/dsh-qqbot

by Oscar-Williams

Evidence-first attention supervision for DeepSeek Harness with C0–C3 policy, deduplicated Inbox alerts, quiet hours, and redacted outcome records.

Notifications & IntegrationsManifest valid

★ 182

↓ 577/wk

MIT

TypeScript

Nov 4, 2026

dsh plugin --profile web add dsh-deepcanary

by Yuuyuko-uu

通到 QQ:DSH 里的 AI 伙伴和 QQ 双向互通 —— 它说完话自动发到 QQ,你在 QQ 说的话自动转进 DSH(走 OneBot 11 HTTP,NapCat / SnowLuma 都行)

Notifications & IntegrationsDevelopment & InfrastructureManifest valid

★ 181

↓ 3.4k/wk

NOASSERTION

JavaScript

Nov 15, 2026

dsh plugin --profile web add dsh-qq-link

by Yuuyuko-uu

通到 QQ:DSH 里的 AI 伙伴和 QQ 双向互通 —— 它说完话自动发到 QQ,你在 QQ 说的话自动转进 DSH(走 OneBot 11 HTTP,NapCat / SnowLuma 都行)

Notifications & IntegrationsDevelopment & InfrastructureManifest valid

★ 149

↓ 347/wk

MIT

JavaScript

Oct 31, 2026

dsh plugin --profile web add dsh-qq-bridge