@deepseek-ai/dsh-a11y-announcer

A11y Announcer

用于 DeepSeek Harness Web UI 的无障碍插件：通过 aria-live 区域播报出现的工具调用和已完成的助手消息，以便屏幕阅读器朗读。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:slohmaier/dsh-a11y-announcer#02ddba97739fe737f2b71b524392d1f265cf2684

兼容性与来源证明

A11y Announcer 以 @deepseek-ai/dsh-a11y-announcer 发布，当前版本为 0.1.0-rc.8。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: github
Registry 更新时间: 2026/8/25

版本

0.1.0-rc.8prerelease

2026/8/25

README

dsh-a11y-announcer

Accessibility plugin for the DeepSeek Harness web UI. Announces tool calls as soon as they appear and finished assistant messages through an aria-live region. NVDA/JAWS/VoiceOver read the live region automatically, without moving the user's focus.

Behavior

Tool calls are announced shortly after they appear ("Tool: <name + content>"), once their text is briefly stable — NOT when they finish (the start is the interesting moment). A short debounce (TOOL_SETTLE_MS=400ms) avoids reading the very first streaming fragment (e.g. a half token like "ulti" from "multi-...").
The last finished assistant message is announced with its full text over the live region (not while streaming).
Only the visible answer text is read; the agent's internal reasoning ("Think" block) is excluded so streamed reasoning fragments are not read aloud.
Deduplication via data-chat-anchor-key: each element is announced only once; re-renders do not trigger a new announcement.
Assistant settle is detected via the data-streaming attribute (dsh removes it once streaming finishes), so only complete text is announced.
No replay: nodes already present when loading an old session are not walked through, only new events from now on.

Deep-diving announcement

While the dsh "Deep diving..." status (agent working) is active, "Deep diving..." is announced every 5 seconds over the live region for as long as the state persists (first announcement after 5s, then every 5s).
Detection by content: a role="status" element whose text contains "Deep diving". IMPORTANT: dsh may additionally render an EMPTY role="status" element; therefore match on text content, not on the first role=status.
Fallback: in addition to the MutationObserver, a 1s polling loop (for missed mutations).

How it works

