bigfurma-bot/dsh-attention

dsh-attention

用于 DeepSeek Harness (DSH) 的审批提醒监视器：
当有任何事情需要所有者决策时——文件夹访问权限升级、工具审批、插件激活——浏览器会响铃并闪烁标签页标题，这样即使所有者不在键盘前，也始终知道他们的 agent 被阻塞了。

什么会触发响铃

| 请求类型 | 检测方式 | 自动？ |
|---|---|---|
| 沙箱 / 文件夹访问权限升级 | 持久化的 approval/asked 会话日志事件 | 是 |
| 工具审批（任何会话或子 agent） | 同一日志通道 | 是 |
| 插件激活（cordis_run 客户端包） | 私有 host-runner 注册表，在总线上不可见——当某次运行返回“等待审批”时，你的 agent 调用 attn_ring | agent 侧；当裁决结果到达时，响铃会自动清除（v1.1.0） |

行为：首次发现时鸣响 → 在未得到答复期间每 20 秒重复一次 →
标题闪烁 🔔 N approvals waiting → 解决后恢复。
亚秒级自动授予的请求按设计保持静默（避免误报）。
音频会在你首次与页面交互时解锁（浏览器自动播放策略）；更早到达的请求仍会闪烁标题，并在首次点击时鸣响。

闪烁的标签页标题和审批卡片

声音

构建时内嵌了一段铃声录音，另外还有一个完全合成的 Web Audio 击铃回退方案（噪声脉冲叮当声 + 非谐波分音 + 房间尾音），以防解码失败。

铃声录音来自 Mixkit，遵循
Mixkit Sound Effects Free License。

换成你自己的通知声音

1. transcode any wav/mp3 to compact opus and base64 it
ffmpeg -y -i my-chime.wav -ac 1 -ar 48000 -c:a libopus -b:a 32k my-chime.ogg
base64 -w0 my-chime.ogg > my-chime.b64

2. inject into client.js (byte-exact, no hand editing)
node scripts/embed-chime.mjs my-chime.b64 /path/to/this/repo/client.js

然后重新安装并重启。

安装

cd ~/.dsh/profiles/web
rm -rf node_modules/@deepseek-ai/dsh-attention        # drop any stale copy
pnpm add --force "file:/path/to/this/repo"

将组合行添加到 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: attention
name: '@deepseek-ai/dsh-attention'

重启 DSH web。验证：

curl -s http://127.0.0.1:3080/attention/state   # -> {"ok":true,"pending":[],...}

host 部分声明了 inject: ['webServer']；如果你 fork，请保留它，否则
轮询路由会在启动时静默跳过。

Agent 工具

为每个会话注册：

| 工具 | 用途 |
|---|---|
| attn_ring | 手动响铃——在任何“等待用户审批”结果之后立即使用；会自动过期（默认 30 分钟），并且自 v1.1.0 起，一旦任何 cordis 激活裁决（approve / reject / cancel / fail）到达，也会自动清除 |
| attn_clear | 在得到答复后让礼貌性响铃安静下来（例如在 ask_user_question 之前响一声）；激活响铃不再需要它 |
| attn_debug | 计数器：瀑布式与持久日志的观测次数、看到的 cordis 解析、活跃环 |

无配置键。

许可证

MIT —— 见 LICENSE。捆绑的铃声录音受
Mixkit 音效免费许可证 约束。