Preface

In long conversations within DSH, the more user messages there are, the more inconvenient it becomes to locate a particular old message. Manual scrolling often overshoots the target, especially when messages and replies are interspersed. dsh-plugin-msg-nav provides a lightweight entry point for such scenarios: it renders a column of dash-like node strings along the right edge of the conversation area, mapping each real user message to a node, and supports hover previews, click-to-jump, and scroll browsing.

What It Is

dsh-plugin-msg-nav is a DeepSeek Harness (DSH) plugin maintained by SherUnlocked-4869, licensed under MIT. It is installed in the DSH web profile and provides navigation capabilities for the conversation view. The core goal of the plugin is to enable quick location, preview, and jumping to user messages in long sessions.

Core Capabilities

  • Renders a vertical dash-like node string along the right edge of the conversation area, with one node for each real user message.
  • The active state of nodes updates in real-time as the reading position changes.
  • When the mouse enters the node string area, the node bar transforms into a single-line message preview panel; it reverts when the mouse leaves.
  • The preview panel displays one message per line, showing up to 10 entries. If there are more, the list can be scrolled up or down using the scroll wheel within the hover area.
  • Clicking on a preview smoothly jumps to the corresponding message and displays a highlighted horizontal line.
  • The host-side session projection allows full coverage of all user messages upon entering the session without needing to fetch page by page.
  • When clicking on an older message node that hasn’t entered the window, the plugin fetches earlier history on demand before jumping.
  • Automatically hides when there are fewer than 2 user messages, in empty sessions, or in non-conversation views.

Installation and Enabling

Below is an example using the web profile. First, execute the installation command:

dsh plugin --profile web add github:SherUnlocked-4869/dsh-plugin-msg-nav

Then start or restart the deployment to apply the bundle changes:

dsh web

If the page is already open, refreshing the page usually loads the new bundle.

To update to the latest version:

cd ~/.dsh/profiles/web && pnpm update dsh-plugin-msg-nav

To uninstall:

dsh plugin --profile web remove dsh-plugin-msg-nav

Usage

First, open a session in conversation view. The current session must have at least 2 real user messages for the node string to appear on the right edge.

  1. Scroll through the conversation area and observe whether the activation state of the right-side node string changes with the reading position.
  2. Hover the mouse over the node string area to view the popped-up single-line message preview panel.
  3. If the preview exceeds 10 entries, use the scroll wheel within the hover area to scroll up or down through the list.
  4. Click on the target message, and the page smoothly jumps to the corresponding message, displaying a highlighted horizontal line.
  5. If the target message is an older message that hasn’t entered the window, the plugin fetches earlier history on demand before jumping.

Operational Details and Notes

  • The plugin runs with the current dsh process permissions; check the source code and license before installation.
  • package.json declares react ^18.2.0 as an optional peer dependency in peerDependencies.
  • Bundle changes require restarting the deployment; refreshing the page usually loads the new bundle.
  • Deployments without the projection registry mounted will automatically fall back to background page-by-page loading, with 50 entries per page and up to 120 pages.
  • The node string will not be displayed in the following cases: fewer than 2 user messages, empty sessions, or non-conversation views.

Links

Directory page:

  • https://www.skillhub.cn/plugins/SherUnlocked-4869/dsh-plugin-msg-nav

GitHub:

  • https://github.com/SherUnlocked-4869/dsh-plugin-msg-nav