Skip to main content

dsh-smooth-stream

43Stars4Forks1Issues0Watchers

Adaptive streaming rendering with smooth follow scrolling for assistant replies and tool results in the DeepSeek Harness web interface, with a "silky streaming" user settings option.

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
JavaScript
License
MIT
Branch
main
ai-chatchat-uicordisdeepseekdeepseek-harnessdeveloper-toolsdshdsh-plugin

Install

cmdweb profile
$ dsh plugin --profile web add dsh-smooth-stream

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin Laplace-bit/dsh-smooth-stream for me: review the repository at https://github.com/Laplace-bit/dsh-smooth-stream first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Pitch

dsh-smooth-stream is a third-party plugin for the DeepSeek Harness (dsh) Web interface that takes over the rendering of assistant responses, Markdown, code blocks, tables, and tool results with a "typewriter"-style adaptive reveal, and smoothly scrolls the page as content grows to prevent long replies from flooding all at once or causing frequent jumps.

Core Capabilities

  • Reveals assistant responses (text blocks, Markdown, code blocks, tables) character by character in typewriter rhythm; headings/lists and other structures remain accessible during streaming
  • Wraps all chat lines owned by the Agent (Tools, Context, Commands, retries, etc.) with the same follow boundary, keeping multi-line scenarios on a single continuous scroll trajectory
  • Dynamically adjusts reveal speed by observing the model's token arrival rate (EMA): slow output is displayed at leisure, fast output keeps pace, and idle periods drain at a capped speed
  • Provides a "Smooth Streaming" card in Web UI "Settings → Plugins → Plugin Configuration" to toggle plugin takeover and switch "Auto-Expand Think" preference, both taking effect instantly
  • Built-in FPS guardian (30 fps threshold) and prefers-reduced-motion adaptation: when off-screen with low frame rate or when reduced motion is enabled, displays complete text directly without competing with visible frames for resources
  • Supports Host's npm package fixed update flow: when detecting profile installation via npm registry, the UI card shows an "Update" button that invokes the same pnpm update

Technical Implementation

  • Language: TypeScript (ESM, type: module, build tool tsdown)
  • Key Dependencies: @deepseek-ai/cordis (Host plugin runtime), @deepseek-ai/schemastery (config Schema), @deepseek-ai/dsh-settings (user-level settings registration), react ^18.2.0 (browser rendering layer)
  • Architecture Pattern: Dual-end Cordis plugin. src/plugin.ts is the Host end: apply(ctx, config) prints [dsh-smooth-stream] plugin loaded! banner, calls webServer.tapIndex to inject Schema-validated config as window.__DSH_SMOOTH_STREAM_CONFIG__ inline script into index.html, then registers user settings for smooth-stream namespace and loopback-only RPC (read/write/trigger npm update). src/client/index.ts is the browser end: reads from inline config, shadowizes assistant-step via slots and wraps other Agent lines in place; user-level preferences sync via the plugin's own loopback RPC, bypassing the third-party namespace default allowlist.
  • Entry Files: src/index.ts (Host-side exports apply/name/Config), src/client/index.ts (client apply, exports exposed via ./client subpath)

Use Cases

Users who prefer long-form Markdown, code blocks, tables, or tool call results to progressively appear on DSH—for example, code review scenarios where you want to watch the thinking process unfold as characters appear; or scheme comparison/long-form writing/report generation where the reading rhythm shouldn't be interrupted by一次性 screen-filling. Regular short responses also benefit directly—it replaces Harness's built-in "chunked laying" with a single continuous reveal curve.

Prerequisites & Compatibility

DependencyMinimum VersionDescription
DeepSeek Harness (cordis, settings, connection, conversation, UI suite, etc.)0.1.0-rc.6+From peerDependencies and devDependencies lock values, cordis ^4.0.1
Node.js^22.19.0 or >=24.0.0From engines.node
React^18.2.0From peerDependencies, used for browser-side rendering
Host profileWeb profile (dsh.client.platform: web)This plugin only registers to cordis.patch.yml for Web host; CLI/Desktop won't be injected
PlatformmacOS / Windows / Linux (any desktop OS with modern browser)No os restriction in engines; client is browser with no native module dependencies
Native modulesNonePure frontend rendering + Cordis RPC, no node-pty / node:sqlite, etc.

Installation

dsh plugin --profile web add github:Laplace-bit/dsh-smooth-stream

Configuration

This plugin contains two types of configuration: profile-level combined configuration (written in cordis.patch.yml, requires Harness restart after changes) and user-level preferences (changed in Web settings card, takes effect instantly).

Profile-level combined configuration (fields validated by Host-side Schema):

ConfigTypeDescriptionDefault
modetypewriter / teleprompterCompatibility field; both modes currently use the same adaptive reveal enginetypewriter
presetrealtime / balanced / silkyReveal rhythm preset: realtime follows model output more closely; balanced is default; silky has maximum buffering and slowest followbalanced
revealCharsPerSecnumber 5–200Legacy field, still loaded but not used at runtime; adaptive engine only follows arrival rate80
scrollSpeedPxPerSecnumber 1–200Legacy field, still loaded but not used at runtime; follow uses smooth-damp instead of cruise speed48
maxScrollSpeedPxPerSecnumber 1–2000Legacy field, still loaded but no longer used at runtime1000

