消息通讯渠道适配

dsh-reminder

Aisland-SJL/dsh-reminder

🔔 Cross-window completion & approval notifications for DeepSeek Harness — popup reminders that bring you back to DSH, Codex/WorkBuddy style.

查看仓库

Stars: 12
Forks: 1
Issues: 0
更新: 1 天前

PROJECT TOPICS

项目标签

agent deepseek deepseek-harness dsh dsh-plugin notification productivity web-gui

INSTALL REFERENCE

安装参考

未验证

dsh plugin --profile web add github:Aisland-SJL/dsh-reminder

在 DSH 中安装

该命令指向仓库当前默认分支；尚无绑定当前 commit 的完整验证结果。

PROJECT README

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

CLASSIFICATION EVIDENCE

分类依据

项目类型渠道适配

功能分类消息通讯

规则置信度高

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中： notification、productivity。