dsh-read-aloud
English | 中文
A speaker button beside the Like button: read any DeepSeek Harness reply aloud.
Every finalized assistant message gets one extra action in the row it already
has, immediately to the right of 👍👎:
copy · 👍 👎 · 🔊 · branch
Click it and the reply is spoken by your browser's own speech engine. Nothing
is uploaded, no API key is involved, and no host-side code runs.
Install
dsh plugin --profile web add dsh-read-aloud
Or install it from Settings → Plugin Market. Most installs go live after a
page refresh.
Use
| Action | Result |
|---|
| Click the speaker | Starts reading this reply from the top |
| Click again while reading | Pauses; the icon becomes ▶ |
| Click again while paused | Resumes from the same sentence |
| Click another message's speaker | Stops the current one and starts that one |
Esc | Stops immediately, wherever the pointer is |
| Hover the speaker | Opens the speed and voice panel |
The button shows three states: 🔈 idle, ⏸ reading, ▶ paused. Reading ends by
itself, and the icon returns to 🔈.
Speed and voice
Hovering the button opens a small panel that stays with the message you are
listening to:
Speed [0.5×] [0.75×] [1×] [1.25×] [1.5×] [1.75×] [2×]
Voice [ System default ▾ ]
Both choices take effect on the sentence being read and are remembered in the
browser's local storage. Voices come from your operating system; the list is
sorted with Chinese voices first, and System default picks a voice matching
your interface language.
What gets read
Replies are Markdown, and reading Markdown literally sounds terrible — URLs get
spelled out character by character and code blocks become noise. So the text is
cleaned first:
| Kept | Dropped |
|---|
| Prose and headings | Fenced code blocks (silently) |
| List items, with their markers removed | Table rows |
| Inline code content, without the backticks | Image syntax |
| Link labels | Link targets and bare URLs |
Emphasis text, without ** and * | HTML tags, file paths, emoji |
Long replies are read in full — nothing is truncated. The text is queued in
sentence-sized pieces rather than handed to the engine in one lump, because
several engines silently cut short or drop a single very long utterance.
Requirements
- DeepSeek Harness 0.1.2-rc.1 or newer
- A browser with the Web Speech API. Speech comes from your operating system's
installed voices, so an OS with no voice for the reply's language will stay
silent — Windows and macOS both ship usable voices, and Edge exposes
additional natural voices.
- If the engine is missing entirely, the button says so instead of failing
silently.
Privacy
- No network requests. The plugin never contacts a server.
- No API keys, no accounts, no telemetry.
- No host-side code:
lib/index.js is an empty apply that exists only so the
plugin appears in the profile's loader.
- Speed and voice live in your browser's local storage under
dsh-read-aloud/settings. Clearing site data resets them to 1× and
System default; nothing else is affected.
Compatibility
The plugin declares engines.dsh >= 0.1.2-rc.1 and registers one entry in the
conversation.chat.assistant-actions slot at order: 20, so it sits beside the
shipped feedback entry (order: 10) without replacing it. It reads the reply
text through the slot's own useChat standard prop, so it needs no host RPC and
no DOM scraping.
Development
npm test
The bundle is hand-written in the client-module format the web shell loads, so
there is no build step and no bundler — lib/client.js is shipped as authored.
The test loads that shipped file with a stubbed module graph and exercises the
text-cleaning, chunking, message-lookup and voice-listing helpers.
License
MIT
