Introduction

When running long sessions in DeepSeek Harness Web, a common issue arises: as the session grows, finding a specific user input becomes cumbersome. Scrolling through the main content alone is not only slow but also prone to missing unloaded historical content.

dsh-codex-timeline is a plugin designed for DeepSeek Harness Web, providing a Codex-style turn timeline and local conversation search. It does not alter the model’s replies but instead adds a user turn navigation track on the page’s side, supporting keyword search across locally persisted session logs.

Below, we introduce its positioning, capabilities, installation methods, typical usage, and important notes.

What is This

dsh-codex-timeline is maintained by Wine-Red under the MIT license. It targets DSH Web long sessions and primarily addresses three needs:

  • Provides a user turn navigation track for long sessions, marking only the user turns that truly alter the session’s direction.
  • Offers a complete historical index, preview, search, and reliable navigation alongside the main content.
  • Defaults to the left side but can be fully mirrored to the right.

The documented compatible DSH version is 0.1.1-rc.2, with Node.js requirements of ^22.19.0 || >=24.0.0.

Core Capabilities

Turn Track

  • Host lite=1 index covers the complete persisted session without truncating at 500 turns; the main content still loads on demand.
  • Desktop track displays a fixed window, defaulting to the most recent 25 turns, adjustable from 5 to 50.
  • Each scrollable direction retains two additional full-edge guides.
  • Main index and edge guides support preview, click, Enter / Space, and arrow key navigation.
  • Maintains a low-disturbance static style when inactive.
  • Scrolling the main content automatically indicates the current turn on the track.
  • Mouse wheel moves precisely one turn per notch.
  • Continuous scrolling reorients from the current animation’s intermediate frame.
  • Small trackpad inputs accumulate first.
  • After reaching the boundary, scrolling control returns to the main content.

Preview, Search, and Settings

  • Preview cards display “Turn x / y”, time, status, two lines of the prompt, two lines of the response, and when available, this turn’s duration, first token latency, and tok/s.
  • Search covers both loaded main content and the complete persisted session log, merging and highlighting keyword context; unloaded hits can be selected and navigated to directly in one step.
  • Supports search, favorites, and keyboard navigation.
  • Settings include enable/disable, flash notification after jump, display on the right side, distance from edge, offset toward the center, label spacing, and number of displayed turns.
  • Narrow screens use a collapsible entry; desktop mode automatically fetches pages when clicking on unloaded index entries.

Full search reads persisted session logs via the same-origin host route /codex-timeline/search, returning only summaries and context windows of matching turns based on keywords. It does not send data to the model, write telemetry, or transmit content to any third party.

Installation and Activation

First, confirm your current DSH version to avoid forced installation on an incompatible version:

dsh --version

The documented compatible version is DSH 0.1.1-rc.2. If you upgrade DSH later, you should uninstall this plugin first.

Install from npm to the Web profile:

dsh plugin --profile web add dsh-codex-timeline

Alternatively, use the version check script from the repository:

powershell -ExecutionPolicy Bypass -File .\install.ps1

After installation, restart the DSH Web process and refresh the page. You can verify the bundle is active with the following command:

dsh --profile web --dump-config | Select-String -Pattern "dsh-codex-timeline|ui-conversation"

Migration from Old Local Override Version

If you previously installed an old local override version, remove the old package first, then install dsh-codex-timeline:

dsh plugin --profile web remove "@deepseek-ai/dsh-client-ui-conversation"
dsh plugin --profile web add dsh-codex-timeline

Uninstallation

dsh plugin --profile web remove dsh-codex-timeline

Or run:

powershell -ExecutionPolicy Bypass -File .\uninstall.ps1

Typical Usage

  1. Scroll the main content; the track automatically indicates the current turn.

  2. Hover to view two lines of the prompt and two lines of the response; click or press Enter / Space to jump.

  3. Click once on unloaded turns; the plugin automatically fetches the required history, restores the reading anchor, and completes the navigation.

  4. On the track, the mouse wheel moves one turn per notch; after reaching the start or end, scrolling naturally returns to the main content.

  5. Use search, favorites, keyboard navigation, or adjust the number of displayed turns and left/right position in settings as needed.

Development and Verification

If building from source, first perform installation, checks, and packaging:

pnpm install
pnpm run check
pnpm pack --pack-destination artifacts

Install the local tarball for profile contract verification:

dsh plugin --profile web add ".\artifacts\dsh-codex-timeline-0.5.5.tgz"
dsh --profile web --dump-config

When upgrading DSH, do not directly relax peer dependencies. At minimum, execute:

dsh --version
dsh --profile web --dump-config
pnpm run check
pnpm pack --pack-destination artifacts
pnpm run test

After completing these checks, verify the compatibility contract.

Applicable Scenarios and Notes

  • Suitable for developers who frequently need to backtrack through user turns in DSH Web long sessions.
  • Suitable for scenarios requiring keyword search within local session logs without sending search content to the model or third parties.
  • The plugin runs with the current DSH process permissions; before installation, review the source code, license, and compatibility statements.
  • The documented compatible version is DSH 0.1.1-rc.2; do not force installation on other DSH versions, and uninstall this plugin before upgrading DSH.
  • Licensed under MIT; this package includes a 0.1.1-rc.2 compatibility adapter built from DeepSeek Harness MIT source code; see NOTICE for upstream derivative code licensing.
  • lib/client.js is a compatibility artifact generated and locked with SHA-256 for DSH 0.1.1-rc.2.

Conclusion

The value of dsh-codex-timeline lies in transforming the “finding a specific user input” in DSH Web long sessions from manual scrolling into track indexing, local search, and reliable navigation.

GitHub URL: https://github.com/Wine-Red/dsh-codex-timeline

Plugin name: dsh-codex-timeline

Additional plugin references point to a directory page at https://www.skillhub.cn/plugins/Wine-Red/dsh-codex-timeline, but this URL has not been confirmed in the currently verified materials; please verify it independently before use.