Tools & Capabilities

dsh-attention

AnLifeX/dsh-attention · ★ 2

AnLifeX

DeepSeek Harness 插件:审批/提问时弹出可操作的 Windows Toast,并在浏览器标签休眠后唤醒重连,避免提权卡片卡住

README body is shown in Chinese.

License
MIT
Added
2026-10-30
Maintenance
active
Install kind
npm
npm
dsh-attention
Manifest details
Manifest status
Declared
Manifest path
package.json#dsh
Manifest checked
2026-10-30T09:38:35.772Z
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add 'dsh-attention@0.4.1'

从 npm 安装预构建包

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: zh · Read Chinese README

Table of contents
  1. dsh-attention
  2. 功能
  3. 宠物模式
  4. 安装
  5. 更新
  6. 用法
  7. 配置
  8. 取值约定
  9. 更新日志
  10. 0.4.1
  11. 0.4.0
  12. 0.3.0
  13. 0.2.1
  14. 0.2.0
  15. 0.1.2
  16. 0.1.1
  17. 局限
  18. 许可与素材

dsh-attention

npm version Windows

DeepSeek Harness 提醒插件:会话需要 审批 / 提问 / 选择,或一轮对话结束时,显示可操作卡片、常驻鲸鱼娘宠物或系统通知。支持 Web、网页应用(PWA)和官方桌面版;桌面提醒功能需要 Windows 10+。

适配 DSH 0.2.1-rc.2 的会话、交互和设置接口,保留 0.2.0-rc.2 / 0.2.1-alpha.1 及 0.1.2-alpha.3 的旧导航和卡片接口回退;不兼容更早使用 apiProxy 的版本。插件列表与设置页支持中文、英文。

功能

  • 网页休眠也能提醒。 通知由 dsh 宿主发出,不走浏览器 Notification。标签被冻住时 JavaScript 停了,审批、提问、会话结束照样能弹窗。
  • 卡片上直接处理。 允许 / 拒绝、单选 / 多选、自定义输入(标题为「其他」)、写下一步,点完即提交,会话继续。不抢网页上的审批卡片。多题卡片会逐题勾选,点「提交」才一起发送。
  • 官方卡自动关闭。 原生卡先答完时,插件会把同一结果交给 DSH 官方审批 / 提问卡,让网页里的卡片自动关闭。已答记录没有时间过期限制,保留条数由 settledMax 控制。
  • 跟着 dsh 主题。 自制卡片亮色 / 暗色与当前页面一致,毛玻璃圆角;底部倒计时条从绿变到红。
  • 三种卡片样式。 默认自制卡片支持直接处理请求;宠物模式提供常驻鲸鱼娘和会话气泡;系统通知只负责点回会话。停用插件、切换样式或退出 DSH 后,常驻宠物退出。
  • 回到已有会话。 「回到会话」优先前置已经打开的 dsh 窗口或 Edge 应用,并切到对应会话;Web 版也可选择每次新开。
  • 外观与预览。 自制卡片的不透明度可调。切换宠物模式后显示 50%–200% 的大小滑块,开启设置页预览可实时查看缩放效果;保存后应用到桌面宠物。
  • 多显示器跟随焦点。 自制通知卡片默认出现在当前聚焦显示器的右下角;找不到焦点屏幕时自动回退到主显示器。宠物使用保存的位置。
  • 按钮布局统一。 自制通知卡片的审批按钮为「允许 / 拒绝」左右布局;会话结束 / 多选提交按钮在左侧,「回到会话」位于右上角关闭按钮左侧。宠物会话气泡使用悬停显示的操作图标。
  • 当前窗口不打扰。 dsh 标签正在聚焦时不弹;切到别的窗口、标签,或页面隐藏时才提醒。
  • 子代理结束提醒独立控制。 「子代理会话结束」开关默认关闭。开启后弹窗会明确标注身份,并且不提供回复输入框。
  • 设置页分组可调。 在插件列表中启用或停用 提醒;打开 设置 → 提醒(铃铛),按「提醒范围 / 卡片外观 / 休眠唤醒」分组调整。改完点 保存,写入 %USERPROFILE%\.dsh\dsh-attention-ui.json,重启仍在。

宠物模式

在 设置 → 提醒 → 卡片外观 中选择 宠物模式 并保存:

  • 鲸鱼娘常驻桌面;单击只唤回 DSH,保留当前页面。拖动可改变位置,松开后自动保存,重启后恢复所在屏幕和位置;屏幕断开或布局变化时调整到可见范围。
  • 有会话时,底部显示折叠横条;鼠标靠近后变为数字气泡,点击展开会话消息,移开鼠标后仍保持展开,再次点击同一按钮收起。没有会话时隐藏横条和数字。
  • 多条消息先以堆叠形式展示,点击堆叠展开列表。每项显示会话标题、最新消息或工具状态,已完成项带完成标记;列表根据宠物位置在上方或下方展开。
  • 点击单条消息进入对应会话。悬停时显示快捷回复、终止和隐藏图标;终止仅用于运行中的会话,隐藏消息不会删除会话。
  • 快捷回复为气泡内的单行输入框,回车发送,再次点击回复图标收起;子代理不提供直接回复。已完成消息在进入对应会话后移除,运行中的会话继续显示。
  • 支持待机、工作、等待回答、完成、失败和拖动等动画;工作形态为吃大白饭。鼠标移动时短暂跟随视线,停下后恢复待机;关闭 Windows 动画效果时使用静态帧。
  • 宠物大小在设置中调整。设置页预览用于检查形象和大小,完整动画在桌面宠物中播放。

