AnLifeX/dsh-attention

dsh-attention

npm version
Windows

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

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

功能

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

安装

dsh plugin --profile web add dsh-attention

装完后重启 dsh web。

更新

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

更新完成后重启 dsh web。

用法

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

配置

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

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

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

取值约定
数值类配置统一：0 = 关闭该项功能，-1 = 无限（不设上限），正数按各自单位取整。

老版本用 0 表示「永久 / 不限制」；升级后第一次启动会自动把配置里的这些 0 改写成 -1，并写入 schemaVersion 标记 —— 只迁移一次，之后你自己填的 0 不会再被改。

更新日志

0.3.0

- 原生卡答完后的自动关闭改为永久有效：已答记录不再 30 秒过期，无论标签休眠多久，回来时网页卡片都会自动关上
- 新增 settledMax 配置（默认 50）：控制记住多少条已答记录；0 = 不记录（等于关闭自动关闭），-1 = 不限
- 移除「同一会话提醒间隔」冷却：审批 / 提问不再被静默跳过（冷却期间原来的第二次提醒不会弹出，容易被漏掉）
- 设置取值统一为 0 = 关闭、-1 = 无限，并自动迁移老配置里的 0（只迁移一次，写入 schemaVersion）
- 修复多问题卡片：点单选题的选项不再立即提交并关窗，改为逐题勾选、按「提交」统一发送
- 修复会话结束卡片里的「下一步」发不出去：sessionController.prompt() 需要 AbortSignal，之前漏传导致抛错被吞，卡片显示已提交但消息没进会话
- 修复数字输入框无法手写 -1：刚打出的负号会被改写成 0 或默认值
- 客户端在卡片注册的瞬间应答官方卡，减少重放时的闪现

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 卡片丢失的缓解，不是给连接层打补丁。
- 自动关闭依赖插件内存里的「已答记录」：超过 settledMax 条后最旧的会被丢弃，此时若卡片被重放，需要手动点一次。
- 自制卡片优先用 pwsh 7，缺失时回退 Windows PowerShell 5.1；系统通知仍用 5.1 的 WinRT Toast。首次加载插件时会在当前用户注册 dsh-attention: 协议。
- 自制卡片和系统通知只在 Windows 上弹出；其它系统装上后设置页和休眠唤醒刷新仍可用。
- 「回到会话」按窗口标题 / PWA 名称匹配；dsh 若在后台标签里，可能只能把整个浏览器前置。普通浏览器标签建议选「新开」。
- 多开 DSH 时端口能区分实例和目标会话，但 Windows 无法可靠地前置普通浏览器里的指定标签；需要精确打开时选「新开」，独立 Edge 应用窗口的复用更可靠。