dsh-one-click-archive

Readme

# dsh-one-click-archive

A DeepSeek Harness Web GUI plugin that previews and archives old conversations in one click.

![One-click archive settings](assets/settings-one-click-archive.png)

## Features

- Choose an age threshold: 1/6/12 hours, 1/3/7/14/30/90 days.
- Preview the exact candidate count and a sample before changing anything.
- Optional inclusion of blank sessions.
- Automatically skips running, recently active, and already archived sessions.
- Recalculates candidates immediately before archiving to avoid stale-preview mistakes.
- Uses DSH's official `workspaceRegistry.archiveSession()` API. Conversation logs are retained and remain restorable.
- Loopback-only host routes and a confirmation dialog before mutation.
- English and Simplified Chinese UI.

## Install

```bash
dsh plugin --profile <your-web-profile> add github:sujiu222/dsh-one-click-archive
```

Restart that DSH Web profile, refresh the browser, then open **Settings → One-click archive**.

For local development:

```bash
npm install
npm run check
dsh plugin --profile <your-web-profile> add /absolute/path/to/dsh-one-click-archive
```

Client plugin updates hot-reload only when the DSH checkout's `pnpm run dev:web` watcher is running. Otherwise rebuild/reinstall, restart the host when the host plugin changes, and refresh the page.

## API

The plugin exposes loopback-only same-origin routes:

- `GET /api/dsh-one-click-archive/health`
- `POST /api/dsh-one-click-archive/preview`
- `POST /api/dsh-one-click-archive/archive`

Request body:

```json
{ "ageMs": 86400000, "includeBlank": false }
```

Accepted ages range from one hour to ten years.

## Safety

Archiving is non-destructive: it only adds session IDs to DSH's global archive set. It does not remove session logs or workspace accounting. Use an archive-management plugin or DSH's archive UI to restore sessions.

## License

MIT