cc-dsh-notifier
Claude Code + DeepSeek Harness Windows 通知系统：Toast + 点击跳转
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:baobaolaodie/cc-dsh-notifier#8f93b37759d6a057062c4f1c2abce1ec6a6bd61dCc Dsh Notifier 以 cc-dsh-notifier 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Windows desktop notifications for Claude Code and DeepSeek Harness sessions
Permission requests · Questions · Waiting for input · Click-to-return
English · 中文
cc-dsh-notifier raises a native Windows toast with sound when an agent needs your attention and you are not looking at its window. It serves Claude Code through its hook system and DeepSeek Harness through a small bundle plugin, sharing one daemon pipeline. Clicking a toast returns you to the session window. Zero third-party npm dependencies.
| Feature | Description |
|---|---|
| Interruption events | Notifies on permission requests, questions, and waiting for input |
| Focus awareness | Suppresses notifications while the session window is focused; notifies only when it is not |
| Click-to-return | SetForegroundWindow targets the session window; browser tabs activate via CDP, with a UIA fallback |
| Multi-session | Each session binds its own window handle; toasts carry the session identity |
| Localized notifications | Toast text follows the Windows display language (auto) or a language setting (zh/en) |
| DeepSeek Harness | The dsh-notifier plugin covers web and tui profiles with one install |
pip install winrt-runtime winrt-Windows.UI.Notifications winrt-Windows.Data.Xml.Domnode scripts/install.mjs
The installer backs up ~/.claude/settings.json, injects five hooks, registers the cc-notifier AppUserModelID, and writes the default config. Open a new Claude Code session afterwards.
Recommended — download the tarball from the latest release and install it (no repository clone, no credentials):
dsh plugin --profile web add ./baobaolaodie-cc-dsh-notifier-0.1.5.tgz
dsh plugin --profile dsh-tui add ./baobaolaodie-cc-dsh-notifier-0.1.5.tgz
版本说明 / Version note: 顶部徽章
0.1.2是 root 包版本;上方 tarball 名0.1.5是 dsh 插件包版本,两者是两个独立的发布单元(en: top badge = root package, tarball = dsh plugin; independent release units). Alternative — git install (clones the whole repository, zero config):
dsh plugin --profile web add github:baobaolaodie/cc-dsh-notifier
dsh plugin --profile dsh-tui add github:baobaolaodie/cc-dsh-notifier
GitHub Packages (
@baobaolaodie/cc-dsh-notifier) exists as a maintainer convenience channel only: GitHub Packages' npm registry always requires aread:packagestoken for downloads, even for public packages (verified). Use the tarball or git install instead.
Verified against dsh 0.1.0-rc.6 on Windows 11 (2026-08-16): web and tui profiles, permission/question/waiting-for-input notifications, focus-aware silence, click-to-return, and the tarball install flow.
dsh-TUI · A Windows toast notifier plugin in the dsh-TUI ecosystem.
npm test
Start a session and switch away. The system notifies when Claude requests a permission, asks a question, or finishes a turn.
claude
# switch to another window; toasts appear when Claude needs you
The plugin forwards dsh session events into the same pipeline. Web sessions bind to the browser window; tui sessions bind to the terminal window:
dsh web # or: dsh --profile web
dsh-tui # or: dsh --profile dsh-tui
node scripts/test.mjs permission-request # permission-request | ask-user-question | stop | session-start
Toasts are suppressed while the target window is focused, so switch away to observe them.
Edit ~/.cc-notifier/config.json (created on install):
| Key | Default | Description |
|---|---|---|
enabled | true | Set to false to disable notifications globally |
dedupWindowMs | 0 | Deduplication window (ms); 0 = no dedup; >0 merges per session+type |
pythonPath | empty | Absolute path of the toast interpreter (written by the installer); empty = python from PATH |
pollIntervalMs | 10000 | Daemon window-poll period (ms) |
windowWhitelist | [] | Browser process whitelist for dsh web binding/focus (e.g. chrome.exe/msedge.exe) |
sound | true | Set to false to mute toast sound |
language | auto | Toast language: auto (system display language, zh-*→zh, en-*→en, other/failure→en), zh, or en |
An event-driven pipeline runs only while sessions are active. Claude Code hooks and the dsh plugin both produce the same normalized payloads; a resident daemon decides whether to notify, and a Python agent shows the toast:
%%{init: {'theme': 'base', 'themeVariables': {'fontSize': '14px'}}}%%
flowchart LR
CC["Claude Code<br/>hooks"] --> NA["notify-agent.mjs<br/>forwarder"]
DSH["dsh-notifier<br/>plugin · web/tui"] --> NA
NA -->|"HTTP · localhost"| DM["daemon.mjs<br/>sessions · focus · lifecycle"]
DM --> TA["toast-agent.py<br/>winrt toast"]
TA -->|"click"| WIN["session window<br/>SetForegroundWindow · CDP/UIA tab"]
DM --> ST[("state · logs<br/>%LOCALAPPDATA%")]
classDef client fill:#3B82F6,stroke:#2563EB,color:#fff,stroke-width:2px
classDef service fill:#10B981,stroke:#059669,color:#fff,stroke-width:2px
classDef data fill:#8B5CF6,stroke:#7C3AED,color:#fff,stroke-width:2px
class CC,DSH,WIN client
class NA,DM,TA service
class ST data
The daemon is single-instance: it wakes on demand, exits after 60 seconds of no sessions, and self-restarts when its code changes. Sessions re-register automatically after a daemon restart.
├── scripts/ # Runtime pipeline
│ ├── notify-agent.mjs # Hook forwarder (Claude Code)
│ ├── daemon.mjs # Resident process: sessions, focus, dedup
│ ├── toast-agent.py # Python winrt toast + click handling
│ └── lib/ # Shared modules, win32 bridge, CDP/UIA helpers
├── plugins/
│ └── dsh-notifier/ # dsh bundle plugin (web + tui profiles)
├── test/ # node:test suite (explicit file list)
├── docs/ # Installation, usage, troubleshooting (bilingual)
├── dsh-plugin.json # dsh-ecosystem-spec Community v0.15 declaration manifest
└── package.json # Zero runtime dependencies
| Layer | Technology | Purpose |
|---|---|---|
| Runtime | Node.js 18+ (ESM) | Forwarder, daemon, plugin |
| Notifications | Python 3 + winrt | Windows toast rendering and activation |
| Window bridge | PowerShell 5.1 + C# helpers | Window enumeration, foreground query, CDP/UIA tab activation |
| Testing | node:test | Unit + integration tests |
CI runs on GitHub Actions (test × 6 matrix across Node 18/20/22 on Ubuntu and Windows, plus quality, pr-policy, docs-links, and a summary job). See .github/workflows/ci.yml.
git checkout -b feature/your-change)feat:, fix:, docs:, …)PRs must pass the full CI suite, including the bilingual documentation mirror check and version consistency checks. See CONTRIBUTING.md.