dsh-easy-archive

Readme

# easy-archive

A DSH (DeepSeek Harness) web plugin that moves session archiving out of the
kebab (⋮) menu and onto the workspace sidebar row itself, as a two-step
inline button:

1. **Hover a session row** — an archive icon appears right before the ⋮ button.
2. **Click once** — the button switches to a red **「确认归档 / Confirm archive」** pill.
3. **Click again** — the session is archived.

The **archive item is removed from the ⋮ menu** — archiving lives only on the
row, never buried in a submenu.

## Features

- Hover-revealed inline archive button on every session row (next to the ⋮ menu);
  one click arms the red confirm, the second commits.
- Archive entry automatically hidden from the ⋮ menu whenever it opens
  (rename / fork stay where they are).
- No slot takeover: the stock workspace browser keeps rendering; rename,
  fork, search, drag-reorder and everything else stay intact.
- Archive runs through the same wire call the built-in menu used
  (`ctx.workspaces.archiveSession`), so behavior and permissions are identical.
- Safety nets: the armed confirm auto-disarms after 4s, on mouse-leave, or on
  any click elsewhere; rows with ambiguous identities never get a button
  rather than risk archiving the wrong session.
- Locale-aware (zh / en), no build step, no React dependency.

## Install

From the DSH plugin market (recommended):

```
dsh plugin --profile web add github:bainianlaoyao/easy-archive   # GitHub distribution
dsh plugin --profile web add dsh-easy-archive                    # npm distribution (prebuilt; skips allowBuilds)
```

…or add it manually to the web profile's `package.json`:

```json
{
  "dependencies": { "dsh-easy-archive": "github:bainianlaoyao/easy-archive" },
  "dsh": { "profile": { "bundles": [ "...", "dsh-easy-archive" ] } }
}
```

then `pnpm install` in the profile directory and restart `dsh web`
(new plugins enter the `window.__DSH_BOOT__` graph at boot; later edits to
`lib/client.js` hot-apply on refresh).

## How it works

The host half (`lib/index.js`) is an inert plugin row that carries the
`dsh.client` declaration into the profile's loader graph; the browser half
(`lib/client.js`) observes the sidebar DOM and, for every rendered session
row:

- resolves the session id exactly from the `ctx.sessions.list` snapshot by
  display title (disambiguated by the rendered relative-time bucket when
  titles repeat),
- stamps the row with the id and inserts a 16px archive button into the row's
  action cell, before the kebab,
- removes the archive item from any ⋮ menu it sees open.

Clicking the button never bubbles to the row's "open session" handler.

## Development

```
node scripts/smoke.mjs   # validate the browser bundle shape
node scripts/check.mjs  # (alias) syntax + smoke
```

## Notes

- Blank "New Session" rows and search-result rows never get the button.
- Sessions whose display title and time bucket collide are skipped
  (conservative: no wrong-session archives).
- Uninstall: remove the dependency and bundles entry, `pnpm install`,
  restart `dsh web`.

## Related plugins

Other dsh plugins by the same author, all listed in the
[dsh plugin market](https://awesome-dsh-plugin.com/):

- [`dsh-codex-mode`](https://github.com/bainianlaoyao/dsh-codex-harness) — a Codex-shaped
  coding mode for GPT-family models: `exec_command` / `write_stdin` / `apply_patch` /
  `view_image`, both OpenAI routes (Chat Completions and Responses), and graphical
  subagent types.
- [`dsh-llm-api-pool`](https://github.com/bainianlaoyao/dsh-llm-api-pool) — pool several
  OpenAI-compatible API keys and hot-switch by remaining balance.
- [`dsh-session-robustness`](https://github.com/bainianlaoyao/dsh-session-robustness) —
  keep long sessions recoverable.
- [`dsh-bash-on-windows`](https://github.com/bainianlaoyao/bash-on-windows) — make Git
  Bash the only, honestly named terminal tool on Windows.

## License

MIT