DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-desktop-notify

x

dsh-desktop-notify

Manifest valid★ 2

Windows desktop popup alerts for DeepSeek Harness: a chat-style card when a turn finishes or the Harness waits for you.

hasBundlePatch

桌面弹窗提醒(dsh-desktop-notify)

English | 简体中文

DSH 窗口被最小化、被别的窗口盖住、或者你正在别的程序里时,任务结束或需要你介入的那一刻, 屏幕右下角会浮起一张小卡片——就是聊天软件收到消息时的那种提示。

卡片预览

什么时候弹

时机触发来源卡片
一轮正常结束turn/end: completed绿色竖条 ·「✓ 任务完成」
一轮出错turn/end: error红色竖条 ·「!任务出错」
输出被截断 / 被阻止 / 会话中断 / 被中止对应的 turn/end 原因灰色竖条
工具等待你授权approval/request琥珀竖条 ·「⚠ 需要你的确认」,正文带工具名与原因
Agent 向你提问user-questions/request琥珀竖条 ·「?需要你回答」,正文带问题

完成卡片显示这一轮最后一段回复(截断为一行),出错卡片显示错误码或错误信息, 底部显示会话标题与实际耗时。

什么时候不弹

  • 前台窗口属于 DeepSeek Harness:你正看着它,不需要提醒。这项检查在渲染之前完成, 此时只是短暂启动一个 PowerShell 进程后立刻退出,屏幕上不会闪任何东西。
  • 子代理(subagent)会话的回合结束,避免一次任务弹出一串提示。
  • 你自己点停的那一轮(中止原因为 user)。
  • enabled 关闭,或当前不是 Windows。

卡片行为

  • 固定在主屏右下角,始终置顶,不抢焦点,不出现在 Alt+Tab 和任务栏里,不影响你正在打的字。
  • 从屏幕右侧滑入(约 220ms,缓出曲线),animate: false 可变成原地出现。
  • 显示后会把自己推到置顶窗口队列的最前面,并在卡片存活期间每 0.8 秒重申一次, 所以别的窗口(包括同样置顶的窗口)后激活也压不住它。真正全屏独占的程序(部分游戏)无法覆盖。
  • 完成卡片默认停留 12 秒,等待你操作的卡片停留 24 秒,然后自己消失。
  • 右上角的 ✕:只关闭卡片,不切换窗口;鼠标移上去会高亮并变成手型光标。
  • 单击卡片其他位置:关闭卡片并把 Harness 窗口叫回前台(最小化会自动还原)。
  • 新卡片会替换上一张,不会叠成一摞。
  • 颜色跟随 Windows 的浅色/深色设置,用绿、琥珀、红、灰四种竖条区分结果。
  • 默认播放系统提示音(完成、等待、出错各用一种),silent: true 可关。

配置

在 cordis.patch.yml 里改 desktop-notify 这一行的 config:

键默认值说明
enabledtrue总开关
notifyOnTurnEndtrue任务完成时提醒
notifyOnErrortrue任务出错时提醒
notifyOnApprovaltrue需要授权时提醒
notifyOnQuestiontrue需要回答时提醒
notifyWhenFocusedfalse窗口在前台也提醒;仅用于检查卡片长什么样
silentfalse不播放提示音
animatetrue从右侧滑入;设为 false 则原地出现
cardDurationMs12000完成卡片停留时长(毫秒)
waitingDurationMs24000等待你操作的卡片停留时长(毫秒)
summaryChars90正文摘要最大字数
appProcessNameDeepSeek Harness判定「窗口在前台」用的进程名
languagezh卡片文案语言,zh 或 en
logFile空写入卡片诊断日志的路径,排错时用

为什么不是系统通知中心的通知

Windows 的 toast 接口要求调用进程有「程序包身份」,普通桌面进程调用会失败并返回 0x80073D54。所以这里用 PowerShell + WinForms 自己画一张卡片:任何 Windows 10/11 都能显示, 外观也完全可控。代价是通知不会留在通知中心,关掉就没了。

排错

每次调用都会在 %TEMP%\dsh-desktop-notify.log 留一行记录(超过 200 KB 自动重来),用它可以分清三种情况:

  • invoked ... —— 插件确实触发了;
  • foreground=... name=DeepSeek Harness 加 skipped: harness window is foreground —— 窗口在前台,按设计不打扰;
  • showing card ... painted —— 卡片已经画出来了;
  • raised to top ok=True style=... topmost=True —— 卡片确实在置顶层(topmost=False 说明没进置顶层,会被普通窗口压住);
  • bounds=... above us: [...] —— 卡片位置和压在它上面的窗口,排查遮挡时看这一行。

想固定日志位置就把配置里的 logFile 指向一个路径。

已知限制

  • 仅 Windows;其他平台插件保持静默。
  • 卡片只出现在主屏右下角。
  • 卡片由一次性 PowerShell 进程绘制,事件到出现之间约有 0.3–0.6 秒延迟,并在显示期间保留该进程。
  • 回复过长时正文只显示前四行。
  • 停用插件后立即不再提醒;已经显示的卡片不受影响,会在超时后消失。

