前言¶

DSH 的插件體系強調「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，也不是官方應用商店。對於使用 DSH Web 會話的讀者來說，一個常見痛點是：流式回答逐字出現時，代碼塊、表格和公式可能反覆處於未完成狀態，頁面也會隨着新文字不斷下移，長回答更容易讀起來有抖動。

dsh-plugin-smooth-stream 就是針對這個問題做的客戶端插件。它把逐字抖動的流式輸出，換成按段落分批、淡入呈現的閱讀體驗；流式期間平滑跟隨滾動，思考塊顯示即時單行摘要。

這是什麼¶

dsh-plugin-smooth-stream 是由 SpookySandwich 維護的 DSH 客戶端插件，採用 MIT 許可。它解決的核心問題是：在不改變 DSH 渲染能力的前提下，讓流式回覆更穩定、更容易閱讀。

它面向 --profile web 安裝使用。

核心功能¶

按段落呈現¶

回覆不再逐字出現，而是按段落分批呈現。每批內容整段淡入，斷句時會避開未完成的代碼塊和表格，避免 Markdown 渲染到一半。

平滑滾動¶

流式輸出期間，頁面平滑滾動跟隨最新內容。如果用戶向上滾動，插件把控制交還給用戶；當滾動回到底部時，自動繼續跟隨。

思考摘要¶

模型思考時，思考塊裏顯示即時單行摘要。回合結束時，該摘要收起。

渲染與降級¶

正文沿用 DSH 渲染器，保留代碼高亮、複製按鈕、表格和 KaTeX 公式。渲染出錯時，自動降級爲純文本顯示。

插件遵循 prefers-reduced-motion，在系統減少動態效果時關閉動畫和平滑滾動。

動畫與設置¶

插件提供八種入場動畫：淡入、上升、浮現、拂過、聚焦、映亮、暈開、洇染。

設置面板中的 Smooth Stream 分區可以調整設置並持久保存，也支持即時預覽和一鍵恢復默認。

安裝與啓用¶

使用下面命令安裝：

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

安裝後打開任意會話即可生效。設置入口爲：

設置面板 → Smooth Stream

典型用法¶

先確認設置面板中 啓用 Smooth Stream 已開啓。然後按需調整：

啓用 Smooth Stream
入場動畫
動畫時長
分批大小
平滑滾動跟隨

各配置項的作用如下：

• 啓用 Smooth Stream：控制是否啓用按段落分批的流式呈現。
• 入場動畫：選擇淡入、上升、浮現、拂過、聚焦、映亮、暈開、洇染。
• 動畫時長：範圍爲 120–1200 ms。
• 分批大小：默認 500 字符，用於控制每批呈現的字符量。
• 平滑滾動跟隨：控制流式輸出期間的平滑滾動。

設置支持即時預覽，並可持久保存。設置面板也提供一鍵恢復默認。

適用場景與注意¶

適合在 DSH Web 會話中查看長回答，尤其是包含代碼、表格或公式時。若希望減少逐字輸出造成的視覺跳動，可以啓用它。

安裝前需要注意：

• 該插件在 dsh 0.1.0-rc.6 上驗證。
• 它接管 conversation.chat.node 的 assistant-step 槽位，與其他同樣接管該渲染的插件互斥。
• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 開啓系統“減少動態效果”或 prefers-reduced-motion 時，動畫和平滑滾動會自動關閉。
• 渲染出錯時會降級爲純文本，不影響會話其餘部分。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/SpookySandwich/dsh-plugin-smooth-stream
• GitHub：https://github.com/SpookySandwich/dsh-plugin-smooth-stream