# dsh-ui-outline

Right-edge turn navigation for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) web — one dash per user turn, hover to expand an outline panel, click to jump.

为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）web 端提供的右侧轮次导航——每轮一条横线，悬停展开大纲面板，点击跳转。

---

## Features

One dash per user turn in a 34px frosted pill (`blur(5px)`); the dash at your reading position lights up in brand blue and tracks scroll live. Hover to expand a 240px outline panel of turn snippets; click a row to jump. Open/close respond immediately, like the official nav. Light and dark themes follow the official signal.

每轮用户消息一条横线，置于 34px 毛玻璃胶囊内；当前阅读位置品牌蓝高亮、实时跟随滚动。悬停展开 240px 大纲面板，点击条目跳转；开合即时响应，与官方一致。明暗主题跟随官方信号。

| Theme \ State | Collapsed | Expanded |
|:---|:---:|:---:|
| **Light** | [![light collapsed](https://raw.githubusercontent.com/iluluyu/dsh-ui-outline/main/docs/img/zoom-demo-light-seal.png)](https://raw.githubusercontent.com/iluluyu/dsh-ui-outline/main/docs/img/demo-light-seal.png) | [![light expanded](https://raw.githubusercontent.com/iluluyu/dsh-ui-outline/main/docs/img/zoom-demo-light-open.png)](https://raw.githubusercontent.com/iluluyu/dsh-ui-outline/main/docs/img/demo-light-open.png) |
| **Dark** | [![dark collapsed](https://raw.githubusercontent.com/iluluyu/dsh-ui-outline/main/docs/img/zoom-demo-dark-seal.png)](https://raw.githubusercontent.com/iluluyu/dsh-ui-outline/main/docs/img/demo-dark-seal.png) | [![dark expanded](https://raw.githubusercontent.com/iluluyu/dsh-ui-outline/main/docs/img/zoom-demo-dark-open.png)](https://raw.githubusercontent.com/iluluyu/dsh-ui-outline/main/docs/img/demo-dark-open.png) |

*2×2 grid (theme × state) from a real dsh web session; thumbnails are zoomed rail close-ups, click through for the full window. 2×2 矩阵（主题 × 状态）均来自真实 dsh web 会话；缩略图为轨道局部放大，点击可查看完整窗口截图。*

## Install

```sh
dsh plugin --profile web add dsh-ui-outline
# or: dsh plugin --profile web add github:iluluyu/dsh-ui-outline
```

Restart `dsh web` and reload. Uninstall: `dsh plugin --profile web remove dsh-ui-outline`.

重启 `dsh web` 并刷新浏览器即可。卸载：`dsh plugin --profile web remove dsh-ui-outline`。

## Design parity

Colors, radii, shadows and motion curves follow the official design tokens (`--dsw-alias-*`), resolved live from the host page with fallbacks, so the plugin stays visually consistent with dsh and the DeepSeek site.

颜色、圆角、阴影、动效均跟随官方设计 token（`--dsw-alias-*`），优先实时读取宿主变量、官方实测值兜底，与 dsh 及官网视觉保持一致。

## Development

Zero-build: `lib/` is both source and artifact. Turn discovery is DOM-based (`[data-conversation-scroll]`, `[data-chat-flow-kind="user"]`), decoupled from the snapshot API.

零构建：`lib/` 既是源码也是发布产物。轮次发现基于稳定 data 属性，与快照 API 解耦。

```sh
node --check lib/client.js      # syntax gate
python3 test/make-parity.py     # regenerate style-parity fixture
```

| File | Role |
|---|---|
| `cordis.yml` | bundle patch: one loader row into the Web profile |
| `lib/index.js` | node half (no behavior) |
| `lib/client.js` | browser half: registers into the `shell.overlay` seat |

## Performance

The rail costs nothing while you read: scroll tracking reads one rect per frame and binary-searches cached turn offsets, refilled only when the conversation DOM changes; streaming reuses unchanged row objects, so a settled outline re-renders nothing; snippets read `textContent`, never the layout-forcing `innerText`.

阅读期间轨道零开销：滚动每帧仅读一次矩形，在缓存的轮次偏移上二分查找，仅当会话 DOM 变化时重填；流式输出时复用未变化的行对象，静止的大纲不产生任何渲染；摘要读取 `textContent`，绝不触发强制重排。

## License

MIT