dusbin/dsh-attention

dsh-attention

DeepSeek Harness 人工介入 / 任务完成提醒插件（Web 端）。

- 需要人工介入（agent 调用 ask_user_question 等待回答 / 权限审批等待确认）→ 浏览器四周红框闪动 + 顶部红色提示条 + 提示音（急促三连音）+（页面不在前台时）tab 标题闪烁 & favicon 红点；
- 任务完成（会话运行→空闲，即回合完成 / goal 进入 complete）→ 浏览器四周绿框闪动 + 顶部绿色提示条 + 提示音（上行双音）+（页面不在前台时）tab 标题闪烁 & favicon 绿点；
- 声音提醒可一键开关（输入框工具条 🔔 按钮，开启时试听）；也可在配置中关闭；
- 预留外部通知渠道接口：微信 / 钉钉 / 企业微信 / Telegram / Discord / 通用 Webhook（Node 半身实现，未配置凭据时返回 not-implemented，配置后即可真正发送）。

目录结构

dsh-attention/
├── lib/
│   ├── index.js    # Node 半身：事件监听（ask_user_question / goal complete / turn/end）
│   │               #        + Notifier 渠道分发（接口 + 桩 + webhook 实现）
│   └── client.js   # 浏览器 bundle：红/绿框闪动、声音、tab/favicon 提醒、声音开关按钮
├── test/
│   ├── smoke.test.mjs      # 23 个冒烟用例（Node 半身 + 浏览器状态机纯函数）
│   └── dom-smoke.test.mjs  # 7 个集成用例（最小 DOM 桩跑通 apply() 全链路）
├── package.json
└── README.md

两个半身共享同一份 cordis.patch.yml 中的 config，互不依赖、可独立启停。

安装

以本机 dsh profile（~/.dsh/profiles/web）为例：

1. 软链到 profile 的 node_modules（client-modules 增量扫描需要包名可解析）
ln -s /Users/robinddu/Desktop/workspace/robinddu/dsh-attention \
~/.dsh/profiles/web/node_modules/dsh-attention

2. 在 ~/.dsh/profiles/web/cordis.patch.yml 追加（?v=N 用于源码改动后绕过 ESM 缓存）
- insert:
- id: attention
name: 'dsh-attention'
config:
见下方「配置项」
scope: 'all'

dsh.client 包需要被 web 端 client-modules 扫描到：重启 dsh web / 刷新页面后生效。
源码改动后：Node 半身递增 ?v=N；浏览器 bundle 刷新页面即可（client bundle 由模块表按 id 缓存，刷新即重载）。

配置项

| 配置 | 默认 | 说明 |
| --- | --- | --- |
| scope | 'all' | 'all' 监控所有会话（含后台子代理）；'current' 仅当前会话 |
| flash.enabled | true | 红/绿框闪动总开关 |
| flash.interventionMs | 0 | 红框持续毫秒数；0 = 持续到介入解决 |
| flash.completeMs | 8000 | 绿框持续毫秒数 |
| sound.enabled | true | 声音提醒总开关（可选择） |
| sound.onlyWhenHidden | false | true = 仅页面不在前台时响 |
| sound.volume | 0.4 | 音量 0~1 |
| sound.intervention.pattern | 'alert' | 介入提示音模式：alert（急促三连音） |
| sound.complete.pattern | 'chime' | 完成提示音模式：chime（上行双音） |
| tab.enabled | true | tab 提醒总开关（页面不在前台时） |
| tab.title | true | document.title 前缀闪烁（⚠ 需要介入｜… / ✓ 已完成｜…） |
| tab.favicon | true | favicon 红/绿点（介入时红点带白色感叹号） |
| browserNotification.enabled | false | 浏览器系统通知（Notification API，首次使用时请求授权） |
| dismissOnInteraction | true | 点击/按键时提前关闭「任务完成」绿闪（介入红闪不受交互影响，持续到问题回答/授权解决才消失） |

外部通知渠道（Node 半身）

config:
notifyEnabled: true        # 外部通知总开关
onIntervention: true       # 需要人工介入时通知
onGoalComplete: true       # goal 进入 complete 时通知（任务完成）
onTurnEnd: false           # 每次 turn/end 都通知（粒度较细，默认关）
channels:
wechat:   { enabled: false }                                  # 微信个人号：需企业微信/第三方平台，接口已预留
dingtalk: { enabled: false, webhook: '', secret: '' }         # 钉钉群机器人（secret 为加签密钥，可空）
wecom:    { enabled: false, webhook: '' }                     # 企业微信群机器人
telegram: { enabled: false, token: '', chatId: '' }           # Telegram Bot
discord:  { enabled: false, webhook: '' }                     # Discord Webhook
webhook:  { enabled: false, url: '', headers: {} }            # 通用 Webhook（POST JSON）

- 接口约定：每个渠道是一个适配器 { id, label, test(cfg), send(message, cfg) }，见 lib/index.js 的 CHANNELS。
- message = { kind: 'intervention' | 'complete', title, body, meta }。
- 未配置凭据的渠道不发送；配置了 webhook / token 的渠道（钉钉、企业微信、Telegram、Discord、通用 Webhook）会用 fetch 真正发送；微信（个人号）暂只返回 not-implemented，接入需企业微信应用消息或第三方开放平台，按同一适配器接口补 CHANNELS.wechat.send 即可。
- 扩展新渠道：在 CHANNELS 里加一个适配器，并在 DEFAULTS.channels 里登记即可，无需改分发逻辑。
- 其他插件可 ctx.provide('attentionNotifier', notifier) 复用（插件启动时已提供）。

工作方式

- 浏览器端不解析聊天内容：web 运行时已将会话列表投影出 pendingInteraction（question=等待回答 / approval=等待授权）与 completed（运行→空闲的完成提醒），插件订阅 ctx.sessions.list 快照做边沿检测（纯函数 foldAlerts，可单测），只在状态跃迁时提醒一次。注意：sessions.list 快照的真实形状是 { ids, byId, current }（无 items 字段），插件通过 listItemsOf() 归一化（两种形状均兼容）。
- Node 半身订阅 ctx.on('session/event')：tool/call 名为 ask_user_question → intervention 通知（按 callId 去重，tool/result 到达后释放）；goal/change 且 operation === 'complete' → complete 通知；可选 turn/end completed。

开发

npm test          # 运行全部测试（无外部依赖）：26 个状态机/Node 冒烟 + 7 个 DOM 集成
node --check lib/client.js   # 浏览器 bundle 语法检查

浏览器 bundle 为手写格式（window.__ModuleLoader__.load），无需构建工具链；foldAlerts / createInitialState 已通过 exports 暴露，可在 Node 中直接单测。

注意事项

- 声音自动播放策略：Chrome 等浏览器要求用户先与页面交互才能发声。首次点击输入框工具条 🔔 按钮（或任何一次点击/按键）会解锁 AudioContext；此后提醒音即可正常播放。
- 系统通知：browserNotification.enabled: true 时，首次提醒会请求通知权限（或在 🔔 按钮开启时预请求）。
- 页面回到前台时自动恢复 document.title 与 favicon。

许可证

MIT