English

A Windows-only DeepSeek Harness plugin: when a turn finishes, fails, or the Harness is waiting for your approval or answer while its window is not in front, a small card slides into the bottom-right corner of the primary screen — the same pattern chat apps use for incoming messages.

Card preview

Install

In the Web GUI open Plugins → Add plugin, enter the Git address github:xiaoweiqianluo/dsh-desktop-notify (or clone the repository and give its absolute path), then enable Desktop popup alerts in the plugin list.

Or from a shell with the dsh CLI available:

dsh plugin --profile desktop add github:xiaoweiqianluo/dsh-desktop-notify

No dependencies, no build step: the bundle is plain ES module JavaScript plus one PowerShell script. It needs Windows 10/11 with Windows PowerShell 5.1 (installed by default).

When it appears

MomentSourceCard
A turn completedturn/end: completedGreen bar · "✓ Task finished"
A turn failedturn/end: errorRed bar · "! Task failed"
Output truncated / blocked / interrupted / stoppedthe matching turn/end reasonGrey bar
A tool waits for authorizationapproval/requestAmber bar · "⚠ Your confirmation is needed"
The agent asks a questionuser-questions/requestAmber bar · "? Your answer is needed"

It stays silent when the foreground window belongs to the Harness (you are already looking at it), for subagent sessions, and for turns you stopped yourself.

Card behavior

  • Always on top of the topmost band, never takes focus, never shows in Alt+Tab or the taskbar.
  • Slides in from the right (~220 ms, ease-out); animate: false shows it in place.
  • The ✕ in the top-right corner closes the card without switching windows; hovering highlights it.
  • Clicking anywhere else closes the card and brings the Harness window back (restoring it if minimized).
  • The ✕/click split, per-kind accent colours and fonts are drawn with WinForms and follow the Windows light/dark setting. Completion cards live 12 s, waiting cards 24 s.

Configuration

Edit the desktop-notify row in cordis.patch.yml:

KeyDefaultMeaning
enabledtrueMaster switch
notifyOnTurnEndtrueCard when a turn completes
notifyOnErrortrueCard when a turn fails
notifyOnApprovaltrueCard when an authorization is pending
notifyOnQuestiontrueCard when the agent asks a question
notifyWhenFocusedfalseAlso alert while focused; for inspecting the card
silentfalseNo system sound
animatetrueSlide in from the right
cardDurationMs12000Completion card lifetime
waitingDurationMs24000Waiting card lifetime
summaryChars90Maximum preview characters
appProcessNameDeepSeek HarnessProcess name treated as "window in front"
languagezhCard copy language, zh or en
logFileemptyOptional diagnostics log path

Why not a Windows toast

The toast API requires package identity; an ordinary desktop process calling it fails with 0x80073D54. This plugin draws its own card with PowerShell and WinForms instead, which works on every Windows 10/11 installation and keeps the appearance under control. The trade-off: notifications are not kept in the Action Center.

Known limitations

  • Windows only; the plugin stays silent elsewhere.
  • The card only appears on the primary screen.
  • A one-shot PowerShell process draws the card: expect 0.3–0.6 s between event and appearance.
  • A long reply is clamped to four lines.
  • A card already on screen closes on its timeout after the plugin is disabled.

Comments

Loading…

From the same category

reactive-resume

DeepSeek Harness plugin for Reactive Resume: bridges your resumes and job applications into a Harness session over MCP.

Tools & CapabilitiesManifest valid

★ 41.7k

↓ 61/wk

MIT

Aug 24, 2026

dsh plugin --profile web add dsh-plugin-reactive-resume

by dsh-market

The plugin market inside DeepSeek Harness — browse, search, one-click install · DSH 可视化插件市场

Tools & CapabilitiesManifest valid

★ 12.8k

↓ 271k/wk

MIT

TypeScript

Nov 17, 2026

dsh plugin --profile web add dshmarket

by Tencent

Let AI agents use your real, logged-in browser without interrupting your work. CLI + extension for browser automation across any shell-capable AI agent.

Tools & CapabilitiesManifest valid

★ 10.5k

↓ 17k/wk

MIT

TypeScript

Nov 17, 2026

dsh plugin --profile terminal add @wxg-prc-cpg/browser-skill-dsh-plugin

by kingcharleslzy-ai

Community-maintained dsh-purge fork with host-policy patches, prompt and rule settings, diagnostics, separate update-check and install controls, and local backup/rollback.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 9.8k

MIT

JavaScript

Nov 17, 2026

dsh plugin --profile web add dsh-purge-community

by superdesigndev

OpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn

Tools & CapabilitiesManifest valid

★ 8.3k

NOASSERTION

Python

Nov 18, 2026

dsh plugin --profile web add treg-dsh

by yjh051108

dsh-routing-suite — injector + router-standard kit: install the runtime injector first, then the task-aware reasoning-mode router preset (measured P1-P23).

Tools & CapabilitiesManifest valid

★ 7k

MIT

JavaScript

Sep 18, 2026

dsh plugin --profile web add @dsh-external/dsh-super-injector