32 lines
2.7 KiB
Markdown
32 lines
2.7 KiB
Markdown
# @local/dsh-chat-split
|
|
|
|
Chats side by side for DeepSeek Harness, right in the normal conversation area. There's no separate view or button to open first.
|
|
|
|
## Use
|
|
|
|
- **Put a chat beside the one you're reading:** in the sidebar, open that chat's "…" menu and choose **Include in split view**. The conversation area turns into a split with both chats.
|
|
- **Add more:** *Include in split view* on more chats, or the `+` in any window's top bar.
|
|
- **Pick chats in the main sidebar as usual:** a chat that's already open flashes its window with a short blue glow. Any other chat opens in the window you used last.
|
|
- **Back to one chat:** close windows with `✕` (or *Exclude from split view*) until one is left, or press `⤢` (*show only this chat*) on a window. The normal single-chat view comes back with that chat.
|
|
|
|
The split survives reloads; the set of open chats and the settings live in the browser (`localStorage`).
|
|
|
|
## Features
|
|
|
|
- **Side by side, then a grid.** Windows sit in one row while each conversation still gets the *readability width* (default 420 px, plus the window's chat list when that is shown). When the area is too narrow for that, they wrap into a grid of rows and columns.
|
|
- **Minimum height.** Every window is at least **396 px** tall (configurable). If the rows don't fit, the area scrolls instead of squashing the chats.
|
|
- **A full chat in every window.** Each window renders the real conversation (messages, composer, tools), the same embedded view DSH uses for sub-agent chats.
|
|
- **Own chat list per window.** `☰` shows that window's own chat list: filter it and switch what the window shows. A blue dot marks chats already open in another window, a green dot running ones.
|
|
- **Top bar per window.** Title, grid position (row · column), move up / left / right / down, `+` open a chat beside, `⤢` show only this chat, `✕` close.
|
|
- **Settings with a live preview.** *Settings → Chat split*: minimum height, readability width, gap, window chat-list width, and whether chat lists start open. A scaled preview built from your real chats shows where the windows wrap; drag its width/height or change the number of chats.
|
|
|
|
## Development
|
|
|
|
`client.js` is the whole plugin (`index.js` is an empty host half). The split is a `main` area entry without a panel-list button: it is selected automatically while two or more chats are open, and when the stock sidebar returns to the conversation view after a pick, it switches back before the browser paints.
|
|
|
|
```bash
|
|
node --test test/*.test.mjs # headless: registrations, include / pick / close flows, layout maths
|
|
```
|
|
|
|
The test loads `client.js` with real React against fake DSH services (sessions, layout, workspace). It looks for a React install itself, or set `REACT_DIR=<dir with react/ and react-dom/>`. It skips when none is found.
|