dsh-conversation-outline

> Conversation Outline — a static DSH Web plugin that adds a "对话大纲" tab to the > DSH-better-sidebar sidebar: > the current session is rendered as a structured, per-turn outline with one-line > LLM-generated titles, and every entry can jump straight to the message.

   

中文文档

Overview

For whom: users of DeepSeek Harness Web (npx @deepseek-ai/dsh web) who want a quick navigable map of the ongoing conversation instead of scrolling a long chat history.

What it solves:

• Structured per-turn outline — user messages, assistant replies, tool calls

(consecutive ones auto-merge into collapsible groups), compaction checkpoints and error rows are grouped by turn.

• One-click jump — click any entry; the plugin loads older history as needed

and scrolls to the exact row in both the chat view and the trajectory view.

• One-line LLM title per turn — the Host calls llm.stream directly (no

subagent), caches by content fingerprint, and reuses titles across forked sessions with the same prefix.

• Fully parallel title generation — ended turns generate immediately, even

while the agent is still working on a later turn; only the still-open current turn waits for its own turn to finish.

• Configurable — title model, reasoning effort, concurrency, per-attempt

timeout, retry count and a master disable switch, persisted via the gear settings panel.

• Auto-collapse on narrow panels — when the panel gets narrow (≤360px), the

per-row kind tags (user / assistant / tool, etc.) collapse from text into icons (hover shows the full label), matching the trajectory view's behavior.

Screenshot

<p align="center"> <img src="assets/screenshot-outline.png" alt="Conversation outline screenshot" width="320"> </p>

> The 对话大纲 panel in the right sidebar: per-turn collapsible outline with > LLM titles; click any entry to jump to the matching message.

Compatibility

> npm's dsh-better-sidebar may still be 0.11.0; build from source and link it > into the profile for v0.12.0 features (see README of better-sidebar).

Install

Option 1: one-liner (recommended)

Install straight into your web profile, no manual clone:

npx @deepseek-ai/dsh plugin --profile web add github:YesSanSan/dsh-conversation-outline#main

> Git-hosted plugins may build on install via a prepare script, which pnpm > blocks until allowed; if pnpm prints an allowBuilds hint, add the exact key to > <profile>/pnpm-workspace.yaml and re-run. This plugin is a plain-JS static > package and usually needs no build step.

Option 2: clone and install locally

The repo root is the plugin package (package.json / index.js / client.js / cordis.patch.yml):

git clone https://github.com/YesSanSan/dsh-conversation-outline
cd dsh-conversation-outline
npx @deepseek-ai/dsh plugin --profile web add .

Restart DSH:

npx @deepseek-ai/dsh web

Open the better-sidebar + menu and pick 对话大纲.

Uninstall

npx @deepseek-ai/dsh plugin --profile web remove dsh-client-ui-conversation-outline

Quick start

1. Start npx @deepseek-ai/dsh web with the plugin installed. 2. Open any conversation; open the sidebar and add the 对话大纲 tab. 3. The outline shows every turn with its LLM title; click a row to jump. 4. Optional: open the gear settings to pick a title model / reasoning effort, or tune timeout and retries.

Configuration

Stored in better-sidebar pluginSettings['conversation-outline'] (localStorage dsh-conversation-outline-settings:v1 is the legacy fallback).

Permissions & data

• Session logs: Host reads the live session log via ctx.sessionQuery

(readSession / listEvents) to build the outline; nothing is written back to the session.

• LLM call: title generation sends only the current turn's visible text

(user + assistant blocks, tools removed, truncated) to the configured model route; the prompt is a fixed short summarization instruction.

• Browser storage: generated titles are cached in localStorage

(dsh-conversation-outline-titles:v1); settings in pluginSettings + localStorage.

• No credentials / no network beyond the configured model provider. The

plugin never reads API keys or other secrets.

Troubleshooting

Development

See [docs/PLUGIN_DEV_NOTES.md](docs/PLUGIN_DEV_NOTES.md) for the WebUI seams (slots, session snapshots, anchors), gotchas and verified behaviors. dev/dynamic/ holds the earlier dynamic-plugin prototype for reference; the static package at the repo root is the deliverable.

npm run check        # node --check index.js && node --check client.js

Contributions: fork, change, npm run check, open a PR. No build step is required — the client is a hand-written window.__ModuleLoader__.load bundle.

License & security

[MIT](LICENSE). Security issues: please open a private issue (Issues) or contact the author via email before public disclosure.

---

Listed in the awesome-dsh-plugins ecosystem directory (dsh-plugin topic). Inclusion ≠ compatibility audit; review the source before installing.