# dsh-web-attention-badge

[English](README.md) | [简体中文](README.zh-CN.md)

<div align="center">

<img src="assets/demo.gif" alt="浏览器标签条:标签上的鲸鱼 favicon 在 4 秒里经历 原色 → 琥珀(有会话在等你)→ 绿(有会话干完了),标题里带着 (1) 计数——不打开页面也能读出状态" width="686">

**别老盯着终端了,瞄一眼标签栏就行。**

</div>

---

<div align="center">

<img src="https://img.shields.io/badge/DSH-Curated%20Plugin-blue" alt="DSH Curated Plugin" title="已被 awesome-dsh-plugin 精选清单收录">
<a href="https://www.npmjs.com/package/dsh-web-attention-badge"><img src="https://img.shields.io/npm/v/dsh-web-attention-badge" alt="npm version"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
<a href="https://github.com/Luaphes/dsh-web-attention-badge/stargazers"><img src="https://img.shields.io/github/stars/Luaphes/dsh-web-attention-badge" alt="GitHub stars"></a>

</div>

`dsh-web-attention-badge` 是 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
WebUI 的一个小插件:一行命令装完,不装客户端、不起后台、不开第二个窗口——
它只是把浏览器标签栏,变成你的会话状态灯。

## 为什么不用再装个"监控 App"?

那类工具的日常是这样的:再装一个应用、托盘里挂个图标、专门开个窗口看、还得再维护一条同步通道。
**它反着来。**

- **零安装** — 一行命令,完事。没有客户端、没有服务、没有托盘图标、没有常驻进程。它就是一段手写的客户端 bundle,挂在官方 WebUI 里;标签页一关,什么都不剩。
- **不用第二块屏** — 状态就在你眼睛本来就会扫到的地方:标签栏。一眼就知道是**在等你**(琥珀)还是**干完了**(绿),页面切到后台照样看得见。
- **不新增通道** — 计数直接读 WebUI 内置的会话存储,和界面自己用的是同一份数据。零 host 代码、零额外管道。
- **零配置、点击穿透** — `pointer-events: none`,不抢侧边栏的点击,也不用任何设置。

### 三处一起亮,一眼就够

| 位置 | 🟠 琥珀 | 🟢 绿 |
| --- | --- | --- |
| 页面左上角角标 | `(1)` —— 有会话在等你的输入 | `(N)` —— 你不在时跑完了、还没打开 |
| 浏览器标签标题 | `(1) DeepSeek Harness…` | `(N) DeepSeek Harness…` |
| 鲸鱼 favicon(标签左边缘) | 染成琥珀色 | 染成绿色 |

- **琥珀** = 有会话卡在**你**这儿:一次 `ask_user` 提问、一个审批弹窗、或者计划模式确认。
- **绿** = 有会话在你离开时跑完了,还没点开看。

favicon 在标签最左边,所以标题被浏览器截断了也不耽误你看见它。

> 💛 **要是"瞄一眼标签栏就知道状态"正好戳中你的痛点 —— 顺手点个 ⭐ Star 吧。对我真的很重要,也能让下一个人发现它。**

## 装它:三步,不到一分钟

**1. 加插件**(一行,自动登记,不用手改配置):

```sh
dsh plugin --profile web add dsh-web-attention-badge
```

想从源码装?钉个 tag:

```sh
dsh plugin --profile web add "github:Luaphes/dsh-web-attention-badge#v0.3.2"
```

**2. 重启 `dsh web`**,打开 WebUI。

**3. 开个会话,然后扭头去干别的。** 切到别的标签页,扫一眼标签栏——角标、`(N)` 标题、变色的鲸鱼,该说的都说了。收工。

升级 / 卸载:

```sh
dsh plugin --profile web update dsh-web-attention-badge
dsh plugin --profile web remove dsh-web-attention-badge
```

## 调参

`lib/client.js` 顶部几个常量:

- `TAB_TITLE_ENABLED` — 标签标题的 `(N)` 前缀。
- `FAVICON_ENABLED` — 鲸鱼 favicon 换色。
- 角标颜色 / 位置 — `AttentionBadge` / `Pill` 里的 `style`。

改 bundle 刷新页面就生效;改 manifest 要重启 `dsh web`。

## 许可

[MIT](LICENSE)

## ⭐ 支持一下

这插件是 DSH 早期几个小时赶出来的——没有设计文档,没有仪表盘,就一句"让标签栏告诉我发生了啥"。
如果它真替你省了事,一个 ⭐ Star 就是最好的回礼:**对我很重要,也能让这个小工具继续被看见。**

## 参与开发

布局、发版与发布流程见 [CONTRIBUTING.md](CONTRIBUTING.md)。