dsh-qnav

English · 中文 · 日本語 · Español · Français

---

One-liner

A slim right-edge question-navigation rail for long DSH conversations — every real user question gets a hoverable tick; click to jump straight to that turn, current position auto-highlights while scrolling.

Install (three steps)

# 1. Clone from GitHub
git clone https://github.com/lin-nanxing/dsh-qnav.git
cd dsh-qnav

# 2. Build (only if you modify source code)
npm run build

# 3. One-line command to mount into DSH
dsh plugin --profile web add link:.

💡 No npm publish needed! The link: prefix tells DSH to install from a local path. After cloning, just run step 3 in the project directory.

"Publishing to npm" means uploading your package to the public npm registry so others can simply type dsh plugin --profile web add dsh-qnav. This is optional — it doesn't affect your own usage.

Key Features

1. Precise extraction — Reads real user questions from DSH conversation DOM nodes using data-chat-flow-kind="user", filtering out steering/pending/context rows; falls back to [class*="userRow"].
2. Element-reference jumping — Saves each flowItem DOM element reference instead of text-prefix matching; clicks call scrollIntoView() directly. Eliminates dedup bugs, prefix collisions, and @-reference text-node splits.
3. Auto-filter non-user rows — Excludes uncommitted inputs and system-injected contexts via data-pending-steering and data-chat-flow-kind. No misleading empty ticks.
4. Proportional layout — Ticks are evenly spaced along the right edge, adapting count as questions accumulate.
5. Dark-mode support — CSS color-scheme: light dark + @media (prefers-color-scheme: dark) switches highlight color automatically with page theme.
6. Hover tooltip bubble — Hovering shows "N. " to the left; bubbles anchor left to avoid viewport overflow and measure dimensions before positioning (no flicker).
7. Current-position highlight — Updates via element rects (getBoundingClientRect().top ≤ 120px) instead of fragile text-tree walks, immune to answer-body quoting interference.
8. MutationObserver sync — Re-scans & re-renders ticks on content change (500ms debounce); highlight polls every 600ms.
9. HMR-safe — apply(ctx) returns a disposer that tears down observers, intervals, injected DOM, and stylesheets — no leaks on hot-reload or disable.

Improvements over desktop preload

| Dimension | Desktop preload-nav.js | dsh-question-nav plugin | |---|---|---| | Runtime | Electron shell preload (desktop only) | DSH web client (any platform) | | Install | Requires editing lib/tabs.js & rebuild | One-line dsh plugin add link:. | | Sandbox | Needs sandbox: false | Pure client, no sandbox changes | | CSS selector | [class*="userRow"] | data-chat-flow-kind="user" (exact) + fallback | | Jump strategy | Text-prefix match + "Load older" retry | Direct element scrollIntoView | | HMR | N/A (restart process) | ctx.effect + auto-dispose | | Platform | macOS desktop only | Any DSH web (Web / Win / Linux / WSL / remote) |

Known limitations

• Visible-only — Only scrolls to rendered items; questions beyond the pagination boundary ("Load older" cutoff) cannot be jumped to yet.
• Very long sessions — Tick density increases with 500+ questions; future search panel will help.
• User questions only — Currently targets user flowItems; assistant answers are not jump targets.

Quick preview