前言¶

在 DeepSeek Harness Web 裏跑長會話時，常見的問題是：會話變長後，回找某一條用戶輸入很麻煩；如果只靠正文滾動，既慢也容易漏掉未加載的歷史內容。

dsh-codex-timeline 是面向 DeepSeek Harness Web 的一個插件，提供 Codex-style turn timeline and local conversation search。它不改變模型回覆本身，而是在頁面側增加一條用戶 Turn 導航軌道，並支持對本地持久化會話日誌做關鍵詞搜索。

下面介紹它的定位、能力、安裝方式、典型用法和注意事項。

這是什麼¶

dsh-codex-timeline 由 Wine-Red 維護，許可證爲 MIT。它面向 DSH Web 長會話，主要解決三件事：

• 爲長會話提供用戶 Turn 導航軌道，只標記真正改變會話方向的用戶輪次。
• 在正文旁提供完整歷史索引、預覽、搜索和可靠跳轉。
• 默認位於左側，也可以完整鏡像到右側。

資料中給出的兼容 DSH 版本是 0.1.1-rc.2，Node.js 要求爲 ^22.19.0 || >=24.0.0。

核心能力¶

輪次軌道¶

• 宿主 lite=1 索引覆蓋完整持久化會話，不再截斷 500 輪；正文仍只按需加載。
• 桌面軌道顯示固定窗口，默認最近 25 輪，可調 5–50。
• 每個可滾方向額外保留兩級完整邊緣指引。
• 主索引與邊緣指引支持預覽、點擊、Enter / Space 和方向鍵。
• 未激活時保持低干擾靜態樣式。

跳轉與滾動¶

• 滾動正文時，軌道自動指示當前 Turn。
• 鼠標滾輪每格精確移動一輪。
• 連續滾動會從當前動畫中間幀重新定向。
• 觸控板小幅輸入會先累積。
• 到達邊界後，把滾動交還正文。

預覽、搜索與設置¶

• 預覽卡顯示“第 x / y 條”、時間、狀態、兩行提問、兩行回答，以及可用時的本輪用時、首 token 延遲和 tok/s。
• 搜索同時覆蓋已加載正文與完整持久化會話日誌，合併並高亮關鍵詞上下文；未加載命中也能一次選擇直達。
• 支持搜索、收藏、鍵盤導航。
• 設置項包括啓用、跳轉後閃爍提示、顯示在右側、距邊緣距離、向中部偏移、標記間距、顯示輪次數量。
• 窄屏使用摺疊入口；桌面端點擊未加載索引時自動補頁。

全量搜索通過同源宿主路由 /codex-timeline/search 讀取持久化會話日誌，僅按關鍵詞返回匹配輪次的摘要與上下文窗口；不會發給模型、不會寫入遙測，也不會將內容發送到任何第三方。

安裝與啓用¶

先確認當前 DSH 版本，避免在不兼容版本上強行安裝：

dsh --version

資料給出的兼容版本是 DSH 0.1.1-rc.2。如果後續升級 DSH，應先卸載本插件。

從 npm 安裝到 Web profile：

dsh plugin --profile web add dsh-codex-timeline

也可以使用倉庫內的版本檢查腳本：

powershell -ExecutionPolicy Bypass -File .\install.ps1

安裝後重啓 DSH Web 進程並刷新頁面。可以用下面命令確認 bundle 已生效：

dsh --profile web --dump-config | Select-String -Pattern "dsh-codex-timeline|ui-conversation"

從舊的本地覆蓋版遷移¶

如果之前安裝過舊的本地覆蓋版，先移除舊包，再安裝 dsh-codex-timeline：

dsh plugin --profile web remove "@deepseek-ai/dsh-client-ui-conversation"
dsh plugin --profile web add dsh-codex-timeline

卸載¶

dsh plugin --profile web remove dsh-codex-timeline

或者運行：

powershell -ExecutionPolicy Bypass -File .\uninstall.ps1

典型用法¶

1、滾動正文，軌道自動指示當前 Turn。

2、懸停查看兩行提問與兩行回答，點擊或按 Enter / Space 跳轉。

3、對未加載的輪次直接點擊一次；插件會自動補齊所需歷史、恢復閱讀錨點並完成定位。

4、在軌道上滾輪每格移動一輪；到達首尾後，滾動會自然交還正文。

5、需要時使用搜索、收藏、鍵盤導航，或在設置中調整顯示輪數與左右位置。

開發與驗證¶

如果從源碼構建，先做安裝、檢查和打包：

pnpm install
pnpm run check
pnpm pack --pack-destination artifacts

安裝本地 tarball 做 profile 契約驗證：

dsh plugin --profile web add ".\artifacts\dsh-codex-timeline-0.5.5.tgz"
dsh --profile web --dump-config

DSH 升級時，不要直接放寬 peer dependency。至少執行：

dsh --version
dsh --profile web --dump-config
pnpm run check
pnpm pack --pack-destination artifacts
pnpm run test

完成這些檢查後，再覈對兼容性契約。

適用場景與注意¶

• 適合需要頻繁回溯 DSH Web 長會話中用戶輪次的開發者。
• 適合需要在本地會話日誌中搜索關鍵詞上下文，並且不希望搜索內容發給模型或第三方的場景。
• 插件以當前 DSH 進程權限運行，安裝前應檢查源碼、許可證和兼容性聲明。
• 資料給出的兼容版本是 DSH 0.1.1-rc.2；請勿在其他 DSH 版本上強行安裝，升級 DSH 前先卸載本插件。
• 許可證爲 MIT；本包包含基於 DeepSeek Harness MIT 源碼構建的 0.1.1-rc.2 compatibility adapter，上游衍生代碼的許可見 NOTICE。
• lib/client.js 是爲 DSH 0.1.1-rc.2 生成並鎖定 SHA-256 的 compatibility artifact。

結尾¶

dsh-codex-timeline 的價值，是把 DSH Web 長會話裏的“回找某條用戶輸入”從手動滾動，變成軌道索引、本地搜索和可靠跳轉。

GitHub 地址：https://github.com/Wine-Red/dsh-codex-timeline

插件名：dsh-codex-timeline

另有插件線索給出目錄頁 https://www.skillhub.cn/plugins/Wine-Red/dsh-codex-timeline，但該 URL 未在本批已覈實資料中確認，使用前請自行覈對。