@muxiva/dsh-voice
本地优先的全双工语音，面向 DeepSeek Harness，由 Muxiva 编排
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @muxiva/dsh-voice@0.1.0-alpha.1Voice 以 @muxiva/dsh-voice 发布，当前版本为 0.1.0-alpha.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Local-first, full-duplex voice for the official DeepSeek Harness, orchestrated by Muxiva.
Your microphone, VAD, ASR, sentence scheduling, TTS, playback and interruption path stay on the Mac. DSH remains the stateful Agent harness and keeps its tools, sessions and Web transcript.
Alpha: the integration contract, source-checkout path and unattended M1 Pro certification are complete. Muxiva 0.1.1 wheels are published for CPython 3.8–3.14, including macOS universal2.
DSH Web microphone ──PCM16──▶ Muxiva Graph
├─ Silero VAD ──barge-in──┐
├─ Zipformer ──preview─────┤
└─ SenseVoice zh/en final─┼─▶ DSH Session / Agent / Tools
DSH assistant deltas ─────────▶ sentence buffer ─▶ speech formatter ─▶ speech normalizer ─▶ Qwen3-TTS / MLX ─▶ browser speaker
Prerequisites: macOS arm64, Node.js 22.19+, Python 3.11–3.13, Rust, Muxiva source at ../muxiva, the muxiva CLI, and an installed official DSH CLI.
git clone https://github.com/PiyotaHu/muxiva-dsh-voice.git
cd muxiva-dsh-voice
# Build the project Python environment and fetch revision- and SHA-256-pinned models.
npm run doctor -- --fix
npm run models
# Install this checkout as a DSH Bundle. No prepare script is executed.
dsh plugin --profile web add .
Start the two supervised processes. Headless mode is the normal low-overhead product path:
# Terminal A
npm start
# Terminal B
dsh --profile web
For local diagnosis, replace npm start with npm run observe. It opens the same
graph.json in Muxiva Studio while keeping the authenticated DSH loopback bridge supervised.
Select Run, then open ◎ Observe for live per-Node latency and throughput, per-Edge queue
age and rates, Node-owned buffers, traces and hotspot verdicts. npm run start:headless is the
explicit non-Studio form; npm start remains headless by default.
Both modes append bridge and Runtime output to .muxiva/runtime.log; use
tail -f .muxiva/runtime.log when diagnosing a headless session.
Open the printed DSH URL, create or open a session, then select the large voice orb above the composer. Its halo follows input energy and the visible status moves through listening, hearing, thinking and speaking. Once connected, the large orb toggles microphone mute without stopping the WebSocket, AudioWorklet or Graph. Muting admits no PCM, explicitly pauses the Muxiva audio Source, and resets VAD/ASR before resume; the small End control performs a full shutdown. Sustained high-confidence VAD or an earlier non-empty ASR partial confirms barge-in, cancels old playback and the active Agent turn; empty detections return to listening instead of leaving the UI waiting.
The low-latency defaults wait for 450 ms of continuous silence before emitting ASR Final and use a 0.70 VAD threshold with Silero's minimum-speech gate. Qwen3-TTS uses Serena, its warm, gentle young Mandarin female voice, by default, while bounded real-time PCM pacing prevents the browser queue from growing without limit.
The public installation path is:
dsh plugin --profile web add @muxiva/dsh-voice@alpha
npx @muxiva/dsh-voice@alpha setup
npx @muxiva/dsh-voice@alpha start
The package is a native DSH Bundle (dsh.bundle) and a dual-face Web plugin (dsh.client). Discovery uses the GitHub dsh-plugin topic; DSH does not currently operate a centralized plugin marketplace.
Session.prompt / Session.cancel; it never changes the agent loop.See the security model, protocol, model licenses, and contribution guide.
npm test
npm run pack:smoke
python3 -m compileall -q python .muxiva/nodes
# After setup/models: certifies Qwen3-TTS Chinese loopback and English ASR.
npm run test:e2e
# Deterministic release-grade workload (about 40 minutes on the M1 Pro).
npm run benchmark:certify
The first M1 Pro certification completed 130/130 turns and 30/30 interruptions with zero TTS underruns. Latency distributions, resource use, CER/WER scope and reproduction commands live in Performance.
Apache-2.0. Models remain under their own licenses and are downloaded at setup time; they are not redistributed in the npm package.