前言¶
在使用 DeepSeek Harness 进行 Agent 开发时，Agent 在执行任务或等待用户输入的回合间隙，容易错过状态变化。DSH 的插件机制允许开发者扩展客户端行为。wenowen/dsh-your-turn 插件通过弹窗和提示音，在回合交接时提醒开发者，并保留未查看的提醒列表。
是什么¶
该插件由 WenOwen 维护，属于客户端插件。它主要解决 Agent 停止运行或等待用户回答时的状态同步问题，通过视觉和听觉双重提醒，确保开发者不遗漏关键回合。
核心功能¶
- 回合结束提醒：Agent 完成任务、出错或中断时，弹窗或横幅提示。弹窗展示会话标题、工作目录等信息。
- 直接回到会话：在提醒弹窗中点击「跳到会话」可快速返回。
- 提问时响铃：Agent 提出新问题等待回答时，仅播放提示音，不弹窗遮挡内容。
- 侧栏小喇叭：侧边栏显示未查看提醒的计数，悬停可查看列表，点击跳转。
- 六种合成音色：支持风铃、轻点、马林巴、街机、水滴、警示六种由浏览器实时合成的音色。
- 同源多标签协同：在多个标签页间协调提醒，一处关闭其他同步关闭，避免重复提醒。
安装与启用¶
在已配置 DeepSeek Harness 的环境中运行，将 web 替换为你实际使用的 profile 名称（例如 desktop）：
npx @deepseek-ai/dsh plugin --profile web add github:WenOwen/dsh-your-turn
安装后需要重启 Harness 并刷新 Web 客户端。
- 打开 设置 → 轮到你了，选择提醒形式、音色与音量。
- 点击 试听，解锁当前页面的声音播放权限。
- 运行一个 Agent 回合，结束后即可看到交接提醒。
设置说明¶
修改选项和开关后自动应用。
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 提醒形式 | 居中弹窗 | modal 为弹窗，toast 为顶部横幅。 |
| 自动消失 | 5 秒 | 可选择预设时长或自定义 0–600 秒；0 表示手动关闭。 |
| 播放提示音 | 开启 | 控制回合交接与提问时的声音。 |
| 成功响应 | 风铃 | 正常回合交接使用的音色。 |
| 异常响应 | 警示 | 出错、中断或截断时使用的音色。 |
| 音量 | 70 | 可调整为 0–100。 |
音色列表：风铃 (chime)、轻点 (ping)、马林巴 (marimba)、街机 (arcade)、水滴 (drop)、警示 (alert)。
保存位置：本机页面保存到 DSH 部署；远程页面仅保存到当前浏览器。页面会显示当前保存位置；只读或无法提供插件设置的部署可能无法编辑。
适用场景与注意¶
- 环境要求：需要带 Web 客户端的 profile，例如
web或desktop。 - 运行状态：客户端需要保持打开并连接 Host；关闭页面后无法继续观察回合状态。
- 声音播放：声音受浏览器播放权限与系统音量影响。如果没声音，请检查设置中的「播放提示音」是否开启，并确认音量不为 0。
- 兼容版本：当前项目对接 DeepSeek Harness
0.2.0-rc.2。
总结¶
该插件通过弹窗和声音提醒，解决了 Agent 回合交接时的状态同步问题，适合需要长时间运行 Agent 并在多任务间切换的开发者使用。
