dsh-section-nav

dsh-section-nav

English | 简体中文

A DeepSeek Harness plugin that brings the Section Nav for ChatGPT experience to the DSH web client: a lightweight section rail beside the current assistant answer, with chapter bookmarks stored locally in the browser.

This is a DSH port of Section-Nav-for-ChatGPT by scandishoper (MIT). The ChatGPT extension adapter and manifest were replaced with a DSH adapter and a dsh bundle manifest. See NOTICE and LICENSE.

Features

• Section rail for the current answer — headings rendered in the latest/currently read assistant answer appear in a compact rail beside the transcript.
• Reading-position tracking — the active section follows the transcript reading line, with the same hysteresis behavior as the original extension.
• One-click section navigation — clicking a heading scrolls to it and briefly highlights the target.
• Local chapter bookmarks — bookmark any section, reopen the bookmark drawer, and jump back later.
• Always-visible rail — the rail never collapses into a marker strip on its own: entries keep their titles, and the width follows the available gutter, narrowing as the window narrows.
• Manual collapse — the collapse control in the rail heading stows the rail into a small edge button, and clicking that button brings it back. The choice is remembered across reloads and Sessions.
• Two-part hover card — hovering a rail entry shows the user's request on the main line and a two-line excerpt of that turn's final model answer beneath it, styled with the Host's tooltip tokens.
• Navigation that holds — paging older history no longer drags the viewport away from the entry you just clicked; the rail restores your target once pagination settles.
• Lazy history — the rail opens with the newest 8 turns and shows a load control at the top of the list; click it, or keep scrolling up, to page in 8 older turns at a time. The control reports when no older turns remain.
• Fast Session switching — each visited Session's directory is cached in memory, so switching back renders its entries immediately.
• Theme following — the rail reads the host page's computed text and surface colors, so it follows DSH light/dark themes.
• Bilingual copy — Chinese and English strings are registered through the DSH locale service.
• No server storage — bookmarks live in localStorage under dshSectionNav.bookmarks.v1; nothing is uploaded.

Compatibility

The plugin targets the DSH web client's chat DOM contract:

• assistant rows: [data-chat-flow-kind="assistant-step"]
• transcript container: [data-chat-flow]
• stable answer keys: data-chat-anchor-key / data-chat-flow-key
• turn indexes: data-chat-turn
• headings: h1, h2, h3 inside the answer, excluding reasoning disclosures

It is a pure browser-side plugin. The host half only mounts the Loader seat; every feature lives in lib/client.js.

The implementation has been smoke-tested against the packaged Oh-DSH 0.1.12 runtime (@deepseek-ai/dsh 0.1.2-alpha.3) and follows the current DSH client contracts used by 0.1.x web/desktop releases.

Install

From the plugin manager

Open Plugins in the DSH sidebar and use Add plugin with:

github:jolaaa999/dsh-section-nav

From the CLI

dsh plugin --profile web add github:jolaaa999/dsh-section-nav

The package commits its built lib/ artifacts, so a git install does not need a build step or an install-script approval.

From a local checkout

dsh plugin --profile web add .

Run that command from this repository's root. The package manifest declares dsh.bundle.patch, so the profile adds dsh-section-nav as a layer automatically.

Usage

1. Open a DSH chat with an assistant answer containing #, ##, or ### headings.
2. The rail is always visible: entries show their titles, and the rail widens or narrows with the space beside the message column.
3. Click a rail item to scroll to that heading.
4. Click the star beside a rail item to bookmark it.
5. Click the star/count button in the rail header to open the bookmark drawer.
6. Use Escape, a click outside, or the close button to close the drawer.
7. The rail shows the newest 8 turns. Click the load control at the top of the list, or keep scrolling up there, to load 8 older turns at a time.

Development

pnpm install
pnpm run typecheck
pnpm run build

pnpm run build first emits the ESM host half to lib/index.js, then builds the browser half to lib/client.js and lib/client.js.map.

Repository layout

• src/index.ts — host half; a Loader seat with no host-side behavior.
• src/client/index.tsx — Cordis client entry, service injection, and lifecycle.
• src/client/sectionNav.tsx — controller: rail mount, trackers, bookmarks, route/session reset, and cleanup.
• src/core/adapter.ts — DSH chat DOM adapter; the only file with DSH selectors.
• src/core/* — adapted section parser, answer tracker, section tracker, rail positioning, bookmark service/resolver/recovery, and mutation watching.
• src/client/components/* — React rail and bookmark drawer components.
• cordis.patch.yml — DSH bundle layer that registers the plugin row.
• lib/ — committed build artifacts used by git and tarball installs.

Configuration

There are no DSH config fields. The plugin intentionally follows the original extension's behavior and persists only bookmarks:

localStorage['dshSectionNav.bookmarks.v1']

Known limitations

• Directory entries come from user turns; assistant heading parsing is not re-enabled in this version.
• On a very narrow viewport the rail narrows to its minimum width and pins to the viewport edge; titles stay visible but truncate earlier.
• History paging stops when the Host has no more pages to return, or when the directory has been fully loaded; a turn older than that cannot be reached.
• A bookmark pointing outside the rendered window still pages history on demand to reach its target.
• Headings inside reasoning disclosures are ignored; sections belong to the assistant's answer text.
• No cross-device bookmark sync and no server-side storage.

Plugin marketplace metadata

Recommended GitHub repository topics:

dsh
deepseek-harness
dsh-plugin
plugin
ui
sidebar
navigation
bookmarks

The repository is intended to be discoverable by DSH plugin catalogs that scan GitHub for dsh-plugin / deepseek-harness topics and package manifests.

License

MIT. This port retains the original project's copyright and license notice; see LICENSE and NOTICE.