67 lines
2.8 KiB
Markdown
67 lines
2.8 KiB
Markdown
# dsh-history-nav
|
|
|
|
Browser history and deep-link URLs for the DeepSeek Harness (DSH) Web UI.
|
|
|
|
The DSH shell keeps its navigation (selected session, central panel, settings dialog/section) in memory only, so the browser **Back/Forward** buttons and page reloads lose your place. This client plugin mirrors that state into the URL hash and the browser history.
|
|
|
|
## Features
|
|
|
|
- URL hash reflects where you are:
|
|
```
|
|
#/session/<id>[/parent/<id>/mode/<m>][/panel/<id>][/settings/<section>]
|
|
```
|
|
- Every user navigation does `history.pushState`, so **Back/Forward** work; changes during app startup use `replaceState`.
|
|
- `popstate` / `hashchange` / loading a page with a hash restores the state (shareable, bookmarkable links to sessions, panels and settings sections).
|
|
- Mouse buttons 4/5 (Back/Forward) map to `history.back()` / `history.forward()`.
|
|
|
|
## How it works
|
|
|
|
| File | Role |
|
|
| --- | --- |
|
|
| `client.js` | Web client module (`@local/dsh-history-nav`), injects `@deepseek-ai/dsh-client-ui-layout` and `@deepseek-ai/dsh-client-ui-workspace`; owns all behaviour. |
|
|
| `index.js` | Empty Host half (`apply() {}`). |
|
|
| `cordis.patch.yml` | Bundle patch inserting the `dsh-history-nav` row. |
|
|
|
|
## Installation
|
|
|
|
Requirements: a working DeepSeek Harness (`dsh`) install with the **web** profile (or any profile that includes the Web UI).
|
|
|
|
### Option A — install from git (recommended)
|
|
|
|
```bash
|
|
dsh plugin --profile web add git+https://git.rizzy.dev/DSH-Plugins/dsh-history-nav.git
|
|
```
|
|
|
|
You can also paste `git+https://git.rizzy.dev/DSH-Plugins/dsh-history-nav.git` into **Settings → Plugins → Install** in the Web UI, or ask the agent to install it with its `plugin_manager` tool (`install_bundle`).
|
|
|
|
The plugin manager adds `@local/dsh-history-nav` to `dependencies` and to `dsh.profile.bundles` in `~/.dsh/profiles/web/package.json`.
|
|
|
|
### Option B — local checkout (for development)
|
|
|
|
```bash
|
|
git clone https://git.rizzy.dev/DSH-Plugins/dsh-history-nav.git ~/dsh-plugins/dsh-history-nav
|
|
dsh plugin --profile web add link:$HOME/dsh-plugins/dsh-history-nav
|
|
```
|
|
|
|
With a `link:` install, edits in the checkout are picked up directly (client changes reload on page refresh, Host changes after a DSH restart or HMR reload).
|
|
|
|
### Enable / verify
|
|
|
|
1. Make sure `@local/dsh-history-nav` is listed in `dsh.profile.bundles` of `~/.dsh/profiles/web/package.json` (the installer does this; add it by hand if you edited `package.json` manually).
|
|
2. Restart DSH (`dsh web`) or reload the page.
|
|
3. Check **Settings → Plugins**: the `@local/dsh-history-nav` bundle should be enabled.
|
|
|
|
### Uninstall
|
|
|
|
```bash
|
|
dsh plugin --profile web remove @local/dsh-history-nav
|
|
```
|
|
|
|
### Updating
|
|
|
|
Re-run the `add` command from Option A (or `git pull` in your Option B checkout).
|
|
|
|
## Configuration
|
|
|
|
None. Once enabled, open a session and watch the address bar update; use Back/Forward or reload the page to verify restoration.
|