# dsh-attention-notify

[English](./README.md) | 中文

为 DeepSeek Harness（DSH）提供原生浏览器通知。它只读取 DSH 已有的会话列表状态，在下列事件发生时通知用户：

- 普通对话或子任务完成
- 工具调用需要审批
- Agent 提出问题，等待回答
- 计划等待评审
- 后台任务完成、失败或被终止

页面切到后台后仍通过 DSH 的事件订阅即时触发，不依赖可见页面轮询。点击通知会聚焦浏览器并打开对应会话。

每个会话首次加载的后台任务列表只建立基线，打开或重新订阅会话不会重播历史任务的完成通知。之后的终态变化仍会通知，包括在两次快照之间就已结束的任务。

## 安装

```sh
dsh plugin --profile web add github:Unintendedz/dsh-attention-notify#v0.1.4
```

重启 `dsh web` 并刷新页面，然后打开 **设置 → 通用设置 → 任务通知**，点击 **开启通知**。授权成功后会收到一条测试通知；已授权的浏览器会显示 **发送测试通知**。若权限弹窗被关闭或阻止，同一行会提示从地址栏的网站设置中开启。

通知入口位于设置内，不再占用侧栏底部。已有浏览器权限会保留，关闭设置后仍会照常通知。如需关闭浏览器通知，请在浏览器的网站设置中修改通知权限。

## 卸载

```sh
dsh plugin --profile web remove dsh-attention-notify
```

卸载后请重启 DSH Web 服务。

## 隐私与边界

- 零运行时依赖，不启动服务、不执行 shell、不访问外网、不采集遥测。
- 通知内容只包含 DSH 会话标题或后台任务标签；它们可能显示在系统锁屏通知中，请按需调整操作系统的通知预览设置。
- DSH 页面必须保持打开。浏览器或操作系统主动休眠、丢弃页面时，纯网页插件无法继续接收 DSH 事件。
- 通知项使用 DSH 原生通用设置布局；很窄的窗口目前仍受其固定双栏布局限制。

## 开发

```sh
npm install
npm test
```

`npm test` 会先构建浏览器包，再运行 Node 内置测试。

## 许可证

MIT