dsh-message-minimap

A slim minimap rail on the LEFT edge of the DeepSeek Harness Web GUI chat pane: every message you sent becomes a tick — hover for a preview, click to jump, drag to scan long sessions.

1. The problem it solves

In a long session, going back to "what did I say earlier?" means endless wheel scrolling. The assistant's replies are long and dense, and your own messages get buried in between.

This plugin adds a thin navigation rail on the left edge of the chat pane (like the VS Code minimap):

chat scroll pane (overflow-y: auto, long sessions are paged)
  │  each turn = one tick (including not-yet-loaded history, from the official turnOutline projection)
  │  ticks of in-viewport turns = bold highlight
  │
  ▼  hover a tick → preview card (index / total + prompt excerpt + time line)
  ▼  click a tick → smooth-scroll to that turn (official loadThrough(seq) pages it in first)
  ▼  click/drag the rail → proportional jump

Read-only: the client only reads the conversation DOM already rendered in the browser (chat rows carry stable data-chat-flow-kind / data-chat-flow-key / data-chat-turn anchors) and scrolls the existing chat scroll container. The full list comes from the official turnOutline session projection (whole-log turn outline: turn number, turn/start seq, bounded prompt/response previews), and paging uses the official sessions.binding(id).session.loadThrough(seq) ("page backwards until the window covers seq").

Since 0.5.0 the host half is a no-op: no route, no session-log parsing. That also drops the dependency on the on-disk log layout, which changed in 0.1.7 (session.v3/v4.jsonl.zstd, new container format).

Compatibility: requires DSH ≥ 0.1.7 (turnOutline is provided by @deepseek-ai/dsh-session-turn-outline, registered by the dsh-web-app composition). On older versions the rail degrades to loaded turns only.

2. Features

• ✅ A compact, vertically centered rail on the chat pane's left edge (not full height) — zero layout interference.
• ✅ One tick per turn (i.e. per message you sent), evenly spaced on the rail (oldest at top, newest at bottom) — never scattered by message sizes.
• ✅ Immune to history paging: ticks cover ALL turns (including history not yet rendered via "load older") — sourced from the official turnOutline projection, so the full ladder shows as soon as the session opens, without scrolling up yourself.
• ✅ Exact jumps: an unloaded turn is fetched with the official loadThrough(seq) in one call ("page backwards until the window covers that turn's turn/start seq") — no blind page-by-page probing, and no drift.
• ✅ Ticks of the turns inside the viewport are auto-bolded, following the scroll in real time.
• ✅ Fisheye magnification while sweeping the rail: the tick under the pointer grows longest, its neighbors grow by a cosine distance falloff (CSS-transitioned) — spot the target at a glance.
• ✅ Hovering a tick pops a preview card: My message · 3 / 12 plus the prompt excerpt and a dedicated time line (taken from the rendered turn).
• ✅ Clicking a tick smooth-scrolls to that turn (parked ~18% below the pane top).
• ✅ Clicking or dragging the rail background jumps proportionally, like a scrollbar.
• ✅ Follows streaming output, history loading, session switches and window resizes automatically (MutationObserver + scroll/resize + polling fallback).
• ✅ Hides itself when the content doesn't overflow, when there are no turns, or on the new-session hero screen — zero layout interference.
• ✅ Bilingual (zh/en) UI strings following the GUI language.
• ✅ Keyboard accessible: ticks are native <button>s — Tab to focus, Enter to jump.

MVP limitations: no ticks for assistant messages/errors/branches; no text search over ticks; no persisted on/off toggle (always auto show/hide).

Preview

Hover a tick: preview card (excerpt + dedicated time line)

3. Directory layout

dsh-message-minimap/        # repo root = npm package root
├── package.json            # dsh.bundle.patch + dsh.client (browser declaration) + exports["./client"]
├── cordis.patch.yml        # composition row: a single plugin record (no route, no config)
├── LICENSE                 # MIT
├── screenshot/             # screenshots for the README "Preview" section
└── lib/
    ├── index.js            # host half: pure marker row (no-op, zero deps), only so the Loader sees this package
    └── client.js           # browser bundle: the rail (mounted via conversation.session.header.utilities)

4. Quick start

One-line install (GitHub):

dsh plugin --profile web add github:AFAP/dsh-message-minimap

Then restart dsh web to take effect.

After installation the plugin lives at $DSH_HOME\profiles\web\node_modules\dsh-message-minimap (cloned by pnpm from GitHub), independent of the source checkout location.

Upgrade:

dsh plugin --profile web update dsh-message-minimap

Uninstall:

dsh plugin --profile web remove dsh-message-minimap

Manual install from a source directory (for equivalent verification)

dsh plugin --profile web add "D:\path\to\dsh-message-minimap"

Verify it loaded

Open a session with several exchanges whose content overflows and scrolls → a ticked rail appears at the chat pane's left edge; hovering a tick shows the message excerpt.

5. Usage

1. Open any long historical session (or chat past one screenful).
2. Look at the centered rail on the chat pane's left edge: each small tick is one message you sent (one turn); the ticks of turns currently inside the viewport are bolded.
3. Hover a tick: a preview card pops to the right with "My message · n / total", the prompt opening and that turn's clock.
4. Click a tick: smooth-scrolls to that turn; if it hasn't been rendered by "load older" paging yet, the plugin calls the official loadThrough(seq) to page it in first, then jumps.
5. Click or drag the rail outside the ticks: proportional jump (equivalent to scrollbar dragging).
6. The rail hides itself when the session is too short (under one screen), has no turns, or shows the blank new-session hero.

6. Official capabilities it relies on

No route is added: the plugin only consumes official DSH interfaces (available since 0.1.7):

7. Implementation notes

8. Troubleshooting

9. Security & compliance

• Read-only: no business-DOM mutation, no event interception (outside its own rail), no file reads or writes, no network requests.
• Zero host capability: the host half is a no-op — no routes, no session-log access, no config keys.
• Minimal disclosure: it only uses the bounded previews the official projection already provides; no extra session content is read or stored.
• No persistence: nothing written to localStorage / cookies (except the optional dmm.debug switch you set yourself); uninstalling leaves no trace.

10. Development & build

Plain JS, no build step. lib/index.js (host half) is a no-op marker with zero imports; lib/client.js is a classic script (window.__ModuleLoader__.load) served directly by the client module system at /plugins/dsh-message-minimap/client.js.

11. License

MIT © AFAP