dsh-official-port-nav
A DSH (DeepSeek Harness) plugin that replicates DeepSeek Web's conversation quick-navigation feature.
A minimal minimap lives on the far right of the chat: a vertical strip of capsule bars when collapsed. Hover it and a message-index panel fades in around the bars without moving them; click any entry to jump instantly to that message with a flash highlight. While you scroll the conversation, the bar mapping and the blue "current" marker follow in real time — a pixel-faithful match to the official DeepSeek experience.
Side-by-Side Comparison
Collapsed (1)
Expanded (2)
Pairs are matched by the trailing number in the filename: 1 = collapsed, 2 = expanded.
Features
- Grows in place: hovering the right-edge strip fades the panel in (border first, then text); the bars never move — the panel wraps around them. Moving out fades it away instantly.
- Inverted mapping: the collapsed state is a mapping of the expanded panel's viewport — as the panel wheel scrolls, the bars move with every row in real time.
- Auto-location: scrolling the chat updates the blue current marker automatically (no click needed); the panel viewport centers on the current message.
- Click-to-jump: clicking a bar or row instantly scrolls the chat so the target message lands at the top, then flashes it for 1.8s.
- Detail preview: hovering a row for 400ms pops a compact tooltip (max 5 lines, ellipsis beyond that).
- Custom scrollbar: a 6px thin wheel with no arrow buttons, slides to the very bottom; click the track to jump, drag the thumb to scrub.
- Details: indexes user messages only (max 10 bars); normal grey / hover slightly-brighter / current blue; 12px viewport inset with 30px edge fades; scroll position preserved on collapse.
Installation
dsh plugin --profile web add dsh-official-port-nav
Then restart DSH so the bundle enters the boot graph.
Local development
cd dsh-official-port-nav
dsh plugin --profile web add .
link: installs read the client bundle live from disk — edits to lib/client.js take effect on a browser refresh. Changes to package.json or cordis.patch.yml require re-adding or restarting.
File Structure
dsh-official-port-nav/
├── lib/
│ ├── client.js # browser half: __ModuleLoader__ bundle (built artifact)
│ └── index.js # host half: no-op placeholder
├── cordis.patch.yml # bundle patch mounting the plugin row
├── dsh-client.js # dynamic-plugin source (archive; not used at runtime)
├── docs/
│ ├── official1.png # official, collapsed
│ ├── official2.png # official, expanded
│ ├── plugin1.png # plugin, collapsed
│ └── plugin2.png # plugin, expanded
├── ConversationNavigator.tsx # v1 UI prototype by ChatGPT (archive)
├── ConversationNavigator.css # v1 UI styles (archive)
├── package.json
└── README.md / README.en.md
Technical Notes
- Mounted on
shell.overlay — the frame-wide floating layer; additive, never changes the chat layout.
- Data bridge reads the chat DOM (
data-chat-flow-kind / data-chat-flow-key) read-only; zero intrusion into chat rendering.
- All timers go through
ctx.timer (the client-half sandbox provides no native timers).
- Current-message detection: throttled scroll events (120ms) + IntersectionObserver + MutationObserver + fallback polling.
- Every style tag, listener, and timer is cleaned up with the plugin's Cordis fiber.
