Plugin directory / UI & Skins / dsh-floor-nav
dsh-floor-nav
Verified · install-tested on dsh thirsty5034
What it does
LiveAgent-style floor navigation rail for DeepSeek Harness (collapsed ticks, hover panel, jump)
Works — verified, early-stage project
LiveAgent-style floor navigation rail for DeepSeek Harness (collapsed ticks, hover panel, jump) It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-floor-nav
DeepSeek Harness community plugin: a LiveAgent-style floor navigation rail for the web GUI.
- Collapsed: a thin column of short horizontal tick marks on the conversation’s right edge (sampled user turns)
- Expanded: hover opens a glass panel listing every user message; click jumps the transcript
- Pins (★): optional bookmarks per session (
localStorage) - Clears dsh-better-sidebar via
--dsh-sidebar-widthand the composer via--dsh-composer-height
Credits / prior art
UI behavior and interaction model are adapted from LiveAgent (open source):
| LiveAgent source | Role |
|---|---|
crates/agent-ui/src/pages/chat/transcript/FloorNavRail.tsx |
Rail UI: collapsed markers, hover panel, touch reveal, pin rows |
crates/agent-ui/src/lib/chat-floor-nav/floorModel.ts |
Floor list, preview truncation, marker sampling, nearest active mark |
crates/agent-ui/src/lib/chat-floor-nav/floorBookmarks.ts |
Per-conversation pin persistence |
This package is a DSH-native reimplementation (Cordis client plugin + DSH conversation snapshot / [data-chat-anchor-key] jump). It is not a fork of the LiveAgent repository and does not ship LiveAgent code as a dependency. LiveAgent remains under its own license; please respect upstream terms when consulting that codebase.
Requirements
- DSH web profile
- Optional: dsh-better-sidebar (layout offset is a no-op if absent)
Install
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/thirsty5034/dsh-floor-nav/main/scripts/install.sh | bash
Windows (PowerShell):
irm https://raw.githubusercontent.com/thirsty5034/dsh-floor-nav/main/scripts/install.ps1 | iex
Or CLI (GitHub until npm publish):
export DSH_HOME=${DSH_HOME:-$HOME/.dsh}
dsh plugin --profile web add "dsh-floor-nav@github:thirsty5034/dsh-floor-nav"
dsh --profile web --dump-config | grep floor-nav
Restart DSH web after install, then hard-refresh the browser. The rail appears when the current session has ≥ 2 visible user (or steering) messages.
Options / local link / npm (later)
bash scripts/install.sh --restart
bash scripts/install.sh --from npm 0.1.0
dsh plugin --profile web add "dsh-floor-nav@link:/path/to/dsh-floor-nav"
Discoverability
- GitHub topics:
dsh-plugin,deepseek-harness,dsh(required for dsh.so auto-index) - Install from GitHub (current): see Install above
- Store listings may lag crawlers; source of truth is this repository
Behavior
| State | Interaction |
|---|---|
| Collapsed | Height-adaptive sampled ticks (desktop ≤40, touch ≤12); pinned floors always kept |
| Expand | Mouse enter → panel; leave → collapse after 160ms; touch: tap rail / outside to close |
| Jump | Scrolls [data-conversation-scroll] to [data-chat-anchor-key] |
| Active floor | Nearest user row to the upper-quarter of the viewport; highlight nearest sampled tick |
| Pins | localStorage["dsh-floor-nav.bookmarks.v1"] |
Development
npm run check
Host half is an empty Cordis shell; all UI lives in lib/client.js (ModuleLoader client bundle).
License
MIT — see LICENSE.
LiveAgent is a separate project; this plugin only references its floor-nav design.
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-floor-nav for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:thirsty5034/dsh-floor-navHeadless (CLI) profile:
dsh plugin --profile headless add github:thirsty5034/dsh-floor-navTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-floor-nav/)<a href="https://dshbase.com/plugins/dsh-floor-nav/"><img src="https://dshbase.com/badges/dsh-floor-nav.svg" alt="dshbase install-tested"></a>