@xain_npm/dsh-client-ui-beep
DeepSeek Harness 的网页代理心跳声音化：代理工作时发出平静的 lub-dub 嗡鸣，流式输出时发出滴答声，会话等待你输入时发出提示音
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xain/ui-beep#c297e055040c2444d981cb8a6ac4381b08e43171Client Ui Beep 以 @xain_npm/dsh-client-ui-beep 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →English | 中文
dsh-beep — an agent-heartbeat sonification plugin for the DeepSeek Harness Web surface. It plays three procedural Web-Audio tones as a subtle, non-intrusive heartbeat that tells you what the agents on this page are doing without watching the screen:
This package is a standalone, publishable fork of the
ui-beepplugin from the deepseek-harness repository (MIT). It builds with its owntsconfig.json+tsdown.config.ts(the in-repo build uses the sharedclientBundlepreset; this copy reproduces the same output format standalone).
npm install @xain_npm/dsh-client-ui-beep
# or: pnpm add / yarn add
Then mount it in your harness cordis.yml (or a cordis.patch.yml overlay) as a
web client row:
- id: ui-beep
name: '@xain_npm/dsh-client-ui-beep'
config:
volume: 0.5 # master gain 0…1
enabled: true # false silences everything
npm install
npm run build # tsc + tsdown → lib/
npm test # vitest (19 specs)
npm login # your npm account
npm version patch # bump
npm publish # prepublishOnly runs build + test first
| Voice | When | Sound |
|---|---|---|
| hum | Any session is busy (working) — "Deep diving…" (model request in flight), tool execution (running code, reading files), reasoning — and no session awaits your input and the current session is not streaming visible output. Repeats as a calm heartbeat every 4 s; pauses while output streams (ticks take over) and while an interaction is pending (the chime already alerted you) | Soft low "lub-dub" heartbeat (~118 Hz + ~92 Hz), ~500 ms |
| tick | The current session streams visible output | Short high 2 kHz pop (~60 ms) |
| chime | Any session begins awaiting your input (approval, plan review, or question). An unanswered interaction re-chimes after 10 s, then every 30 s, until answered | Two-tone 880 Hz + 1320 Hz bell (~500 ms) |
The mapping is an AgentPulse heritage: the agent working → a low heartbeat hum, output activity → a light tick, the agent waiting on you → a clear chime.
The browser half observes three React-free observable faces:
ctx.sessions.list (an ObservableSnapshot<SessionListState>): every session row's running bit.
running is the busy signal: it stays true for a whole turn, from prompt admission through tool execution and reasoning. While any session is running, the low hum repeats on a fixed interval (default 4 s, configurable) — first beat immediate when work begins (or on page load, if a session is already mid-work). The hum pauses only while the current session is actively streaming visible output (ticks take over — "streaming" means text growth within the last 1.5 s, configurable) and while any session holds a pending interaction (the chime already alerted you). It resumes ~1.5 s after output stops — even when the agent keeps working (a tool call after a message) — and when the interaction clears. It stops entirely when the last running session goes idle. This is level-based: it is the "something is working" indicator. The tone itself is a soft low lub-dub heartbeat (two gentle sine swells around 90–120 Hz with slow attacks) — reassuring, not urgent.ctx.uiSession.pendingInteractions (an ObservableSnapshot<SessionPendingInteractionSnapshot>): every session's effective pending interaction (approval / plan-review / question). A 0→1 appearance for a session chimes. Decisions are edges, never levels — a session that stays pending does not re-chime on every refresh. An interaction that stays unanswered re-chimes after 10 s and then every 30 s (both configurable) until it is answered or the session disappears; an interaction already pending when the page loads starts the same reminder ladder (no immediate chime).uiConversation.binding(id).snapshot, an ObservableSnapshot<ConversationSnapshot>): its notifier fires on every assembled frame; visible output text growth in the chat target's live partial fires the tick at the render cadence (the audio engine's debounce adds a hard floor).All tones are synthesized in code with linear fade in/out envelopes — no asset files, no clicks or pops on rapid state flips. Each voice is debounced to a 50 ms minimum interval.
Browsers block audio until a user gesture, so the engine arms on the first pointerdown/keydown anywhere on the page and is a silent no-op before that. It never throws or spams the console when audio is unavailable.
The cordis row accepts a config: object (all optional):
- id: ui-beep
name: '@xain_npm/dsh-client-ui-beep'
config:
volume: 0.5 # master gain 0…1
enabled: true # false silences everything
heartbeatMs: 4000 # busy hum period in ms
pendingFirstRechimeMs: 10000 # first re-chime of an unanswered interaction
pendingRechimeMs: 30000 # later re-chimes of an unanswered interaction
streamingPauseMs: 1500 # output counts as "streaming" this long after the last text growth
The row config: seeds the durable ui-beep user-settings section as the
composition base. The Settings → 提示音 (Sound) page then owns the live
values: an enable switch, a master volume, and one volume per voice
(streaming tick / working hum / awaiting-input chime), each 0–200 % with a
preview button. 100 % is Web Audio's nominal full scale; the stretch past it
is the user's own headroom — the plugin caps nothing, so anyone who raises a
slider decides for themselves how loud the beeps are (values above full scale
may clip). The defaults stay conservative so a first-time user is not
startled. Changes apply immediately and persist in the user-settings
document; a user override always wins over the row config.
A mute toggle also sits in the composer's right tool row, beside the model
selector: a speaker button that mutes/unmutes every beep (speaker with an X
when muted). It mirrors the same durable enabled field as the Settings
switch, so the two stay in sync; muting stops a looping hum immediately, and
unmuting while an agent is busy plays a beat at once (no waiting for the next
heartbeat interval). The waiting chime also sounds when work finishes: as
soon as the last busy session goes idle, a chime tells you the agent is done
and it is your turn again.
Each voice can play a user-supplied audio file instead of the built-in
tone. The Settings page shows a Choose audio button per voice; picking one
opens a whole-filesystem file browser (rooted at / or the drive root) that
lists ordinary user folders and audio files (.mp3, .wav, .ogg, .flac,
.m4a, .aac, .opus, .webm) — hidden (dotfile) entries and system
directories are skipped. The chosen absolute path is stored in the
settings document — the file is never uploaded or copied, and it can be
moved/replaced on disk freely. Playback semantics:
The Host half serves the file through two loopback, browser-authenticated
routes (GET /ui-beep/audio/:voice, GET /ui-beep/browse) — the path comes
from the settings document, never from the request URL, so the routes cannot
be pointed at arbitrary files. The browser fetches and decodes each file
once, then caches the decoded buffer.
None. The package is a browser-side read-only sonification of already-logged session facts (running/busy, streaming output, pending interactions); it plays audio and registers nothing model-facing. The model's own view of its work stays with the tools and host services that produce those facts.
None; the package never assembles or sends provider requests.