前言¶
在 DSH 的 Web 會話裏,多輪輸入、補充指令和助手回覆混在一起,長會話中定位自己某一條消息比較麻煩。dsh-tick-rail 在會話旁邊提供一列刻度線,把用戶消息作爲索引,用來做快速跳轉和預覽。
這是什麼¶
dsh-tick-rail 是 DeepSeek Harness Web UI 的 tick-rail conversation navigator。倉庫由 caisiyang123 維護,許可證爲 MIT。它是純 Web 客戶端插件,host 側爲空實現,安裝後可在瀏覽器 UI 和 DSH Desktop 中使用。
核心功能¶
安裝後,rail 會按用戶消息生成刻度:
- 一條用戶消息對應一個刻度;助手回覆不佔刻度。
- 鼠標經過 rail 時,高亮位置呈峯值衰減:中間刻度最長,兩側均勻變短。
- 懸停時,rail 旁邊顯示對應消息的片段預覽。
- 點擊 rail 任意位置,會話平滑滾動到對應用戶消息。
- rail 可鍵盤聚焦:方向鍵移動峯值,
Enter或Space跳轉,Escape收起預覽。 - 用戶消息少於 3 條時自動隱藏;沒有打開會話時不渲染任何內容。
實現說明¶
它是純 Web 客戶端插件,host 側爲空實現。客戶端模塊掛載在 shell.overlay 插槽,通過會話 DOM 的 data-chat-flow-* 標記定位消息,並使用 --dsw-alias-* 主題變量適配亮色和暗色模式。
安裝與啓用¶
先從最新 release 下載 .tgz 包,然後執行:
dsh plugin add ./dsh-tick-rail-<version>.tgz
安裝完成後重啓 dsh web 生效。如果當前已有 Web 進程,可以停止後重新執行:
dsh web
也可以直接從 GitHub 安裝:
dsh plugin add github:caisiyang123/dsh-tick-rail
如果安裝因 allowBuilds 報錯中斷,把 pnpm 輸出中給出的鍵加進 profile 目錄的 pnpm-workspace.yaml,然後重新執行安裝命令。
典型用法¶
下面是在一條已有會話中驗證 rail 的常規路徑:
1、把鼠標移到會話旁邊的 rail 上,查看峯值高亮和消息片段。
2、點擊 rail 的目標區域,讓會話平滑滾動到對應用戶消息。
3、用鍵盤操作時,先聚焦 rail;用方向鍵移動峯值,Enter 或 Space 跳轉,Escape 收起預覽。
適用場景與注意¶
適合在 DSH Web 或 DSH Desktop 中進行多輪對話調試、希望減少滾動查找的人。使用前注意:
- 插件以當前 dsh 進程權限運行。安裝前建議檢查倉庫源碼、版本、依賴與許可證。
- 本插件許可證爲 MIT;可選 peer dependency 爲
@deepseek-ai/cordis。 - 從 GitHub 安裝時,pnpm 可能要求構建授權;即使本包沒有構建步驟,也可能出現
allowBuilds相關報錯。 - 用戶消息少於 3 條時 rail 不顯示,沒有打開會話時不渲染,這是預期行爲。
短結尾¶
dsh-tick-rail 把長會話中的用戶消息變成一條可懸停、可點擊、可鍵盤操作的索引 rail。GitHub 倉庫:https://github.com/caisiyang123/dsh-tick-rail。已覈實材料未提供目錄頁 URL,本文不附目錄頁鏈接。