DeepSeek Harness Plugin

jjxjjjjiik-bot/dsh-chat-timeline

Stars ★ 1 Category UI Enhancements Added 2026-08-14

1:1 port of DeepSeek's official web right-side chat navigation rail (ScrollNav): hover-expandable rail, reading-position highlight, click-to-jump.

Install

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:jjxjjjjiik-bot/dsh-chat-timeline

GitHub-sourced plugins run build scripts on your machine at install time. Only install sources you trust, and pin a commit (github:owner/repo#sha).

README

English | 简体中文

License: MIT PRs Welcome

A 1:1 port of the official DeepSeek web app's right-side conversation navigation rail (ScrollNav) as a DeepSeek Harness (DSH) plugin — the exact ScrollNav UI/UX from chat.deepseek.com's shipped client, brought to your DSH Web chat.

Not affiliated with, endorsed by, or sponsored by DeepSeek.

Preview

Features

  • Always-visible right rail — slim fixed vertical rail; every user-sent message appears as one indicator line, exactly like the official collapsed state
  • Hover to expand — panel reveals message previews; the item nearest your reading position is highlighted in brand blue, tracking scroll in real time
  • Click to jump — smooth-scrolls to the message, loading older history on demand
  • Auto-hidden — disappears when the session has fewer than 2 user messages
  • Accessible — ARIA labels + prefers-reduced-motion support

How it works

The host half registers the dshChatTimeline session projection that durably enumerates all user-sent messages; the client half renders the TimelineRail component (mounted in the conversation.input.dock slot, portal-rendered to body). Data sources, fastest first: projection → loaded chat nodes → background loadOlder loop.

Install

One-click (Windows, recommended)

  1. Download this repo (green Code button → Download ZIP, or git clone)
  2. Double-click install.bat — the script copies the plugin, registers the config, and runs pnpm install automatically
  3. Restart dsh web and refresh the browser

The script is idempotent: re-running it won't re-install.

Manual (other platforms)

  1. Copy the plugin to $DSH_HOME/profiles/web/plugins/dsh-chat-timeline/ ($DSH_HOME is usually ~/.dsh)
  2. Add "dsh-chat-timeline": "file:plugins/dsh-chat-timeline" to profiles/web/package.json, then run pnpm install
  3. Add to profiles/web/cordis.patch.yml:
    - insert:
        - id: chat-timeline
          name: dsh-chat-timeline
    
  4. Restart dsh web and refresh the browser

Architecture reference

  • Layout/CSS: 1:1 port of the official ScrollNav (extracted from the shipped main.css), re-scoped under the dsct_ prefix
  • Plugin architecture: modeled on asukasec/dsh-message-preview (MIT)

License

MIT — see LICENSE. "DeepSeek" is a trademark of its owner; this project is not affiliated with DeepSeek.

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →