前言¶

在使用 DeepSeek Harness Web GUI 處理長對話或複雜 Agent 會話時，用戶通常需要頻繁上下滾動以定位關鍵信息。傳統滾動條只能表示頁面位置，無法告知用戶每一段內容的語義。

dsh-sm-context-piano 針對此問題，在聊天正文左側提供一組緊湊的橫線琴鍵，將長對話壓縮爲可預覽、可定位的語義節點。用戶可以沿琴鍵快速瀏覽對話結構，懸停查看摘要，點擊或使用鍵盤跳轉到目標段落。

插件簡介¶

該插件由維護者 hjj345 開發，面向 DeepSeek Harness Web profile，旨在提升多任務、多會話場景下的工作效率。

核心功能¶

• Codex 式緊湊琴鍵：默認使用 2px 粗細、12px 中心間距和 20 根可見琴鍵，保持集中排列。
• 純語義節點：只顯示用戶消息和模型可見文本輸出，完全過濾 tool、edit、read、reasoning、command、partial 等非輸出內容。
• 連續輸出合併：相鄰且未被非輸出內容打斷的模型文本合併爲一根琴鍵。
• 固定窗口瀏覽：節點數量超過上限時，以當前閱讀位置爲中心顯示固定數量，選擇頂部或底部琴鍵即可繼續瀏覽。
• 安全文本預覽：懸停卡片展示標題和正文摘要，使用 textContent 寫入，不執行會話內容中的 HTML。
• 快速定位：支持點擊琴鍵或按下 Enter/Space 平滑滾動到目標消息起始位置。
• 三語設置頁：支持簡體中文、English、繁體中文，默認簡體中文。
• 鍵盤與輔助技術支持：支持完整鍵盤選擇、跳轉和關閉預覽，琴鍵軌道使用導航角色和無障礙名稱。
• 完整卸載：卸載後移除 DOM、樣式、監聽器、Observer、定時器和動畫幀，不殘留頁面副作用。

安裝與啓用¶

在終端執行以下命令安裝插件：

dsh plugin --profile web add @hjj345345/dsh-sm-context-piano

安裝後刷新或重新打開 DSH Web GUI，進入設置彈窗，左側進入“琴鍵導航”一級設置項即可啓用。

典型用法¶

• 預覽對話內容：移動鼠標經過琴鍵軌道，插件會自動選擇最近的節點並展開波形，顯示段落預覽。
• 跳轉定位：點擊琴鍵或按下 Enter/Space，頁面平滑滾動到目標對話段落。
• 鍵盤導航：使用 ArrowUp/ArrowDown 在當前可見琴鍵間移動選擇，使用 Home/End 選擇當前窗口的第一根或最後一根琴鍵。
• 閱讀同步：滾動聊天正文時，當前閱讀位置的琴鍵會立即加深並加長，固定窗口隨閱讀位置重新居中。

適用場景與注意¶

該插件適合需要在長對話中快速定位上下文、管理多輪 Agent 交互的用戶。

使用前需注意：
- 最低支持版本 DSH 0.1.7-rc.1，兼容 0.2.0-rc.2。
- 僅面向 DeepSeek Harness Web profile。
- 插件不修改會話內容、不裁剪模型上下文、不注入系統提示，也不註冊額外 HTTP 接口。

結尾¶

dsh-sm-context-piano 專注於對話結構的可視化與導航，通過語義節點壓縮和預覽功能，幫助用戶在長對話中快速找回上下文。更多細節與源碼可訪問 GitHub 倉庫。