dsh-reminder

编辑精选维护状态: 活跃

aisland-sjl/dsh-reminder

跨窗口完成与审批通知弹窗，及时把你带回 DSH

前往 GitHub

$ dsh plugin add dsh-reminder

安装

dsh 没有统一的安装命令——把该插件 README（见下方）中的配置行加入你的 profile/patch 配置，然后重启即可。

了解安装方式

星标

Fork

TypeScript

语言

MIT

许可证

2026-08-16

创建于

2026-08-16

README

dsh-reminder 🔔
English · 简体中文

A cross-window reminder plugin for DeepSeek Harness — while you work in any other window, it taps you on the shoulder the moment a task finishes or waits for your approval. Codex / WorkBuddy style.

✨ Features

🎯	Feature	Description
🟢	Completion	Pops "Task completed" on every turn end, with session · duration and a green check icon
🟡	Approval	Pops "Waiting for your approval" with the tool name and an amber alert icon
🎯	Pops in any window	Notifies even while you work in other apps
🖱️	Click to return	Clicking focuses the DSH window and opens the session
⏱️	Auto-dismiss	Gone in 3-5 s (adjustable)
🎵	Soft chime	A gentle two-note chime (D4→A4) — nothing startling
🔁	Deduplicated	Never pops twice for the same event
🛡️	Reminds, never acts	Never approves on your behalf

🤔 Why

😴 Nobody calls you for approvals — the agent waits while you are away; now an amber popup tells you
👀 Nobody tells you it's done — no completion signal before; now a green popup tells you

🚀 Quick start

Install: dsh plugin --profile web add <dsh-reminder> (or npm i dsh-reminder), register dsh-reminder in the profile bundle list, restart the DSH web process
Grant permission: Settings → Reminders → "Enable & test notifications" → Allow — a test popup arrives instantly
Enjoy: Switch away and work — the popups come to you

⚙️ Settings

Setting	Default	Description
Notification permission	unset	One-click grant + test popup
Approval reminders	On	Off = no approval popups
Completion reminders	On	Off = no completion popups
Duration	3-5 s	Seconds before auto-dismiss
Failure alerts	Off (reserved)	Planned for v0.3

🏗️ Architecture

One package ships the host Cordis plugin and the web client:

host: registers the settings namespace plus a plugin-owned Typert Remote (reminder/getSettings · updateSettings) — plugin namespaces sit outside the web settings allowlist
client: subscribes to the session list and conversation snapshots (turn/end, approval/requested arrive over the mux stream), pops via the Notification API with a Web Audio chime
Read-only: never mutates DSH core behavior

🔧 Development

pnpm install
pnpm run typecheck   # tsc --noEmit
pnpm test            # node tests/unit/*.test.cjs (16 tests)
pnpm run build       # esbuild: host ESM + single-file client CJS (ModuleLoader handshake) + tsc d.ts

Artifacts: lib/index.js (host ESM), lib/client.js (client), lib/types/ (.d.ts)
Offline dev: no new dependencies; @deepseek-ai/* types and local esbuild/typescript come from 03_local/codes (not in git)

⚠️ Known limits

Chrome page notifications reject actions (ServiceWorker persistent notifications only) — dismiss via auto-close or the hover ✕
Permission must be requested from a user gesture (browser policy) — the settings button does it in one click
The chime unlocks on the first click (autoplay policy)

📄 License

MIT