SherUnlocked-4869/dsh-plugin-msg-nav

English | 简体中文

dsh-plugin-msg-nav

DeepSeek Harness conversation node navigation rail plugin: renders a column of short dash nodes on the right edge of the conversation area — one node per real user message — tracking your reading position. When the mouse approaches the node strip, it "morphs open" into a single-line message preview panel (covering the strip's original position; moving away restores it). Clicking any preview smoothly jumps to that message and highlights the dash; when there are too many nodes, scroll the wheel inside the hover area to browse the list; Alt+↑ / Alt+↓ jump directly between adjacent user messages. The host-side session projection makes the strip cover all user messages across the entire history the moment you enter a session — zero page-fetch requests, no initial lag.

Distributed as a bundle: after dsh plugin install, it automatically joins the profile layer stack — no manual config edits. Architecture follows dsh-chat-timeline's host session projection + client on-demand loading pattern.

Installation (official DSH command)

# Install directly from GitHub
dsh plugin --profile web add github:SherUnlocked-4869/dsh-plugin-msg-nav

dsh plugin forwards to pnpm to install into the profile directory and automatically adds packages declaring dsh.bundle to the dsh.profile.bundles layer stack. Then start (or restart, if already running) the deployment:

dsh web          # or dsh --profile <your profile>

Update to the latest version:

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

Uninstall:

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

Features

How it works

The same "projection fast path + on-demand paging" pattern as dsh-chat-timeline:

1. Host projection: the host half registers the msgNavMessages session projection unit, folding every user/message event in the entire log (only real user messages and steering with source.kind === "user"; injected context lines are excluded — exactly matching the chat view node assembler's classification) into a full {seq, time, text, id} list; the framework keeps driving it, delivered via the history tail page and session/projection push frames.
2. Client instant rendering: the node strip renders the full list directly with useProjection("msgNavMessages"); messages within the loaded window are associated with DOM rows by persistent id for reading-position tracking and jumps.
3. Click on-demand paging: when an old node not yet in the window is clicked, loadOlder() is looped by message id (50 per page, up to 120 pages) until the target enters the window and renders its row, then smooth jump + highlight.
4. Fallback: on deployments without the projection registry mounted, the client automatically falls back to a background loadOlder full loop (stopping immediately once the projection arrives); session switches invalidate the old loop generationally, and plugin unload stops it too.

Reference project

The new "full history instantly in strip" and "click on-demand loading" features reference jjxjjjjiik-bot/dsh-chat-timeline (MIT):

• Host session projection (msgNavMessages) follows its dshChatTimeline projection unit's folding approach: fold the entire log into a full user message list on the host side (only real user messages and steering with source.kind === "user", injected context excluded) and deliver it instantly to the client via the history tail page and push frames, avoiding the initial lag of client-side page-by-page history pulls;
• Client on-demand loadOlder (fetching page by page until the target enters the window when clicking old nodes) follows its jumpToMessage load-wait-land pattern; this plugin instead associates by persistent message id and window row, without relying on its hard-coded node key format;
• The background page-by-page fallback for deployments without the projection likewise follows its client loadOlder loop (50 per page, up to 120 pages).

Package structure

• lib/client.js — browser-side bundle (window.__ModuleLoader__ registration format, loaded/unloaded with the DSH module system); node strip UI + projection instant rendering + fallback background loading + click on-demand loading
• lib/index.js — host-side session projection unit msgNavMessages (full user message folding; automatically inactive when the registry is absent)
• lib/types/ — TypeScript type declarations
• cordis.patch.yml — bundle patch layer: insert one ui-msg-nav client line
• package.json — dual declarations of dsh.client (browser manifest) + dsh.bundle (bundle manifest)
• assets/screenshot.png — screenshot

FAQ

dsh plugin add reports ERR_PNPM_TARBALL_INTEGRITY?

If a third-party plugin installed in the profile via a refs/heads/... branch address is updated upstream, the new tarball checksum no longer matches the lockfile, and pnpm's supply-chain protection rejects the entire install. After confirming the upstream update is trustworthy, pin that dependency to a specific commit instead (this plugin is installed that way):

"dependencies": {
  "<pkg>": "https://codeload.github.com/<owner>/<repo>/tar.gz/<commit-sha>"
}

Then run pnpm install to refresh the lockfile, and re-run dsh plugin add.

The node strip doesn't appear?

• Confirm the deployment has been restarted and the page refreshed (bundle changes require a deployment restart; refreshing the page usually fetches the new bundle)
• The current session needs ≥2 real user messages and must be in the "conversation" view

Development

git clone https://github.com/SherUnlocked-4869/dsh-plugin-msg-nav.git
# local integration: install into a test profile
dsh plugin --profile <profile> add file:<abs-path>
dsh --profile <profile> --port 3090

License

MIT