前言¶
DeepSeek Harness(DSH)採用“一切皆插件”的架構理念,允許通過純客戶端腳本擴展 Web UI 的行爲。在使用推理模型時,思考過程的展開與摺疊往往會引起佈局的突兀跳動,干擾閱讀體驗。dsh-think-ux 旨在解決這一痛點,提供平滑的思考過程預覽與滾動跟隨。
介紹¶
dsh-think-ux 是一個純 DOM 客戶端插件,不修改打包文件、不依賴獨立服務、不發起網絡請求。它針對 DeepSeek Harness Web UI 設計:當模型進行推理時,思考行會展開爲 capped 的 24 行預覽,內容流式輸入時平滑滾動到底部;推理結束摺疊時,使用短動畫過渡,避免約 490px 的瞬間跳變。
核心功能¶
- 思考行流式展開:推理過程中,思考行自動展開,並限制爲 24 行預覽高度。
- 平滑滾動跟隨:流式文本輸入時,預覽區域平滑滑向底部,而非卡頓跳轉。
- 意圖識別:通過
scrollTop寫陷阱技術,區分閱讀器滾動意圖與跟隨滾動,避免衝突。 - 平滑摺疊動畫:推理結束時,使用短動畫摺疊,避免佈局的劇烈抖動。
安裝與啓用¶
通過 DSH 的插件命令安裝,指定 web 配置文件:
dsh plugin --profile web add dsh-think-ux
安裝後刷新 Web 會話,插件配置會在重載時生效。
典型用法¶
- 安裝到特定配置文件:
dsh plugin --profile <name> add dsh-think-ux
- 卸載插件:
dsh plugin --profile web remove dsh-think-ux
適用場景與注意¶
該插件依賴特定的 DSH 版本和 DOM 結構。不保證升級兼容性,已驗證基於 DSH 0.1.5-rc.2。
- 版本依賴:插件依賴該版本的 DOM 屬性和客戶端加載協議。如果行爲假設失效,插件會靜默停止工作;但如果註冊/清單不匹配,可能導致整個 Web UI 無法加載。
- 維護者:el16z3c
結尾¶
dsh-think-ux 通過純 DOM 操作優化了 DSH Web UI 中思考過程的交互體驗,適合追求流暢閱讀體驗的用戶。更多詳情與源碼可訪問:GitHub | 目錄頁