前言¶

在 DeepSeek Harness（dsh）裏跑長回覆時，默認 Web UI 的流式呈現往往不夠順滑：文字逐段跳出、Markdown 結構在生成過程中抖動，內容變高時滾動也容易頓挫，視線很難穩定貼在正在輸出的位置。若你主要用 Harness 的 Web 界面做對話與工具調試，這類體驗問題會直接影響閱讀節奏。

下面介紹社區插件 dsh-smooth-stream。它面向 dsh Web UI，接管回覆與工具行的渲染與跟隨邏輯，讓文字、Markdown、代碼塊、表格和工具結果隨輸出自然呈現，並在內容逐步增長時保持平穩滾動。

這是什麼¶

dsh-smooth-stream 是由維護者 Laplace-bit 發佈的 DeepSeek Harness 客戶端插件，採用 MIT 許可證，與 DeepSeek 無從屬關係。項目在 GitHub 上約有 51 stars、5 forks。

一句話定位：爲 DeepSeek Harness Web UI 提供流暢流式渲染與絲滑滾動。npm 包名同爲 dsh-smooth-stream，當前版本 0.3.4；項目主頁見 https://laplace-bit.github.io/dsh-smooth-stream/。

核心功能¶

README 與項目文檔中列出的能力如下，均可覈對：

• 流暢渲染：文字邊到邊呈現，Markdown 結構持續更新；標題、列表、代碼塊和表格在流式過程中保持可讀狀態。
• 絲滑滾動：內容變高時，頁面沿連續軌跡平穩跟隨，視線貼着正在生成的內容。
• 統一過渡：換行、代碼塊、表格和工具結果使用一致的過渡方式，正文、思考過程與工具輸出銜接自然。
• 自適應節奏：渲染速度隨輸出速度與待顯示內容調整；慢速輸出從容呈現，快速輸出及時跟上。
• 可配置預設：組合包默認 preset: balanced，可在 realtime、balanced、silky 之間切換手感。
• 用戶級設置：Web 界面 設置 → 插件 → 插件配置 中可開關絲滑渲染、控制思考塊自動展開，以及打開渲染調試面板。
• 無障礙與降級：支持 prefers-reduced-motion；系統開啓減少動態效果時直接顯示完整文本；幀率低於 30 fps 且回覆在屏外時，揭示自動暫停、恢復後再補上。

安裝與啓用¶

插件通過 Harness 內置命令安裝，npm 包帶預構建的 lib/，無需額外構建授權。在 DeepSeek Harness 源碼倉庫裏執行：

pnpm dsh plugin --profile web add dsh-smooth-stream

若 PATH 上已有 dsh 命令，也可直接：

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

安裝後啓動 Web 界面：

pnpm dsh web

Host 日誌裏應出現 [dsh-smooth-stream] plugin loaded!，表示插件已加載。

卸載：

pnpm dsh plugin --profile web remove dsh-smooth-stream

（或對應地使用 dsh plugin --profile web remove dsh-smooth-stream。）

典型用法¶

調整渲染預設¶

組合包默認 preset: balanced。若要換節拍，在 profile 的 cordis.patch.yml 裏修改：

舊版字段 mode、revealCharsPerSec、scrollSpeedPxPerSec、maxScrollSpeedPxPerSec 仍可被加載以兼容已有 profile；當前自適應引擎僅通過 preset 調整節拍。

Web 界面用戶設置¶

打開 設置 → 插件 → 插件配置，找到 絲滑流式（Smooth stream） 卡片：

1. 啓用絲滑流式渲染（默認開啓）：由本插件接管回覆和工具行的渲染與跟隨；關閉後恢復 Harness 內置渲染。
2. 自動展開思考：控制思考塊在流式期間是否自動展開；主開關關閉時此選項不生效。
3. 顯示渲染調試面板（默認關閉）：在聊天頁右側顯示即時渲染、幀率和滾動跟隨數據，可調流式揭示與滾動彈簧參數。

上述設置爲用戶級持久化偏好，改完即生效，無需重啓。調試面板支持即時調參、保存組合、恢復默認，關閉調試開關後引擎立即恢復正式默認參數。

更新插件¶

Web 界面卡片會顯示 Host 當前加載的版本；僅當 profile 明確把 dsh-smooth-stream 聲明爲 npm 依賴時，更新按鈕纔會執行包更新並提示重啓。命令行也可：

dsh plugin --profile web update dsh-smooth-stream

查看是否有新版本：

dsh plugin --profile web outdated

適用場景與注意¶

適合誰

• 日常通過 dsh Web UI 閱讀長回覆、Markdown、代碼塊和工具結果，希望流式過程更連貫的開發者。
• 需要在 Harness 對話界面裏調試思考塊、工具輸出呈現效果的智能體開發者。

使用前注意

• 這是社區獨立維護的客戶端插件，不是 DeepSeek 官方插件；安裝前建議查看 GitHub 倉庫 源碼與 MIT 許可證。
• 插件隨當前 dsh 進程在客戶端側運行，安裝與配置會寫入你的 Harness profile 與用戶設置；link: 或 file: 本地開發安裝會顯示爲開發版本，更新按鈕保持禁用。
• Node 引擎要求爲 ^22.19.0 || >=24.0.0（見 package.json）。
• DeepSeek Harness 生態遵循「一切皆插件」；社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

若默認 Web UI 的流式跳動和滾動頓挫影響你的閱讀，dsh-smooth-stream 提供了一條可落地的改進路徑：一條安裝命令、可選預設與用戶級開關，即可在 Harness Web 界面裏獲得更連貫的流式體驗。

• 目錄頁：https://www.skillhub.cn/plugins/Laplace-bit/dsh-smooth-stream
• GitHub：https://github.com/Laplace-bit/dsh-smooth-stream
• 項目主頁：https://laplace-bit.github.io/dsh-smooth-stream/