dsh-ui-chime
Verified@uachar/dsh-ui-chime · v0.1.3 · MIT · Web UI
DSH 思考结束提示音:每轮对话完成或等待用户答复时在浏览器播放提示音,支持音量调节。
Install
dsh plugin add @uachar/dsh-ui-chime Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
@uachar/dsh-ui-chime(思考结束提示音)
DeepSeek Harness 的浏览器提示音插件:每当模型到达用户关心的边界——一轮对话完成,或正在等待用户——浏览器播放一声短促的合成"叮"。无音频资源、不写会话日志、不改 dsh 核心;作为独立包安装。
插件功能
- 每轮对话全部完成时响(
turn/end,completed/max-tokens)——多步骤回合中间的间歇思考不响。 - 等待用户确认权限时响(
approval/asked)——模型在等权限决定。 - 模型调用
ask_user_question时响(tool/call)——它在等用户选择方案。 - 音量调节,拖动滑条即时试听,设置持久保存。
- 音效由 Web Audio 合成(振荡器 + 增益包络)——零音频文件,不增加任何资源体积。
- 历史回放(打开会话、翻页、重连)不响:事件距现在 10 秒内才视为实时。
如何使用
- 音量调节:聊天输入框工具行左侧的喇叭按钮(Windows 风格线条图标),点击弹出音量滑条;拖动滑条时会即时播放对应音量的试听音。设置保存在
localStorage(dsh.ui-chime.volume)。 - 自动播放策略:浏览器在首次用户手势前挂起
AudioContext,因此页面未被点击过时提示音静默——点击页面任意位置后即正常。
安装与卸载
需要可用的
dshCLI(pnpm)与一个 profile,例如web。
从 npm 安装(推荐)
pnpm dsh plugin --profile web add @uachar/dsh-ui-chime
从 GitHub Release tarball 安装
pnpm dsh plugin --profile web add https://github.com/uAcharGG/dsh-ui-chime/releases/download/v0.1.0/uachar-dsh-ui-chime-0.1.0.tgz
从源码构建并安装
git clone https://github.com/uAcharGG/dsh-ui-chime.git
cd dsh-ui-chime
pnpm install
pnpm run build # tsc -> tsdown;产出 lib/index.js 与 lib/client.js
pnpm dsh plugin --profile web add link:<本目录的绝对路径>
安装后重启 dsh 生效。
卸载
pnpm dsh plugin --profile web remove @uachar/dsh-ui-chime
随后重启 dsh。(面板中的启/停只改组合层,不卸载代码。)
项目文件结构
| 文件 | 作用 |
|---|---|
cordis.patch.yml |
bundle 组合层:把自己作为一行 ui-chime 插入 profile |
src/index.ts |
主机侧:空 apply(让行出现在 Host Loader / dsh.client 扫描中) |
src/client/index.ts |
浏览器侧:无头 Conversation Definition(响铃触发)+ 音量控件注册 |
src/client/chime.ts |
Web Audio 合成引擎 + 音量持久化 |
src/client/volume-control.tsx |
输入框工具行的喇叭按钮与音量滑条 |
lib/ |
构建产物(随包发布) |
使用限制
- 自动播放策略 —— 首次用户手势之前的提示音会被静默跳过(解锁监听器让之后的一声正常响起)。
- 仅边界事件 —— 触发点是
turn/end、approval/asked与ask_user_question工具调用;推理中途被中断的步骤不会响。 - 无按会话控制 —— 提示音对所有会话同一音量(全局音量,存 localStorage)。
许可
MIT