对话时间线 shenhaiyong/dsh-timeline

dsh-timeline

DeepSeek Harness Web GUI 的对话时间线插件（@shy666/dsh-timeline）。

功能

- 对话区域左侧一条竖着的时间线。
- 每一次提问一个蓝色点；最新一个点以淡灰色闪烁，标记最新一轮。
- 悬浮点显示卡片：上方为该轮提问，下方为该轮 AI 摘要与关键文件（等宽字体小字），右下角为该提问的时间戳（精确到秒）。
- 时间线顶部有一个圆形详情按钮，点击弹出「时间线摘要详情」弹窗：可滚动的垂直时间轴，列出每一轮提问、摘要、文件与时间戳，并提供「复制全部」按钮一键导出 Markdown。
- 时间线随对话滚动联动：当前视口所在轮次的点会放大高亮；最新点在回答进行中显示橙色脉冲，回答完成后转为淡灰闪烁。
- 点击点可快速跳转到对话对应位置，并短暂高亮该条消息。
- 输入框命令按钮（+）左侧的圆圈开关控制是否记录当前会话（默认关）。
只有开关开启时，提问才会进入时间线。
- 所有状态按会话（session id）隔离：切换会话互不干扰，数据随会话生命周期生灭。
- 全局时间线：汇总所有已记录会话的轮次（会话分组、按时间倒序），跨会话搜索提问与摘要，一键复制任意轮次或整体导出 Markdown。
- 详情弹窗支持搜索（匹配高亮）、星标优先排序；摘要可手动编辑并写回磁盘文件；可设置「新会话默认开启记录」。
- 悬浮卡片支持一键复制提问；未开启记录或无轮次时，时间线区域显示引导提示；长会话（24+ 轮）自动切换为紧凑布局（小点、隐藏时间戳、可滚动）。

预览

对话区左侧的时间线：每次提问一个点，悬浮点显示该轮提问与 AI 摘要，点击点可跳转；输入框左侧的圆圈开关控制是否记录当前会话。

时间线总览

悬浮点弹出的摘要卡片（含提问、AI 摘要、关键文件与时间戳）：

悬浮摘要卡片

点击时间线顶部的详情按钮，弹出「时间线摘要详情」弹窗（轨迹、复制全部、删除、会话信息）：

时间线摘要详情

安装

插件是 dsh web profile 加载的 cordis bundle，两种方式任选其一。

方式 A：部署预构建产物

拿到构建好的 lib/ 目录（来自 Release 附件，或按方式 B 自行构建），把包放进 profile 目录树：

1. 将 lib/、cordis.patch.yml、package.json 复制到 ~/.dsh/profiles/web/node_modules/@shy666/dsh-timeline （Windows 为 %USERPROFILE%\.dsh\profiles\web\node_modules\@shy666\dsh-timeline）。
2. 在 ~/.dsh/profiles/web/cordis.patch.yml 追加 insert 行：

- insert:
- id: dsh-timeline
name: '@shy666/dsh-timeline'

3. 重启 dsh web；profile 插件不参与热更新。

方式 B：从源码构建

git clone https://github.com/shenhaiyong/dsh-timeline.git
cd dsh-timeline
pnpm install
pnpm build

要求：Node.js ^22.19 || >=24 并安装 pnpm。依赖已在 package.json 完整声明，
直接 pnpm install 即可。pnpm build 产出 lib/（tsc 类型 + tsdown 产物）；按方式 A 部署该目录。

使用

1. 点击输入框命令按钮左侧的圆圈开关，开启当前会话的记录（开启后圆圈实心）。
2. 正常提问。每一条被接受的提问都会变成时间线上的一个点。
3. 悬浮点查看提问与该轮摘要；点击点跳转到对话对应位置。
4. 打开时间线顶部的详情按钮查看完整会话记录，点「复制全部」导出 Markdown。

配置

- 记录开关按会话由输入框命令按钮旁的圆圈控制（默认关）。
- 摘要文件位于 <工作区根>/.dsh/timeline/<sessionId>.json，见下方「AI 摘要」。除此之外无需其他配置。

AI 摘要

摘要由 agent 自己写入。插件的 host 半会自动把完整的协作约定（写入时机、文件格式、三段式模板、历史轮次查询方法）注入 agent 的系统提示（system prompt），因此无需用户额外配置全局人设——只要插件已部署， agent 就知道怎么配合。插件通过标记文件把开关状态暴露给 agent：

- 路径：<工作区根>/.dsh/timeline/<sessionId>.json（sessionId 取环境变量 DSH_SESSION_ID）。
- 格式：{ "version": 1, "enabled": true, "entries": [{ "seq": 1, "summary": "..." }] }，其中 seq 为该会话第几个用户提问（从 1 开始）。

每一轮回答结束后，若文件存在且 enabled 为 true，agent 追加（或更新）本轮摘要条目并写回整个文件。浏览器端经插件自带的 /dsh-timeline-files 文件通道（host 半注册，仅读写 .dsh/timeline/ 目录）读取该文件，不依赖任何外部 host 插件，不新增端口与凭据。文件缺失或损坏时静默降级：卡片只显示提问。

数据生命周期

时间线条目与开关状态保存在浏览器内的按会话隔离的内存状态中，随页面生灭；磁盘上的 AI 摘要文件是持久部分。

已知限制

- 时间线条目与开关状态仅在内存中：刷新页面即重置。磁盘上的 AI 摘要文件才是持久部分。
- 摘要依赖 agent 配合：若 agent 从不写标记文件，卡片只显示提问。
- 时间线按会话隔离；全局时间线只包含仍在会话列表中的会话（已销毁的会话其时间线状态会被自动清理）。

许可证

BSD-3-Clause