# dsh-session-archive

![installs](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdeepseek1024.com%2Fapi%2Fv1%2Fplugins%2Fkiligzzz%2Fdsh-session-archive&query=installCount&label=installs&color=blue&suffix=%20installs)

English | [简体中文](./README.md)

A DeepSeek Harness web plugin that surfaces the registry-global **archived
session set** and lets you preview, restore (unarchive), or delete sessions.

The harness hides archived sessions from every grouping surface (workspace
groups, Ungrouped, content search, flat list) but ships no UI to view or
restore them. This plugin adds that missing capability as a sidebar-footer
entry.

## Screenshots

**Panel** — archived sessions grouped by owning workspace directory, sorted
newest-first, each row showing its last-activity time with the absolute
timestamp on hover.

![Panel](https://raw.githubusercontent.com/kiligzzz/dsh-session-archive/main/assets/2-panel.png)

**Live title search** — typing filters the list across all groups as you type.

![Search](https://raw.githubusercontent.com/kiligzzz/dsh-session-archive/main/assets/3-search.png)

**Read-only preview** — clicking a session title opens a modal rendering
every user question from the on-disk log. The archived state is never touched.

![Preview](https://raw.githubusercontent.com/kiligzzz/dsh-session-archive/main/assets/4-preview.png)

**Delete confirmation** — deleting requires an explicit confirmation dialog;
live sessions are always refused.

![Delete](https://raw.githubusercontent.com/kiligzzz/dsh-session-archive/main/assets/5-delete-confirm.png)

**Sidebar entry** — the plugin adds a bottom-of-sidebar button alongside
Cordis Plugin and the Plugin Marketplace.

![Sidebar entry](https://raw.githubusercontent.com/kiligzzz/dsh-session-archive/main/assets/1-sidebar-entry.png)

## Features

- **Sidebar footer entry** — an "Archived sessions" button at the bottom of
  the sidebar (also works in the collapsed icon rail).
- **Grouped panel** — every archived session listed in a wide fixed-size
  panel, **grouped by owning workspace directory** (Ungrouped last), with
  **collapsible directory groups** and a per-group count badge.
- **Last-activity time per row** — compact relative time (now / 5min / 3h /
  2d), matching the sidebar session rows' style; hover shows the absolute
  local timestamp. Rows sort newest-first within each group.
- **Live title search** — filters sessions across all groups as you type.
- **Read-only preview** — clicking a session title opens a modal rendering
  every genuine user question (system-injected content excluded) from the
  on-disk log. Purely observational: the archived state is never touched, so
  you can inspect contents before deciding to restore or delete.
- **One-click restore** — calls a same-origin host route that durably removes
  the id from the archived set (idempotent, serialized through the
  workspace-registry write chain); the session reappears in its grouping.
- **Delete with confirmation** — a trash action opens a confirmation dialog;
  confirming permanently removes the session from the archived set, detaches
  its workspace accounting, and deletes its on-disk log directory. Live
  sessions are refused.
- **Host service API** — `workspaceArchive` (`list()` / `preview(sessionId)` /
  `restore(sessionId)` / `deleteSession(sessionId)`) exposed to sibling host
  plugins.

## Install

Prereq: a DeepSeek Harness Web profile (`dsh` available, `pnpm` on PATH).

```sh
dsh plugin --profile web add https://github.com/kiligzzz/dsh-session-archive
```

Restart the Web profile (host and browser bundles are scanned at boot), then
refresh the page. Its bundle id appears in `__DSH_BOOT__` and a
`sidebar.footer.action` entry appears at the bottom of the sidebar.

Install from a local checkout instead:

```sh
pnpm --dir <this-checkout> install   # dev deps (esbuild) only if rebuilding
pnpm --dir <this-checkout> run build # optional — lib/ build artifacts are committed
dsh plugin --profile web add "$PWD"
```

## Remove

```sh
dsh plugin --profile web remove @kiligzzz/dsh-session-archive
```

## How it works

- **host** (`src/index.ts`): a cordis plugin injecting `workspaceRegistry`
  (and optionally `webServer`). `WorkspaceArchive.restore()` mirrors the
  registry's own `archiveSession` write path: `enqueueOperation` →
  `requireState` → `setState({ ...state, archivedSessionIds: filtered })`,
  so the change is serialized and atomically persisted to the workspace domain
  (`~/.dsh/storages/workspace.json`). A same-origin route
  `/_dsh/session-archive` exposes `GET` (list) and
  `POST {action:'restore'|'delete'|'preview'}`.
- **client** (`src/client/index.tsx`): registers a `sidebar.footer.action`
  entry; the panel reads `archivedSessionIds` / session summaries from the
  shared `useWorkspaces` / `useSessions` stores and POSTs to the host route
  on restore, then the workspace baseline refreshes. Relative-time labels
  derive from each session's `updatedAt`.

## License

MIT