qwen-code/docs/design/web-shell/web-shell-voice-mode.md
Heyang Wang 9223de3517
docs(web-shell): organize design documents by feature area (#8304)
Group the existing Web Shell design materials under a dedicated directory
so related specifications and supporting assets are easier to navigate.

- Move Web Shell design documents into the web-shell directory
- Keep pane header action screenshots alongside their design notes
- Normalize selected filenames to use the web-shell spelling

Co-authored-by: heyang.why <heyang.why@alibaba-inc.com>
2026-08-01 14:32:20 +00:00

1.3 KiB

Web Shell voice mode

Goal

Make the Web Shell voice control honor the workspace voice mode already returned by the daemon.

Behavior

Mode Start Finish Cancel
hold Primary pointer down Matching pointer up Pointer cancel
tap Click while idle Click while recording Click while connecting

The control captures the active pointer so releasing outside the button still finishes a hold. Keyboard-generated clicks retain the existing toggle behavior in either mode.

Once microphone access is ready, audio produced while the socket connects is buffered locally. The socket receives start, the buffered audio, and then a deferred stop, so releasing during connection does not discard captured speech.

The mode is loaded with the existing workspace voice status and refreshed through the existing settings-version signal. A status request remains fail-closed: the control stays hidden until the current workspace reports that voice is enabled.

Scope

This change only affects Web Shell input interaction. It does not change the daemon settings contract, transcription transport, model selection, or TUI voice behavior.