dsh-task-notify

任务通知（dsh-plugin-task-notify）

两种值得打断你的事件，各自给出两个提示：

• 任务完成：Agent 从 running 变回 idle；
• 会话卡在你身上：出现了待处理的交互——工具越权授权（approval）、提问（question）、计划待确认（plan-review）。

两个提示分别是：

• 应用内提示（toast）：出现在页面顶部正中，和 Harness 自带 toast 同一位置与色调；
• 系统通知（macOS 横幅）：走渲染进程的 Notification API，由 DeepSeek Harness 应用本身发出，点一下即可把 Harness 拉到前台并打开对应会话。

安装方式

已经装进 desktop profile，重启后仍然有效：

• ~/.dsh/profiles/desktop/package.json：依赖 "dsh-plugin-task-notify": "link:/Users/maerceci/dsh-plugins/dsh-task-notify"，并把 dsh-plugin-task-notify 追加进 dsh.profile.bundles；
• ~/.dsh/profiles/desktop/node_modules/dsh-plugin-task-notify 是指向本目录的软链接；
• 因此不要移动或删除本目录，否则 profile 会加载失败（在 插件 页面取消勾选即可解除）。

本目录就是包的实体，改完保存即生效（Host 会监听 client.js 并热重载；必要时刷新页面 ⌘R）。

换到另一台 Mac：见 MIGRATION.md。三种方式（GitHub / 拷目录 ./install.sh / 手动），包含前置运行时版本要求、三层验证方法和卸载回滚。

文件

判定规则

在客户端订阅 ui-session 提供的 useSessionStatus（即 api-session/status 的会话状态投影）。每行状态形如 { running, pendingInteraction, completionUnread }，本插件只读前两个字段。

任务完成——只认 running: true → false 这个跳变：

• 首次拿到的快照只当基线，不通知（否则每次刷新页面都会炸一堆旧会话）；
• 变回 idle 后再等 SETTLE_MS（1.2 秒）才通知；期间若又变回 running（goal 自动续跑、重试、用户又发了一条），则取消，不会一个任务响好几次；
• 跳过子代理会话（origin: 'subagent' / 带 parentId）和空白会话（blank）——子代理频繁结束，不是「你的任务」。

等待你处理——只认 pendingInteraction 从无到有（它带一个稳定的 key）：

• 交互出现后等 ATTENTION_SETTLE_MS（0.6 秒）才通知；这个窗口足够让「被委托给下一个监听者」的请求（例如 experimental-auto-review 接管）在通知前就消失——那种请求根本没轮到你；
• 按 key 去重：状态投影因任何原因重新发布（同一个请求换了新对象）都不会重复通知；
• 请求被回答 / 取消后清除该会话的去重标记，所以同一个会话的下一个请求会正常通知；
• 一次请求被回答后，running 可能仍然为 true；此时只发「等待处理」，不会顺带发一条完成通知；
• 与完成不同，子代理的授权 / 提问照发（ATTENTION_INCLUDE_SUBAGENTS）：子代理卡住也就卡住了你正在等的那一轮。空白会话仍然跳过；
• 横幅正文会带上有用的上下文（工具名、提问文本，截断到 140 字符）。

系统通知在窗口可见时也照发（与 Codex 一致）。完成与等待处理用不同的 tag，所以一条完成通知不会悄悄顶掉一条还没处理的授权。

可调参数

都在 client.js 顶部：

提示点颜色区分事件类型：完成是绿色（--dsw-alias-state-success-primary），等待处理是琥珀色（--dsw-alias-state-warn-primary，缺失时回退到 error 色）。

已知限制

ATTENTION_SETTLE_MS 只能降低被委托请求误报的概率，不能消除。运行时里 PendingApproval.delegate() 之后，真正取消发布的 remove() 在瀑布消费方的 finally 里执行，而 finally 要等 await next()（例如 auto-review 那一环）跑完才轮到；同时 PendingInteractionDomain.valuesSnapshot() 返回所有已发布的值，并不过滤已委派的条目。所以当下游监听者处理超过 ATTENTION_SETTLE_MS 时，一条本该由它消化掉的授权仍会通知你。对象上的 #delegated 是私有字段，插件侧拿不到这个信号，唯一的缓解手段就是把这个窗口调大。

文案

走 Harness 的 locale 服务（命名空间 task-notify），zh / en 两套字典就在 client.js 里，跟随界面语言切换。

卸载

用 plugin_manager 的 remove_bundle（target dsh-plugin-task-notify），或在 设置 → 插件 里取消勾选 / 卸载；也可以直接删掉本目录再手动清理 profile 的 package.json。删除本目录前请先从 profile 里解除。

已验证 / 未验证

• 已验证：包被 profile 加载（Loader 条目 include:task-notify）、client.js 被实时以当前版本送到页面（改一次 rev 变一次）、shell.overlay 槽位里出现 task-notify 占用者且 active: true、槽位向该条目提供 useSessionStatus。判定逻辑由 test/notify.test.mjs 覆盖（npm test，47 项断言）：结算窗口、续跑去重、子代理静默、空白会话静默、通知文案、点击打开会话、自动消失、授权 / 提问 / 计划三类交互、按 key 去重、被委托请求静默、回答后新请求重新通知、无 key 时的退化、横幅文本截断、两类 TTL 与不同 tag。
• 未验证：真实点击与系统横幅的实际观感，需要人眼确认一次。

维护者：看下载量

npm run downloads                                   # 本包
node scripts/downloads.mjs dsh-plugin-task-notify   # 也可以查别的包

数据来自 npm 官方公开 API（api.npmjs.org），不需要 token；网页版是 https://www.npmjs.com/package/<包名>（页面上直接显示 weekly downloads）。

口径提醒：凡是从 npm 官方 registry 安装的（pnpm / dsh plugin add / 应用内 Plugins 页）都会计入； 镜像源（如 npmmirror）和 CDN 缓存会少计或不计。