sjscy05/dsh-task-progress-notifier

dsh-task-progress-notifier

English

一个 DeepSeek Harness 插件，用于跟踪 agent 的 todo_write 任务列表，并在任务完成时在右下角弹出原生桌面提醒。

功能

- 监听持久化的 todo/write 会话事件，并为每个会话保留最新的完整列表快照。
- 将每次写入与上一次快照进行差分，因此它只播报真正的状态迁移，而不是每次重写都播报：
- notifyOnComplete —— 当任务变为 completed 时弹出提醒。
- notifyOnStart —— 当任务变为 in_progress 时弹出提醒（默认关闭）。
- notifyOnAllDone —— 当所有任务都变为 completed 后弹出汇总提醒。
- 注册一个 notify 工具，以便模型可以按需弹出提醒（Use the notify tool to remind me to take a break.）。
- 通知是跨平台的：
- Windows：PowerShell 托盘气泡提示（右下角）。
- macOS：osascript 通知。
- Linux：notify-send。

安装

在已安装 dsh 的机器上：

dsh plugin --profile  add github:sjscy05/dsh-task-progress-notifier

（ 是你希望安装该插件的 profile。）

或者直接从本地检出安装：

dsh plugin --profile  add ./task-progress-notifier

配置

该 bundle 自带合理的默认值。可在你的 profile 的 cordis.patch.yml 中覆盖它们：

- id: task-progress-notifier
config:
title: 'DeepSeek Harness'  # popup title
notifyOnComplete: true     # reminder per completed task
notifyOnStart: false       # reminder per started task
notifyOnAllDone: true      # summary reminder when everything is done

要求

可在 dsh profile 中运行于 Node 22.19+ / 24+。它仅导入 @deepseek-ai/dsh-tools 和 @deepseek-ai/schemastery，每个 dsh 安装都会通过 profile 的模块回退提供这些模块——无需安装额外依赖。

文件

- index.js —— 插件（name、inject、Config、apply、notify 工具）。
- notify.js —— 平台原生通知分发器。
- cordis.patch.yml —— 插入插件行的 bundle 补丁。

中文

一个 DeepSeek Harness 插件：跟踪 agent 的 todo_write 任务进度，并在任务完成时在电脑右下角弹出原生桌面提醒。

功能

- 监听持久化的 todo/write 会话事件，为每个会话维护最新的完整任务清单快照。
- 对每次写入与上一次快照做差分，只播报真正的状态迁移，而不是每次重写都播报：
- notifyOnComplete —— 任务变为 completed 时弹提醒。
- notifyOnStart —— 任务变为 in_progress 时弹提醒（默认关闭）。
- notifyOnAllDone —— 全部任务完成后弹汇总提醒。
- 注册 notify 工具，让模型可以主动弹提醒（例如「用 notify 工具提醒我起来活动一下」）。
- 跨平台通知：
- Windows：PowerShell 托盘气泡（右下角）。
- macOS：osascript 通知。
- Linux：notify-send。

安装

在装有 dsh 的机器上：

dsh plugin --profile  add github:sjscy05/dsh-task-progress-notifier

（ 是你想装进的目标 profile 名称。）

也可以从本地 checkout 直接安装：

dsh plugin --profile  add ./task-progress-notifier

配置

bundle 自带合理默认值。可在 profile 的 cordis.patch.yml 里覆盖：

- id: task-progress-notifier
config:
title: 'DeepSeek Harness'  # 弹窗标题
notifyOnComplete: true     # 每完成一个任务弹提醒
notifyOnStart: false       # 每开始一个任务弹提醒
notifyOnAllDone: true      # 全部完成时弹汇总提醒

环境要求

在 dsh profile 中运行，需要 Node 22.19+ / 24+。仅导入 @deepseek-ai/dsh-tools 和 @deepseek-ai/schemastery，这两个包每个 dsh 安装都会通过 profile 的模块回退目录提供——无需额外安装依赖。

文件

- index.js —— 插件本体（name、inject、Config、apply，以及 notify 工具）。
- notify.js —— 平台原生通知派发。
- cordis.patch.yml —— 插入插件行的 bundle patch。