跳到主要内容

dsh-attention

已验证

dsh-attention · v0.4.0 · MIT · Web 界面

Notifications for approvals, questions and completed sessions, with interactive cards and a desktop pet.

安装

dsh plugin add dsh-attention

用 dsh --profile default --dump-config 确认 layer 已生效 —— 参见安装指南。

源码

标签

作者

说明文档

dsh-attention

dsh-attention

npm version Windows

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

适配 DSH 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.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 无官方隶属或背书关系。