XiLuovo/dsh-session-timeline
30Last commit Aug 15, 2026
dsh-session-timeline DSH plugin
dsh-session-timeline renders a horizontal short-line timeline on the left side of the conversation. It helps users navigate long sessions by showing user message positions, providing hover previews, click-to-jump, and a collapsible UI.
How to install the dsh-session-timeline DSH plugin
dsh plugin --profile web add dsh-session-timelineCopying does not run this command. Review the repository and version before installing the dsh-session-timeline DSH plugin.
dsh-session-timeline DSH plugin data source
dsh-session-timeline DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-session-timeline DSH plugin can do
- Horizontal short-line timeline showing only user message positions
- Full session statistics via DSH sessionProjections with persistent caching
- Scroll-spy: active line follows the visible user message in the viewport
- Wave focus effect: hovering a line highlights it and fades neighbors
- Rounded tooltip preview on hover showing user message and AI reply
- Click to jump to the corresponding message, auto-loading history if needed
- Collapsible capsule handle to hide/show the timeline
Where the dsh-session-timeline DSH plugin fits
- Quickly navigate through a long conversation history
- Preview the content of past messages without scrolling
- Jump to a specific user message in a session with many turns
- Use the timeline as a visual index of user interactions
- Collapse the timeline when not needed for a cleaner UI
Who the dsh-session-timeline DSH plugin is for
- DSH Web users who frequently interact with long sessions
- Developers and power users wanting efficient session browsing
dsh-session-timeline DSH plugin limitations
- Requires DSH ≥ 0.1.0-rc and web profile with sessionProjections service
- Dynamic loading (without cordis_define) lacks full session projections, only works for visible window
- Only supports web platform (browser environment)
- Manual scrolling of the timeline temporarily disables scroll-spy until a click triggers re-following
dsh-session-timeline DSH plugin: from the repository README
Quoted from the XiLuovo/dsh-session-timeline README, the upstream source of the dsh-session-timeline DSH plugin. Copyright remains with the original authors.
DeepSeek Harness 会话时间轴插件：在会话左侧渲染一条**横短横线时间轴**，用于在长会话中快速定位、跳转和预览。    ## 效果   ## 功能 - **横短横线时间轴**：只在用户输入的位置显示一条横向短横线，无消息处无线；条数等于**整个会话**的用户消息数，放得下时居中排布，放不下时时间轴内部滚动（无滚动条）。 - **全量统计（投影机制）**：通过 DSH sessionProjections 增量统计整个会话的用户消息与 AI 回复预览，持久化缓存保证刷新秒出、新消息实时更新；对长会话压力可控。 - **当前消息定位（scroll-spy）**：激活条始终对应右侧视口当前显示的那条用户消息；滚动右侧对话，激活条随之移动（手动滚动时间轴后保持不动，点击某条跳转后恢复跟随）。 - **波浪聚焦**：鼠标在时间轴上移动时，鼠标接近的那条变为激活色并变长，相邻条向上下递减，形成波浪效果。 - **圆角预览 tooltip**：悬停某条时立即显示圆角提示——第一行用户消息（黑色加粗、单行省略），下方 AI 回复（灰色、多行），时间贴在最后一行右下角；字体与右侧对话一致。窗口外的历史消息同样可以预览。 - **点击跳转**：点击任意横线，对话立即滚动到该次用户输入所在位置；窗口外（未加载）的历史消息会自动加载更早历史后跳转。 - **收起 / 展开**：第一条消息上方有一个悬停淡入的**胶囊把手**（点击收起；悬停时第一、二条灰色递减，胶囊扮演激活条角色）。收起后变成一条**全高细竖条**，常态隐藏，鼠标接近识别区域时淡入，点击展开。任何滚动位置，胶囊与最上方条目之间始终保留固定空白。 ## 安装 需要 DSH ≥ 0.1.0-rc（`dsh` CLI 已安装，web profile 含 sessionProjections 服务）。 ### 方式一：npm 安装（推荐） 已发布到 npm，预构建安装**无需 GitHub 构建授权**： ```sh dsh plugin --profile web add dsh-session-timeline ``` 然后启动（或重启）we
Read the full READMERepository license: MIT
dsh-session-timeline DSH plugin questions
How do I install dsh-session-timeline?
You can install it via npm: `dsh plugin --profile web add dsh-session-timeline`. Then restart the web interface with `dsh web`. Alternatively, you can install from GitHub or local directory as described in the README.
Does the timeline work for sessions with many messages?
Yes. The plugin uses DSH sessionProjections to compute statistics incrementally and caches them persistently. This ensures that even for very long sessions, the timeline renders quickly and updates in real-time when new messages arrive.
How do I jump to a message that is not yet loaded in the viewport?
Click on the timeline line corresponding to that message. The plugin will automatically load the earlier history before scrolling to the exact position. This works for messages outside the current visible window.
Can I hide the timeline when I don't need it?
Yes. Hover over the capsule handle above the first line (it fades in on hover), then click it to collapse the timeline. When collapsed, a thin vertical bar appears; hover near it to reveal the handle and click to expand again.
What happens if I install the plugin dynamically without npm?
You can paste the `client.js` code via `cordis_define` in a DSH session. However, dynamic loading does not have access to host projections, so full session statistics are unavailable. The timeline will only work for messages currently in the visible window.