Aisland-SJL/dsh-reminder 预览 preview

Aisland-SJL/dsh-reminder

🔔 为 DeepSeek Harness 提供跨窗口补全与审批通知——弹出式提醒,以 Codex/WorkBuddy 风格将你带回 DSH。

Project Overview项目介绍

dsh-reminder is a native notification plugin built exclusively for DeepSeek Harness. It delivers cross-window pop-up notifications when an agent task completes or is waiting for user approval, so you don’t miss status updates while working in other applications. To install the plugin, you can run the DSH CLI command dsh plugin --profile web add dsh-reminder, or install it via npm then manually register it in your DSH profile bundle list, then restart the DSH web process to activate it. After activation, you can go to the DSH settings menu to grant notification permission and test that notifications work correctly before you start using it.

This plugin is designed for DSH users who regularly switch between multiple windows and applications during their workflow. If you often step away from the DSH window to work on other tasks, you no longer have to check back periodically to see if the agent needs approval or has finished its work. When a notification pops up, you can just click it to immediately focus the DSH window and jump directly to the relevant session. Notifications are automatically dismissed after 3 to 5 seconds by default, but this duration can be adjusted in the plugin settings to match your preference, and notifications are deduplicated to avoid duplicate alerts.

dsh-reminder is released under the permissive MIT license, so it is free to use and modify for any purpose. There are a few known limits you should be aware of before first use: Chrome does not support action buttons on page notifications, so you can only dismiss notifications via auto-close or the hover close button. Due to browser autoplay and permission policies, notification permission must be granted via a user gesture, which the plugin handles with a single click in the settings menu, and the audio chime unlocks after your first click.

这是一款专为 DeepSeek Harness 开发的原生提醒插件,当代理任务完成或等待用户审批时,会在用户当前任何活动窗口弹出通知提醒,避免用户错过任务状态变更。用户可通过 DSH CLI 执行 dsh plugin --profile web add dsh-reminder 安装,也可通过 npm 安装后在配置文件中手动注册该插件,完成后重启 DSH 网页进程即可启用。

这款插件适合需要多窗口切换工作的 DSH 用户,在用户切换到其他窗口处理其他任务时,不会错过 DSH 代理的任务状态更新。典型工作流程是:用户安装启用后,即可切换到其他窗口工作,插件会在任务完成或等待审批时自动弹出提醒,点击提醒即可直接切回 DSH 窗口打开对应会话。

该插件采用 MIT 许可证开源免费使用,存在几个已知限制:受浏览器策略影响,通知权限需要用户手动点击设置按钮授权,首次使用需要在设置页面开启通知权限并测试。Chrome 页面通知不支持快捷操作,仅能通过自动关闭或悬浮关闭按钮关闭提醒。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 19 stars - an early-stage project星标 19,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

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

把 Aisland-SJL/dsh-reminder 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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 <dsh-reminder> (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

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev awesome-deepseek-harness 下一个 Next dsh-routing-suite →