dsh-question-rail

English | 中文

A DeepSeek Harness web plugin that adds a right-edge question rail like the deepseek.com chat — a narrow strip of ticks on the right edge that expands on hover to list every user turn in the current conversation, and jump-scrolls back to that turn when clicked.

• One rendering, two states — the collapsed tick column and the expanded list are the same .qrl_item elements. Collapsed shows only each item's right-edge tick; hovering widens the panel to reveal the text. Identical style, identical spacing, identical right reference line.
• Jump to any round — click a question, and the chat scrolls smoothly to that turn (data-chat-anchor-key anchor) with a brief highlight ring.
• Conversation-only — reads the live per-session chat store (view from ctx.slots.entries("conversation.session") + resolveStore), so it renders only on the chat view and hides instantly on 轨迹 / 上下文 / Design / PPT or the empty home.
• Full history — DSH conversation history is windowed (hasMore). The rail auto-calls session.loadOlder() in a loop until hasMore === false, so it lists all rounds, not just the loaded window.
• Performance-tuned — useSessions selects only current; the rail subscribes to a render signature (question set + active view) instead of the whole conversation snapshot, so streaming output / tool calls don't re-render the list. Skip-free typing, stable handlers, signature-memoized items.
• Theme-aware — panel text & the hover detail box follow body[data-ds-dark-theme] (dark: white text on transparent; light: black text). The panel itself is transparent (no card, no border).
• Keyboard accessible — each question is role="button" with tabIndex=0, Enter/Space triggers.
• Zero runtime dependencies — the node half is intentionally empty (it only makes the loader discover the package); the browser half uses only react / react/jsx-runtime seed words.

How it works

| Layer | What happens | |---|---| | Node half (lib/index.js) | Empty apply() — just enough to be an active cordis loader entry so dsh-client-modules publishes /plugins/dsh-question-rail/client.js. | | Browser half (lib/client.js) | Registers via window.__ModuleLoader__.load, then apply(ctx) injects the rail into the shell.overlay slot (frame-wide, additive, click-through until the entry opts in). | | Data | Reads the current session's ConversationSnapshot.nodes (full list, not the windowed chat.order), extracts user/steering turns, and maps each seq → chat key for scroll anchors. | | View gating | ctx.slots.entries("conversation.session") → resolveStore(handle, sessionId) → store.getSnapshot().view — the authoritative source DSH's own header tabs use. Renders only when view === "chat". |

Installation

# From a local checkout (dev / link mode — source edits take effect on hard-refresh)
dsh plugin --profile web add link:D:/path/to/dsh-question-rail

# Or straight from GitHub (requires git + a GitHub token on this machine)
dsh plugin --profile web add github:LeonSone/dsh-question-rail

dsh plugin add adds the package to the profile's dependencies; because the package declares dsh.bundle, it is automatically appended to dsh.profile.bundles.

New client packages need a restart. dsh.client discovery scans only at boot for new packages (bundle content changes hot-reload). After first install, restart dsh web (or the headless runner), then hard-refresh the browser (Cmd/Ctrl+Shift+R).

Usage

Once installed, a narrow strip of ticks appears along the right edge of an active chat conversation:

| Interaction | Behavior | |---|---| | Move mouse near the right edge | The strip widens, revealing each round's question as a single line (12px, right-aligned, trailing tick). | | Hover a single question | A detail box appears on the left showing the full question text (scrollable up to 50vh). | | Click a question | The chat scrolls smoothly to that turn and flashes a highlight ring. | | Switch to 轨迹 / 上下文 / Design / PPT | The rail hides instantly (chat-view gate). | | Empty / home screen | Nothing renders. |

Development

lib/client.js          browser half (ModuleLoader bundle, injects into shell.overlay)
lib/index.js           node half (empty apply; discovery only)
cordis.patch.yml       bundle patch (mounts the node half)
test/*.mjs             headless contract & extraction tests

Run the checks:

node test/bundle-contract.test.mjs   # __ModuleLoader__.load / apply / inject / shell.overlay registration
node test/bind-fix.test.mjs          # closure-bound getSnapshot/subscribe (no lost-this crash)
node test/extract.test.mjs           # full-list extraction: user/steering only, anchor mapping
node test/loadolder.test.mjs         # loadOlder loop until hasMore=false (full history)

License

MIT