前言¶
DeepSeek Harness（DSH）采用插件化架构，Web GUI 的会话窗口随着对话轮次增加，快速定位到特定问题变得困难。针对这一痛点，dsh-client-ui-timeline 在聊天区左缘提供了一列导航条，旨在提供类似桌面端 ZCode TurnNavigator 的交互体验。
是什么¶
这是一个位于 DSH Web GUI 左侧的会话问题导航条，由开发者 hhb1028 维护。它通过「一问一杠」的视觉形式，辅助开发者或用户在长对话中快速跳转、预览上下文，是早期针对 DSH Web GUI 会话导航的社区参考实现。
核心功能¶
- 随滚动高亮：导航条会自动高亮当前视口内的问题，当前杠会拉长（2.6×），相邻杠按距离渐变拉伸。
- 悬停预览：鼠标悬停在某根杠上时，右侧会弹出该轮问答的预览气泡（包含用户问题和助手回复）。
- 平滑滚动：点击导航条上的杠，对应的消息行会平滑滚动到视口顶部。如果目标消息尚未渲染，系统会自动触发翻页加载。
- 自动加载：对于未渲染的历史记录，点击时会自动翻页加载（上限 80 页）。
- 视觉呈现：采用左缘 dash 版样式，会话宽度小于 640px 时自动隐藏。
安装与启用¶
本插件已停止维护且被官方功能取代，仅作历史记录。
- 进入 DSH 的 profile 目录（例如
profiles/desktop）。 - 编辑
package.json，在dependencies中添加：
"dsh-client-ui-timeline": "^0.1.0"
- 在
dsh.profile.bundles数组中添加"dsh-client-ui-timeline"。 - 执行
pnpm install安装依赖。 - 重启 DSH 客户端。
典型用法¶
- 预览：将鼠标移动到左侧导航条的横杠上，查看右侧弹出的问答摘要。
- 跳转：点击左侧对应的横杠，聊天界面会平滑滚动到该问题的位置。
- 响应式：在移动端或窄窗口下（<640px），该导航条会自动隐藏，以免遮挡内容。
适用场景与注意¶
- 停止维护：插件已于 2026-10-01 停止维护，npm 包已标记
deprecated。 - 官方替代：DSH 官方客户端（
@deepseek-ai/dsh-client-ui-chat0.2.0-rc.2 起）已内置同等能力的会话 turn rail，不建议再安装本插件。 - 兼容性：依赖 DSH 大版本更新，若 DOM 结构变化，功能会静默隐藏，不影响 DSH 本体运行。
- 权限提示：作为 Web 插件，它运行在浏览器模块空间，零构建，不触碰 DSH 本体源码。
总结¶
dsh-client-ui-timeline 曾是 DSH Web GUI 缺乏导航功能时的有力补充。随着官方内置功能的完善，它更多保留了「在宿主未提供导航时如何自行实现」的技术记录价值。若需导航功能，请直接使用官方内置的右缘 rail。
