Introduction

DeepSeek Harness’s ecosystem is built around the core philosophy of “everything is a plugin.” When handling long conversations, developers often find it difficult to quickly locate a specific turn or their current reading progress. dsh-conversation-minimap is a client plugin maintained by bilbillm. It adds Codex-like conversation list breadcrumb navigation to DeepSeek Harness, helping locate specific turns through visual markers.

Core Features

The plugin registers a layout-neutral entry point and provides navigation assistance in the conversation header. The main features include:

  1. Visual markers: Each turn owned by an engine corresponds to a marker, and the turn currently being read is highlighted.
  2. Interactive preview: Hovering with a mouse or applying keyboard focus shows a compact preview card; clicking, pressing Enter, or pressing Space scrolls to that turn.
  3. Information display: The preview card displays a summary of the user request, a summary of the assistant’s latest result, the running status (running, completed, failed, stopped), and the file paths generated by ui-deliverables.
  4. Layout adaptation: Wide columns display a left-side track, with each turn having a visual marker and an accessible button; short histories remain compact in the center of the track; long histories expand progressively with available height; narrow columns use compact header tools.
  5. Non-invasiveness: It does not replace the conversation body, does not change the width, does not rely on CSS-module hashes, and does not scrape rendered text.

Installation and Activation

You need to build the source code and add it to a separate Harness Web configuration file:

pnpm install
pnpm run build

cd C:\Users\lumoren\Documents\GitHub\deepseek-harness
pnpm dsh plugin --profile web add C:\Users\lumoren\Documents\GitHub\dsh-conversation-minimap
pnpm dsh web

Usage Examples

  1. Wide conversation column: A left-side track appears, and each turn has a visual marker and an accessible button.
  2. Short history: Markers stay compact with fixed spacing in the center of the track.
  3. Long history: Markers expand progressively with available height.
  4. Preview interaction: Focusing or hovering displays a theme-token-based glassmorphism preview card containing the request and result text, as well as the status.
  5. Disabling: If you need to disable it within a specific subtree, add data-dsh-conversation-minimap="off" to the HTML tag.

Compatibility and Notes

  • Version requirements: Targets Harness semantic conversation contracts 0.1.0-rc.5 and 0.1.0-rc.6.
  • Theme support: Supports light, dark, angelina-light, and angelina-dark themes; colors are taken from --dsw-alias-* tokens.
  • Motion preference: Independent of dsh-motion; animations can be disabled with data-dsh-motion="off"; listens to prefers-reduced-motion in real time.
  • Performance: Does not use polling, timers, or permanent animation frames; only uses a MutationObserver scoped to the active conversation scroll area.
  • License: MIT License.

Conclusion

This plugin enhances the readability of long conversations in DeepSeek Harness through Codex-style navigation, making it suitable for developers who need to quickly locate content in complex conversation flows.