前言¶
在使用 DeepSeek Harness (dsh) web 进行开发或调试时，Agent 在运行过程中可能会遇到需要用户介入的节点，例如轮次结束等待输入、工具审批请求或模型提问。如果此时页面处于后台或未及时查看，这些状态很容易被遗漏。dsh-turn-reminder 插件旨在解决这一问题，通过监听 Agent 状态并在需要时触发通知，确保用户不会错过任何阻塞点。
插件简介¶
这是一个用于 DeepSeek Harness web 的用户注意力通知插件。当会话等待用户操作时，该插件会提供页面内 Toast 提示或系统级浏览器通知。该插件由 SipengXie2024 维护，开源协议为 MIT。
核心功能¶
插件通过监听特定事件来识别需要用户注意的场景：
- turnEnd：监听
agent/status事件。当 Agent 从运行状态转为空闲状态时触发。这涵盖了已结束的目标和出错的轮次。 - approval：监听
approval/request事件。用于处理工具审批、沙箱升级等需要中断当前流程的操作。这些操作通常发生在轮次中间。 - question：监听
tools/pre-execute事件中的ask_user_question。当模型向用户提问时触发。 - plan：监听
tools/pre-execute事件中的exit_plan_mode。当模型展示计划供审核时触发。
通知机制分为两种：
* 页面可见时：显示页面内 Toast 提示。
* 页面隐藏时：显示操作系统级别的浏览器通知。
安装与启用¶
使用官方提供的安装命令添加插件：
dsh plugin --profile web add dsh-turn-reminder-0.1.0.tgz
安装完成后，需要重启 dsh web 进程。插件会在启动时加载并自动为所有会话提供提醒服务。
使用说明¶
- 在 DSH web 的 Composer 工具栏右侧找到 🔔 按钮。
- 点击该按钮以授予浏览器通知权限（浏览器要求必须通过用户手势触发权限请求）。
- 之后，每当出现上述四种情况之一，系统会弹出通知。Toast 提示会在 8 秒后自动消失，也可以手动点击关闭。
注意事项¶
- 计数器逻辑：插件仅在加载后开始记录事件，进程重启后计数器会重置。第一次轮询仅记录基线数据，不会针对历史事件发送提醒。
- 版本兼容性：该插件在 dsh
0.1.0-rc.6版本下测试通过。 - 本地重新安装：如果通过本地 tarball 文件重新安装，需要手动 bump 版本号。这是因为 pnpm 会保留同名同版本的旧构建文件，导致新安装的插件未生效。
生态与链接¶
DeepSeek Harness 的设计理念是“一切皆插件”。该插件属于社区目录中的项目，与 DeepSeek 官方应用无关。如需查看源码或反馈问题，可访问其 GitHub 仓库：https://github.com/SipengXie2024/dsh-turn-reminder
