前言¶
在 DeepSeek Harness 里跑长对话时，问题往往不是“没有内容”，而是内容太多、太线性：你需要的答案可能已经在几百条消息之前，当前视口里看不到，只能不断向上滚动。
DeepSeek Harness Timeline Navigator 是为这个场景做的一层轻量时间线导航：把冗长对话变成可以浏览、搜索和回到关键消息的结构化视图。
下面介绍这个插件的定位、安装方式和典型用法。
插件定位¶
DeepSeek Harness Timeline Navigator 是面向 DeepSeek Harness 的轻量级时间线导航插件，由 7A7K 维护，许可证为 MIT。
它解决的问题很具体：让长对话更容易浏览、搜索和回到关键消息。
它不修改 DeepSeek Harness 宿主应用源代码文件，而是使用宿主的 ChatSnapshot 和 data-chat-anchor-key 契约，而不是抓取原始会话事件。
核心能力¶
这个插件提供的时间线导航主要包含以下能力：
- 可搜索消息标题和预览，并跳转到最早或最新消息。
- 按回合分组，默认折叠，支持一键展开或折叠全部。
- 可按会话书签单个消息。
- 从右侧可见句柄打开，支持键盘焦点、点击和触摸。
- 高亮当前聊天中可见的消息。
- 跳转目标尚未加载时自动加载旧历史。
- 提供移动端底部 sheet，并尊重
prefers-reduced-motion。 - 记住启用状态、面板宽度、过滤模式、滚动模式和首次使用提示状态。
- 使用宿主
ChatSnapshot和data-chat-anchor-key契约，而非抓取原始会话事件。
安装与启用¶
先确认环境：需要运行中的 DeepSeek Harness Web UI，以及 Node.js 18 或更新版本。
下面是 GitHub 安装命令：
.\install.ps1 -Source 'https://github.com/7A7K/DSH-Timeline-Navigator' -Version main
执行安装后，重新加载：
http://127.0.0.1:3080/
如果 Web 进程仍服务旧 bundle，重启一次。
典型用法¶
安装并重新加载 Web UI 后，可以按下面的方式使用时间线：
- 悬停或聚焦右边缘：打开时间线。
- 点击消息：在聊天中居中该消息。
- 点击星号：添加或移除书签。
- 点击回合标题：折叠或展开该回合。
- 点击“展开全部 / 折叠全部”：一次性变更所有回合组。
- 按
↑/↓：跳转到最早 / 最新消息。 - 按
Escape：关闭时间线。 - 拖动左侧边缘：调整面板宽度。
适用场景与注意¶
这个插件适合以下场景：
- 你经常在长会话中回头查找某一条消息。
- 你希望按回合浏览对话结构，而不是持续滚动。
- 你希望把关键消息标记为书签，方便再次查看。
- 你需要在跳转目标尚未加载时，让插件自动加载旧历史。
使用前需要注意：
- 目标 DSH Web 客户端插件契约，适用于
rc.6客户端运行时线及更新版本。 - 设置和书签保存在浏览器存储中，相关部分按会话作用域限定。
- 插件不修改 DeepSeek Harness 宿主应用源代码文件。
- React 和 DSH 客户端运行时等运行时依赖保持 external。
- 插件以当前 dsh 进程权限运行。安装前应检查源码与许可证，确认许可证为 MIT 后再使用。
相关链接¶
目录页：
https://www.skillhub.cn/plugins/7A7K/DSH-Timeline-Navigator
GitHub：
