Herald v1.0.1 — 双语文档 · 官方 DSH 标识 · 真实通知截图

What''s new in 1.0.1

• Bilingual READMEs — README.md (EN) + README.zh.md (ZH) with the cross-linked language bar, following the official dsh documentation convention
• Official dsh branding — the official powered by dsh badge (per the DSH brand guidelines), plus npm / tests / license shields
• Official community-plugin manifests — dsh.inventory bilingual hover card + dsh.origin (opensource · customized · upstream) so Herald classifies itself correctly in the DSH plugin inventory
• Notification showcase images — the host-direct OS toast and in-page toasts rendered with real payloads on a privacy-clean backdrop
• npm packaging — dsh plugin add dsh-herald documented as the recommended route - now live: https://www.npmjs.com/package/dsh-herald

Full v1.0.0 story: tri-channel delivery, host-direct OS toasts that survive a closed browser, premium bilingual panel, persistent history, 108 tests, and two upstream bug fixes (inject deadlock + gateway parameter dispatch). See the CHANGELOG.

Herald v1.0.0 — 传令官已就位

Herald v1.0.0 — 传令官已就位

Tri-channel task notifications for DeepSeek Harness — an independent, deeply customized descendant of kaotusi/dsh-task-notify (MIT).

Why

DSH runs long agent turns, background jobs, subagents and workflows. The original plugin notified through the browser's Notification API — which silently dies when the page is hidden, throttled, or the browser is closed. Herald fixes the delivery architecture itself: the host process raises OS notifications directly (PowerShell WinRT / osascript / notify-send). Browser open, hidden, or fully closed — the toast still lands.

Highlights

• 🔔 Tri-channel model — three independently switchable channels, each with its own test button:
  • A In-browser alerts (toasts + chimes, per-browser switch)
  • B Browser OS banners (per-browser switch; auto-standby while the host delivers — never double banners)
  • C Host-direct OS toasts (host-persisted switch, works headless; DSH_TASK_NOTIFY_OS env lock for ops)
• 🛡️ Anti-bombardment: serialized spawns, burst coalescing into summary toasts (approvals exempt), timeout kill + retry; base64(UTF-16LE) text transport — zero injection surface
• 🎨 Premium panel: card-based channel settings, status-dot health strip, segmented theme control, bilingual 中/EN
• 💾 Persistent history + host-side settings under <profile>/data/task-notify/ (survives reinstalls and the package rename)
• ⚡ Incremental sync (pullSince change feed) with adaptive polling
• 🧪 108 tests (virtual-clock adapter suite, channel quadrants, RPC wire-shape contracts)

Upstream bugs found & fixed

• web-composition inject deadlock (plugin never mounts; loader tree never settles)
• gateway positional-parameter dispatch mismatch — silently degraded incremental pulls (every round was a full reset), cross-tab acks (silent no-ops), and settings writes (bounced back)

Full history in CHANGELOG.md.

Install

dsh plugin --profile web add git+https://github.com/bululuburuarua666/dsh-herald.git

Manual install and upstream-migration notes in the README. The attached dsh-herald-1.0.0.zip is a ready-to-copy package for offline installs.

Credits

Upstream by kaotusi (MIT). Herald's architecture, tri-channel model and UI by @bululuburuarua666. MIT, dual attribution.