dsh-stt-plugin
DeepSeek Harness 的语音转文字（语音输入）插件——在编辑器工具栏中提供麦克风切换按钮，并提供语音输入设置页面。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:zemanzhang809/dsh-stt-plugin#31e749583d2ead341cf9826e54336ad87d9d67c0Stt Plugin 以 dsh-stt-plugin 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A speech-to-text (voice input) plugin for DeepSeek Harness.
It adds a microphone toggle to the conversation composer tool row (beside the model selector and the submit button) that dictates into the message draft via the browser's Web Speech API, plus a Voice Input page in the settings dialog for recognition language, continuous dictation, and auto-send. All recognition runs in the browser — only the recognized text enters the conversation.
ui-stt namespace).| Requirement | Notes |
|---|---|
| DeepSeek Harness | run-from-source (pnpm dsh web) or a deployed bundle with profile support |
| Node.js ≥ 18 / pnpm ≥ 8 | for building and installing the plugin |
| Browser | Chrome / Edge ✅ full support · Safari ⚠️ partial · Firefox ❌ unsupported (button renders disabled) |
| Microphone permission | the browser asks on first use |
# installs the package into the profile and adds the bundle layer
dsh plugin --profile web add dsh-stt-plugin
# boot (or reboot) the harness — `web` is the built-in alias for `--profile web`
dsh web
Notes:
This is the most reliable path: a registry fetch never touches GitHub, so it works on networks where GitHub is unreachable. On mainland-China networks, point pnpm at a registry mirror first (any directory):
pnpm config set registry https://registry.npmmirror.com
The repository ships prebuilt lib/ artifacts with zero runtime dependencies (schemastery is bundled) — installing this package runs no build scripts and pulls no transitive packages, so pnpm ≥ 10 build-script approvals and fresh-release supply-chain policies never apply to it. (Build tooling lives in devDependencies and is only used inside the plugin checkout.)
To install a pinned version, use dsh-stt-plugin@0.1.0.
dsh plugin --profile web add github:zemanzhang809/dsh-stt-plugin
Symptom watch: if the install stalls at
Progress: resolved …and then fails withgit ls-remote … Could not connect to server, your machine cannot reach github.com — that is a network problem, not a plugin problem. Use Option 1 or Option 3, or route git through a proxy (git config --global http.proxy http://127.0.0.1:<port>).A second failure shape is
ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATIONon a package you have never heard of (e.g.style-mod): anypnpm addre-resolves the whole profile, and a transitive dependency of some other package released a version too recently for pnpm's default 24-hour supply-chain policy. Pin that package to its previous version in the profile'spnpm-workspace.yamland re-run:overrides: style-mod: 4.1.3
Notes:
insert row from the profile's cordis.patch.yml first: installed this way the package joins the bundle layers and contributes the row itself — a duplicate stt entry fails composition.github:zemanzhang809/dsh-stt-plugin#v0.1.0.# 1. prepare the plugin checkout
git clone https://github.com/zemanzhang809/dsh-stt-plugin.git
cd dsh-stt-plugin
pnpm install && pnpm build # lib/ is also committed; rebuild only after editing src/
# 2. link it into the target profile's node_modules
cd ~/.dsh/profiles/web
pnpm add /absolute/path/to/dsh-stt-plugin
Then add the plugin row to the profile's user patch layer (cordis.patch.yml) — new rows must use the insert form:
- insert:
- id: stt
name: dsh-stt-plugin
- # ...any existing id-targeted overrides stay as they are
With patchReload: "live" in the profile, saving the file hot-reloads the composition; otherwise restart the harness.
Because the package is linked (link:), later development is just: edit src/ → pnpm build → refresh the browser (host-half changes need a restart).
# composition-level check, no boot needed: the output must contain
# - id: stt
# name: dsh-stt-plugin
dsh --profile web --dump-config
In the browser:
Open Settings → Voice Input:
| Setting | Default | Meaning |
|---|---|---|
| Recognition language | auto | auto follows the browser locale, or pick a BCP-47 code (zh-CN, en-US, ja-JP, de-DE, fr-FR, es-ES, ru-RU, …). |
| Continuous dictation | off | Keep the microphone open until you click the mic button again; phrases accumulate in the draft. |
| Auto-send after recognition | off | Single-shot mode only: submit the message as soon as a phrase finishes. |
Preferences persist in the DSH settings store and survive refresh and restart. When that store is not writable in your composition (settings service absent, or the page served from a non-loopback address), the page transparently falls back to this browser's local storage — the controls stay enabled either way, and a hint states where values are kept.
The composer tool row offers two additive slot lists (conversation.input.left / conversation.input.right); this plugin registers into conversation.input.right, whose entries render at the right end of the row, directly before the model selector — the closest zero-risk position to "left of the send button, right of the model selector". There is no additive seat between the model selector and the submit button; occupying that exact gap would require replacing the whole shipped composer (conversation.composer.bar, a single slot), shadowing the product UI and every child slot it declares. If upstream ships a finer-grained seat there, migrating is a one-line change in src/client/index.tsx.
Two flows make up the plugin: how it gets composed into the running harness, and what happens while you dictate.
flowchart TD
A["pnpm dsh web<br/>profile: ~/.dsh/profiles/web"] --> B["Compose the plugin tree<br/>bundle layers → user cordis.patch.yml<br/>insert row: id stt → dsh-stt-plugin"]
B --> C["Node process — Host half<br/>lib/index.js apply()"]
C --> D["inject: ['settings']<br/>fiber waits for the settings service"]
D --> E["ctx.settings.register('ui-stt', schema)<br/>language · continuous · autoSend (defaults)"]
B --> F["Browser — boot graph serves<br/>lib/client.js via the module loader"]
F --> G["inject: ['slots', 'locale', 'settingsScope']<br/>fiber stays PENDING until providers mount"]
G --> H["apply(): inject stylesheet + zh/en dictionaries<br/>+ settingsScope.bind('ui-stt', decode)"]
H --> I["Slot: mic button<br/>conversation.input.right"]
H --> J["Slot: Voice Input page<br/>settings.section"]
E -.->|"settings describe mirror"| H
The Host and Client halves never talk to each other directly: the Host only registers the settings namespace, and the Client reads it back through the settings scope (bind + describe mirror, dotted edge). Speech never leaves the browser — only recognized text enters the draft.
flowchart TD
S["Click the mic button"] --> T{"SpeechRecognition<br/>available?"}
T -- "no (e.g. Firefox)" --> U["Render disabled<br/>tooltip explains why"]
T -- "yes" --> V["Start recognition<br/>capture baseDraft"]
V --> W{"result event"}
W -- "interim" --> X["Rewrite trailing interim text"]
W -- "final" --> Y["Commit the phrase"]
X --> Z["setDraft(join(baseDraft, committed, interim))<br/>guarded to input phase 'plain'"]
Y --> Z
Z --> W
W --> EE{"recognition ended"}
EE -- "continuous mode on" --> FF["auto-restart after 250 ms<br/>same baseDraft"]
FF --> W
EE -- "single-shot" --> GG["Stop"]
GG --> HH{"autoSend on and<br/>phrase committed?"}
HH -- "yes" --> II["inputActions.submit()"]
HH -- "no" --> JJ["Draft ready — send manually"]
V -.->|"denied / network / no mic"| KK["Show error hint,<br/>listening state cleaned up"]
Everything on the right side of the first diagram runs inside one page; setDraft / submit are the standard session input actions every session-scoped slot receives, so the plugin never touches product DOM.
dsh-stt-plugin/
├── cordis.patch.yml # composition layer: inserts the plugin row
├── package.json # dsh.bundle.patch + dsh.client (web) manifest
├── scripts/
│ ├── build.mjs # esbuild: lib/index.js (node ESM) + lib/client.js (browser)
│ └── smoke.mjs # artifact + render-level smoke tests
├── docs/
│ └── dev-pitfalls.zh-CN.md # development post-mortem: pitfalls & debugging playbook
└── src/
├── host.ts # registers the ui-stt settings namespace (Schemastery schema)
├── shared/languages.ts # language list shared by schema and UI
└── client/
├── index.tsx # apply(): slots, styles, locale, settings scope
├── mic-button.tsx # Web Speech API + inputActions.setDraft/submit
├── settings-section.tsx # Voice Input settings page
├── speech.ts # Web Speech API typings + helpers
├── locales.ts # zh / en dictionaries
└── styles.ts # plugin stylesheet (theme tokens)
ctx.settings.register('ui-stt', …) so the browser can bind a durable scope. No audio, no networking.conversation.input.right (mic button) and settings.section (Voice Input page). Draft writes go through the standard session input actions (setDraft / submit) that every session-scope slot receives; no product DOM is touched.lib/client.js is a classic script wrapping the bundle in window.__ModuleLoader__.load({ id, factory }) (the DSH client module protocol); react / react/jsx-runtime stay external and resolve from the shell's module table.pnpm install
pnpm check # tsc --noEmit
pnpm build # emit lib/
pnpm test # smoke-test both artifacts, incl. rendering both slot
# components against simulated slot props (react-dom/server)
The test suite renders both UI components in Node with react-dom/server against the props the slot renderer assembles, so render crashes surface in CI instead of silently blanking the UI.
More development notes — composition pitfalls, the client runtime contracts this plugin relies on, and the debugging playbook — live in docs/dev-pitfalls.zh-CN.md.