返回目录
界面增强 插件

dsh-floor-nav

thirsty5034/dsh-floor-nav

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

Stars
0
Forks
0
Issues
0
更新
1 天前

PROJECT TOPICS

项目标签

INSTALL REFERENCE

安装参考

未验证
dsh plugin --profile web add github:thirsty5034/dsh-floor-nav

该命令指向仓库当前默认分支;尚无绑定当前 commit 的完整验证结果。

PROJECT README

README

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 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

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.

CLASSIFICATION EVIDENCE

分类依据

项目类型插件
功能分类界面增强
规则置信度

系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。当前命中: web-ui。