# dsh-restore-archived-sessions

[中文](README.md)

> View and restore archived sessions in Harness.

## Runtime compatibility

This repository is a prebuilt host/client replacement for a customized Harness, not a standalone
`dsh plugin add` package. Its `dist/` replaces sibling-package targets named `dsh-workspace`,
`dsh-host-apiproxy`, and three client bundles. Published `@deepseek-ai/dsh@0.1.2-rc.1` does not
expose `dsh-host-apiproxy` at that location, so copying this dist into it is unsupported. The
pinned `0.1.3-alpha.1` source point `d347e703908d0406b7a7ef80e3a0e594d86b2215` uses different
transport seams such as `dsh-api-workspace-controller`; this dist is not thereby compatible.

Run the read-only preflight first. It exits before creating a backup or overwriting an installed
file when the host layout is wrong:

```bash
bash install.sh --check
```

An existing local old build is a separate candidate. It needs a passing layout/anchor check and a
synthetic archive/restore verification in an isolated profile before installation can be evaluated.
This preflight does not establish source provenance or full ABI compatibility, and never reads or
writes a real archive record.

`--rollback` validates the backup and exact target paths instead of requiring the current files to
pass the archive ABI preflight; a damaged installation is precisely a rollback use case.

To migrate to `0.1.3-alpha.1`, rebuild the restore surface and the `workspace.unarchiveSession`
transport from that source point through `dsh-api-workspace-controller` and
`dsh-client-ui-workspace`. Preserve archive-set position semantics and cross-tab snapshot updates;
do not overwrite published packages or remove restoration to claim compatibility.

## Overview

The official DeepSeek Harness hides archived sessions from every grouping surface and provides no way to view or restore them.
This project adds the missing surface: archived sessions appear under **Settings → Archived conversations**, where you can see each session's title, workspace, and last activity, then restore it with one click.

## Features

- Lists every archived session in one Settings page
- Shows session title, owning workspace (or Ungrouped), and last activity time
- **Restore**: removes only the archive marker; the session returns to its previous workspace slot
- **Restore and view**: restores the session, opens it, and closes Settings
- Archive state uses full-snapshot synchronization across tabs
- Archive state is durable and survives restarts

![Archived conversations](docs/images/archived-sessions.png)

## Installation

> This feature depends on the `workspace.unarchiveSession` RPC from the Harness mainline.
> Older official builds do not expose that RPC, so this project ships a patch bundle plus an installer.

```bash
git clone https://github.com/le-soleil-se-couche/dsh-restore-archived-sessions.git
cd dsh-restore-archived-sessions
bash install.sh --check
# Only after customized-host preflight and isolated verification: bash install.sh --install
dsh web --host 127.0.0.1 --port 3080
```

Rollback:

```bash
bash install.sh --rollback
```

## Usage

1. Archive any session from the sidebar.
2. Open Settings.
3. Open **Archived conversations**.
4. Use **Restore** to unarchive only, or **Restore and view** to unarchive and open the session.

## Project layout

```text
.
├── README.md              # Chinese (default)
├── README.en.md           # English
├── docs/images/           # Screenshots
├── dist/                  # Built host and client bundles
└── install.sh             # Install / rollback script
```

## Compatibility

- The original artifact was verified against a customized DeepSeek Harness `master` source tree;
  that is not a compatibility promise for a current published build or any local old build.
- The installer replaces only `dsh-workspace`, `dsh-host-apiproxy`, and three client bundles.
- Existing files are backed up before installation; rollback is one command.

## License

MIT