dsh-attention

Readme

<p align="center">
  <img src="assets/logo.png" width="128" height="128" alt="dsh-attention">
</p>

# dsh-attention

[![npm version](https://img.shields.io/npm/v/dsh-attention.svg)](https://www.npmjs.com/package/dsh-attention)
![Windows](https://img.shields.io/badge/Windows-10%2B-0078D6?logo=windows&logoColor=white)

DeepSeek Harness 插件：会话需要 **审批 / 提问 / 选择**，或一轮对话结束时，在屏幕右下角弹出可操作的提醒；浏览器标签休眠后再回来时自动刷新，避免审批卡片卡住。自制卡片和系统通知仅 **Windows 10+**。

当前 `0.2.x` 适配 DSH `0.1.2-alpha.3` 及其新版 Remote/Waterfall API，不兼容使用旧 `apiProxy` 接口的 DSH 版本。

## 功能

- **网页休眠也能提醒。** 通知由 dsh 宿主发出，不走浏览器 `Notification`。标签被冻住时 JavaScript 停了，审批、提问、会话结束照样能弹窗。
- **卡片上直接处理。** 允许 / 拒绝、单选 / 多选、自定义输入（标题为「其他」）、写下一步，点完即提交，会话继续。不抢网页上的审批卡片。
- **官方卡自动关闭。** 原生卡先答完时，插件会把同一结果交给 DSH 官方审批 / 提问卡，让网页里的卡片自动关闭，不需要刷新页面。
- **跟着 dsh 主题。** 自制卡片亮色 / 暗色与当前页面一致，毛玻璃圆角；底部倒计时条从绿变到红。
- **两种卡片样式，二选一。** 默认自制卡片可在窗口里操作；系统通知卡片只负责点回会话。
- **回到已有会话。** 「回到会话」优先前置已经打开的 dsh 窗口或 Edge 应用，并切到对应会话；也可每次新开。
- **透明度可调 + 动效预览。** 自制卡片的毛玻璃不透明度可在设置里用滑块调整；开启右下角预览可重放向上弹入动画，并体验按钮悬停和按下反馈。
- **多显示器跟随焦点。** 弹窗默认出现在当前聚焦显示器的右下角；找不到焦点屏幕时自动回退到主显示器。
- **按钮布局统一。** 审批卡片为「允许 / 拒绝」左右布局；会话结束 / 多选提交按钮在左侧，「回到会话」统一固定在右上角关闭按钮左侧。
- **当前窗口不打扰。** dsh 标签正在聚焦时不弹；切到别的窗口、标签，或页面隐藏时才提醒。
- **子代理结束提醒独立控制。** 「子代理会话结束」开关默认关闭。开启后弹窗会明确标注身份，并且不提供回复输入框。
- **设置页分组可调。** 打开 **设置 → 提醒**（铃铛），顶部滑动开关控制总开关，下面按「提醒范围 / 卡片外观 / 休眠唤醒」分折叠卡片管理；提示音和回到会话方式也在默认展开的「提醒范围」中。改完点 **保存**，写入 `%USERPROFILE%\.dsh\dsh-attention-ui.json`，重启仍在。

## 安装

```bash
dsh plugin --profile web add dsh-attention
```

装完后重启 `dsh web`。

## 更新

```bash
dsh plugin --profile web add dsh-attention@latest
```

更新完成后重启 `dsh web`。

## 用法

1. 模型申请提权：右下角出现允许 / 拒绝；点「回到会话」切回该会话。在右下角答完后，DSH 网页里的审批卡会自动关闭。
2. 提问 / 选择：主会话单选点选项即提交；多选或多题先勾选再点提交；也可在「其他」里自己写答案。DSH 不允许受控子代理直接向用户提问。
3. 主会话一轮对话结束：在窗口里写下一步并发送。子代理结束提醒默认关闭；开启后只提示并提供「回到会话」，不显示回复输入框。
4. 标签休眠后再回来：隐藏超过约 8 秒会自动刷新一次（等同 F5），把还挂着的审批卡片重放出来。正在输入时不会刷新；将隐藏刷新时间设为 `0` 可关闭自动刷新。
5. 在 **设置 → 提醒** 里用顶部开关控制通知总开关，再在「提醒范围 / 卡片外观 / 休眠唤醒」分组里调整提示音、回到会话方式、样式、不透明度、停留时间和休眠刷新。

## 配置

`cordis.patch.yml` 或 profile 里覆盖 `dsh-attention` 的 `config`：

| 字段 | 默认 | 含义 |
|---|---|---|
| `enabled` | `true` | 总开关 |
| `notifyApproval` | `true` | 提权审批 |
| `notifyQuestion` | `true` | 提问 / 选择 |
| `notifyIdle` | `true` | 一轮对话结束后的下一步输入 |
| `notifySubagentIdle` | `false` | 子代理会话结束通知；弹窗不提供回复输入框 |
| `notifyStyle` | `custom` | `custom` 自制卡片；`system` 系统通知 |
| `notifyTimeoutSec` | `30` | 停留秒数；`0` 一直留到关掉。系统通知实际只有约 7 秒 / 25 秒两档 |
| `cardOpacity` | `0.78` | 自制毛玻璃卡片不透明度，`0.1`–`1`，越小越透 |
| `openSessionMode` | `reuse` | `reuse` 复用已有窗口；`new` 每次新开 |
| `hiddenReloadMs` | `8000` | 标签隐藏多久后唤醒要刷新（毫秒；设置页按秒填写）；`0` 表示不自动刷新 |
| `cooldownMs` | `1500` | 同一会话通知去抖（毫秒；设置页按秒填写） |
| `sound` | 系统默认提示音 | 设为 `false` 静音 |
| `choiceShellPath` | 自动 | 自制卡片使用的 PowerShell。默认优先 `pwsh` 7（启动更快），找不到时用 Windows PowerShell 5.1；可显式指定路径 |

插件会自动使用当前 DSH 实例的回环端口生成回调地址；多开时通知动作和会话切换会发给产生它的实例。回调路由只接受本机回环。

## 更新日志

### 0.2.1

- 审批 / 提问保持双卡同显：网页卡片与右下角卡片可同时出现，先提交的一方生效
- 原生卡先答完时，自动把同一结果交给 DSH 官方卡片，让网页里的卡片自动关闭（无需刷新页面）
- 弹窗启动优化：优先 `pwsh` 7、按运行时缓存 C# 辅助类型，并在插件加载时预热，显著缩短卡片出现前的等待
- 新增 `choiceShellPath` 配置，可显式指定自制卡片的 PowerShell

### 0.2.0

- 适配 DSH `0.1.2-alpha.3`，移除旧版 `apiProxy`、`events.mux` 与 `events.host` 接口
- 审批与提问改为接入 `approval/request`、`user-questions/request` waterfall；网页卡片和右下角卡片均可回答，先提交的一方生效
- 会话完成提醒改为监听 `api-session/status`，下一步消息改由 `sessionController.prompt()` 提交
- 宿主 HTTP 路由改为直接注入 `webServer`，恢复设置、焦点、待处理项和通知动作回调
- 客户端依赖声明切换到新版 Session Controller、Renderer 与 Settings General 插件

### 0.1.2

- 修复子代理结束后会话对象已销毁、被误判成主会话并弹出通知的问题
- 新增单一的「子代理会话结束」开关，默认关闭
- 子代理弹窗明确标注身份；子代理结束弹窗移除下一步回复输入框
- 根据 DSH 约束不展示子代理审批、提权和提问通知控制
- 设置页布尔开关统一改为滑块；提醒范围移到卡片外观上方并默认展开
- 移除共享的页面地址配置，通知自动绑定当前 DSH 实例端口，避免多开时回调串到其他实例
- 将提示音和回到会话方式并入提醒范围，移除独立的声音与打开方式卡片
- 主会话与子代理完成弹窗改用明确身份徽标；子代理卡片增加主题色描边，并加入遵循系统动效设置的向上弹入动画；实际弹窗与设置页预览按钮均有悬停和按下反馈

### 0.1.1

- 新增卡片不透明度设置与设置页实时预览开关
- 弹窗跟随当前聚焦显示器，找不到时回退主显示器
- 调整卡片按钮布局：「回到会话」统一到右上角关闭按钮左侧
- 优化浅色输入框边框与中文字体回退
- 设置页拆分为折叠分组，顶部新增滑动总开关

## 局限

- 选择 / 允许 / 下一步走右下角自制窗口，不依赖系统通知按钮回调。
- 自动刷新是对标签休眠后 pending 卡片丢失的缓解，不是给连接层打补丁。
- 自制卡片优先用 `pwsh` 7，缺失时回退 Windows PowerShell 5.1；系统通知仍用 5.1 的 WinRT Toast。首次加载插件时会在当前用户注册 `dsh-attention:` 协议。
- 自制卡片和系统通知只在 Windows 上弹出；其它系统装上后设置页和休眠唤醒刷新仍可用。
- 「回到会话」按窗口标题 / PWA 名称匹配；dsh 若在后台标签里，可能只能把整个浏览器前置。普通浏览器标签建议选「新开」。
- 多开 DSH 时端口能区分实例和目标会话，但 Windows 无法可靠地前置普通浏览器里的指定标签；需要精确打开时选「新开」，独立 Edge 应用窗口的复用更可靠。