LongFuXiaoFeng/dsh-task-reminder ↗★ 1

dsh-taskreminder

A DSH (DeepSeek Harness) Cordis plugin that plays a crisp 'ding' the moment the agent finishes a task. / DSH 任务完成提醒插件:智能体完成任务时播放一声清脆的叮声。 适合在后台运行任务、需要声音提醒任务完成的用户。

Package
dsh-taskreminder
Compatibility
Unverified
Version
1.0.2
License
MIT
Last updated
Aug 25, 2026

Install

This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗

🔊 dsh-task-reminder

DSH 任务完成提醒插件:任务完成时响一声清脆的"叮"。 A DSH (DeepSeek Harness) Cordis plugin: a crisp ding when your agent finishes a task.

License: MIT

当当前会话的智能体完成任务(回复结束)时播放一声清脆的"叮",无需盯着屏幕也能知道任务已完成。仅响应顶级会话,子代理不触发;声音为内存合成,不依赖系统声音方案。

Plays a crisp ding the moment the agent finishes your task — no need to watch the screen. Only top-level sessions trigger it (subagents never do); the sound is synthesized in memory, independent of the OS sound scheme.


⚡ 安装 / Install

npm 一键安装(推荐):

npx dsh-taskreminder@latest
  • 从 npm 安装 dsh-taskreminder 包并自动安装插件到 $DSH_HOME/profiles/web(拷贝源码 + 写组合补丁,幂等)
  • 卸载:npx dsh-taskreminder@latest uninstall
  • 指定 profile:npx dsh-taskreminder@latest --profile (EAC 桌面客户端:--profile web-desktop)
  • 全局安装后可直接用 dsh-taskreminder install

或 PowerShell 一键脚本(从 GitHub 克隆仓库 + 建联接,适合开发者改源码):

irm https://raw.githubusercontent.com/LongFuXiaoFeng/dsh-task-reminder/main/install.ps1 | iex
  • 卸载:.\install.ps1 -Uninstall

装完 重启 DSH 即自动加载。也可作为动态插件(DSH 会话内,无需重启):将 plugin/index.js 的 apply 函数体粘贴到 cordis_define 的 code.host(idPrefix: taskrm),再 cordis_run 激活。

详细说明见 docs/INSTALL.md。


⚙️ 工作原理 / How it works

  1. 启动时通过 agents.currentInitiator() 捕获所属 agent(动态插件方式);组合方式退化为"任一顶级会话"
  2. 监听 agent/status,agent 转为 idle(任务完成)时触发
  3. 经 shell 服务以 workspace-write 策略执行 PowerShell,合成 1568 Hz 正弦波 + 指数衰减的"叮"(~0.6s)

🎵 自定义音色 / Customizing

编辑 plugin/index.js 中 DING 脚本的关键参数:$f(频率 Hz)、$dur(秒)、$decay(衰减速率)、振幅系数 0.35。


📁 结构 / Layout

install.ps1          # 一键安装/卸载脚本
plugin/index.js      # 插件源码
docs/INSTALL.md      # 详细安装说明

📄 License

MIT © 2025 LongFuXiaoFeng