前言¶
在 DeepSeek Harness（DSH）里编排任务后，如果长时间离开或切到其他会话，容易错过任务完成、待确认或失败的状态变化。手动的「刷新会话」或「查看历史」无法覆盖所有场景，尤其是需要等待用户交互的「待确认」状态。下面介绍一个原生插件，在后台监听任务状态变化，并统一管理完成、待确认与失败三种状态，支持站内记录与系统通知。
插件定位¶
dsh-task-alerts 是一个 DeepSeek Harness 原生插件，由维护者 yxue301603 开发。它把任务状态从分散的会话中抽离出来，集中展示未读或按状态筛选的任务，并支持一键「前往会话」回到原上下文。
核心功能¶
任务状态区分¶
插件将任务状态分为三类：
- 完成：任务正常结束，有明确结果。
- 待确认：宿主当前仍在等待原生交互请求，需要用户介入。
- 失败：任务运行失败或被停止，有明确原因。
「待确认」仅来自宿主当前仍在等待的原生交互请求。因前置检查拒绝而结束的 blocked 轮次属于「已结束」，不会误标为待用户确认。
站内记录与筛选¶
在输入框旁打开「任务提醒」面板，可以查看未读记录，或按状态筛选（完成 / 待确认 / 失败）。点击「前往会话」会跳转到对应会话，继续处理。站内记录默认开启。
记录保存在本地，最多保留 200 条，支持中英文与深浅主题切换。
系统通知与隐私¶
系统通知默认关闭。只有主动点击「开启系统通知」才会请求通知权限。
通知默认静音，并在 DSH 前台且获得焦点时抑制。面板中可以开启前台通知。
通知仅显示会话标题，不暴露回答正文。支持标记已读、批量标为已读、清理已读记录。
实时监听与隐私保护¶
插件监听插件启动后的原生实时变化，不回放旧会话产生历史误报。已打开会话的原生事件提供失败、停止和完成原因，统一原生待确认状态提供交互提醒。
跨会话只获知运行状态结束，没有明确结束原因时，显示「已结束，请查看结果」，不会推断任务成功。部分宿主未公开完整数据时，只提供可用的状态；不会为监控而打开其他会话历史。
记录只保存在本地，无 API Key、无模型调用、无外部推送服务器。
断开客户端或关闭应用期间无法发通知。
安装与启用¶
在 DSH 的「插件 → 添加插件」中粘贴以下 URL：
https://github.com/yxue301603/dsh-task-alerts
安装并启用后，按 DSH 提示重新加载。仓库已包含预构建文件，无需自行编译。
需要 DSH 0.2.1-rc.2 或兼容的 0.2.x 版本。迁移、整套安装与升级说明见 工具箱安装指南。
典型用法¶
- 安装并启用插件后，在任意会话中执行需要等待的任务（例如需要输入确认的复杂操作）。
- 切换到其他会话或离开 DSH，等待任务状态变化。
- 在输入框旁点击「任务提醒」，查看是否有新的未读状态。
- 按状态筛选（如只看待确认），找到需要处理的项目。
- 点击「前往会话」，回到原会话继续操作。
- 如需系统通知，在面板中点击「开启系统通知」，允许权限后即可接收提醒。
适用场景与注意¶
适合需要长时间等待或需要用户确认的任务编排场景，如自动化工作流、多轮交互任务、批量处理等。
插件以当前 DSH 进程权限运行，安装前建议查看源码与许可证。若宿主未公开完整状态数据，插件只提供可用的状态，不会强行推断结果。
结尾¶
dsh-task-alerts 把任务状态从会话中抽离出来，提供统一的查看与跳转入口，适合需要后台监控与状态管理的场景。安装地址见 GitHub。
