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