# dsh-plugin-smooth-stream

[简体中文](README.md) | English

[![npm](https://img.shields.io/npm/v/dsh-plugin-smooth-stream)](https://www.npmjs.com/package/dsh-plugin-smooth-stream)
[![CI](https://github.com/SpookySandwich/dsh-plugin-smooth-stream/actions/workflows/ci.yml/badge.svg)](https://github.com/SpookySandwich/dsh-plugin-smooth-stream/actions/workflows/ci.yml)
[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
[![dsh](https://img.shields.io/badge/dsh-0.2.1--rc.5-4b8dff)](https://github.com/deepseek-ai/deepseek-harness)
[![deepseek1024](https://img.shields.io/badge/deepseek1024-listed-4b8dff)](https://deepseek1024.com/plugins/SpookySandwich/dsh-smooth-stream)
[![stars](https://img.shields.io/github/stars/SpookySandwich/dsh-plugin-smooth-stream?style=flat&label=stars)](https://github.com/SpookySandwich/dsh-plugin-smooth-stream/stargazers)

Replaces token-by-token streaming twitch with paragraph-batched, fading reveals. Scroll follows smoothly while streaming, and reasoning blocks show a live one-line summary.

**Left: native DSH rendering · Right: Smooth Stream** — same question, started together:

![comparison demo](https://raw.githubusercontent.com/SpookySandwich/dsh-plugin-smooth-stream/main/assets/demo.gif)

## Install

```bash
dsh plugin --profile web add dsh-plugin-smooth-stream
```

Takes effect in any open session. Settings live under Settings → **Smooth Stream**.

## What it changes

- **Paragraph-batched reveal** — body text no longer jitters in token by token; it accumulates and enters a paragraph at a time with a fade. Batch boundaries avoid unclosed code fences and tables, so half-rendered Markdown never appears.
- **Smooth scroll-follow** — while streaming, the conversation glides toward the bottom covering a fraction of the remaining distance each frame: large appends catch up without teleporting. Scrolling up hands control back to you; returning to the bottom re-engages the follow.
- **Reasoning summary** — while thinking runs, the collapsed row live-scrolls its latest line, with soft fades instead of hard clipping at both edges. When a turn completes, a closing underline retracts — finished, not merely stopped.
- **Markdown & math** — body text renders through the host's own renderer: code highlighting, copy buttons, tables and KaTeX math look exactly like native output.

## Settings

The **Smooth Stream** section in the settings panel; changes apply live and persist:

| Setting | Default | Notes |
|---|---|---|
| Enable Smooth Stream | On | Off hands rendering back to the built-in view instantly — handy for comparing |
| Reveal animation | Fade | Fade / Rise / Dissolve / Wipe / Focus / Glow / Iris / Soak |
| Animation duration | 520 ms | Entrance duration (120–1200 ms) |
| Batch size | 500 chars | Text accumulated before a batch reveals; smaller feels more live, larger reads calmer |
| Smooth scroll-follow | On | The streaming-time scroll glide |

Includes a live preview and one-click reset. The settings UI follows DSH's display language.

## Reveal styles

Eight entrances, each tuned to its own rhythm; all recorded over the same reply for a direct comparison.

| Fade | Rise |
|---|---|
| ![fade](https://raw.githubusercontent.com/SpookySandwich/dsh-plugin-smooth-stream/main/assets/variants/fade.gif) | ![rise](https://raw.githubusercontent.com/SpookySandwich/dsh-plugin-smooth-stream/main/assets/variants/rise.gif) |
| **Dissolve** | **Wipe** |
| ![dissolve](https://raw.githubusercontent.com/SpookySandwich/dsh-plugin-smooth-stream/main/assets/variants/dissolve.gif) | ![wipe](https://raw.githubusercontent.com/SpookySandwich/dsh-plugin-smooth-stream/main/assets/variants/wipe.gif) |
| **Focus** | **Glow** |
| ![focus](https://raw.githubusercontent.com/SpookySandwich/dsh-plugin-smooth-stream/main/assets/variants/focus.gif) | ![glow](https://raw.githubusercontent.com/SpookySandwich/dsh-plugin-smooth-stream/main/assets/variants/glow.gif) |
| **Iris** | **Soak** |
| ![iris](https://raw.githubusercontent.com/SpookySandwich/dsh-plugin-smooth-stream/main/assets/variants/iris.gif) | ![soak](https://raw.githubusercontent.com/SpookySandwich/dsh-plugin-smooth-stream/main/assets/variants/soak.gif) |

## Compatibility

Version `1.5.0`: Support official dsh `0.2.1-rc.5` (while retaining `0.2.0-rc.2` and `0.2.1-rc.2` compatibility). Adapt reasoning display preparation for official rc.5 reasoning signatures: strip leading signature envelopes and trailing LF/CRLF from streaming summaries and history views, hide partial envelopes during streaming, and omit signature-only rows from display while leaving raw host block data intact. Fix CSS specificity overrides for `prefers-reduced-motion` so animation suppression and instant scroll behavior reliably apply across all reveal styles, wipe overlays, and container scroll.

Version `1.4.0`: Support official dsh `0.2.1-rc.2` (while retaining `0.2.0-rc.2` compatibility). Filter assistant blocks, interruption markers, and plain-text fallback by host `groupPart` (`reasoning` / `response`) seats so thinking and answer blocks do not duplicate across split seats; assistant images on `0.2.1-rc.2` fall back to plain `<img>` rendering without the native gallery/lightbox.

Version `1.3.0`: Load on official dsh `0.2.0-rc.2`. Rendering still registers on `conversation.chat.node` and `settings.section`.

Version `1.2.0`: Declare the current UI renderer service provider and the verified DSH release range. Existing rendering behavior passes the current host checks.

The declared host range is `>=0.2.0-rc.2 <0.3.0-0 || 0.2.1-rc.2 || 0.2.1-rc.5`; official dsh `0.2.0-rc.2`, `0.2.1-rc.2`, and `0.2.1-rc.5` satisfy it. Keep the previous plugin release on older DSH. [Validation record](.github/reviews/dsh-0.2.1-rc.5.md).

Download the archive from the [GitHub Release](https://github.com/SpookySandwich/dsh-plugin-smooth-stream/releases/tag/v1.5.0), then run `dsh plugin --profile desktop add ./dsh-plugin-smooth-stream-1.5.0.tgz`.

This release targets DSH `0.2.1-rc.5`. Run `npm ci`, `npm test`, and `npm run check:package` to verify the build and package. Restart DSH after updating.


- Uses the host client services, Markdown and image APIs; automated tests cover loading and component rendering.
- This plugin owns the conversation view's assistant rendering (the `assistant-step` cell of `conversation.chat.node`) and is mutually exclusive with other plugins that take over the same rendering — with both installed, only one wins.
- Respects `prefers-reduced-motion`: with reduced motion enabled, all animation and smooth scrolling switch off.
- A rendering failure degrades to plain text for that message instead of breaking the conversation.

## License

[MIT](LICENSE)