dsh-turnbar
用于代理对话的进度条——在 DeepSeek Harness 中提供会话内轮次导航、悬停预览、上下文余量指示器、章节、轨迹跳转和 ⌘K 搜索
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-turnbar@0.3.3Turnbar 以 dsh-turnbar 发布，当前版本为 0.3.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A progress bar for your agent conversations.
Long agent sessions are productive — until you need to find that one requirement
you mentioned 80 turns ago. Native scrollbars make you guess and re-scroll.
dsh-turnbar gives your DeepSeek Harness chat a video-style progress bar: hover to
preview any turn, drag to scrub, click to jump, Esc to come back.
scrub, hover cards, and ⌘K search landing on the bar
Three ways, pick one:
① Plugin market (easiest): open dshmarket inside dsh, search "turnbar", one click (listing pending; until it lands, use the options below).
② Command line: open your macOS Terminal app and paste:
dsh plugin --profile web add dsh-turnbar
This runs in the Terminal app, not in the dsh chat box. If your terminal doesn't
know the dsh command (dsh --version says command not found — you never installed
dsh globally, e.g. you use a desktop build or let your AI launch it), install it first:
npm install -g @deepseek-ai/dsh
③ Ask your AI: just tell your agent "install dsh-turnbar for me" — it runs the same command on your machine, exactly how you've been installing your other plugins.
Restart dsh afterwards. Zero config; historical sessions are backfilled automatically and the bar always shows the whole conversation.
⌘K opens it. Search everything the agent said or you said, across the whole
session (including history beyond what's loaded); results show a count, arrow
keys scroll the highlight into view, Enter lands the pick on the bar. Results
are also drawn on the bar itself — matching turns glow amber, so a query like
"TypeScript" shows you at a glance where in the conversation it lives (v0.3).v0.3)./goal rounds are marked as thin ticks on the bar, so a
long session gets visible "milestones" without any manual bookkeeping (v0.3).⌘/Alt + click a segment opens the official
Trajectory view and scrolls to that turn's row, centered and highlighted.
Falls back to a normal in-chat jump when trajectory is unavailable (v0.3).⌘↑ / ⌘↓ — hop one turn at a time from where you're reading; empty
turns are skipped automatically.Esc (or the toast) takes you back to
exactly where you were.Nine navigation plugins appeared in dsh's first four days — all of them are rails, drawers, or dot chains: a list of user messages you click through. dsh-turnbar is the only one shaped like a video player:
| dsh-turnbar | dsh-navbar | dsh-chat-timeline | dsh-message-navigator | dsh-conversation-outline | dsh-codex-timeline | dsh-outline | dsh-chat-outline | dsh-message-preview | dsh-turn-marks | |
|---|---|---|---|---|---|---|---|---|---|---|
| Form | full-map bar, always visible | sliding dot window | official-rail clone (right rail) | outline drawer | sidebar outline tab | left rail (Codex-style) | outline overlay | left sidebar outline | right-edge navigator | left-turn strip |
| Whole-conversation map (beyond loaded window) | ✅ event log | ❌ | ❌ | ❌ | ❌ | ⚠️ auto-loads history | ❌ | ⚠️ full mode on demand | ❌ | ❌ |
| Drag scrub | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Rich hover meta (tools/files/tokens) | ✅ | ❌ | ❌ | ❌ | ❌ | ⚠️ latency/tok-s only | ❌ | ❌ | ✅ preview | ✅ preview |
| Context fuel gauge (window occupancy) | ✅ from usage events | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Search (whole conversation incl. assistant) | ✅ + results on the bar | ❌ | ❌ | user msgs only | ❌ | ⚠️ local browser-only | ⚠️ headings/keywords | ⚠️ keyword filter | ❌ | ❌ |
Chapter ticks (/goal milestones) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ⚠️ markdown headings | ❌ | ❌ | ❌ |
| Trajectory view jump | ✅ ⌘/Alt+click | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ Ctrl/Shift click | ❌ | ❌ |
Esc return | ✅ | ❌ |
All of them are MIT and genuinely useful — dsh-turnbar just goes further on the feel: it's a video player, not a list. See also Companions below.
Built on paths others paved first — with gratitude:
PLUGIN_DEV_NOTES.md;Tested against dsh 0.1.5-rc.1 (web profile, handle-based persistence
open/read/close) and 0.1.0-rc.7 (one-step inspect/readRaw persistence).
Both persistence generations are auto-detected at runtime, so history backfill
works on either. Works with the official web UI's conversation.composer.dock
slot; no patches, no UI hacks — which is the point: upgrading dsh does not
require uninstalling dsh-turnbar first. The one plugin that does require that
dance is
dsh-codex-timeline: it pins an
exact dsh commit by replacing the official conversation adapter, so the upgrade
checklist says "uninstall before upgrading". Different trade-off, stated plainly.
Coexists with other plugins that share the same composer.dock slot —
dsh-web-ui-all and its
included dsh-live-stats / dsh-aionui-panel. A built-in co-existence CSS layer
(v0.2.2+) forces the dock into a wrapping row so the TurnBar always owns its own
full-width line while the official StatsLine sits beside any third-party entries,
so the bar is never squeezed sideways. Single-turn sessions now show a one-segment
progress bar too (only brand-new 0-turn sessions stay hidden).
| dsh version | status |
|---|---|
| 0.1.5+ (web, handle-based persistence) | ✅ full features |
| 0.1.0-rc.5 – 0.1.1-rc.x (web, inspect/readRaw) | ✅ full features (legacy chain) |
| older / non-web profiles | plugin stays inert; nothing breaks |
/goal), bookmarks, trajectory ↔ chat
round-trip polish.pnpm install
pnpm test # vitest (fold logic, card model, host-half degradation)
pnpm build # tsdown: lib/index.mjs (node half) + lib/client.js (web half)
Architecture: a dual-half plugin — the node half folds the session/event
firehose into per-turn records (persisted sidecar), serves them over
/plugins/dsh-turnbar/state; the web half renders the bar into the official
composer dock slot. All dsh API contact is confined to src/platform/dsh/.
MIT — same as dsh.
| ❌ |
| ❌ |
| ❌ |
| ❌ |
| ❌ |
| ❌ |
| ❌ |
| ❌ |
| Survives dsh upgrades | ✅ official slot + graceful degradation | ✅ | ✅ | ✅ | ⚠️ via better-sidebar | ❌ pins an exact dsh commit, uninstall before upgrading | ✅ | ✅ | ✅ | ✅ |