DSH Dock 跳动提醒（dsh-dock-attention）

DeepSeek Harness 插件（macOS）：会话一轮任务结束时，让 Dock 里跳出一个带 DSH 图标的提醒图块；点击图块回到 Harness。

为什么不是 DSH 本体图标在跳：Dock API 属于 Electron 主进程，插件进程够不到，macOS 也不允许跨进程让别的应用图块跳动。插件附带一个原生小应用「DSH Attention」，它拥有自己的 Dock 图块，运行时采用本机 DSH 应用的图标，所以看起来就是 DSH 图标在跳。

行为

• 默认任何会话的一轮任务结束都提醒（完成 / 失败 / 被阻止 / 超 token）。
• 你不在看 DSH：持续跳，直到切回 DSH、点击图块或超时（默认 30 秒）。
• 你正在看 DSH：跳 4 下（约 5 秒）后自动消失。
• 子智能体会话、用户取消/中断的轮次、3 秒内重复的事件不会提醒。
• 手动测试：在输入框输入 /dock-attention。

安装

dsh plugin --profile desktop add "github:ClintHwang/dsh-dock-attention"

仓库：https://github.com/ClintHwang/dsh-dock-attention。仅支持 macOS；不需要辅助功能、录屏或通知权限。

配置

在 profile 对应插件行的 config 里覆盖（改完重装 bundle 生效）：

字段	默认	说明
skipWhenActive	false	true = 安静模式，只在 DSH 不在前台时提醒
bounceOnTurnEnd	true	一轮任务结束时提醒
bounceOnApproval / bounceOnQuestion	false	等待审批 / 智能体提问时也提醒
repeatCount	4	前台提醒的跳动次数（1–20）
timeoutSeconds	30	后台提醒最长持续时间（3–300）
minIntervalSeconds	3	两次提醒之间的防抖（0–120）
sound	null	系统声音名（如 Glass）或音频文件路径
mode / includeSubagents / targetBundleId	critical / false / com.deepseek.dsh	一般不用改

限制

• 跳的是临时提醒图块，不是 DSH 本体图块（见上）。
• Dock 设为「自动隐藏」或开启「减少动态效果」时，可能看不到或动画被抑制。
• 提醒活跃的几秒内，helper 会短暂出现在 Dock 与 Cmd+Tab。

开发

node --test                  # 单测
node tools/self-check.mjs    # 启动 helper，观察 Dock 图块出现/退出
bash tools/build-helper.sh   # 改 src/helper/main.swift 后重新编译

本机开发安装用 plugin_manager 的 link: 方式；发布/上架流程见 PUBLISHING.md。

许可

MIT。原生 helper 的思路与初版来自 ihodorchenko/dsh-dock-attention；许可证见 LICENSE。