前言¶
在 DeepSeek Harness（DSH）里让 agent 跑长任务时，常见做法是一边等一边反复切回窗口：怕它卡在审批、怕它在等你回答、又怕已经跑完你却不知道。DSH 生态里能力多以插件形式扩展；社区目录 SkillHub 与 GitHub 上的第三方仓库彼此独立，并不等同于 DeepSeek 或幻方的官方应用商店。下面介绍维护者 YE-ZINAN 的客户端插件 dsh-quiet（仓库 YE-ZINAN/dsh-quiet）：在你离开时替你「盯着」会话进展，只在真的需要你出手或整件事有了终态时才用任务栏闪烁叫你，其余通知攒起来，不打断你手上的事。
这是什么¶
dsh-quiet 是 DeepSeek Harness 桌面端插件（package.json 版本 1.0.1，MIT 许可证）。一句话定位：让 agent 在你离开时替你监控，只在卡住（要审批 / 要你回答）或有结果（目标达成、意外中断、回复被截断）时提醒你；中间某一步做完、一次正常回复结束这类进展不会来烦你。
提醒方式很克制：只闪 Windows 任务栏按钮，不弹系统通知、不出声、不抢焦点。插件以当前 DSH 进程权限运行；安装前建议自行查看仓库源码与许可证（NOTICE.md 说明 PowerShell 启动与本地写入等行为）。
平台限制（资料原文）：仅 Windows。 闪烁依赖 Win32 FlashWindowEx；窗口缩到托盘时闪不了；你人正在 DSH 前台时任务栏本就在亮，闪烁也看不出效果——插件设计假设「走开时」才需要闪。
核心功能：提醒分级与 /focus¶
插件把事件分成三级，专注块内的行为如下。
| 级别 | 含义 | 专注块内 |
|---|---|---|
| L0 卡住了 | 要你审批，或 agent 问你问题 | 穿透——立刻闪任务栏 |
| L1 有结果了 | 目标达成、意外中断、回复被截断 | 先攒着，专注结束或你主动结束时一起给 |
| L2 中间进展 | 某一步做完、一次回复正常结束 | 永不提醒 |
设计取向在 README 里写得很直白：审批是 fail-closed，不应答任务就停着，所以 L0 必须穿透；L2 不阻塞任何事，「收到一条通知」本身就会损害注意力任务表现，因此不可配成提醒。
日常使用围绕一条斜杠命令 /focus：
| 输入 | 行为 |
|---|---|
/focus |
开始专注块，默认 25 分钟 |
/focus 40 |
自定义时长（分钟） |
/focus 0 |
不定时，直到你说停 |
/focus off |
提前结束，并列出这段时间攒下的事 |
/focus status |
当前状态与攒下的事 |
/focus digest |
只看攒下的事 |
开始时会给出一段托管声明（大意：这段时间不用管 agent；被卡住会闪任务栏；其他进展攒着；到点再闪一次方便你过一遍攒下的事）。README 说明这不是文案装饰，而是帮你在心理上把「未完成的监控」换成一个具体计划，减轻悬而未决的干扰。
安装与启用¶
安装命令须使用资料原文，路径换成你本机 clone 或解压后的 dsh-quiet 绝对路径：
$env:DSH_HOME = "$env:USERPROFILE\.dsh"
dsh plugin --profile desktop add "link:<dsh-quiet 的绝对路径>" --registry=https://registry.npmmirror.com
装完会当场激活。若之后改了插件代码，需要完全退出并重开桌面客户端才加载新代码——关窗口可能只是最小化到托盘，注意真正退出。
重要警告（README 实测）： 不要在插件市场里「停用」本插件。桌面端停用意图会失败并约每 60 秒重试，反复重写 cordis.patch.yml，可能把该文件从约 13 KB 刷到约 661 B，导致 agent preset 与模型设置丢失。
配置¶
在 cordis.patch.yml 的 config 中调整（改完不热重载，需重启客户端）：
| 键 | 默认 | 说明 |
|---|---|---|
flash |
true |
总开关；关则只写日志、不闪 |
alertLevels |
[L0, L1] |
允许提醒的级别 |
focusMinutes |
25 |
/focus 无参时的默认时长 |
focusL0Penetrates |
true |
专注块内 L0 是否穿透 |
l0FlashMode |
tray |
L0 闪烁模式：tray 只闪任务栏，all 含标题栏 |
l0FlashCount |
15 |
L0 闪几下 |
l1FlashMode / l1FlashCount |
tray / 8 |
L1 对应设置 |
logPath |
'' |
观测日志；留空用包内 events.jsonl |
典型用法¶
- 在 DSH 桌面端给 agent 交代完任务后，输入
/focus或/focus 40，离开窗口去做别的事。 - 若 agent 卡在审批或提问（L0），任务栏闪烁；回到 DSH 处理即可。
- 专注时间内 L1 事件不会实时打断；到点闪一次，或随时
/focus off//focus digest查看攒下的事。 - 需要静默调试时，可将
flash设为false，仅看日志。
提醒执行细节在仓库 tools/flash-dsh.ps1，可单独运行（-Mode tray|all|caption、-Count N、-UntilFocused）。更完整的设计推导见 DESIGN.md。
适用场景与注意¶
适合谁： 经常在 DSH 桌面端跑长任务、又不想被逐步进展通知打断的 Windows 用户；愿意用「任务栏闪一下」代替「一直盯窗口」。
务必知晓：
- 仅 Windows，且目前 README 写明只在 DSH 桌面端验证过。
- 托盘最小化时无法闪任务栏——这是「只做任务栏闪烁」的固有盲区。
- 插件会按需启动 PowerShell 等本地行为，安装前请读 NOTICE.md。
- 社区目录页：https://www.skillhub.cn/plugins/YE-ZINAN/dsh-quiet；源码与文档：https://github.com/YE-ZINAN/dsh-quiet。
结尾¶
dsh-quiet 把「什么时候该回来看 agent」从人的反复切换，改成系统按 L0/L1/L2 规则托管：阻塞你的立刻闪，终态与块结束再批量交代，中间进展一律安静。若你已经在用 DSH 桌面端做 agent 开发或长对话，可按上文 PowerShell 命令用 link: 本地路径安装，用 /focus 试一轮，再按需改 cordis.patch.yml。分类上它属于 客户端 插件；在 SkillHub 与 GitHub 上均可找到 YE-ZINAN 维护的 dsh-quiet 条目与仓库。
