dsh-task-feedback

为 DeepSeek Harness 打造的会话状态反馈插件。基于真实使用痛点而做：

切到其他标签页或离开电脑时，无法实时感知到 Agent 是否已完成回复，或是否需要人工介入。

安装

# 浏览器访问的 Web profile
dsh plugin --profile web add dsh-task-feedback

# Desktop 客户端 profile
dsh plugin --profile desktop add dsh-task-feedback

DSH 的客户端 API 在 rc.x → alpha.x 之间前向不兼容：装错版本不会优雅降级，而是在运行时直接报错（常见症状 TypeError: useConversation is not a function）。请按你的 DSH 版本选择插件版本：

你的 DSH	建议安装
`0.2.x`（已在 `v0.2.1-alpha.2` 上实测）	`dsh plugin --profile <profile> add dsh-task-feedback`（最新，当前 `0.2.1`）
`0.1.2-alpha.1` ~ `0.1.x`	`dsh plugin --profile <profile> add [email protected]`

主视图会话与待介入状态的读取都做了双代次兼容，0.2.x 在旧版 DSH 上通常也能运行；但上表中只有 0.2.x × v0.2.1-alpha.2 这一组经过本版本实测（0.2.1 相对 0.2.0 仅元数据变更，运行时代码逐字节一致）。

切走标签页时，把 DSH 的 Favicon 换成状态指示图标（默认小圆点，可在设置中改为圆形或圆角矩形），并根据会话状态实时变色：

设计巧思：

在切走标签页时，才会根据状态更改 Favicon（原生 Page Visibility API 实现）
若会话本身已经处于空闲/完成状态，Favicon 仍然显示默认的小鲸鱼（最低打扰设计）
支持配置多种形状：小圆点 | 圆形 | 圆角矩形
形状设置仅在 Web 模式提供：Desktop 客户端窗口没有浏览器标签栏，Favicon 不可见，因此设置中的「图标样式」分组会在 Desktop 下自动隐藏

人工精选了 12 个合成音效，可以为「任务已完成」和「需要你介入」分别选择不同的音效，并控制播放时机：

全部：无论页面是否失焦，只要当前会话已完成或需要人工介入，就播放音频提示；
仅失焦时：仅在页面失焦时播放音频——切走标签页、最小化、关闭显示器（原生 Page Visibility API），或切到其他应用/窗口导致窗口失焦（window 的 blur 事件）

技术亮点 - 所有可选音效均由 Web Audio API 合成，零外部依赖。鼠标悬停即可试听。

所有设置项（Favicon 形状、音效作用域、音效选择）均在 设置 → 反馈 中配置，持久化在 localStorage 中。

MIT