前言¶
DSH Web 中進行多輪問答時，消息列表會不斷變長，想回到某一次用戶提問、查看對應模型回覆，或覈對發送時間、用時與 Token/吞吐率，往往需要反覆滾動。dsh-history-tree 是一個用於 DSH Web 界面的插件，提供與 Codex 1:1 一致的對話輪次時間線點陣，並附帶懸浮歷史概覽卡片。下面介紹它的能力、安裝方式和啓動查看方法。
這是什麼¶
dsh-history-tree 的項目倉庫爲 z953218350/dsh-history-tree。package.json 中版本爲 1.0.3，許可證爲 MIT，author 字段爲 DSH Harness Agent。
它的定位很直接：在 DSH Web 對話界面左側提供一個垂直居中的時間線點陣，按真實用戶提問生成刻度點，並讓懸浮卡片展示每一輪的用戶提問、模型最終回覆和底部元數據。
核心功能¶
左側時間線點陣¶
時間線點陣固定在視口垂直居中位置，緊貼工作區/側邊欄右分界線，不隨消息滾動位移。刻度點按右側真實用戶提問生成，排除產物、工具執行與系統佔位節點。
當對話輪次過多時，點陣會應用自適應最大高度限制，並支持鼠標滾輪平滑滾動。
懸浮概覽卡片¶
鼠標滑過時間線點陣時，會出現階梯波浪擴散放大動效。懸浮卡片以毛玻璃樣式展示內容，包括：
- 用戶提問文本
- 模型最終回覆與說明正文
- 底部單行元數據：發送時間、用時、Token/吞吐率
卡片內容會過濾 Think、Bash 工具執行與文件產物。
點擊定位與向上加載歷史¶
點擊任意刻度點或懸浮卡片，會平滑滾動到對應對話輪次。
當鼠標懸停在頂部刻度，或向上滾動觸頂時，插件會自動加載更早歷史會話，並動態向上延長刻度點陣。
安裝與啓用¶
在 DSH 的插件化安裝方式下，可以先用 DSH CLI 安裝。
使用 DSH CLI 安裝¶
dsh plugin --profile web add -w dsh-history-tree
在 Web Profile 目錄下安裝¶
也可以進入 Web Profile 目錄後使用 npm 或 pnpm：
cd ~/.dsh/profiles/web
npm i dsh-history-tree
或：
pnpm add -w dsh-history-tree
經過上面的步驟，確認 ~/.dsh/profiles/web/package.json 中的 dsh.profile.bundles 數組包含 dsh-history-tree。
使用本地源碼目錄安裝¶
如果本地正在開發該插件，可以用 link 方式添加：
dsh plugin --profile web add -w "link:/path/to/dsh/plugin/dsh-history-tree"
這裏將 /path/to/dsh/plugin/dsh-history-tree 替換爲本地插件目錄。
啓動與查看¶
啓動 DSH Web 服務：
dsh --profile web
或：
dsh web
打開瀏覽器訪問：
http://127.0.0.1:3080/
打開任意包含多輪問答的對話，即可在左側看到垂直居中的時間線點陣。
適用場景與注意事項¶
適合在 DSH Web 中頻繁查看多輪問答歷史、需要快速定位某一次用戶提問或模型回覆的開發者。
安裝前注意以下幾點：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - DSH 社區目錄是獨立站點，不等同於官方應用商店，第三方插件需要自行審查。
- 如果
add後啓動報錯提示子包重複聲明，檢查~/.dsh/profiles/web/package.json中的dsh.profile.bundles數組，確保僅包含根包，避免包含子組件包。 package.json中client.inject聲明依賴@deepseek-ai/dsh-client-runtime與@deepseek-ai/dsh-client-locale，platform爲web。package.json中dependencies爲空對象，publishConfig.registry爲https://registry.npmjs.org/。
小結¶
dsh-history-tree 的價值在於把 DSH Web 的多輪對話歷史變成左側可見的時間線點陣，並通過懸浮卡片提供上下文概覽。它適合需要快速回溯問答輪次、查看最終回覆和基礎元數據的場景。
倉庫地址：https://github.com/z953218350/dsh-history-tree
