前言¶
在 DeepSeek Harness（DSH）里同时挂着多个 Agent 任务时，常见做法是反复切窗口看「好了没有」。注意力被窗口切换占掉，任务往往还没结束。
task-complete-chime 把「完成」变成可听见的信号：任务收尾、失败或纯问答一轮结束时响一次，听到声音再去看结果，中间可以去做别的事。下面是这个客户端类 DSH 插件的定位、能力与安装用法；事实以仓库 README 与 npm 包信息为准。
这是什么¶
- 名称：task-complete-chime（npm 包名相同）
- 维护者：lilinshuei
- 分类：客户端（DSH 插件目录归类）
- 许可证：MIT
- 简介：Agent 干完活自动响一声；内置约 12 秒原创 WAV 提示音，Windows 上播放零第三方 Python 依赖，也可换成自己的音频。
插件本身不监听 Agent 事件，需要 Agent 在收尾时调用播放脚本；DSH 侧通过 lib/index.js 与 cordis.patch.yml 完成挂载，运行时第三方依赖为 0。
核心功能¶
README 中已说明的行为如下。
- 只响一次：多步骤任务只在最后收尾响，不会每一步都打断。
- 成功与失败都提醒：失败也是一轮结论，听到声音即可去检查。
- 内置原创铃声：
assets/chime.wav，约 12 秒、22050Hz 单声道合成 WAV，README 称不含商业歌曲片段。 - Windows 零依赖播放：
scripts/chime.py使用 Python 标准库wave+winsound，无需pip install。 - 可自定义音频：支持指定 WAV；MP3 / MP4 需本机
ffmpeg在 PATH 中。 - 停止方式：
--stop、播满设定时长、或 Ctrl+C；README 称--stop写入停止标记后约 0.1 秒内停下。
安全与隐私方面，README 写明零遥测、本地执行、脚本以只新增不删除为约束、不含凭据；具体见仓库 SECURITY.md。
安装与启用¶
推荐通过 npm 注册表安装，命令与 README 一致。桌面端将 web 改为 desktop；安装后重启 DSH，新会话即可使用。在 DSH 桌面端「添加插件」窗口里只填包名 task-complete-chime，不要粘贴整条 shell 命令。
npm 一行安装（推荐）¶
dsh plugin --profile web add task-complete-chime
从 GitHub 安装¶
需要跟仓库最新提交，或 npm 拉取不畅时：
dsh plugin --profile web add github:lilinshuei/task-complete-chime
package.json 中 engines.node 为 >=20；插件版本当前资料为 1.0.0。
典型用法¶
环境要求（README）：Windows 10 / 11，Python 3.9+，除非 WAV 外无第三方 Python 包。
1. 播放默认铃声¶
在插件目录下执行，默认播放 assets/chime.wav：
python scripts/chime.py
2. 换成自己的音频¶
WAV 直接播放；可限制播放秒数：
python scripts/chime.py --audio "C:\path\to\your.wav" --seconds 8
3. 立刻停止¶
python scripts/chime.py --stop
SKILL.md 中写有触发时机、停止方式与设计边界，Agent 集成时应与该文档对齐。
适用场景与注意¶
适合：在 Windows 上使用 DSH / Agent，希望任务结束用声音提醒、减少盯屏；接受由 Agent 在收尾时显式调用 chime.py。
能力边界（README）：
- 仅支持 Windows（
winsound为 Windows 专属）。 - 不修改注册表、系统提示音，也不删除既有文件。
- 自定义歌曲需自行确认使用权。
权限：插件以当前 DSH 进程权限运行；安装前建议阅读源码、SKILL.md 与 MIT 许可证。社区目录站 SkillHub 插件页 与 GitHub 无 DeepSeek / 幻方官方从属关系，属社区「一切皆插件」生态中的独立条目。
仓库结构（便于对照）¶
task-complete-chime/
├── scripts/chime.py
├── assets/chime.wav
├── SKILL.md
├── lib/index.js
├── cordis.patch.yml
└── ...
结尾¶
task-complete-chime 把「任务是否结束」从反复看屏变成一声提示：内置 12 秒 WAV、Windows 标准库播放、可换音频与三种停止方式。需要安装与细节时，可看 SkillHub 目录页 与 GitHub 仓库。
