deepseekplugins

DeepSeek Harness plugin

dsh-done-notifier

当 DeepSeek Harness 模型完成回复、等待用户输入时，弹出 macOS 系统通知并播放童声提示音「老板，我干完活儿了！快来！」。

Models & Providers
Jump to install

Source facts

Repository
tdeluna024-ui/dsh-done-notifier
Latest update
Aug 16, 2026
Category
Models & Providers
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/tdeluna024-ui/dsh-done-notifier
Plugin: dsh-done-notifier
Author: tdeluna024-ui

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-done-notifier

!License: MIT !dsh-plugin

当 DeepSeek Harness（DSH）的模型完成一轮回复、等待你输入时，自动弹出 macOS 系统通知，并播放一句童声提示音：

> 「老板，我干完活儿了！快来！」

让你离开电脑或切到别的窗口时，也能第一时间知道「轮到你了」。

![demo](docs/demo.gif)

目录

  • [特性](#特性)
  • [环境要求](#环境要求)
  • [安装](#安装)
  • [自定义](#自定义)
  • [工作原理](#工作原理)
  • [发布新版本](#发布新版本)
  • [License](#license)

特性

  • 模型每完成一轮回复、状态进入 idle 时触发一次通知。
  • 弹出系统通知横幅（标题 DeepSeek，正文 模型已完成，等你回复）。
  • 同时用 afplay 播放随包携带的童声提示音（真人神经语音合成）。
  • 只通知顶层对话，忽略子代理（subagent）的结束，避免轰炸。
  • 单轮内模型连续调用多个工具期间状态保持 running，不会重复触发。
  • 纯 JS、零依赖、无需构建授权，从 GitHub 直装即可。

环境要求

  • macOS（依赖系统自带的 osascript 与 afplay）。
  • DSH 已安装，profile 包含提供 agents 与 shell 服务的宿主组合（@deepseek-ai/dsh-base 即满足）。

非 macOS 平台会打印一条警告并跳过，不影响其他功能。

安装

从 GitHub 直接安装（推荐，无需 npm）：

dsh plugin --profile <你的 profile 名> add github:tdeluna024-ui/dsh-done-notifier

或从发布页下载 tarball 离线安装：

curl -LO https://github.com/tdeluna024-ui/dsh-done-notifier/releases/latest/download/dsh-done-notifier-0.1.0.tgz
dsh plugin --profile <你的 profile 名> add ./dsh-done-notifier-0.1.0.tgz

安装后重启 DSH 生效。若 dsh 不在 PATH，改用：

node <dsh 安装根目录>/apps/cli/lib/bin.js plugin --profile <name> add github:tdeluna024-ui/dsh-done-notifier

自定义

  • 横幅文案：index.js 顶部的 TITLE / BODY 常量。
  • 提示音：替换 assets/notify-kid.mp3（afplay 支持 mp3 / aiff / m4a / wav），保持文件名一致即可。

工作原理

  • 监听宿主事件 agent/status：状态从 running 回到 idle 即表示「模型跑完、等待用户」。
  • 通过 ctx.agents.roots() 识别顶层对话，过滤子代理。
  • 用 shell 服务依次执行 osascript（弹横幅）与 afplay（放提示音）。
  • 提示音通过 import.meta.url 从包目录解析，不依赖任何用户绝对路径。

发布新版本

本项目用 GitHub Actions 自动打包。推送一个 v* 标签即可自动发布：

git tag v0.1.0
git push origin v0.1.0

工作流会运行 npm pack，把 dsh-done-notifier-<version>.tgz 上传到对应 Release。

License

[MIT](./LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category