@deepseek-ai/dsh-client-ui-session-archive

Readme

# DSH Plugin: UI Session Archive

[中文](README.zh.md) | English

Provides **session archive management and restoration** features for the [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness) web interface, hiding inactive conversations from the main workspace list while keeping them accessible and restorable from a dedicated sidebar section.

## Target Audience and Use Cases

Designed for users with many active conversations who want to keep the sidebar uncluttered while preserving complete historical transcripts for later review and restoration.

## Key Features

- **One-Click Archive and Restore**: Archive sessions from the session action menu, and restore them back to their original workspaces from the sidebar footer.
- **Pure Slot-Based Composition**: Injects seamlessly through the `sidebar.workspaces.archive` slot without leaving redundant UI artifacts when unmounted.
- **Non-Destructive Lifecycle**: Archiving hides sessions from active grouping surfaces without altering underlying transcript logs or workspace records.
- **Readily Accessible History**: Archived conversations can still be opened and viewed directly from the archive disclosure.

## Installation and Quick Start

Install a reviewed revision into your Web profile. The repository tracks prebuilt `lib/` artifacts, so Git installation requires no local build step:

```sh
dsh plugin --profile web add github:OpenSaozi/dsh-session-archive#<commit-sha>
```

After installation, refresh the page to access the "Archived (n)" disclosure at the bottom of the sidebar.

## Compatibility

This plugin requires a DeepSeek Harness version whose `@deepseek-ai/dsh-client-ui-workspace` package declares the `sidebar.workspaces.archive` child slot.

## Storage and Privacy

The plugin consumes only the host-owned workspace registry archive APIs and does not store prompt text, model responses, or private credentials.

## Model Experience

### Request Context and Condition

#### What the model sees

Nothing. Archive and restore actions inject no `system` prompt text, messages, tool schemas, or provider request fields.

#### Token effect

Zero direct tokens.

#### KV Cache effect

None; archive and restore operations do not issue or alter model inference requests.

## Known Limitations and Deferred Work

- **Inspection and restoration only** — the archive disclosure focuses on history viewing and restoration, without nested session renaming actions inside the list.