前言¶

長會話在 web 界面裏滾過幾屏之後，兩個麻煩會變得明顯：回頭找某次請求只能靠滾動；想退回某次請求重新來過，被撤回消息之後的內容怎麼處理也不直觀。dsh-toc-tail 處理的就是這兩件事：它把每條用戶請求壓縮爲會話列右側縱向時間軸上的一條橫線，目錄面板支持一鍵回溯到任意用戶請求，回溯時可選 LLM 總結與代碼狀態恢復。

DSH 的理念是「一切皆插件」，Web 界面的擴展也走同一套插件機制。下面介紹 dsh-toc-tail 的定位、功能與用法。

這是什麼¶

dsh-toc-tail 是 DeepSeek Harness Web 界面的對話目錄尾欄 + 回溯插件，由 PaRr0tBoY 維護，截至本文版本爲 0.1.0，許可證 MIT，在插件分類中屬於客戶端類。

它是一個 Web 平臺插件，package.json 中 dsh.client.platform 聲明爲 "web"，運行時注入以下客戶端模塊：

"dsh": {
  "client": {
    "platform": "web",
    "inject": [
      "@deepseek-ai/dsh-client-runtime",
      "@deepseek-ai/dsh-client-locale",
      "@deepseek-ai/dsh-client-ui-conversation"
    ]
  }
}

peer dependencies 爲 @deepseek-ai 系列，包括 cordis、dsh-agent、dsh-client-*、dsh-commands、dsh-llm、dsh-session 等。

核心功能¶

tick 時間軸¶

插件在會話列右邊緣放一條縱向 rail，每條用戶請求對應其中一個 tick（橫線）。tick 寬度與消息長度成正比，最長的那條請求決定比例尺，其餘按長度比例縮放，所以不看正文也能從 rail 上看出各請求的長短分佈。

rail 有一個出現條件：會話至少有三條用戶請求。出現後相對視口垂直居中，貼着會話列右邊緣，保留屏幕原本的窄邊距。

目錄面板¶

懸停或聚焦某個 tick，會展開一個圓角目錄面板，列出每個用戶請求及其摘要。面板裏每一行有兩個交互點：點擊行的摘要區域，跳轉到對應消息；點擊行內的回溯按鈕，打開確認菜單。

回溯¶

回溯的含義是把所選用戶請求撤回，如同它從未發出：消息文本回填到輸入框，其後直到前一個請求的助手回覆之間的對話全部摺疊。確認菜單提供三個選項：

1、不選任何選項：僅摺疊到所選位置；
2、Summarize：由模型總結被摺疊區間，總結報告替換原區間作爲上下文；
3、Restore code：把工作區文件恢復到該請求時的快照，快照在每次用戶請求前自動拍攝。

摺疊後的對話從 web 視圖消失，原位置顯示一張 fold marker 卡片，卡片上帶摘要（或摺疊提示）與被摺疊的消息數。被回溯的請求會失去自己的 tick，對應的 flow 行也被隱藏。

高亮與主題¶

• 段落作用域高亮：視口內的請求對應段落保持高亮；助手回覆會保持其請求的 tick 高亮，直到下一個請求滾入視野。
• 主題自動跟隨：rail、目錄、回溯卡片使用 Harness 投影的 --dsw-* 主題 token，明暗切換時整個插件即時重着色。

安裝與更新¶

從 npm 安裝：

dsh plugin --profile web add dsh-toc-tail

或者從 GitHub release tarball 安裝：

dsh plugin --profile web add https://github.com/PaRr0tBoY/dsh-toc-tail/archive/refs/tags/v0.1.0.tar.gz

安裝後重啓 dsh web，Host 與瀏覽器客戶端纔會加載新版本。更新使用與安裝相同的命令，重啓步驟相同。

本地開發¶

在源碼目錄下先裝依賴，再跑校驗：

pnpm install
pnpm run verify

verify 依次執行 typecheck、build、test。lib/ 下的構建產物已提交進倉庫，profile 安裝因此不依賴包構建腳本；開發環境需要 Harness checkout 通過 peer dependencies 提供。

適用場景與注意¶

適合的場景：

• 長會話需要在多次請求之間快速定位、跳轉；
• 想撤回某次請求重試，並希望用 Summarize 把摺疊內容壓成上下文，或用 Restore code 回到當時的代碼狀態。

使用前注意：

1、rail 在會話累計三條用戶請求後纔會出現，短會話看不到時間軸；
2、插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證（MIT）；
3、倉庫地址存在不一致：README 抓取來源爲 PaRr0tBoY/dsh-toc-and-rewind，安裝 tarball 指向 PaRr0tBoY/dsh-toc-tail 倉庫，真實倉庫地址無法完全確認。查源碼時建議對照文末鏈接與安裝命令中的 tarball 地址。

小結¶

dsh-toc-tail 用一條縱向 tick 時間軸解決了 web 界面長會話的兩個老問題：導航和回溯。每條用戶請求一條橫線，懸停出目錄，回溯時還可以疊加模型總結與代碼快照恢復。經過上面的步驟安裝並重啓 dsh web 即可使用。

鏈接：

• 社區目錄頁：https://www.skillhub.cn/plugins/PaRr0tBoY/dsh-toc-and-rewind
• GitHub：https://github.com/PaRr0tBoY/dsh-toc-and-rewind

社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。