dsh-plugin-control-your-development

Threadline / 脉络

A read-only DSH plugin that turns what a conversation did to your workspace into a drillable timeline.

中文

Overview

Threadline is a plugin for [DeepSeek Harness](https://github.com/deepseek-ai) (DSH) that answers a

narrow question well: what did this conversation actually change in my workspace?

It collects the files a turn touched, the commands it ran, the subagents it spawned and the relations

between turns, then presents them as one drillable timeline embedded in the DSH session view. Everything

is read-only: the plugin never writes to your workspace, never stores anything, never opens an extra

entry point.

It is built for people who let an agent work in a repository and then need to review the result — not for

planning, task assignment or code editing.

Features

• Relation graph of the current directory. A deterministic force-directed layout where folders are

rounded cards and files are dots. Edges are layered (skeleton, top-3 co-occurrence, the rest on hover),

capped at 1.6 × node count so the graph never turns into a spider web.

• Folder-to-folder links. Aggregated from real cross-directory relations only. Folders with no real

relation go to a perimeter ring and are never connected by a fabricated edge.

• Node cap with an honest switch. Up to 40 files by default; a persistent Show N/M chip switches to

the full set in place and auto-degrades density, labels and radius. Hard ceiling 300.

• Dual-track timeline. An activity histogram per time bucket on the upper track, one row per session on

the lower track, a single playhead label, and exactly three scale ticks.

• Turn strip with lock-first selection. Click a turn to lock it, hover another turn without losing the

lock, click again to release. Double-click the timeline to snap back to "now".

• Workspace file browser. Starts at the workspace root, navigates to any depth, breadcrumb / back /

refresh, card or list view, virtualization beyond 200 rows.

• Zero third-party runtime dependencies. dependencies is an empty object; React and @deepseek-ai/*

are peer dependencies provided by the host.

Installation

Threadline is a DSH plugin. Install it through the DSH plugin manager, or with npm:

npm install dsh-plugin-control-your-development

Requirements:

• DSH with runtime 0.2.1-rc.5 or later (@deepseek-ai/dsh-session >= 0.2.0-0)
• React 18 and React DOM 18 provided by the host (not bundled)

Restart DSH after installing or replacing the package. Replacing an already-loaded plugin requires a

process restart; a page refresh alone does not reload it.

Usage

Three surfaces, no fourth entry point:

| Surface | Where | What you get |

| --- | --- | --- |

| Threadline tab | conversation.view, id threadline | Left column: relation graph of the current directory + dual-track timeline + turn strip. Right column: workspace file browser. Both columns scroll independently. |

| Impact count | assistant message actions, id threadline-impact | Files / commands / subagents touched by that turn. Clicking jumps to the Threadline tab focused on that turn — no dialog. |

| /threadline | input box command (also /脉络) | Jumps to the Threadline tab for the current session. |

Typical flow:

1. Open a session and switch to the Threadline tab.

2. The left graph shows the current directory. Click a folder card to enter it; the right column follows.

3. Hover a file to highlight its relations; click to pin the evidence panel.

4. Click a turn in the strip to lock that turn's file graph. Click it again to release.

5. Drag a folder card or a file dot to rearrange. Use Fit to reset the camera and Reset to clear drags.

Folder-to-folder links

A directory with many subfolders is not a scatter of isolated cards: folders that really exchanged

files are connected, so you can see which parts of the workspace move together.

One turn in isolation

Clicking a turn switches the left graph to that turn's files and overlays the read / write line counts.

Node cap

Directories with more than 40 files keep the most active ones and show a persistent Show N/M chip.

Switching to the full set degrades density, labels and radius automatically.

> The screenshots above are rendered from the real component with a synthetic fixture dataset, so the

> file names are test data; the interface itself is not a mock-up.