DeepSeek Harness plugin

dsh-floor-nav

LiveAgent-style floor navigation rail for DeepSeek Harness (collapsed ticks, hover panel, jump)

Jump to install

Source facts

Repository
thirsty5034/dsh-floor-nav
Latest update
Aug 18, 2026
Category
UI Enhancements
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/thirsty5034/dsh-floor-nav
Plugin: dsh-floor-nav
Author: thirsty5034

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-floor-nav

English | 简体中文

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-width and the composer via --dsh-composer-height

Credits / prior art

UI behavior and interaction model are adapted from LiveAgent (open source):

LiveAgent sourceRole
crates/agent-ui/src/pages/chat/transcript/FloorNavRail.tsxRail UI: collapsed markers, hover panel, touch reveal, pin rows
crates/agent-ui/src/lib/chat-floor-nav/floorModel.tsFloor list, preview truncation, marker sampling, nearest active mark
crates/agent-ui/src/lib/chat-floor-nav/floorBookmarks.tsPer-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

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.

<details> <summary><b>Options / local link / npm (later)</b></summary>

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"

</details>

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

StateInteraction
CollapsedHeight-adaptive sampled ticks (desktop ≤40, touch ≤12); pinned floors always kept
ExpandMouse enter → panel; leave → collapse after 160ms; touch: tap rail / outside to close
JumpScrolls [data-conversation-scroll] to [data-chat-anchor-key]
Active floorNearest user row to the upper-quarter of the viewport; highlight nearest sampled tick
PinslocalStorage["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](./LICENSE).

LiveAgent is a separate project; this plugin only references its floor-nav design.