前言¶
在 DSH 的對話頁裏，一條長會話往往包含多輪 user / assistant 往返。滾動條能回到大致位置，但要在幾十輪裏精確找到某條 user 提問，仍要反覆上下翻頁。部分用戶會依賴瀏覽器搜索或記憶大致段落，在長上下文、多分支的對話裏效率不高。
vlln/dsh-navbar 在對話區域右緣提供一條節點導航條：每個 user 消息對應一個節點，懸停預覽、點擊跳轉，並隨閱讀位置高亮當前節點。下面介紹它的定位、能力與安裝方式。
這是什麼¶
dsh-navbar 是維護者 vlln 發佈的 DSH 客戶端插件，當前 npm 版本爲 0.4.0。它在對話區域右緣渲染一條等距節點串（每個 user 消息一個節點），懸停顯示預覽卡片，點擊平滑滾動到對應消息；活躍節點以品牌藍色膠囊跟隨當前閱讀位置。插件實現 dsh-external/issues#144 規格，形態爲官方 bundle 插件（dsh.bundle + dshClient 通道，僅瀏覽器端，Node 半部爲空 apply，0 patches）。GitHub 倉庫：https://github.com/vlln/dsh-navbar；社區目錄頁：https://www.skillhub.cn/plugins/vlln/dsh-navbar。
核心功能¶
節點導航條¶
對話區域右緣顯示垂直節點條，每個節點對應一條 user 消息。少於 2 條 user 消息時自動隱藏；非對話頁不顯示。默認懸停前不可見，鼠標移入後顯現。
跟隨閱讀位置¶
當前閱讀位置對應的節點以 22px 品牌藍色膠囊高亮，隨滾動自動移動。
懸停預覽與連續命中¶
懸停節點時彈出消息預覽卡片（截斷 6 行，樣式對齊官方 HoverCard）。整條導航條（含節點間隙）均響應懸停：預覽切換到最近節點，對應膠囊臨時拉長爲灰色，標示可點擊區域，無死區。
滾輪切換與點擊跳轉¶
光標在導航條上時，滾輪上下切換相鄰 user 消息（並阻止對話區滾動）。整條導航條可點擊（含間隙，跳轉到最近節點），膠囊命中區已放大，無需精確對準小圓點。點擊後平滑滾動，並以品牌藍色高亮環標記目標。
滑動窗口¶
節點超過 11 個時，僅顯示窗口內的節點，避免溢出。
加載更早歷史¶
若當前會話仍有未加載的更早消息，導航條頂部固定顯示 ↑ 按鈕。點擊後通過官方「加載更早」控件拉取歷史，導航條在頂部增長新節點；全部加載完成後按鈕自動隱藏，加載進行中時禁用。懸停時即時顯示與節點預覽同風格的提示卡片；加載中提示爲 “Loading…”。點擊轉發至官方控件，閱讀位置得以保留。
消息固定（Pin）¶
assistant 操作欄（複製與 Good response 之間）提供 📌 按鈕。固定後，對應輪次在導航條中顯示爲金色細長橢圓節點（始終可見）；預覽卡片帶 📌 徽標，點擊直接跳轉到被固定的回覆。固定狀態按會話保存在瀏覽器 localStorage，刷新後仍有效；再次點擊可取消固定。
實現約束¶
不依賴 data-channel：僅通過官方錨點屬性（data-time-hover-root，user 行自 0806 起）驅動，無輪詢、無路由、無 tools 調用。在 prefers-reduced-motion 下禁用動畫。
安裝與啓用¶
推薦從 git 源一行安裝（構建產物已提交，git 源不觸發構建）：
dsh plugin --profile web add "github:vlln/dsh-navbar#main"
也可使用 npm 源：
dsh plugin --profile web add @vlln/dsh-navbar@0.4.0
若本地已有源碼，可先 git clone，再執行：
cd dsh-navbar && dsh plugin --profile web add .
安裝後需重啓 web 方可生效；可在設置頁的 Plugins 面板中啓用或禁用。
運行環境要求（來自 package.json）：Node >=22.19.0，DSH >=0.1.0-rc.5。
典型用法¶
插件開箱即用，無需額外命令或 tools。在對話頁（Chat view）右緣即可看到節點導航條：懸停預覽，點擊跳轉。
固定回覆：將鼠標移到 assistant 消息的操作欄，點擊 📌。導航條中該輪次變爲金色橢圓節點；再次點擊 📌 取消固定。
加載更早歷史：會話頂部若仍有未加載內容，點擊導航條頂部的 ↑。加載完成後頂部出現新節點；全部歷史加載完畢後按鈕消失。
適用場景與注意¶
適合經常在 DSH web 端瀏覽長對話、需要按 user 輪次快速定位的開發者與使用者。插件僅在瀏覽器客戶端運行，不改變服務端邏輯。
安裝前建議查看 GitHub 源碼 與 MIT 許可證。插件以當前 DSH 進程權限運行，安裝第三方插件前應自行審閱代碼與許可條款。SkillHub 目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-navbar 把長對話中的 user 消息變成右緣可預覽、可跳轉的節點串，並支持固定回覆與加載更早歷史，減少在長上下文裏反覆滾動的成本。