Client plugin, discovered via dsh.client metadata (platform: web) and activated as its own bundle (dsh.bundle.patch = cordis.patch.yml with - insert) in the web profile.
lib/index.js = plain host loader entry (apply/inject), NO window.__ModuleLoader__ wrapper (server-side, otherwise "window is not defined" and the plugin is not activated).
lib/client.js = browser bundle (ModuleLoader wrapper). Uses a MutationObserver on the [data-slot="conversation.session"] container and selects targets via data-chat-flow-kind / data-chat-anchor-key.
Assistant settle detection via the data-streaming attribute: dsh renders the assistant markdown root with data-streaming while it streams and REMOVES it once the full text is settled. The plugin observes attribute changes (attributes + attributeFilter: ["data-streaming"]) and only announces when the node is no longer streaming — so it never reads partial output.
Tool calls are announced after a short debounce (TOOL_SETTLE_MS=400ms) once their text is briefly stable, without waiting for completion.
Text extraction: clones the node and REMOVES the agent's internal reasoning ("Think" block, data-variant="think") before reading textContent. This keeps the hidden, streamed reasoning fragments from being read aloud — only the visible answer text is announced. It also strips known model-artifact lines (a bare "ulti" the LLM occasionally appends). For tool calls, textContent also captures collapsed/hidden content (which innerText would omit).
Announcement: a hidden (but assistive-visible) div with aria-live="polite" + role="status"; textContent is set when settled. No element.focus() (moves the user's focus unnecessarily and did not reliably read elements).

Installation

Package: this repository (e.g. cloned to /opt/dsh/plugins/dsh-a11y-announcer/).
Add as a file dependency in /opt/dsh/package.json and /mnt/ssd/dsh/profiles/web/package.json.
Add as a bundle in dsh.profile.bundles (profiles/web/package.json).
After changes to lib/client.js: restart dsh web (no bundle build needed, the file is served directly).

Files

lib/client.js — browser bundle (MutationObserver + aria-live announcement)
lib/index.js — host loader entry (empty)
cordis.patch.yml — - insert of the loader entry
package.json — dsh.client + dsh.bundle + exports["./client"]

Tests

Logic verified in jsdom (see development test cases):

A tool call is announced shortly after appearing ("Tool: ") with its full text, without waiting for completion; streaming fragments (e.g. "ulti" from "multi-...") are not announced thanks to the short debounce.
A finished assistant is only announced after text stability (900ms) with the full text, not while streaming.
The live region has aria-live="polite".
Deduplication via data-chat-anchor-key works.

README

dsh-a11y-announcer

Behavior

Tool calls are announced shortly after they appear ("Tool: <name + content>"), once their text is briefly stable — NOT when they finish (the start is the interesting moment). A short debounce (TOOL_SETTLE_MS=400ms) avoids reading the very first streaming fragment (e.g. a half token like "ulti" from "multi-...").
The last finished assistant message is announced with its full text over the live region (not while streaming).
Only the visible answer text is read; the agent's internal reasoning ("Think" block) is excluded so streamed reasoning fragments are not read aloud.
Deduplication via data-chat-anchor-key: each element is announced only once; re-renders do not trigger a new announcement.
Assistant settle is detected via the data-streaming attribute (dsh removes it once streaming finishes), so only complete text is announced.
No replay: nodes already present when loading an old session are not walked through, only new events from now on.

Deep-diving announcement

While the dsh "Deep diving..." status (agent working) is active, "Deep diving..." is announced every 5 seconds over the live region for as long as the state persists (first announcement after 5s, then every 5s).
Detection by content: a role="status" element whose text contains "Deep diving". IMPORTANT: dsh may additionally render an EMPTY role="status" element; therefore match on text content, not on the first role=status.
Fallback: in addition to the MutationObserver, a 1s polling loop (for missed mutations).

How it works

Client plugin, discovered via dsh.client metadata (platform: web) and activated as its own bundle (dsh.bundle.patch = cordis.patch.yml with - insert) in the web profile.
lib/index.js = plain host loader entry (apply/inject), NO window.__ModuleLoader__ wrapper (server-side, otherwise "window is not defined" and the plugin is not activated).
lib/client.js = browser bundle (ModuleLoader wrapper). Uses a MutationObserver on the [data-slot="conversation.session"] container and selects targets via data-chat-flow-kind / data-chat-anchor-key.
Assistant settle detection via the data-streaming attribute: dsh renders the assistant markdown root with data-streaming while it streams and REMOVES it once the full text is settled. The plugin observes attribute changes (attributes + attributeFilter: ["data-streaming"]) and only announces when the node is no longer streaming — so it never reads partial output.
Tool calls are announced after a short debounce (TOOL_SETTLE_MS=400ms) once their text is briefly stable, without waiting for completion.
Text extraction: clones the node and REMOVES the agent's internal reasoning ("Think" block, data-variant="think") before reading textContent. This keeps the hidden, streamed reasoning fragments from being read aloud — only the visible answer text is announced. It also strips known model-artifact lines (a bare "ulti" the LLM occasionally appends). For tool calls, textContent also captures collapsed/hidden content (which innerText would omit).
Announcement: a hidden (but assistive-visible) div with aria-live="polite" + role="status"; textContent is set when settled. No element.focus() (moves the user's focus unnecessarily and did not reliably read elements).

Installation

Package: this repository (e.g. cloned to /opt/dsh/plugins/dsh-a11y-announcer/).
Add as a file dependency in /opt/dsh/package.json and /mnt/ssd/dsh/profiles/web/package.json.
Add as a bundle in dsh.profile.bundles (profiles/web/package.json).
After changes to lib/client.js: restart dsh web (no bundle build needed, the file is served directly).

Files

lib/client.js — browser bundle (MutationObserver + aria-live announcement)
lib/index.js — host loader entry (empty)
cordis.patch.yml — - insert of the loader entry
package.json — dsh.client + dsh.bundle + exports["./client"]

Tests

Logic verified in jsdom (see development test cases):

A tool call is announced shortly after appearing ("Tool: ") with its full text, without waiting for completion; streaming fragments (e.g. "ulti" from "multi-...") are not announced thanks to the short debounce.
A finished assistant is only announced after text stability (900ms) with the full text, not while streaming.
The live region has aria-live="polite".
Deduplication via data-chat-anchor-key works.

A11y Announcer

兼容性与来源证明

版本

相关插件

A11y Announcer

README

dsh-a11y-announcer

Behavior

Deep-diving announcement

How it works

Installation

Files

Tests

兼容性与来源证明

版本

相关插件

相关插件

相关插件

README

dsh-a11y-announcer

Behavior

Deep-diving announcement

How it works

Installation

Files

Tests