This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

dsh-navbar

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add @vlln/dsh-navbar

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

• Node half: src/index.mjs (empty apply, the bundle mount carrier)

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Do I need to manually enable it after installation?

No. The plugin is automatically active on chat pages after being loaded by the web profile; just restart the web profile after installation. You can disable or re-enable it in the Settings page's 'Plugins' panel.

On which pages will the node bar be displayed?

Only on chat pages in Chat view (also compatible with mounted focused chat view dsh-focus-chat); automatically hidden on other pages like Settings and when user messages are fewer than 2.

Will pinned messages sync across devices?

No. Pinned status is stored in browser localStorage per session (key name dsh-navbar:pins:<sessionId>), persists after refresh, but doesn't sync across devices or browsers.

What happens when there are more than 11 nodes?

Automatically switches to sliding window: only shows 11 nodes near the current activation (±5), with smaller dots at both ends to indicate there are more; the currently selected or pinned node is always forced to display within the window.

When does the top ↑ Load earlier history button appear?

Only appears when the current session has unloaded earlier messages (determined by the presence of the official 'Load earlier' control), automatically hides after all messages are loaded; during loading, the button is disabled and shows 'Loading...'.

Does uninstalling the plugin clear pinned data?

No. Data is stored in browser localStorage; uninstalling the plugin or restarting DSH doesn't automatically clean it up. To clean it up, delete keys starting with dsh-navbar:pins:* in browser developer tools.

Why does the position sometimes jump after navigation?

The plugin uses the official post-0811 'reader input ledger' for direct one-step positioning. Baseline versions before 0811 (0808/0810) use wheel event as a compatibility fallback, which may cause slight jitter with official streaming rendering.

— source: plugin_wiki.faq_json

Compatibility

• DSH: >=0.1.0-rc.5
• Node: >=22.19.0

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule