🧠 dsh-thinkbar

Dynamic reasoning-wait visual indicator for DeepSeek Harness Web Composer

English | 简体中文

dsh-thinkbar is a lightweight, non-intrusive Web UI plugin for DeepSeek Harness. It fills the existing model selector with a dynamic thermal gradient during each assistant Step's model-thinking window, and overlays a separate Tool activity treatment while that Step's tools execute.

✨ Key Features

• 🌡️ Thermal Iron Scale Palette: Smooth transition from initial Harness info blue (0s) through red (~6.7s), orange (~13.3s), and glowing gold (20s) with an ease-out progression curve.
• ⚡ Zero-Intrusion Portal Adapter: Injects through the public conversation.input.right Slot lifecycle without hacking DSH internals, generated CSS classes, or model label strings.
• 🎯 Model-Compatible Per-Step State Machine: Starts with each model request, follows explicit reasoning chunks when available, and switches exclusively to Tool activity when a call begins.
• 🛠️ Visible Tool Activity: Uses a distinct violet/cyan sweep and temporarily overlays the names of every currently executing Tool.
• 💨 Fluid Drain Animation: Drains smoothly in 240ms when reasoning yields to text, tool calls, or message completion.
• ♿ Accessibility Ready: Fully respects prefers-reduced-motion settings.
• 🔒 100% Client-Side & Private: Zero backend modifications, zero telemetry, zero external network traffic.

📋 Requirements

[!IMPORTANT] This release supports exactly 0.1.2-alpha.4. Earlier builds used different Conversation target lifecycles and are not supported.

🚀 Quick Start

Installation

Install via npm registry:

pnpm dsh plugin --profile web add dsh-thinkbar

Or test a local release tarball:

pnpm dsh plugin --profile web add ./dsh-thinkbar-<version>.tgz

Restart your DSH Web Profile after installation:

pnpm dsh web

Verify that dsh-thinkbar is loaded:

pnpm dsh --profile web --dump-config

(The output must contain exactly one dsh-thinkbar row)

Upgrade & Uninstall

# Upgrade to a specific version
pnpm dsh plugin --profile web add dsh-thinkbar@<version>

# Uninstall plugin
pnpm dsh plugin --profile web remove dsh-thinkbar

🔍 How It Works

[ step/start ] ──> Start Thinking Fill (8% -> 100%, 0s -> 20s)
       │
[ assistant/chunk: reasoning ] ──> Continue Thinking Fill
       │                              │
       │                              └──> Palette: Blue -> Red -> Orange -> Yellow
       │
[ text / step/end ] ──────────────> Fast Drain (240ms) -> Return to Idle

[ assistant tool-call / tool/call ] ──> Stop Thinking Clock + Fast Drain (240ms)
                   │
                   └──> After 200ms, show violet/cyan Tool sweep + name overlay
                                      │
[ final matching tool/result ] ───────┴──> Return to Idle until next step/start

1. State Projection: Derives mutually exclusive Thinking and Tool phases for each { turn, step } from the public ctx.uiConversation.events and ctx.uiConversation.views registries. Parallel Tools remain paired independently by call ID, while the Thinking clock stays stopped for the rest of that Step.
2. Anchor & Portal: Anchors in conversation.input.right, identifies the trailing button[aria-haspopup="menu"] within [data-composer-card], and portals an isolated plugin layer.
3. Safety Fallback: If the model trigger cannot be identified uniquely, the DOM remains untouched with a single console notice:

   [dsh-thinkbar] Could not uniquely identify the DeepSeek Harness model selector; the indicator is disabled.

🛠️ Troubleshooting

🧑‍💻 Development

# Install dependencies
pnpm install --frozen-lockfile

# Run typecheck, unit tests, build validation & publint
pnpm verify

# Pack local tarball
pnpm pack

Release Pipeline

# One-command automated publish suite
npm run publish

# Dry-run validation without publishing
npm run publish -- --dry-run

The browser artifact is a DSH lazy-CJS factory. Always preserve its window.__ModuleLoader__.load(...) envelope.

Contributor References

• Upstream-compatible reasoning indicator research
• DSH plugin publishing research

📄 License and Attribution

MIT License

The original reasoning indicator design was extracted from DeepSeek Harness commit 6d7ae5aa57b4dedfc03b09de7cafb65c01338800. DeepSeek Harness is Copyright (c) 2026 DeepSeek and distributed under the MIT License. Independent packaging and subsequent modifications are maintained by the dsh-thinkbar contributors.