dsh-macos-notify
DeepSeek Harness 的原生 macOS 通知和可配置声音
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:CrombastiC/dsh-macos-notify#48b1236de090e193434337545a3d7a26038c09f1Macos Notify 以 dsh-macos-notify 发布，当前版本为 0.4.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Native macOS notifications for DeepSeek Harness, with event-specific sounds, notification filtering, multi-task coalescing, and a first-level settings page in the DSH Web UI.
~/Library/Sounds.web profileInstall the published npm package:
npx -y @deepseek-ai/dsh plugin --profile web add dsh-macos-notify
npx -y @deepseek-ai/dsh web
Alternatively, install the latest source directly from GitHub:
npx -y @deepseek-ai/dsh plugin --profile web add github:CrombastiC/dsh-macos-notify
Then open Settings → macOS notifications from the first-level settings navigation.
To remove the plugin:
npx -y @deepseek-ai/dsh plugin --profile web remove dsh-macos-notify
From this repository checkout:
npx -y @deepseek-ai/dsh plugin --profile web add .
npx -y @deepseek-ai/dsh web
dsh plugin anchors relative paths to the invoking directory and forwards the install to pnpm in the selected profile. Avoid absolute-path bundle overlays in cordis.dev.yml; install the local package through plugin add instead.
The settings namespace is macos-notify. Values changed from the Web card apply live.
| Option | Default | Description |
|---|---|---|
onCompleted | true | Notify when a turn completes normally. |
onError | true | Notify for errors and blocked turns. These alerts bypass completion gates and digesting. |
onAborted | false | Notify when a user aborts a turn. |
onApproval | true | Notify immediately when a tool waits for approval. |
minDurationSec | 30 | Suppress completed-turn notifications shorter than this many seconds; 0 disables the threshold. |
onlyWhenIdleSec | 0 | Require this many seconds of keyboard/mouse idle time for completed notifications; 0 disables idle gating. |
onlyWhenUnfocused | true | Suppress completed notifications while any DSH Web tab is focused. |
digestMinutes | 0 | Collect completed notifications into a periodic digest; 0 sends them immediately. |
includeSubagents | false | Include subagent sessions instead of notifying only for top-level sessions. |
channel | auto | auto, osascript, or osc9. |
sounds.completed | Glass | Sound for completed turns. |
sounds.error | Basso | Sound for errors, blocked turns, and rate limits. |
sounds.aborted | empty | Sound for aborted turns; empty means silent. |
sounds.approval | Ping | Sound for approval requests. |
coalesceMs | 1500 | Window for merging simultaneous turn results; disables merging. |
mute — suppress every notification under the configured project path.errors — allow only errors, blocked events, and approval requests.important — bypass minimum-duration, focus, idle, quiet-hour, and temporary-pause filters.The settings page keeps the last 50 decisions, the duplicate-error cooldown state, and recent session titles, persisted to ~/Library/Application Support/dsh-macos-notify/state.json so they survive DSH restarts. Each row records whether an event was sent, queued, suppressed, or failed and includes the reason. This history does not contain message content.
auto uses OSC 9 when the terminal is recognized as supporting it, and falls back to osascript otherwise.
Recognized OSC 9 terminals include iTerm2, WezTerm, Kitty, Ghostty, and Warp. tmux sessions are wrapped in DCS passthrough automatically.
Sound selection applies to the osascript channel. With OSC 9, the terminal controls whether and how a notification sound is played.
In the settings page, select Edit → Import sound. Supported inputs include AAC, AIFF, CAF, FLAC, M4A, MP3, OGG, Opus, and WAV.
The host validates the extension, decoded size, converted duration, managed-file count, and total managed size before writing anything to the user sound directory. Imports are converted to 44.1 kHz mono AIFF using macOS afconvert, with ffmpeg as a fallback for formats that afconvert cannot decode. Existing files are never overwritten; a numeric suffix is added instead.
New imports are recorded in ~/Library/Application Support/dsh-macos-notify/sounds.json and can be deleted from the settings page. If a sound is currently selected, deletion asks for confirmation and changes affected events to silent. Files remain in ~/Library/Sounds if the plugin is removed without deleting them first.
osascript, and custom import uses macOS audio tooling./macos-notify RPC channel because the current DSH Web settings proxy has a namespace allowlist for built-in settings.~/Library/Sounds manually.The package is intentionally build-free:
index.js — host plugin, event handling, notification delivery, settings RPC, and sound import.client.js — hand-written DSH client module for focus reporting and the first-level Web settings page.src/policy.js — pure policy helpers (quiet hours, project rules, duplicate merging) covered by unit tests.src/state.js — validated, atomic persistence for diagnostics, duplicate state, and session titles.cordis.patch.yml — profile bundle patch.Run the release checks:
node --check index.js
node --check client.js
npm test
npm pack --dry-run
这是一个仅支持 macOS 的 DeepSeek Harness 通知插件。它可以在任务完成、出错、等待审批时发送系统通知，并支持通知诊断（跨重启持久化）、afplay 本地试听、测试矩阵、每日勿扰、自定义时长的临时暂停、自定义声音管理与导入指派、常用开关即时保存、重复错误抑制、项目路径自动补全、焦点抑制、合并通知和定时汇总。推荐从 npm 安装，也可以直接从 GitHub 安装最新版源码。
MIT © 2026 CrombastiC
0quietHoursEnabled | false | Enable the daily local-time quiet period. |
quietStart | 23:00 | Quiet-period start in local HH:mm time. |
quietEnd | 08:00 | Quiet-period end in local HH:mm time. Overnight ranges are supported. |
quietAllowCritical | true | Continue sending error, blocked, and approval alerts during quiet hours. |
pauseUntil | 0 | Temporary pause deadline as Unix milliseconds; managed by quick actions in the Web card. |
duplicateWindowSec | 300 | Suppress identical errors from the same session within this window; 0 disables it. |
projectRulesJson | [] | Project rules managed by the Web card. More-specific descendant paths win. |