dsh-archived-sessions

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-archived-sessions

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

A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (`dsh`) web plugin that adds an **Archived Sessions** section to the Settings page for managing archived conversations.

> **Official source:** this repository is the official source of the npm package `dsh-archived-sessions` — `dsh plugin add dsh-archived-sessions` installs exactly this code.

![Archived Sessions in Settings](assets/screenshot.png)

## Features

- **List archived sessions** — each row shows the session's own name (the same title the sidebar uses), working directory, log size, and last update time.
- **Unarchive** — restore a session to the sidebar with one click; its original position in the workspace is kept.
- **Permanently delete** — removes the session's local log directory (`~/.dsh/sessions/...`) plus the attachment objects its log references that no other remaining session still uses, then drops the session from workspace accounting. A confirmation dialog must be acknowledged first.
- **Native look & feel** — built on the same UI primitives and design tokens as the built-in Settings sections.

## Requirements

- DeepSeek Harness with the workspace **archive** feature (the `archivedSessionIds`/`archiveSession` surface).
- Full unarchive/delete functionality requires the core `WorkspaceRegistry.unarchiveSession` / `deleteSession` methods. Until they ship in a released core, the plugin degrades gracefully: it still lists archived sessions and can still remove on-disk files, while unarchive reports a clear "restart `dsh web`" hint.

## Installation

Install from npm:

```sh
dsh plugin add dsh-archived-sessions
```

The plugin is then mounted automatically (its `dsh.bundle` patch joins the profile's bundle stack). Refresh the page (hard refresh) to load the client half, then open **Settings → Archived Sessions**.

Alternatively, install from source:

```sh
git clone https://github.com/Jxy-hy/dsh-archived-sessions.git
cd dsh-archived-sessions
pnpm install
pnpm run build
dsh plugin --profile web add link:./dsh-archived-sessions
```

Then mount it by appending to `~/.dsh/profiles/web/cordis.patch.yml` (or via your preferred bundle mechanism):

```yaml
- insert:
    - id: dsh-archived-sessions
      name: 'dsh-archived-sessions'
```

The host half hot-mounts through the profile's config HMR; refresh the page (hard refresh) to load the client half. Open **Settings → Archived Sessions**.

## Usage

1. Archive a session from the sidebar session menu (it hides from the sidebar).
2. Open **Settings → Archived Sessions**:
   - **Unarchive** — restores the session to its original sidebar position.
   - **Delete** — opens a confirmation dialog; confirming permanently deletes the local log and related attachments (objects still referenced by other sessions are kept) and removes the session from workspace accounting.

## Architecture

- **Host half** (`src/index.ts`) — registers `GET/POST /__dsh-archived-sessions/{list,unarchive,delete}` on the shared web server. The delete flow: dispose the live session first if it is open (so the in-memory store drops it and persistence retires its state) → wait for the write-behind flush to materialize the log → remove the session log directory → parse attachment references (`sha256:`) from the log → delete only the objects no other remaining session references → drop workspace accounting via `WorkspaceRegistry.deleteSession`.
- **Client half** (`src/client/`) — registers the `settings.section` entry "Archived Sessions"; the list merges `session.list` (including the projection title) with the plugin's host surface (creation time, log size); both mutations go through the host surface because the core RPC map offers neither operation. After a successful delete the client re-pulls the `session.list` baseline: deleting a cold (persisted, not-open) session emits no `session/disposed`, so the sidebar would otherwise keep the stale row under **Ungrouped** until the next reconnect.

## Community & Support

- Welcome to submit feedback or bug reports via [GitHub Discussions](https://github.com/Jxy-hy/dsh-archived-sessions/discussions).
- This repository carries the [`dsh-plugin`](https://github.com/topics/dsh-plugin) topic so it can be discovered.

## License

[MIT](LICENSE)