前言¶
DeepSeek Harness（DSH）在處理智能體長文本輸出時，默認的跟隨滾動邏輯有時會過快，導致內容來不及閱讀。chat-pace 插件針對這一痛點，提供了多種可配置的滾動模式和精細控制，讓用戶重新掌握閱讀節奏，避免內容“飛過”屏幕。
插件定位¶
這是一個爲 DeepSeek Harness Web UI 設計的插件，由 TheGoodMorty 維護。它解決了智能體輸出速度過快的問題，通過提供 5 種滾動模式、全局熱鍵和會話位置記憶功能，實現了與 DSH 內置跟隨邏輯的協同工作。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin add TheGoodMorty/chat-pace
安裝完成後，必須重啓 DSH 服務器並刷新頁面，插件配置纔會生效。控件會出現在工具行、停靠欄、會話頭部以及設置頁面中。
核心功能¶
滾動模式¶
插件提供 5 種滾動模式：
- Follow：DSH 默認行爲，跳轉到最新輸出。
- Smooth：保持最新輸出可見，以可配置的像素/秒速度平滑滾動。
- Paced：分段閱讀。滾動到 settled（已 settled）的文本段落，暫停一段時間（計算公式爲
sectionHeight / screenHeight × seconds-per-screen），然後繼續。暫停時間被限制在可配置的最小值和最大值之間（最高 80 秒）。 - Step：手動滾動，每次按一次（按鈕或熱鍵）滾動一個段落。
- Hold：鎖定視圖，新輸出不會移動視圖。
控件與熱鍵¶
- 界面控件：位於工具行、停靠欄、會話頭部和設置頁。
- 全局熱鍵：
F9：暫停/恢復Ctrl+ArrowDown：下一節Ctrl+ArrowUp：上一節Ctrl+End：跳轉最新
會話記憶¶
- 設置頁面：可配置會話打開位置（頂部、底部或上次停留處）。
- 位置存儲：會話的閱讀位置記憶存儲在
localStorage的dsh-chat-pace-scrollpos-v1中，獨立於會話打開位置設置。 - 恢復邏輯：如果選擇“上次停留處”，系統會嘗試恢復該位置。恢復過程會持續約 12 秒，若在此期間用戶觸摸視圖，恢復會立即中斷並鎖定當前位置。
持久化設置¶
所有配置選項保存在 localStorage 的 dsh-chat-pace-settings-v1 中，刷新頁面後依然生效。
協同工作原理¶
插件與 DSH 內置的跟隨邏輯協同工作，而非替換它。
- 當內置邏輯嘗試強制跳轉到底部時，插件會識別這些跳轉，並恢復用戶的閱讀錨點。
- 插件的滾動行爲通過 scrollTop 值實現，不會與內置邏輯在同一幀內衝突。
- 插件通過監聽滾輪、觸摸和按鍵事件來追蹤用戶意圖，一旦檢測到用戶手動滾動，自動滾動模式會立即讓出控制權。
調試與維護¶
在瀏覽器控制台中，可以通過 window.__chatPaceDebug 獲取調試信息，包括引擎狀態、實時設置（通過 getSettings()）和最近的滾動決策日誌（scrollLog），用於排查插件異常行爲。
適用場景與注意¶
此插件適用於需要精細控制閱讀節奏的開發者和用戶。由於插件直接運行在瀏覽器端，建議在安裝前檢查源碼與許可證（MIT）。
