Introduction

When using DeepSeek Harness Web UI for long conversations, the default interaction usually relies on page scrolling. As the conversation history grows, quickly locating a specific question or reviewing context becomes inefficient. This operational fragmentation is a major barrier to improving the user experience. The DeepSeek Harness Message Navigator was created to solve this pain point by introducing a Codex-like tick navigation on the left side of the conversation flow, making browsing history more intuitive.

What Is This

This is a browser-side client plugin designed to add session message navigation to DeepSeek Harness Web UI. The project is maintained by miaomiao636 and is open-sourced under the MIT License. It reads the rendered content of the Web UI and generates interactive tick markers for each regular user message. It does not store any data on the server side.

Core Features

The plugin provides a complete message navigation solution. Its core capabilities include:

  1. Precise tick generation: Ticks are generated only for regular user messages and user interruptions. AI responses, thinking processes, tool calls, and status content are not included.
  2. History loading: Automatically loads the complete history, overcoming the limitation of DSH only rendering the latest page by default.
  3. Visual following and positioning: In dark mode, long ticks follow the current reading position. Supports hover preview, click-to-jump, and keyboard operations (arrow keys, Home, End, Enter).
  4. Streaming and state handling: Automatically handles streaming generation, new message insertion, loading earlier records, content reordering, and session switching, ensuring the navigation logic does not break.
  5. Theme and performance: Uses Harness --dsw-* theme variables, compatible with dark mode and reduced-motion settings. The logic runs entirely locally in the browser and does not persist message content.

Installation and Enablement

Installing this plugin requires the target environment to support the DeepSeek Harness 0.1.0-rc.6 Web UI contract.

1. Install the plugin
Run the following command in the terminal to add the plugin to the web profile:

dsh plugin --profile web add dsh-codex-message-navigator

2. Verify installation
After installation, enter the web profile directory, check the dependency tree, and confirm that the plugin is active:

dsh plugin --profile web add dsh-codex-message-navigator
cd ~/.dsh/profiles/web
pnpm ls dsh-codex-message-navigator --depth 0

If you need to install from local source code, use an absolute path:

dsh plugin --profile web add /absolute/path/to/deepseek-message-navigator

Typical Usage

After installing and restarting DSH Web UI, message ticks will automatically appear on the left side of the conversation window. Use them as follows:

  • Browse: Hover the mouse over a tick to display a preview card of the corresponding question.
  • Jump: Click a tick or preview card, and the page will smoothly scroll to the corresponding user question.
  • Keyboard operation: Use arrow keys to switch ticks, Home/End to quickly navigate to the beginning or end, and Enter to confirm the jump.

Applicable Scenarios and Notes

  • Environment requirements: Ensure the DeepSeek Harness version is 0.1.0-rc.6. The current plugin depends on specific DOM structures in the Web UI contract (such as [data-conversation-scroll]).
  • Desktop compatibility: The plugin is primarily designed for the web profile. If used in a desktop application, confirm that the application uses the web profile and check that the DSH_HOME configuration correctly points to the application’s data directory; otherwise, installation may fail.
  • Privacy and security: The plugin only reads text already rendered on the page to generate navigation. It contains no network requests, telemetry, or local storage. All ticks are focusable accessible elements and provide Chinese labels.
  • License: Use of this project must comply with the MIT License. It is recommended to review the source code before installation to confirm the current runtime logic.

Conclusion

The Message Navigator solves the navigation pain point in long conversations with minimal local logic. For developers or users who frequently review historical context, it is a tool that can improve efficiency without requiring additional server support.