dsh-reminder

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-03），介绍文案由本站再加工。

以下为插件仓库 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.

[图片: Toast preview]

---

## ✨ 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

1. **Install**: `dsh plugin --profile web add ` (or `npm i dsh-reminder`), register `dsh-reminder` in the profile bundle list, restart the DSH web process
2. **Grant permission**: Settings → Reminders → "Enable & test notifications" → Allow — a test popup arrives instantly
3. **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

```bash
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](LICENSE)