dsh-section-nav

Section Nav

DSH 插件：用于 DeepSeek Harness 聊天中当前助手回答的分节导航栏和本地章节书签。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:jolaaa999/dsh-section-nav#3327a461c60cfe91b43ffbd93272f0b7c12f36f3

兼容性与来源证明

Section Nav 以 dsh-section-nav 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: github
Registry 更新时间: 2026/9/20

版本

0.2.1stable

2026/9/20

0.1.0stable

2026/9/20

README

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.
Adaptive presentation — full, compact, mini, and hidden rail modes follow the available space next to the chat column.
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

Open a DSH chat with an assistant answer containing #, ##, or ### headings.
The section rail appears next to the transcript when there is room.
Click a rail item to scroll to that heading.
Click the star beside a rail item to bookmark it.
Click the star/count button in the rail header to open the bookmark drawer.
Use Escape, a click outside, or the close button to close the drawer.

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

Only h1–h3 headings are shown, matching the original extension.
The rail hides itself when the available space beside the chat column is too narrow.
A bookmark whose answer is outside the currently loaded session window is marked unavailable until that history page loads.
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

License

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

README

dsh-section-nav

English | 简体中文

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.
Adaptive presentation — full, compact, mini, and hidden rail modes follow the available space next to the chat column.
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.

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

Open a DSH chat with an assistant answer containing #, ##, or ### headings.
The section rail appears next to the transcript when there is room.
Click a rail item to scroll to that heading.
Click the star beside a rail item to bookmark it.
Click the star/count button in the rail header to open the bookmark drawer.
Use Escape, a click outside, or the close button to close the drawer.

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

Only h1–h3 headings are shown, matching the original extension.
The rail hides itself when the available space beside the chat column is too narrow.
A bookmark whose answer is outside the currently loaded session window is marked unavailable until that history page loads.
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

License

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

Section Nav

兼容性与来源证明

版本

相关插件

Section Nav

README

dsh-section-nav

Features

Compatibility

Install

From the plugin manager

From the CLI

From a local checkout

Usage

Development

Repository layout

Configuration

Known limitations

Plugin marketplace metadata

License

兼容性与来源证明

版本

相关插件

相关插件

相关插件

README

dsh-section-nav

Features

Compatibility

Install

From the plugin manager

From the CLI

From a local checkout

Usage

Development

Repository layout

Configuration

Known limitations

Plugin marketplace metadata

License