前言¶

在使用 DeepSeek Harness Web UI 處理長對話時，默認的交互方式通常只能依賴頁面滾動。隨着對話記錄變長，快速定位到特定提問或回顧上下文會變得低效。這種操作上的割裂感是提升使用體驗的主要阻礙。DeepSeek Harness 消息導航器正是爲了解決這一痛點而生，它通過在對話流左側引入類似 Codex 的刻度導航，讓瀏覽歷史記錄變得更加直觀。

這是什麼¶

這是一個運行在瀏覽器端的客戶端插件，旨在爲 DeepSeek Harness Web UI 增加會話消息導航能力。項目由 miaomiao636 維護，基於 MIT 許可證開源。它通過讀取 Web UI 的渲染內容，爲每一條普通用戶消息生成可交互的刻度標記，無需在服務端存儲任何數據。

核心功能¶

插件提供了一套完整的消息導航解決方案，核心能力包括：

1. 精準刻度生成：只爲普通用戶消息和用戶插話生成刻度，AI 回答、思考過程、工具調用及狀態內容不計入。
2. 歷史記錄加載：自動加載完整歷史記錄，突破 DSH 默認只渲染最新頁面的限制。
3. 視覺跟隨與定位：深色模式下的長刻度會跟隨當前閱讀位置；支持懸停預覽、點擊跳轉，以及鍵盤操作（方向鍵、Home、End、Enter）。
4. 流式與狀態處理：自動處理流式生成、新消息插入、加載較早記錄、內容重排及會話切換，保證導航邏輯不中斷。
5. 主題與性能：使用 Harness 的 --dsw-* 主題變量，兼容深色模式和減少動畫設置；邏輯完全在瀏覽器本地運行，不持久化消息內容。

安裝與啓用¶

安裝此插件需要目標環境支持 DeepSeek Harness 0.1.0-rc.6 Web UI 合約。

1. 安裝插件
在終端中執行以下命令，將插件添加到 web profile：

dsh plugin --profile web add dsh-codex-message-navigator

2. 驗證安裝
安裝完成後，進入 web profile 目錄檢查依賴樹，確認插件已生效：

dsh plugin --profile web add dsh-codex-message-navigator
cd ~/.dsh/profiles/web
pnpm ls dsh-codex-message-navigator --depth 0

若需從本地源碼安裝，請使用絕對路徑：

dsh plugin --profile web add /absolute/path/to/deepseek-message-navigator

典型用法¶

安裝並重啓 DSH Web UI 後，對話窗口左側會自動出現消息刻度。操作方式如下：

• 瀏覽：鼠標懸停在刻度上，會顯示對應問題的預覽卡片。
• 跳轉：點擊刻度或預覽卡片，頁面會平滑滾動到對應的用戶提問處。
• 鍵盤操作：使用方向鍵切換刻度，Home/End 快速定位首尾，Enter 確認跳轉。

適用場景與注意¶

• 環境要求：確保 DeepSeek Harness 版本爲 0.1.0-rc.6，當前插件依賴 Web UI 合約中的特定 DOM 結構（如 [data-conversation-scroll]）。
• 桌面版兼容：插件主要針對 web profile 設計。若在桌面版應用中使用，需確認該應用是否使用 web profile，並檢查 DSH_HOME 配置是否正確指向應用的數據目錄，否則可能安裝失敗。
• 隱私與安全：插件僅讀取頁面已渲染的文本進行導航生成，不包含網絡請求、遙測或本地存儲。所有刻度均爲可聚焦的無障礙元素，並提供中文標籤。
• 許可：使用本項目需遵守 MIT 許可證，建議安裝前查看源碼以確認當前運行邏輯。

結尾¶

消息導航器通過極簡的本地化邏輯，解決了長對話場景下的導航痛點。對於需要頻繁查閱歷史上下文的開發者或用戶，這是一個無需額外服務支持即可提升效率的工具。

• 項目地址：https://github.com/miaomiao636/dsh-message-navigator
• 插件目錄：https://www.skillhub.cn/plugins/miaomiao636/dsh-message-navigator