在 DeepSeek Harness (DSH) 的开发流程中，agent 经常需要人类介入：回合结束后等待回复、调用工具提问、或者执行审批操作。一旦你切换了标签页或去处理别的事务，这些请求可能会被忽略，agent 便会长时间处于空闲等待状态。dsh-plugin-attention-chime 解决了这个问题，它通过 macOS 的系统提示音和通知横幅，把「agent 需要你」变成听得见、看得见、且可点击跳转的信号。
功能说明¶
这个插件主要提供以下能力：
- 三类独立提醒：针对「等待回复」、「提问」和「审批」三种场景，提供独立的开关、提示音和音量控制。
- 系统通知与跳转：弹出 macOS 系统通知横幅。如果安装了
terminal-notifier，点击通知可以自动激活浏览器，并切换到标题匹配该会话的标签页。 - 后台任务守卫：插件会检查 agent 是否有后台任务（job）或正在运行的子代理。只有在 agent 确实空闲时才会触发提醒，避免误报。
- 升级提醒机制：如果长时间未理会，插件会按设定间隔重复提醒，并自动增加音量（每次 +0.5，上限 3），直到处理或达到最大次数。
- 灵活配置：支持在设置页的卡片中直接配置，也支持通过
cordis.patch.yml进行 profile 补丁覆盖。
安装¶
在终端中执行以下命令进行安装：
dsh plugin --profile web add github:YuChuanhui3/dsh-plugin-attention-chime
安装后需要重启 dsh web 以加载新的插件层。
注意：若想体验点击通知跳转功能，需要先安装 terminal-notifier。
配置与使用¶
安装完成后，可以通过以下方式进行配置或测试。
设置页配置¶
在 DSH 的设置界面中找到「插件 -> 可配置 -> 「注意力提醒」」卡片。在此处修改参数后即可生效，配置会持久化到 ~/.dsh/settings.yaml。
Profile 补丁覆盖¶
也可以在 profile 的 cordis.patch.yml 中对配置进行覆盖。需要注意的是，补丁会整行替换 config，因此必须提供完整的配置项。
试听提示音¶
在安装插件前，你可以先测试系统自带的提示音，确认音效符合预期：
# 试听回复等待音效
afplay /System/Library/Sounds/Glass.aiff
# 试听提问等待音效
afplay /System/Library/Sounds/Funk.aiff
# 试听审批等待音效
afplay /System/Library/Sounds/Sosumi.aiff
环境与限制¶
- 运行环境：插件全本地运行，不依赖任何外部服务，无遥测数据收集。但需要 macOS 环境，并授予系统权限（通知、自动化）。
- 依赖要求：需要安装 DeepSeek Harness 的 web profile。
- 兼容性：兼容 dsh 0.1.2-rc 系列。
- 标签页匹配策略：点击跳转时，插件通过标题包含会话名来匹配浏览器标签页。如果存在多个标题高度相似的标签页，可能会聚焦到错误的标签页。