安装

Web 版:

dsh plugin --profile web add dsh-attention

装完后重启 dsh web。

官方桌面版:优先在桌面应用的插件管理页安装 dsh-attention。同一个包自动适配桌面版和 Web,无需手动配置平台或端口。桌面版与 Web 的插件安装目录独立,安装到 web 不会自动启用到 desktop。

也可在桌面版菜单「管理 dsh 命令」安装桌面自带的命令,完全退出桌面应用,再执行:

dsh plugin --profile desktop add dsh-attention

重新打开桌面版。桌面 profile 请使用桌面应用自带的 dsh 命令。

桌面版「回到会话」可唤回现有窗口,包括隐藏在托盘时,并切换到对应会话。桌面版始终复用窗口,不受 Web 的「新开」设置影响,也不执行浏览器休眠强制刷新;已答记录与通知设置仍生效。

更新

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

更新完成后重启 dsh web。

桌面版在插件管理页更新并重启;也可完全退出后用桌面自带命令执行 dsh plugin --profile desktop add dsh-attention@latest。

用法

以下通知卡片操作以默认的自制卡片样式为例;宠物操作见上方「宠物模式」。

  1. 模型申请提权:右下角出现允许 / 拒绝;点「回到会话」切回该会话。在右下角答完后,DSH 网页里的审批卡会自动关闭。
  2. 提问 / 选择:主会话单选点选项即提交;多选或多题先勾选再点提交;也可在「其他」里自己写答案。DSH 不允许受控子代理直接向用户提问。
  3. 主会话一轮对话结束:在窗口里写下一步并发送。子代理结束提醒默认关闭;开启后只提示并提供「回到会话」,不显示回复输入框。
  4. Web 标签休眠后再回来:隐藏超过约 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 自制卡片;pet 宠物模式;system 系统通知
notifyTimeoutSec 30 停留秒数;-1 无限(一直留到关掉),0 关闭自动消失。系统通知实际只有约 7 秒 / 25 秒两档
cardOpacity 0.78 自制毛玻璃卡片不透明度,0.1–1,越小越透
petScale 1 宠物大小倍率,0.5–2;设置页显示为 50%–200%
openSessionMode reuse Web:reuse 复用已有窗口;new 每次新开;官方桌面版始终复用
hiddenReloadMs 8000 Web 标签隐藏多久后唤醒要刷新(毫秒;设置页按秒填写);0 关闭自动刷新,-1 无限;官方桌面版不执行此刷新
settledMax 50 记住多少条「已用弹窗答过」的记录,用于回到窗口时自动关掉网页卡片;0 不记录,-1 不限
sound 系统默认提示音 设为 false 静音
choiceShellPath 自动 自制卡片使用的 PowerShell。默认优先 pwsh 7(启动更快),找不到时用 Windows PowerShell 5.1;可显式指定路径

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

取值约定

时间和记录条数配置中,0 = 关闭该项功能,-1 = 无限(不设上限),正数按各自单位取整。cardOpacity 和 petScale 为小数倍率,遵循各自的范围。

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

更新日志

0.4.1

  • 修复 Web / PWA 唤起时只在任务栏闪烁的问题:卡片、宠物和协议入口共用窗口查找及前台验证;最小化窗口先恢复,前置受阻时重试
  • 宠物直接在点击进程中唤回浏览器;修复动态标题匹配和无关浏览器窗口误匹配
  • 新增 engines.dsh 兼容范围声明:>=0.1.2-alpha.3 <0.3.0-0

0.4.0

  • 自动适配官方桌面版和 Web,修复桌面唤回、设置页注册、服务注入及审批 / 提问卡同步
  • 新增常驻鲸鱼娘宠物、状态动画、会话数量提示和消息堆叠,支持会话跳转、快捷回复、终止和隐藏消息
  • 支持宠物位置记忆、多屏恢复、设置页缩放和实时预览;气泡与回复输入框跟随亮暗主题
  • 已完成消息在进入会话后移除;修复多选标记、回复输入框文字裁切和拖动光标
  • 卡片关闭后清理临时文件,启动时清理超过 24 小时的遗留文件;仍待处理的卡片可从宠物再次打开
  • 插件展示名称改为「提醒」,图标与设置页一致,插件元信息及设置页支持中文、英文

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 上展示;其它系统装上后设置页和 Web 休眠唤醒刷新仍可用。
  • 插件列表与设置页支持中文、英文;原生通知卡片和宠物会话操作提示目前使用中文,会话标题与消息保留原文。
  • Web 的「回到会话」按窗口标题 / PWA 名称匹配;dsh 若在后台标签里,可能只能把整个浏览器前置。普通浏览器标签建议选「新开」。官方桌面版使用 dsh://open,不依赖浏览器窗口匹配。
  • 多开 DSH 时端口能区分实例和目标会话,但 Windows 无法可靠地前置普通浏览器里的指定标签;需要精确打开时选「新开」,独立 Edge 应用窗口的复用更可靠。

许可与素材

插件代码采用 MIT。鲸鱼娘衍生动画与预览素材采用 CC BY-NC-SA 4.0,保留原作者署名、非商业性使用和相同方式共享要求,详见 素材说明 与 素材许可。此许可与插件代码的 MIT 许可分别适用。

抓取光标使用 Chromium 原版资源,许可见 Chromium 光标许可。鲸鱼娘是社区二创形象,本插件与 DeepSeek 无官方隶属或背书关系。