# @angela_lwh/dsh-archive-purge

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

A real "delete" for archived DeepSeek Harness sessions: removes the session and any subagent sessions it spawned from disk.

## Install

```powershell
# npm
dsh plugin --profile desktop add @angela_lwh/dsh-archive-purge

# GitHub
dsh plugin --profile desktop add https://github.com/Angela-lwh/dsh-archive-purge
```

Restart DSH afterwards: the Host half loads at startup, and an archived session's `...` menu and hover strip then show **Delete session**.

## Limits

- Only **archived** sessions can be deleted; archive one first.
- Refused while the session, or one of its subagent sessions, has work in progress; a session the Host still holds is staged and finished at the next start or from "Finish pending deletions".
- Deletion is irreversible and there is no trash; attachments (shared across sessions) are untouched. A deleted Session's spill overflow and projection-cache record go with it, and cache records left by earlier deletions are swept too (`sweepCache: false` turns that off).
- Subagent sessions are deleted with their parent; leftovers whose parent is already gone are swept at startup or on the next deletion.
- Blank sessions that never sent a message (the sidebar hides them) are removed automatically once they are **24 hours old** — on Host start, on a new conversation, or on any deletion (`blankMinAgeMs` tunes that) — and no longer show up in `@`; **a Session whose composer still holds an unsent draft is never swept** (the browser half reports those Session ids to the Host, which persists them). `sweepBlanks` / `filterBlankReferences` switch each part off.
- The browser half carries one workaround: the connection has no heartbeat, so a laptop sleep leaves the WebSocket half-open and the Workspace snapshot frozen (new Sessions look ungrouped, the picker misses a Workspace). After 30 minutes without activity the first interaction reconnects once, so the projection re-baselines.
- Only this machine's `$DSH_HOME/sessions` is touched, and no backup is kept; back it up first if you need a way back.