Introduction

When developing agents using DeepSeek Harness (DSH), web-based sessions tend to become very long. To return to a previous round of conversation, you have to scroll up manually; with many turns, this is time-consuming.

The philosophy of DSH is “everything is a plugin,” and client-side UI issues can also be solved by plugins. The dsh-turn-rail introduced below is such a client plugin: it adds a conversation timeline to the right edge of the page, mimicking the style of the DeepSeek official chat page, to help locate and jump to historical turns in long sessions.

What is this

dsh-turn-rail is maintained by Luoji-Yuli, with the repository located at luoji-yuli/dsh-turn-rail. The current version is 0.3.0, licensed under MIT, and it is a client-side plugin. It solves a specific problem: quickly finding historical turns in long sessions without manual scrolling.

Core Features

  • Collapsed Navigation Bar: A 34px navigation bar on the right edge of the page. Each user turn corresponds to a small gray marker; the current turn is displayed in blue and stretched.
  • Expanded Panel: Expands to a 240px floating panel on hover or keyboard focus; each user message occupies one line.
  • scrollspy: Keeps the active marker synchronized during scrolling.
  • Auto-load History: Automatically paginates and loads older history when opening a session; all historical turns appear in the navigation bar without manual scrolling.
  • Optional Frosted Glass Background: The frosted glass rounded background is an optional toggle (disabled by default) and supports both light and dark themes.
  • No Build Required: The repository includes a pre-compiled lib/client.js; no build step is needed for standard installation.

Installation and Usage

Prerequisites: DeepSeek Harness Web is installed and running (npx @deepseek-ai/dsh web or pnpm dsh web), and both dsh and pnpm are in the PATH.

First, execute the installation command:

dsh plugin --profile web add github:Luoji-Yuli/dsh-turn-rail

If installation is successful, it will output + @deepseek-ai/dsh-turn-rail .... If dsh web is running, you need to restart and refresh the page.

Then, start and verify:

dsh web

Open http://127.0.0.1:3080, force refresh with Ctrl + F5, then open a session containing at least 2 user messages. The navigation bar will appear on the right edge of the page. Note: The navigation bar will only display if the session contains at least 2 user messages.

Typical Usage

Enabling the Frosted Glass Background

The frosted glass rounded background is disabled by default and needs to be manually enabled in settings:

  1. Open DeepSeek Harness Web, go to Settings → General;
  2. Find the line “Turn rail frosted background”;
  3. Toggle the switch. The frosted glass rounded background will appear under both light and dark themes. After turning it off, only the markers will be displayed without a background in either theme.

Local Directory Installation (Development Scenario)

dsh plugin --profile web add link:./dsh-turn-rail

Building from Source

Standard installation does not require building, but if you want to modify source code under src/, first mirror the changes to the packages/client/ui-turn-rail/ directory of the deepseek-harness monorepo, then run:

pnpm install
pnpm --filter @deepseek-ai/dsh-turn-rail run bundle

After building, commit the newly generated lib/client.js back to this repository.

Uninstalling

dsh plugin --profile web remove @deepseek-ai/dsh-turn-rail

Applicable Scenarios and Notes

Suitable for developers who frequently engage in long sessions in DSH Web and need to review historical turns back and forth, as well as for those who want the client interface to closely match the DeepSeek official website style.

There are a few points to note before using:

  • The plugin runs with the permissions of the current dsh process; it is recommended to check the source code and license before installing (this project is MIT);
  • The navigation bar will only appear if the session contains at least 2 user messages;
  • The frosted glass background is disabled by default and needs to be manually enabled;
  • If dsh web is running during installation, you must restart and refresh the page after installation.

Summary

dsh-turn-rail does not do anything complicated, but it addresses a frequent pain point in long sessions: quickly locating historical turns. One command to install, and it’s ready to use. Following the steps above, you can verify the effect directly in your own DSH Web environment.

  • GitHub: https://github.com/Luoji-Yuli/dsh-turn-rail
  • Community Directory: https://www.skillhub.cn/plugins/Luoji-Yuli/dsh-turn-rail

Please note that the above directories are community-maintained independent sites and have no official affiliation with DeepSeek or Huansuan.