dsh-task-toast
jgao9906-droid/dsh-task-toast
Top-right status plate for DeepSeek Harness. DSH 右上角状态提示板。
설치
dsh plugin --profile web add github:jgao9906-droid/dsh-task-toastREADME
dsh-task-toast
English | 中文
DeepSeek Harness 插件：把 agent 的状态显示在右上角——完成、出错、等你授权、等你回答、还有子 agent 在跑。
视觉沿用 dsh-theme-endfield 开机加载屏的设计语言
（只是沿用设计语言，与本插件无隶属关系）。
dsh plugin --profile web add github:jgao9906-droid/dsh-task-toast
零依赖、无构建步骤、不用手改 profile 补丁。详见 安装。
两张都是真机截图。橙色那张的示例是一次沙箱提权请求——所以任务行是宿主生成的
escalate sandbox to danger-full-access: …；那是请求方给的理由，插件不加工、只单行省略 （官方面板里它是多行，这里一行放不下就截断）。工具级授权则显示成工具 Bash 请求越权执行——见下面那段 ASCII 图。
┌────────────────────────────────────────────────────┐
│▌ // TASK │ ← 10px 强调色轨（自上而下填充）+ 大字距 kicker
│▌ │
│▌ ❯❯ APPROVAL │ ← 纯边框画的叠层雪佛龙 + 大字（34px）
│▌ │
│▌ 工具 Bash 请求越权执行 │ ← 一行细节（超出省略）
│▌ ▬▬▬▬▬▬ 14:32:07 │ ← 6 格方块状态条（依次点亮） + 等宽时钟
└────────────────────────────────────────────────────┘
▐ ← 挂起超时后收成这条细边（8px 宽，贴右上角）
▐ 高度取板子的实测高度，和板子上下边缘齐平
▐ 鼠标移上去会重新展开，移开又收回
没有版式变化，只有三个变量：大字换词、强调色换色、那一行换内容。
细边是可以悬停的：挂起超时收成细边之后，鼠标移到它上面会把板子重新展开，让你再看一眼"到底在等什么"；移开就再收回。它没有按钮、也不做任何动作，纯"看一眼"。
细边和板子共用同一条上边缘（都从距顶 18px 开始），长度也取板子的实测高度而不是写死常量——两者必须完全对齐，否则一眼就看得出是错位的两截东西。（最初它贴在视口角落 top:0，比板子整整高出一个边距，就是这个毛病。）
六个状态
| 状态 | 大字 | 强调色 | 那一行 | 性格 |
|---|---|---|---|---|
| 完成 | COMPLETE | 跟随主题 --edge-accent | 会话标题 | 瞬时：弹 5 秒 |
| 出错 | ERROR | 红 #ff4d4f | 错误消息 | 瞬时 |
| 会话打不开 | UNOPENED | 红（与 ERROR 同色） | 错误码 / 会话标题 | 瞬时 |
| 还有子 agent | SUBAGENT | 跟随主题 | 会话标题 | 瞬时 |
| 待授权 | APPROVAL | 橙 #ff9f0a | 工具 Bash 请求越权执行 或请求自带的原因 | 挂起 |
| 待回答 | QUESTION | 青 #3fd8d0 | 问题标题（面板自己的 1 / N 题号也会留在行尾） | 挂起 |
瞬时 vs 挂起，本质不同
- 瞬时型：一件事发生了 → 弹
TOAST_MS就走。 - 挂起型：agent 正卡着等你。它不会"5 秒后就没事了"，所以：整块显示
PENDING_FULL_MS→ 收成右上角那条细边（只表示"有东西在等你"，不带文字）→ 直到你处理掉才消失。 细边的颜色告诉你等的是哪一类（橙=授权，青=提问），鼠标移上去会把板子重新展开。
挂起型和其余状态守同一条可见性规则：正看着 DSH 时只出板子，没看着才追加系统通知。 （这里曾经给挂起型开过例外，理由是"agent 卡着等你更该被知道"——真机用过一次就否掉了： 正盯着那块大字板子，同时又弹一条系统通知，纯属重复。）
几条边界行为：
- 同一时刻可能不止一条挂起（授权可以叠）。来新的 → 整块弹出；答掉一条但还有别的 → 收成细边 （不会继续显示你已经答过的那条）；全部答完 → 细边消失。
- 细边在整块显示期间也留着，它是板子旁边的"锚点"，同时也是鼠标悬停的目标。这不是顺手为之：
一个从鼠标底下被移除的元素永远不会触发
mouseleave，悬停状态会永久卡住、之后再也不响应 鼠标。有断言盯着这个节点在收起、展开、新挂起到达之间始终是同一个。 - 悬停展开不会抽搐：命中区只占视口最边上 14px，板子距边缘留 18px，两者不重叠——所以鼠标
停在细边上时板子不会盖住它。这条几何不变式（
EDGE > EDGE_HIT_W）有断言，而且是从源码里读 真值来比的（早先拿 harness 自己镜像的常量比，结果一个变异体活了下来）。 - 悬停展开的板子在你移开鼠标时收回；而"新挂起刚到达"的那次播报不会被你顺手扫过角落的鼠标 掐断——两者用不同的标记区分。
- 挂起优先于瞬时：挂起板子占屏时，完成/出错这类瞬时状态不抢屏（DSH 自己的对话流里仍然看得到）， 也不会额外发系统通知（你已经明显在看了）。这是刻意的取舍，不是漏做。
三个可见通道，页内板子恒开
各自独立可关（client.js 顶部常量）：
| 通道 | 常量 | 覆盖范围 | 前提 |
|---|---|---|---|
| 页内提示板 | 恒开 | 任何时候 | 无 |
| 系统通知 | OS_NOTIFY + OS_NOTIFY_ONLY_WHEN_AWAY | 盖在任何程序之上；DSH 在后台或最小化都行 | 授权一次 |
| 标题栏 ● 前缀 | TITLE_BADGE | 任务栏 / 标签页上的廉价兜底 | 无 |
系统通知的标题也按状态分开（任务完成 / 任务出错 / 等待你授权 / 等待你回答 / 会话打不开）——
一条写着"任务完成"的通知其实是报错，比不通知更糟。
只有系统通知挂可见性判据，板子永远显示
任何时候 → 页内提示板（主通道，不受任何判据影响）
没看着 DSH → 系统通知 + 标题栏 ●
正看着 DSH → 只有板子（这时再弹系统通知纯属噪音）
所有状态守同一条规则，没有例外。 PENDING_ALWAYS_NOTIFY = true 会让挂起型无视判据、
一定发通知——那曾经是默认值（理由是"agent 卡着等你，比完成更该知道"），真机上用了一次就被
否掉了：正盯着屏幕看那块大字板子，同时又弹一条系统通知，纯属重复。想恢复那个行为把它改回
true 即可。
OS_NOTIFY_ONLY_WHEN_AWAY = false 就退化成"两种都发"。
板子不挂判据是刻意的（开发过程中修掉的一个真 bug）：判据一旦在任何环境下不可用，主通道就跟着整个静默——现象是"任务完成了但什么都不弹"。失败模式必须是"多弹一个通知"，而不是"什么都不弹"。
判据是 document.hidden / document.visibilityState（见 isLookingAtDsh()）。刻意不用 document.hasFocus()：DSH 页面跑在 iframe 里，点一下壳层自己的导航栏就会让 iframe 失焦，那会变成"你正盯着 DSH 却弹系统通知"。
在 Tauri 桌面端上这个判据不是猜的：宿主注入的 shim 会在 iframe 里重定义这两个属性去镜像宿主窗口（宿主失焦/最小化 → hidden，回来 → visible），并用 dsh://visibility-state 校正。
板子被节流饿死后会被回收
页面隐藏时定时器会被浏览器/WebView 狠狠节流（后台标签页不保证按时触发 5 秒的 timeout，被挂起的 WebView 可能根本不跑）。板子不再被可见性拦住，所以它可能在页面隐藏时升起，然后超时了还挂在屏幕上。
reapStalePlate() 因此不看定时器、只看钟：回到前台时若板子已超过自己的截止时刻就直接收掉；没超时的原样留着，活满自己的全程（有对照测试，防止它把板子切短）。挂起型的截止时刻是 PENDING_FULL_MS（收成细边），不是 TOAST_MS —— 两者在默认值下恰好相等，所以有那么一条守卫看起来像死代码；它有专门的差分测试盯着（见下方「怎么验证」）。
停留时长
TOAST_MS = 5000，对齐 Windows 系统通知的默认档（5 秒），让两种情况观感一致。
反方向做不到：系统通知的时长由 Windows 决定（设置 › 系统 › 通知 › 显示通知的时长：5/7/15/30 秒），NotificationOptions 里根本没有 duration 字段。你把系统那档改成别的，就改 TOAST_MS 跟上。
授权流程
浏览器要求 Notification.requestPermission() 由用户点击触发，所以首次回合结束后会出现一块同样风格的一次性询问板（// NOTIFY → 开启 / 不用了）。它刻意排在页内提示板消失之后，两者不会重叠。选过之后记在 localStorage，不会再问第二次；若权限已是 denied，则永远不再打扰。
在 Tauri 桌面端上这块询问板不会出现：宿主的 shim 让
Notification.permission永远返回'granted'，并且把每条new Notification(...)接到宿主自己的原生通知上。那段询问逻辑只在普通浏览器里有意义。
系统通知的正文带上当前会话标题；tag 是 dsh-notification-<会话id>-0，形状是宿主定的契约——它按这个正则从 tag 里取会话 id，用来让点击通知直接跳到那个会话。重复完成用同一个 tag，所以是替换而不是堆叠。
两条前提（在你的启动方式下都成立）
http://127.0.0.1属于安全上下文（localhost 例外），所以明文 http 下 Notification API 可用；- 授权按 origin 记，而启动脚本把端口写死
3080，因此授权一次长期有效。若哪天改用随机端口的 DSH Desktop，每次启动 origin 都变，就得重新授权。
它够不到的情况
DSH 窗口被完全关闭时不会通知——通知跑在页面里，页面没了就没有了。那种情况需要 Host 侧通知（dsh web 服务进程仍在，可以走 Windows 原生通知通道），是另一套实现，本插件没做。
另外 Windows「专注助手 / 勿扰」会压掉系统通知，那是系统设置，不是插件能绕过的。
安装
dsh plugin --profile web add github:jgao9906-droid/dsh-task-toast
重启或重新加载 web profile 后生效。
不需要额外的构建步骤，也不需要手改 profile 补丁。 两点值得说明：
- 本包没有任何
prepare/postinstall脚本，client.js就是可直接运行的源码。dsh plugin是 pnpm 的转发器，git 来源的包如果带构建脚本，pnpm 会拦下来要你先在pnpm-workspace.yaml里加allowBuilds白名单——本插件绕开了这一整类麻烦。 - 包声明了
dsh.bundle.patch，所以dsh plugin add会自动把它加进 profile 的dsh.profile.bundles层栈，不用手动编辑cordis.patch.yml。
开发期改源码时用 link: 装更省事（改完刷新页面即生效，不用重装）：
dsh plugin --profile web add link:<你 clone 下来的路径>
卸载：
dsh plugin --profile web rm dsh-task-toast
兼容性
- 平台：纯客户端插件，只用 DOM 与
document.hidden，没有平台专有代码。 在 DSH Desktop（Tauri 壳）上实测运行；普通浏览器里除了系统通知那部分， 其余行为同样成立。 - DSH 版本：针对
0.1.5-rc.x开发与验证。它依赖的内部接口有两类——会话快照的 字段名，以及官方面板的三个 data 属性（data-approval-key/data-question-key/data-plan-review-key）。后者属于非官方钩子，DSH 若改名，待授权/待回答会静默消失 （其余状态不受影响），不会报错也不会崩。 - 构建依赖：运行时零依赖。
开发者：怎么验证它是好的
仓库自带三个 harness、一个变异测试矩阵，零依赖、不需要 DSH 在跑（vm + 假 DOM/假时钟）：
npm test # 三个 harness，共 191 条断言
node _mutate.js list # 列出 24 个变异体，各自对应哪条断言
它怎么知道每个状态
完成 / 子 agent：一个信号位
只认 DSH 自己那份权威状态：
| 步骤 | 调用 |
|---|---|
| 取服务 | ctx.get('sessions') |
| 当前会话 | sessions.list.getSnapshot().current |
| 会话快照 | sessions.binding(id).session（SessionFace = ISession & ObservableSnapshot<SessionSnapshot>） |
| 状态位 | session.getSnapshot().running |
只对 true → false 这一个边沿反应（一个回合结束），并且：
- 每个会话读到的第一个值只当基线，不触发 —— 所以切进一个已经在跑的会话不会误报；
sessions.list因为标题变化、任务行、侧栏刷新等各种原因频繁推送，同一会话不重新订阅；- 会话快照暂时不可读（窗口还没开）时会继续订阅，它的第一个真实值成为基线；
- 服务可能晚于
apply()就绪（web boot 并发挂载所有插件行），所以不声明inject， 一律ctx.get+ 120ms 重试。
"这一回合结束了"不等于"事情干完了"：如果还有别的会话挂在这个会话底下在跑，大字说 SUBAGENT
而不是 COMPLETE。两个容易写错的点（我用变异测试钉住了）：
- 快照上的
subagent字段说的是"这个会话自己是个 subagent"（主会话上永远是null）， 不是"它有子 agent"。父侧信号只在列表快照里。 - 列表行投影到公开面时父链接叫
parentId，不是内部的parentSessionId。写成后者会得到一个 永远为假的判定 —— 编译不报错、日志不报错，状态就是不出现。
出错 / 会话打不开：从快照读，但按"变化"报
| 来源 | 说明 |
|---|---|
session.getSnapshot().lastAgentError | 唯一来源。它喂的是宿主那条 api-session/error 事件（DSH 官方注释称其为"没有 turn 位置的实时失败"的出口），但插件读的是快照上的值，没订阅那个事件 |
openState === 'error' + openError | 会话打不开 |
⚠️ lastAgentError 是粘性的：它只在连接/重置时清空，不会自己消失。"非空就报"会永远挂着
一个过期的 ERROR。所以只在内容变化时报一次，而且切换会话时把到达那一刻的值当基线
（进到一个早就有旧错误的会话不会突然弹板子）。openState 同理，只报进入 error 的那一次跳变。
待授权 / 待回答：看官方面板的 DOM
不订阅远程事件，尽管那才是"正规"接口。原因是一条实测结论，写在这里免得以后有人 又照着官方插件的写法改回去：
官方插件用的是瀑布远程事件
ctx.remote.$on('approval/request', fn)/'user-questions/request'。本插件也照这个写法实现过，包括"必须return next()把决策 交回宿主"的契约和对应的变异测试。但在开发所在的这台机器上（Windows + DSH Desktop，0.1.5-rc.x）一个远程事件都送不到：实测（把诊断读数打到板子和壳层日志上）得到
sess=yes remote=yes $on=yes而命中数为 0 —— 服务取得到、$on不报错、监听器却从不被调用；连api-session/status这类 emit 事件 也一个不来。查过 cordis 的投递实现（EventsService建在 root、子 ctx 原型继承同一张_hooks、emit 类派发不过滤），也确认了同类的用户插件dsh-tauri-model-config用的就是ctx.get('remote')—— 所以不是"这条路对用户插件不成立"，而是它在这个环境里就是不工作。⚠️ 这一条是环境相关的观察，不是放之四海的结论。 别人的机器上远程事件很可能是正常的 （官方插件就靠它工作）。如果你在自己的环境里发现
ctx.remote.$on可用，完全可以把它换回来 —— 但要连同"瀑布事件必须return next()"那条契约一起做，否则会吞掉官方审批面板、 让 agent 永久卡在等你授权。本插件选择 DOM 的另一个理由是：不订阅瀑布，就等于结构上不可能犯那个错误。
结论：用官方面板渲染出来的 DOM 作为唯一真相。
两个面板都带语义化 data 属性（不是哈希过的 CSS 类名），这是它们自己的选择器钩子：
| 面板 | 属性 | 对应状态 |
|---|---|---|
审批面板 dsh-client-ui-approval | data-approval-key | 待授权 |
提问面板 dsh-client-ui-user-questions | data-question-key | 待回答 |
| 计划待审（同一个插件的另一种面板） | data-plan-review-key | 待回答 |
推演方式：MutationObserver 盯 document.body（childList + subtree + characterData），
60ms 防抖后重扫；面板在 = 有东西在等你，面板消失 = 结束了。另外在挂载时和"回到前台"时
各扫一次——前者覆盖"刷新时授权面板本来就在屏幕上"，后者覆盖"隐藏期间面板出现、MutationObserver
也被节流"的情况。
那一行的文案 = 面板的 textContent 依次减去三类噪音：
- 面板自己的固定文案（
等待审批/拒绝/允许一次/跳过本题/确认执行…，取自官方字典）。计划待审故意不剥——它是有意义的状态标签，不是按钮。 - 成对的 Markdown 标记（
**x**、`x`）——那一行是纯文本 HUD，不解释语法，不剥就会 原样显示星号。单星号*x*刻意不处理：它和通配符、乘法撞得太死，控制测试当场抓到过排除 *.png 和 2*3会被吃成排除 .png 和 23。下划线与波浪号也不碰（标识符和路径里太常见）。 - 行尾的短按钮标签（
提交/跳过/取消，提交来自 DSH 公共词表而非面板自己的字典）。 这些是普通词，只能切行尾——按钮在 DOM 里本来就是最后一个，所以提交前要检查什么里的"提交"不会被误删。
三个由此而来的性质：
- 去重靠面板自己的 key（属性值，如
approval:1）。同一个 key 重新渲染不会再播一遍 （否则你在面板里每敲一个字就弹一次）；换 key 才是新请求，才值得重新播报。 - 本插件再也不可能吞掉审批面板：不监听瀑布，就没有"忘了
next()把 agent 卡死"这个 失败模式。之前那条警告是真实风险，现在是结构上不可能。 - 代价：这是非官方钩子。DSH 若改掉这些 data 属性，状态会静默退化（见下）。
拿不到的信号（别指望）
| 想要 | 为什么拿不到 |
|---|---|
turn/end 的 reason（completed/error/aborted/blocked/max-tokens/interrupted） | 它确实存在于 SessionEventMap，但客户端插件没有订阅点：Session.events 是会话对象自己翻页 transcript 用的内部流，不是公开订阅。把所有 lib/client.js 扫过一遍，没有任何客户端消费者碰 turn/end。所以"这一回合是以什么方式结束的"推不出来 |
tool/result 的 error: {name, code} | 同样是 session event，够不到。所以"某个工具报错了"报不出来，只有 agent 级错误 |
| 挂起属于哪个会话 | DOM 里只有一个面板，拿不到它挂在哪个会话上（远程事件那条路本来可以用 ctx.sessions.scopeOf(this)，但那条路不通）。所以待授权/待回答不标注会话，系统通知的点击跳转也指向当前会话——子 agent 的授权可能跳错 |
| 主会话"子 agent 全部跑完" | 子会话行消失/停跑时不会再产生一次 COMPLETE。SUBAGENT 之后就没了 —— 要知道全部完成，得再发一条消息或看侧栏 |
兼容性风险：待授权/待回答依赖 DSH 官方面板的 data 属性（rc 版可能改名）。
最坏情况是这两个状态静默消失（只报 COMPLETE/ERROR），不会崩——每次扫描都套了
try/catch，拿不到节点就当没有。
视觉
不是"类似风格"，是照着开机屏的手法逐项复刻：
| 开机屏 | 本插件 |
|---|---|
| 左侧 8–10px 强调色进度轨 | 左侧 8px 强调色轨，scaleY 自上而下填充 |
| 黄色铺满收尾 | 底部强调色扫光（scaleX） |
END / FIELD 叠层大字 | 大字：COMPLETE / ERROR / APPROVAL / QUESTION / UNOPENED / SUBAGENT |
| 6 格方块状态条 | 同样的 6 格，带 animation-delay 依次点亮 |
| 纯边框叠层雪佛龙 | 同样的 border-left + border-bottom + rotate(-45deg) |
letter-spacing: .26em kicker | 同值 |
font-feature-settings: "tnum" 1 | 同值（时钟跳动时宽度不抖） |
全直角、发丝描边、#101110 / #f5f5f0 | 同值 |
完成 / 子 agent 的强调色不是硬编码：走 var(--edge-accent, #fff500)。装了终末地主题就自动跟随它的
谷地黄 / 武陵青配色，没装则退回信号黄——两种情况都成立。
其余状态用状态自己的颜色（红=错、橙=待授权、青=待回答），因为那是在表达"这不是正常完成"，
不该被主题配色吃掉。它们写在 CSS 的 [data-state="…"] 规则里，hex 与 rgb 三元组成对写死：
描边与辉光用的是 rgba(var(--tt-accent-rgb), x)，而 var() 拼不出 rgb 三元组——只改 hex 会让板子
变成"红轨黄光"。UNOPENED 的状态规则与 ERROR 逐字节相同，且有一条断言盯着它们不许漂移。
可调参数
client.js 顶部是一组常量（刻意不做设置页，设置命名空间要跨 Host/Client 两半，
且客户端读取时机有一整类竞态；先做成"改一行就生效"）：
const TOAST_MS = 5000 // 瞬时型停留时长（对齐系统通知的 5 秒档）
const PENDING_FULL_MS = 5000 // 挂起型整块显示多久，然后收成细边
const PENDING_ALWAYS_NOTIFY = false // 挂起型是否无视可见性也发通知（默认否，见上）
const EDGE_W = 8 // 可见细边宽度（原 6）
const EDGE_H = 128 // 细边长度的**退路值**；正常用板子的实测高度
const EDGE_HIT_W = 14 // 鼠标命中区宽度：比可见的条宽，否则点不中
const EDGE_HIT_PAD = 4 // 命中区比可见的条上下各多出的量
const WORD_DONE = 'COMPLETE'
const WORD_ERROR = 'ERROR'
const WORD_APPROVAL = 'APPROVAL'
const WORD_QUESTION = 'QUESTION'
const WORD_UNOPENED = 'UNOPENED'
const WORD_SUBAGENT = 'SUBAGENT'
const ACCENT_ERROR = ['#ff4d4f', '255, 77, 79'] // hex 与 rgb 必须成对
const ACCENT_APPROVAL = ['#ff9f0a', '255, 159, 10']
const ACCENT_QUESTION = ['#3fd8d0', '63, 216, 208']
const KICKER = '// TASK'
const TAG_DONE = 'SESSION IDLE' // 取不到任务名时的回退文案
const OS_NOTIFY = true // 系统通知总开关
const OS_NOTIFY_ONLY_WHEN_AWAY = true // 只在没看着 DSH 时才发系统通知
const TITLE_BADGE = true // 标题栏 ● 前缀
PENDING_FULL_MS 想调长（比如让挂起板子显示 30 秒再收边）直接改就行，有一条守卫专门保证
它不会被 TOAST_MS 提前掐掉——而那正是最容易被忽略的一处。
细边尺寸：EDGE_W 是可见的条宽度，EDGE_H 只是"还没量到板子高度"时的退路——
正常情况下脚本会把板子的实测高度写进 --tt-edge-h，细边跟着板子走。EDGE_HIT_W 与
EDGE_HIT_PAD 决定鼠标真正能碰到的那块。三条必须成立的几何关系，都有断言（且读源码真值）：
- 命中区比可见的条宽（否则鼠标点不中）；
- 板子的
EDGE边距大于命中区宽度（否则板子会盖住鼠标，悬停立刻结束、变成抽搐）； - 可见的条起点 = 板子的上边缘（命中区多出的 PAD 要在内部减掉，否则整条低 PAD 像素）。
改完重新加载 profile 即可。想额外在回合开始时也弹一次，把订阅回调里那句
if (prev === true && next === false) 补一个 else if (prev === false && next === true)
分支就行（前面的边沿跟踪已经在跑了）。
怎么验证
三个 harness，纯 Node，不需要 DSH 运行，也不碰真实 DOM（vm + 假 DOM/假时钟）：
node verify-toast.js # 信号与生命周期：基线、边沿、单例、teardown
node verify-notify.js # 通道：可见性路由、僵板回收、授权询问、系统通知契约
node verify-status.js # 多状态：六个状态、挂起生命周期、DOM 去重、展示行清理、优先级
verify-status.js 里几条值得单独说的：
- 不订阅瀑布：第一条断言就是"任何时刻都没有注册过远程监听器"。这不是洁癖——它就是 "插件再也不可能吞掉官方审批面板"这个安全性质的表述。
- 差分测试：把
PENDING_FULL_MS换成 15000 再跑同一套逻辑，验证挂起板子能活过TOAST_MS。 默认值下两个截止时刻相等，那条守卫看起来像死代码——只有改动一个常量才能证明它不是。 - 面板 key 去重：同一个 key 重新渲染不许再播一遍（否则你在面板里每敲一个字就弹一次）， 换 key 才重新播报。两个方向都有断言。
- 没看着才发通知：三个状态各有一条"正在看着 → 系统通知数是 0"的断言，加一条 "没看着 → 通知标题正确"的对照。挂起型曾经豁免于这条规则，被用户实际用过之后否掉了， 所以现在有变异体专门盯着它不许偷偷豁免。
- 展示行清理带反例控制：剥 Markdown 和行尾标签各有"必须剥掉"与"绝不能误伤"两个方向的断言
（
*.png/2*3/file_name必须原样保留，提交前要检查什么里的"提交"必须留下）。 - 挂载时就有面板：面板在插件挂载之前就存在的场景（刷新时授权框开着）单独测， 因为那条路径没有 MutationObserver 事件可依赖，只能靠挂载扫描。
变异测试（证明上面这些断言真的有牙）
_mutate.js 会针对每一条断言造一个只破坏这一件事的变异体，harness 必须失败：
node _mutate.js list # 列出全部变异体与它对应的断言
node _mutate.js no-dom-observer # 写出 _mutant.js
node verify-status.js "$PWD/_mutant.js" # 必须失败
| 变异体 | 破坏的是什么 | 结果 |
|---|---|---|
no-dom-observer | 不观察 DOM，挂载后出现的面板全瞎 | 28 条断言失败 |
edge-vanishes-on-arrive | 整块显示时把细边移除（鼠标底下的元素消失了） | 6 条 |
no-hover-expand | 悬停什么都不做（功能整个不存在） | 4 条 |
no-copy-strip | 把面板自己的按钮文案留在那一行 | 4 条 |
no-markup-strip | 让字面星号显示在板子上 | 1 条 |
markup-strip-too-greedy | 无差别删星号，毁掉通配符与乘法 | 2 条 |
no-tail-strip | 把提交按钮留在行尾 | 1 条 |
tail-strip-anywhere | 行尾标签改成全局删，吃掉问题正文里的同一个词 | 2 条 |
bar-still-tiny | 把细边改回那个"看不出来"的长度 | 1 条 |
bar-not-aligned | 细边贴回视口角落（比板子高出一个边距） | 1 条 |
bar-hardcoded-height | 不采用板子的实测高度，用写死的长度 | 1 条 |
slip-offset-by-padding | 忘记在内部减掉命中区的 padding（整条低 4px） | 1 条 |
pointer-target-overlaps-plate | 命中区宽到和板子重叠（悬停会抽搐） | 1 条 |
sticky-expires | 给挂起板子套上普通 toast 的截止时刻 | 2 条 |
no-key-dedupe | 把每次重扫都当新请求（重绘即重播） | 2 条 |
transient-wins | 让瞬时状态顶掉挂起板子 | 2 条 |
teardown-orphan | teardown 不做 DOM 清扫 | 2 条 |
pending-exempt-from-visibility | 让挂起型豁免可见性判据、盯着板子还弹通知 | 2 条 |
joins-waterfall | 偷偷去订阅审批瀑布（唯一能卡死 agent 的写法） | 2 条 |
timer-snatches-while-hovered | 你正指着它，定时器把板子收走 | 1 条 |
reduced-motion-stale-selector | reduced-motion 规则还打在那个动画已经搬走的元素上 | 1 条 |
scan-after-teardown | 卸载后已排队的扫描仍会反应 | 1 条 |
internal-parent-field | 用内部名 parentSessionId 代替 parentId | 1 条 |
error-refires | 去掉粘性错误的去重 | 1 条 |
判定标准是"退出码为 0 且打印了成功行"才算存活——只看有没有 FAIL 行会把"harness 直接崩了"
误判成存活（我第一版 runner 就这么错过一次）。
变异测试在这里不是形式，它抓出的每一类都是我自己写的问题：一段不可达的防御代码（删掉了）、
一个打空了的 reduced-motion 规则（动画搬到 ::after 之后没跟着搬）、一条拿 harness
自己的常量去比的不变式（所以 pointer-target-overlaps-plate 一开始活了下来）、
一个只写一次的高度（第一次挂起时细边先于板子高度测量被创建，于是永远停在退路值上），
以及一条过度剥离的清理规则（无差别删星号，把 *.png 和 2*3 吃成 .png 和 23）。
边界
- 提示板与细边都是
<body>子节点 +pointer-events: none，不拦截点击与文本选择；aria-hidden， 不打扰读屏。 - 同一时刻只保留一块板子：第二次完成会替换第一块，不会叠起来。细边在挂起期间一直留着（见上）。
- 细边是插件唯一接收鼠标的元素（命中区 14px 宽，贴在右上角）。代价是它下面那十几像素的应用 界面点不到——换来"鼠标移上去能再看一眼在等什么"。板子本身仍然是穿透的，不挡任何东西。
- 悬停只是鼠标的便利，键盘用户够不到它。它不执行任何动作（没有可"激活"的东西），而这一行信息
DSH 自己的面板里本来就有，所以它是
aria-hidden的——不是因为忘了做无障碍。 - 挂起板子占屏时，瞬时状态被丢弃（不抢屏、也不再发系统通知）。这是刻意的取舍：挂起意味着 agent 卡住了，比"完成了"更急；而且此时你明显在看着 DSH，DSH 自己的对话流里就有那条错误。
- 挂起状态依赖官方面板的 data 属性，属于非官方钩子；DSH 改名则这两个状态静默消失。
prefers-reduced-motion下保留出现/消失（那是信息），取消位移与扫光；细边由呼吸改为常亮。- 提示板与细边
z-index: 2147482800—— 低于终末地主题的开机屏（2147483000），高于它的雷霆大字 （2147482000），所以主题加载动画播放时仍然盖得住。
许可证
MIT