长对话时间线导航7A7K/DSH-Timeline-Navigator

DeepSeek Harness 时间线导航

把 DeepSeek Harness 的超长对话变成可浏览、可搜索、可回访的时间线。
A lightweight timeline navigator for long DeepSeek Harness conversations.

English ·
版本发布 ·
问题反馈

一个专注于长对话导航的侧边时间线插件：提供回合目录、消息搜索、星标收藏和支持历史加载的跳转，不修改 DeepSeek Harness 主程序。

它解决什么问题？

长时间运行的 Agent 对话通常只有一条线性消息流。当关键答案埋在几百条消息之前时，反复滚动和凭记忆寻找都很低效。时间线导航在聊天窗口旁边增加一个紧凑的结构化入口，让你能快速看清回合、定位消息，并把重要内容留作书签。

界面预览

下面的截图只展示时间线面板；原始聊天正文已经裁剪，避免把本地路径和私人对话内容发布到项目中。

从左到右分别是：按回合导航、批量展开/折叠，以及星标消息。面板中的内容由当前会话的 ChatSnapshot 实时投影生成，不是写死在截图里的数据。

核心能力

| 定位消息 | 看清结构 | 保存重点 |
| --- | --- | --- |
| 搜索消息标题和预览，一键跳到最早或最新消息。 | 按回合组织消息，默认折叠，并支持一键展开或折叠全部回合。 | 每条消息都有独立星标，收藏内容按会话保存。 |

- 通过右侧边缘把手打开，也支持键盘聚焦、点击和触摸。
- 自动高亮当前聊天视口中的消息。
- 跳转到尚未加载的旧消息时，自动加载历史内容。
- 支持移动端底部面板，并尊重系统的“减少动态效果”设置。
- 记住启用状态、面板宽度、过滤模式、滚动模式和首次使用提示状态。
- 使用 Harness 的 ChatSnapshot 与 data-chat-anchor-key 契约，不扫描原始事件日志。

安装

要求：正在运行的 DeepSeek Harness Web UI，以及 Node.js 18 或更高版本。

从本地目录安装：

.\install.ps1 -Source (Get-Location).Path

从 GitHub 安装：

.\install.ps1 -Source 'https://github.com/7A7K/DSH-Timeline-Navigator' -Version main

安装完成后刷新 http://127.0.0.1:3080/。如果 Web 进程仍在使用旧 bundle，需要重启一次。

使用方式

| 操作 | 结果 |
| --- | --- |
| 悬停或聚焦右侧边缘 | 打开时间线 |
| 点击消息 | 将消息居中显示在聊天窗口中 |
| 点击星标 | 添加或取消收藏 |
| 点击回合标题 | 展开或折叠该回合 |
| 展开全部 / 折叠全部 | 一次改变所有回合状态 |
| ↑ / ↓ | 跳到最早 / 最新消息 |
| Escape | 关闭时间线 |
| 拖动面板左边缘 | 调整面板宽度 |

开发

npm install
npm run bundle
npm run check

bundle 使用与 DSH 官方插件相同的 window.__ModuleLoader__.load 格式输出；React 和 DSH 客户端依赖由宿主环境提供。

lib/ 是生成产物。请修改 src/ 后运行 npm run bundle，不要手动编辑 lib/client.js。

兼容性与设计

- 面向 rc.6 客户端运行时及更新版本使用的 DSH Web 插件契约。
- 只拥有自己的 overlay 和 settings slot，不修改 Harness 主程序源码。
- 设置和星标保存在浏览器存储中，相关数据按会话隔离。
- 核心的数据投影、过滤、分组和存储行为已有 Node 测试覆盖。

项目结构

src/                 # 源代码
src/client/          # React 界面、数据投影、存储、DOM 集成、语言和样式
lib/                 # 生成的 DSH 可加载产物
tests/               # node:test 测试
scripts/build.mjs    # esbuild 构建入口
scripts/smoke.mjs    # Playwright UI 冒烟测试
install.ps1          # 本地或 GitHub 安装脚本
uninstall.ps1        # 卸载脚本

参与贡献

欢迎提交 Bug、兼容性反馈和聚焦的改进建议。请尽量附上 DSH 版本、浏览器环境、复现步骤，以及问题是否只出现在桌面端或移动端。

许可证

MIT