dsh-popup-cards
始终置顶的 DSH 风格 Windows 卡片，用于显示 DeepSeek Harness 的审批、问题和已完成运行——点击可跳回启动会话的应用（默认为 DSH），点击 × 按钮关闭，或在您返回时自动关闭。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Leo1958923515/dsh-popup-cards#6935be6cdf1baa8511d5c101e2d91fa9b2349e6c
Popup Cards 以 dsh-popup-cards 发布，当前版本为 0.1.6。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Topmost Windows cards that tell you when DeepSeek Harness needs you — while you are looking at another app.
When a tool asks for permission, the model asks a question, a plan waits for review, or a run finishes, a small card appears in the bottom-right corner of your screen. It looks like the DeepSeek Harness client (dark panel, 12 px radius), stays until you deal with it, and never blocks the agent turn.
Popup card in the bottom-right corner
DeepSeek Harness already shows approvals and questions in its own window. That is useless when you are editing code in another app, reading a browser tab, or waiting for a long build. This plugin brings that moment to your desktop with a card that survives window switching, and lets you jump straight back:
The card itself only carries two facts, by design: which task and what kind of confirmation it is. No message bodies, no tool arguments, no code.
Requirements: Windows 10/11, PowerShell 5.1 (bundled with Windows), DeepSeek Harness >= 0.2.1-rc.2.
Desktop app (recommended). Settings → Plugins → Install, and paste the repository URL:
https://github.com/Leo1958923515/dsh-popup-cards
Command line. From the profile directory (the desktop profile is managed by the app):
dsh plugin --profile desktop add https://github.com/Leo1958923515/dsh-popup-cards
Local checkout.
dsh plugin --profile desktop add link:D:\path\to\dsh-popup-cards
The plugin loads immediately after installation — DSH hot-reloads profile patch files, so no restart is needed.
Naming: the repository and the plugin package are both
dsh-popup-cards, and the package name matchesname:incordis.patch.yml. Install from the URL above; the directory name of a local checkout does not matter.
Windows only. On other platforms the plugin loads but silently skips popups (a warning is written to the DSH log).
Everything is optional. Add overrides to your profile's cordis.patch.yml — the object replaces the defaults, so repeat any key you still want:
- id: popup-notify
config:
sound: true
durationMs: 8000
hintText: '点击回到 DSH'
| Key | Default | Meaning |
|---|---|---|
notifyOnApproval | true | Pop when a tool waits for permission. |
notifyOnQuestion | true | Pop when the model asks a question or submits a plan for review. |
notifyOnComplete | true | Pop when a root agent goes from running to idle. |
ignoreSubagents | true | Stay quiet for sub-agents, background delegations and workflow workers. |
skipWhenDSHFocused | true | Skip the card while DSH (or the client that started the session) is in the foreground. |
dshWindowTitleMarker | — DeepSeek Harness | Title fallback: a matching window title also counts as DSH. |
attributeByClient | true | Remember which client started each session (foreground process name) and stay quiet while it is in front. |
clientProcesses | [] | Client process names that take part in attribution, e.g. ['Obsidian.exe']; DSH itself must not be listed. |
activateDSHOnClick | true | Clicking the card brings the session's client to the front before closing. |
autoCloseOnDSHFocus | true | Close the card when you return to the session's client (or DSH) on your own. |
foregroundPollMs | 400 | Foreground check interval while a card is open (clamped to 100–2000). |
sound | false | Play the Windows Asterisk sound when a card opens. |
durationMs | 0 | Auto-close after N ms; 0 keeps the card until you click it. |
hintText | 点击回到 DSH | Small third line; set to '' to hide it. |
- id: popup-notify
config:
testOnStart: true
Reload the profile and one card appears immediately. The self-test card skips the foreground suppression and never auto-closes, so you can inspect it; click it (or the ×) to dismiss. Set testOnStart: false to stop.
The card is a borderless, always-on-top WPF window hosted by a short-lived powershell.exe (hidden, -NonInteractive, script passed via -EncodedCommand). It is positioned 24 px above the bottom-right corner of the primary display's work area, so it never covers the taskbar, and it fades in over 160 ms.
Foreground detection is primarily process based, with the window title only as a fallback: every time you send a message (root agent enters running) the plugin records the foreground window's process name against that session, and the card compares DeepSeek Harness.exe first, then that session's client process (e.g. Obsidian.exe). A title match still suppresses the card when the process name cannot be read.
The plugin listens to three Cordis events and never replaces DSH's own UI:
| Event | What it means |
|---|---|
approval/request (waterfall) | A tool needs your approval. Registered with prepend and always calls next(), so the built-in bridge still answers it. |
tools/pre-execute (waterfall) | ask_user_question → "question", exit_plan_mode → "plan review". Always calls next(), so the tool still runs. |
agent/status | running → idle for a root agent → "run finished"; the running edge also records the session's client attribution. |
The first line of the card is the session title (ctx.get('sessionTitle')), falling back to the working-directory name, then to the first 8 characters of the session id.
powershell.exe), which ships with Windows.>= 0.2.1-rc.2.running edge. Switching windows while the run is in progress does not change it, but messages forwarded from a browser (or sent while the foreground is something else) fall back to the DSH-only rule — such an unattributed card stays quiet while the DSH window is in front, even if the run was started elsewhere. dshWindowTitleMarker remains a title fallback.Add-Type/WPF (a few hundred milliseconds); cards are serialized, so bursts queue instead of racing.npm test # node --test: pure functions + config/metadata checks
npm run pack:check
The test suite runs without Windows: it asserts the generated PowerShell script contains the expected gates and handlers, and checks locale/manifest metadata. Actually rendering a card needs Windows + PowerShell.
Report bugs: https://github.com/Leo1958923515/dsh-popup-cards/issues.
This project is based on dsh-popup-notify by yiumanlenong (MIT). The upstream copyright notice is kept in LICENSE; the card UI, the interaction model and the fixes listed in CHANGELOG.md were added here.
completeCooldownMs | 10000 | Minimum gap between two "run finished" cards for the same session. |
title | DeepSeek Harness | Task name used by the self-test card. |
testOnStart | false | Pop one card on load to prove the PowerShell path works. |
traceFile | '' | Append diagnostics (why a card opened, skipped, closed) to this file. |