User-level preferences (written to dsh user settings document, edited via plugin's own loopback RPC, no restart needed):

PreferenceTypeDescriptionDefault
enabledbooleanMaster toggle: when enabled, this plugin takes over response and tool line rendering and follow; when disabled, takeover is reverted, fully falling back to Harness built-in renderingtrue
thinkAutoExpandbooleanWhether Think blocks auto-expand during streaming and collapse after thinking ends; when disabled, stays folded but can still be manually expanded. This setting has no effect when enabled = falsetrue

FAQ

Q: What does this plugin do?

A: It reveals assistant responses on DSH's Web interface character by character in typewriter rhythm, with Markdown structures remaining accessible during streaming; it also takes over scroll follow so multi-line/multi-tool scenarios follow the same visual curve without page jumping.

Q: Is this an official plugin?

A: No. Both the code repository and README clearly state: this project is an independently maintained MIT-licensed plugin with no official affiliation with DeepSeek company.

Q: Does it support prefers-reduced-motion and low frame rates?

A: Yes. When the system has reduced motion enabled (window.matchMedia('(prefers-reduced-motion: reduce)')), it displays complete text directly without taking over follow; during streaming, if frame rate stays below 30 fps and the response is off-screen, reveal is paused by the FPS guardian and resumes when recovered.

Q: How to switch streaming rhythm?

A: In the installed profile's cordis.patch.yml, change config.preset to realtime (closer to model output), balanced (default), or silky (maximum buffering, softest follow), then restart Harness to see the difference.

Q: Is any additional setup needed after installation?

A: Usually no. The npm package comes with pre-built lib/, so no pnpm ≥10 build script authorization needed; after installation completes, run dsh web to start, and Host logs showing [dsh-smooth-stream] plugin loaded! ... indicate successful loading.

Q: How to uninstall?

A: Run dsh plugin --profile web remove dsh-smooth-stream in the dsh source directory; UI returns to Harness built-in rendering, and combined config is also removed.

Q: Can I install from npm?

A: Yes. dsh plugin --profile web add dsh-smooth-stream installs the pre-built artifact of npm package Laplace-bit/[email protected].

Q: How to update to a new version of this plugin?

A: If installation used npm package (not link: / file: local development), the "Smooth Streaming" card in the web UI shows an "Update" button; clicking it runs a fixed pnpm update dsh-smooth-stream in the current profile directory, then prompts to restart Harness; you can also run dsh plugin --profile web update dsh-smooth-stream from the command line.

Q: Can this plugin only be installed on Web profile?

A: Yes. The package.json declares dsh.client.platform as web, and only registers this set of Web-related client packages in the Hook panel: @deepseek-ai/dsh-client-runtime, @deepseek-ai/dsh-client-ui-conversation, @deepseek-ai/dsh-client-locale, @deepseek-ai/dsh-client-connection, @deepseek-ai/dsh-client-ui-settings, @deepseek-ai/dsh-client-ui-settings-plugins; therefore it won't auto-inject into CLI/Desktop or other host faces.

Q: Getting errors or no effect?

A: First check if Host logs show [dsh-smooth-stream] plugin loaded!; if not, the profile likely doesn't have the plugin checked or the browser has been modified. If boot config is invalid (error code shows dsh-smooth-stream: malformed __DSH_SMOOTH_STREAM_CONFIG__), you can clear the config section in cordis.patch.yml to let it re-use defaults.

Difficulty Level

Beginner — Plug and play, works with default configuration; only need to modify cordis.patch.yml or settings card when switching rhythm or disabling plugin, no React/source code changes needed.

Known Issues & Limitations

  • Three legacy numeric fields revealCharsPerSec, scrollSpeedPxPerSec, maxScrollSpeedPxPerSec are still accepted by Schema, but are no longer used at runtime; the adaptive engine only looks at preset (see src/config.ts:20-30); changing these fields won't alter the feel—only preset takes effect
  • When Think block is at the tail of streaming, the root node deliberately skips pre-paint horizontal displacement to avoid exposing blank runway above fixed turn-status in fast-paced reasoning; if you rely on "pre-positioning" experience, you need to disable streaming or the plugin (src/client/TypewriterAssistantNodeView.tsx:513-522)
  • A single click of "Update" button only works when profile uses npm: / general registry scope declaration; link: / file: local development installs and catalog: / patch: / portal: / workspace: non-registry specifiers are recognized as non-updatable, and the Update button stays disabled to protect source directory (see src/profile-installation.ts:56-77, :100-102)
  • This plugin is only designed for Web profile and doesn't register for CLI/other host faces; attempting to install on non-web profile won't take effect but won't error either—you need to change the profile back to web yourself (package.json:65-78)

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/Laplace-bit/dsh-smooth-stream)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory