在使用 DeepSeek Harness(DSH)桌面版进行多轮对话或长时间会话时,用户可能难以第一时间察觉对话轮次完成或应用启动的状态变化。dsh-chimes 插件通过在特定时机触发系统提示音,弥补了视觉反馈的盲区。
插件概览¶
这是一个为 DeepSeek Harness 桌面版设计的插件,提供应用启动和对话轮次完成时的提示音。代码与资源均开源,代码许可证为 MIT,资源许可证为 CC0-1.0。插件纯本地运行,不依赖网络或遥测数据。
核心功能¶
- 启动提示音:当桌面应用窗口即将渲染时播放一次。
- 完成提示音:当单次对话轮次成功结束时播放(仅针对用户会话,跳过子代理会话)。
- 界面控制面板:提供独立的开关、下拉菜单和预览功能,无需命令行操作。
- 音效库管理:内置 9 个示例音效,支持自定义音频文件(mp3, m4a, wav, ogg, flac)。
- 本地运行:完全在本地通过 Windows 的
System.Media.SoundPlayer播放,无网络请求。
安装与启用¶
在终端执行以下命令安装插件:
dsh plugin --profile desktop add github:boring-cuzzz/dsh-chimes
安装后,在侧边栏进入 Plugins 页面(或部分核心中的 Settings -> Plugins),找到 Chimes 即可访问控制面板。插件加载后,无需重启即可立即生效。
配置与用法¶
插件支持通过配置文件调整行为。在当前配置文件中编辑 cordis.patch.yml:
- insert:
- id: startup-chime
name: dsh-chimes
config:
kind: startup
enabled: true
delayMs: 350 # UI 就绪后额外等待的毫秒数
waitMs: 6000 # 超时后强制播放的毫秒数
- id: done-chime
name: dsh-chimes
config:
kind: done
enabled: true
cooldownMs: 1500 # 两次提示音之间的最小间隔
minTurnMs: 0 # 设为 5000 等仅对长轮次播放
全局静音可设置环境变量 DSH_CHIME_MUTE=1。
注意事项¶
- 平台限制:仅支持 Windows。
- 依赖要求:需要 DSH 桌面版至少启动过一次,且系统 PowerShell 版本为 5.1 及以上。
- 音频格式:通过命令行安装时,音频文件必须是 PCM WAV 格式;通过控制面板添加自定义音频则支持浏览器直接转换。
- 安全性:无运行时依赖,无 postinstall,无网络调用。
结语¶
dsh-chimes 通过简单的提示音反馈提升了 DSH 桌面版的使用体验。更多细节可参考 Catalog 或 GitHub。