Plugin directory / Developer / dsh-task-notify
dsh-task-notify
Verified · install-tested on dsh ltao0829
What it does
DeepSeek Harness task-completion reminder plugin
Works — verified, early-stage project
DeepSeek Harness task-completion reminder plugin It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-task-notify
DeepSeek Harness (DSH) Web 的任务完成提醒插件。任务完成、需要审核、失败时都会弹提醒;
默认同时发送系统通知(OS notification,像 Codex 那样)和页面右下角 toast,可选提示音。
功能
- 对话任务完成提醒(agent 一轮 turn 结束)
- 后台任务完成提醒(后台命令 / 子代理作业结束)
- 需要审核时提醒(审批 / 计划评审 / 提问)
- 失败提醒(对话报错 / 后台任务失败或被终止)
- 通知方式:浏览器系统通知 + 页面 toast + 可选提示音
安装
# 前提:先装 pnpm
npm i -g pnpm
dsh plugin --profile web add git+https://github.com/ltao0829/dsh-task-notify.git
安装后重启 dsh web,刷新页面。
首次在页面里点击/按键时,浏览器会请求「通知」权限,点允许即可收到系统通知。
网络提示:git 安装需要能直连 github.com(国内可能需要代理);发布到 npm 后可用
dsh plugin --profile web add @linxin666/dsh-task-notify,走 npm CDN 通常更稳。
配置
设置里的「插件」配置区会出现「任务完成提醒」卡片(本地存储,无需额外授权):
| 开关 | 默认 | 说明 |
|---|---|---|
| 启用提醒 | 开 | 总开关 |
| 对话任务完成提醒 | 开 | agent 一轮任务结束时提醒 |
| 后台任务完成提醒 | 开 | 后台命令 / 子代理作业结束时提醒 |
| 需要审核时提醒 | 开 | 运行中等待审批 / 计划评审 / 提问时提醒 |
| 失败时提醒 | 开 | 对话报错 / 后台任务失败或被终止时提醒 |
| 浏览器系统通知 | 开 | 发送操作系统通知(需授权) |
| 提示音 | 关 | 额外播放提示音 |
实现说明
- 纯客户端监听:订阅
ctx.sessions.list,对相邻两次快照做 diff,检测 turn 完成、
job 完成、pendingInteraction(需要审核)与 lastAgentError(失败)。 - 首次快照只建立基线,刷新不会为历史任务补发提醒。
- 设置用 localStorage 存储(键
dsh.taskNotify.v1),不依赖 settings 命名空间。 - 检测逻辑(
src/detect.ts)为纯函数,可直接单测。
开发
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalog Then say "install dsh-task-notify for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:ltao0829/dsh-task-notify Headless (CLI) profile:
dsh plugin --profile headless add github:ltao0829/dsh-task-notify Test report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Extend the agent's coding surface — give it a new tool, workflow, or integration so it handles a dev task it couldn't before.
Who it's for
Developers who want dsh to behave like a teammate on real codebases — editing, running, and verifying changes rather than just answering.
For developers — extending it
The tool/command surface is the seam: expose more of the SDK, add smarter context wiring, or tighten the loop between code changes and verification.