前言¶
在 DeepSeek Harness (DSH) Web 界面進行長對話調試或智能體開發時，面對數百個回合的上下文，原生滾動體驗往往難以快速定位關鍵節點。該插件引入 Codex 風格的導航機制，將對話回合轉化爲縱向刻度，旨在解決上下文切換效率低和內容概覽困難的問題。
插件簡介¶
dsh-conversation-strip 是由 mldhao 維護的客戶端插件，它爲 DSH 主側欄右側添加了一列對話導航刻度。插件不修改 DSH 會話數據，僅通過瀏覽器中的 MutationObserver 讀取已渲染的 DOM，確保隱私安全。
核心功能¶
-
Codex 風格刻度與卡片
在主側欄右側默認約 28px 的位置顯示短橫線刻度，每條短橫線對應一個完整的“用戶問題 + 助手回覆”回合。懸停刻度時，會展開 Codex 風格卡片，顯示用戶問題、助手回覆首行以及結構化摘要（標題、列表、段落）。 -
連續熱區與精準定位
每個刻度具備連續的縱向懸停熱區，鼠標穿過刻度間的視覺間距時，卡片不會反覆閃爍。點擊刻度可平滑定位至該回合開頭，並顯示短暫高亮。 -
自動測量與響應式設計
插件自動測量 DSH 主側欄寬度，側欄縮放或摺疊時同步調整位置。當窗口寬度小於 900px 時，導航刻度會自動隱藏，以避免遮擋聊天區域。 -
智能過濾與設置
支持全部、對話、僅助手三種過濾方式。設置頁面支持完整滾動，允許調整距側欄邊緣距離、刻度密度、自動跟隨、懸停預覽和動效。 -
交互反饋
在流式生成過程中，當前回合刻度帶有輕微的呼吸效果。當消息較多時，圍繞當前回合顯示最多 24 個刻度，並提示前後還有內容。
安裝與啓用¶
通過 DSH 命令行安裝插件：
dsh plugin --profile web add "D:\path\to\dsh-conversation-strip"
安裝或更新後，必須徹底重啓 DSH Web Profile，再執行一次 Ctrl+F5 強制刷新網頁，插件才能正常加載。
典型用法¶
- 打開任意 DSH 對話，導航刻度會出現在主側欄右側。
- 將鼠標懸停在短橫線上，展開鄰近刻度並查看該回合的問題、正文首行和結構化摘要。
- 點擊短橫線，平滑定位到該回合開頭。
- 使用快捷鍵快速導航：
-Ctrl+Shift+J：顯示或隱藏對話導航
-Alt+↑：切換到上一個對話回合並定位
-Alt+↓：切換到下一個對話回合並定位 - 在 DSH 設置中打開“對話導航”，調整過濾、距離、密度、自動跟隨和動效。
注意事項¶
- 推薦使用 DSH
0.1.1-rc.2或兼容版本。 - 插件以瀏覽器端權限運行，僅讀取頁面渲染的 DOM，不會上傳對話內容或修改 DSH 會話數據。
- 生態背景：DSH 理念爲“一切皆插件”，社區目錄（如技能庫）爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
總結¶
dsh-conversation-strip 通過 Codex 風格的縱向刻度，爲 DSH 用戶提供了高效的長對話導航能力。無論是快速定位還是概覽上下文，該插件都能顯著提升調試體驗。
