# dsh-chat-toc (DSH Chat Outline & Native Turn Rail Enhancer)

[中文说明](./README.md) · [Documentación en Español](./README.es.md)

A native conversation navigation and table-of-contents enhancer for the DSH Web GUI: **deeply supercharges the official native Turn Rail** without adding redundant parallel tracks. Provides dual-layer preview popovers (User prompt + AI response), one-click bookmarks with golden glowing highlights, session-scoped persistent storage, and an ultra-clean inline top toolbar (Search / Starred filter / Markdown export).

## Features

- **100% Native Fusion & Zero Redundancy**:
  - Eliminates secondary side-by-side indicator tracks to preserve clean UI breathing room.
  - Directly attaches to DSH's native Turn Rail, transforming the minimal map into a flagship navigation experience.

- **Stable Hover Popovers (No Unexpected Dismissal)**:
  - **Dual Content Display**: Hovering any native rail mark reveals a clean preview card displaying both the **👤 User prompt** and **🤖 AI core response**.
  - **300ms Hover Bridge**: Keeps the card stably visible while moving the cursor leftward from the rail into the card, allowing smooth text selection and interaction without flashing dismissals.
  - **In-Card Actions (⭐ Bookmark & 📋 Copy)**: Directly embeds action buttons at the bottom of the card to star the conversation turn or copy the complete prompt and response.

- **Session-Scoped Persistent Storage**:
  - Scoped by stable **Session ID + message unique anchor keys (`chatAnchorKey`)**.
  - Survives page refreshes and browser restarts without losing any starred marks; clears only when the session is archived or deleted.

- **Inline Native Top Toolbar**:
  - Embedded right beside the "Session Logs" action button in the native top bar; avoids sidebar collisions and never causes dual body scrollbars.
  - **🔍 Instant & Deep Session History Search**: Instant fuzzy highlight for current page; **press Enter in long sessions to trigger Deep History Search**, automatically paging through earlier turns via the official "Load earlier" action until the target is found and smooth-scrolled into view!
  - **💻 Code & Tools Filter Capsules**: Quick filter pills (`All` · `Code 💻` · `Tools ⚙️`) below the search bar to isolate turns with code blocks or tool calls in long conversations.
  - **⭐ Starred-Only Filter**: Turns unstarred marks into subtle 8% opacities, while starred marks illuminate into **22px elongated golden lines with ambient particle glows**.
  - **📋 Export Markdown Outline**: One-click button to extract the entire conversation turn hierarchy as formatted Markdown.

- **Multilingual & Theme Adaptive**:
  - Automatically reactive to DSH Web language settings (Chinese / English / Spanish).
  - 100% compatible with both Light and Dark DSH themes.

## Screenshots

**1. Hover Card (Prompt + AI Response Preview with Inlined Star/Copy actions, and the Inline Top Toolbar):**

![Hover Card Preview](docs/toc-pop.png?v=0.4.10)

**2. Starred Filter Active (Starred marks shine in golden glow, non-starred marks dim down):**

![Rail Marks Highlight](docs/toc-bar.png?v=0.4.10)

## Requirements

- **Minimum version: DSH host ≥ `0.1.5-rc.2`** (`@deepseek-ai/dsh-client-runtime` / `dsh-client-locale` / `dsh-client-ui-chat` ≥ `0.1.5-rc.2`). `peerDependencies` declares `>=0.1.5-rc.2 <0.3.0`.
  This plugin relies on the following official DOM contracts, all of which exist only from `0.1.5-rc.2` onward:
  - `data-chat-flow-kind` / `data-chat-turn` / `data-chat-anchor-key` (authoritative turn and row markers)
  - the `data-chat-flow-kind="text"` vs `"reasoning"` distinction (to take the **answer body** and skip reasoning)
  - the turn number inside each mark's `aria-label` (`chat.turnNavigation.jump`)
  - `*_bubble` / `*_previewPrompt` / `*_previewResponse` (prompt text and the official-preview fallback)
- **Verified on**: `0.1.5-rc.2`, `0.1.6-alpha.1/2`, and **`0.2.0-rc.1`** (current latest).
- **Compatible with the breaking `0.2.0-rc.1` redesign**: that release **removed the `markPosition` class** and switched the rail to **virtualized rendering**. This plugin now anchors on the **mark button itself**, which works across both generations, and re-reads the DOM every time instead of caching mark element references.
- **How it hooks in**: it keys off official **data attributes** (`data-chat-*`) and `aria-label` rather than fragile CSS-Module hashes, using "hash prefix + underscore" class substrings only where genuinely necessary.
- **Dependencies**: a pure client-side enhancement. No other plugins, no host-side service, no extra configuration.

## Installation

```sh
dsh plugin --profile web add dsh-chat-toc
```

After updating, refresh your `dsh web` browser tab to enjoy the upgraded experience.

## Feedback

Found a bug or have a suggestion? Feel free to open an issue on [GitHub Issues](https://github.com/a792883583/dsh-chat-toc/issues).

## License

MIT