# dsh-message-navigation

**中文** | [English](docs/README_EN.md)

Provides a Codex-style user message navigation bar for DeepSeek Harness.

## Installation

Run the following command from the plugin checkout:

```bash
dsh plugin --profile web add .
```

Alternatively, link the plugin with an absolute path:

```bash
dsh plugin --profile web add /absolute/path/to/dsh-message-navigation
```

Restart the corresponding Web profile after changing its Bundle membership.

## Configuration

The default configuration is suitable for local Web sessions. To override it, add the complete configuration to the profile's `cordis.patch.yml`:

```yaml
- id: message-navigation
  config:
    pageSize: 256
    labelChars: 512
    previewChars: 1024
    maxCacheBytes: 16777216
    scanYieldEvery: 2048
```

Codex behaviors such as animation timing, scale widths, and requiring at least four user messages are part of the fixed interaction contract and are not exposed as configuration options.

## Development

```bash
pnpm install
pnpm run typecheck
pnpm test
pnpm run build
```

Build outputs:

- `lib/index.js`: Host plugin and compact-index RPC.
- `lib/client.js`: Client bundle compatible with DSH's `window.__ModuleLoader__` protocol.