# DeepSeek Harness

evo integrates with DeepSeek Harness as a Cordis plugin, providing automatic recall and reflection plus a web-based Settings → Memory panel.

## Quick Install

For an npx-managed Harness profile:

```bash
./install_evo_dsps.sh
```

This builds the package, installs a local link through `dsh plugin`, and activates evo as a DSH bundle. The default profile is `web`; override with `DSH_PROFILE=tui` or another profile name.

The bundle uses `deepseek-official` and `deepseek-v4-flash` by default; override at launch with `EVO_PROVIDER` and `EVO_MODEL`.

## Manual Configuration

Add the plugins to your `cordis.patch.yml` after the Harness LLM and system-prompt services:

```yaml
- id: evo
  name: evo/cordis
  config: {}

- id: evo-deepseek
  name: evo/deepseek
  config:
    provider: deepseek-official
    model: deepseek-chat
    recallLimit: 40
    maxContextChars: 6000
    reflect: true

# Optional: web panel carrier
- id: evo-web
  name: evo
  config: {}
```

A copyable fragment is available in [`examples/cordis.yml`](https://github.com/TIZ36/evo/blob/main/examples/cordis.yml).

## How It Works

The adapter uses official Harness extension points:

| Extension Point | Role |
| --- | --- |
| `system-prompt/assemble` | Recalls global, project, and session memory into dynamic context |
| `session/event` | Observes successful `turn/end` events and reflects activity |
| `ctx.llm.stream()` | Runs reflection and consolidation through the configured model |

Interrupted, aborted, rejected, and failed turns are never reflected.

## Web Panel

The package ships a web client that adds a **Memory** page to Harness GUI Settings:

- Memory list with kind tabs and search
- Recent reflect/consolidate activity log
- Actions to consolidate a scope or force workspace re-import

The composer tool row also gets an **evo** chip that pulses during reflection. Clicking it opens Settings → Memory.

The client half is carried by the `evo-web` row in `cordis.patch.yml`. Restart Harness after upgrading so the new boot graph includes the panel.

## Configuration Options

| Option | Default | Description |
| --- | --- | --- |
| `provider` | — | Harness provider for reflection |
| `model` | — | Model for reflection and consolidation |
| `recallLimit` | `40` | Maximum memories to consider per recall |
| `maxContextChars` | `6000` | Character budget for injected context |
| `reflect` | `true` | Set `false` to recall only, never write |
| `workspaceImport` | `true` | Set `false` to skip automatic workspace import |